La tabella seguente mostra tutte le opzioni disponibili per l'impostazione e la ricezione entro camera.setOptions e camera.getOptions. Un'opzione non può essere modificata se il relativo supporto è vuoto o contiene una sola opzione.
| Nome | Tipo | Descrizione | Lettura/scrittura |
|---|---|---|---|
captureMode |
Stringa | Modalità di acquisizione attuale. Il valore predefinito è image. |
rw |
captureModeSupport |
Array di stringhe | Elenco delle modalità di acquisizione attualmente disponibili. Il requisito minimo per il livello API 1 è ["image"], mentre il requisito minimo per il livello API 2 è ["image", "interval"], dove "interval" rappresenta la modalità di acquisizione di una serie di immagini distanziate a un determinato intervallo. Consulta anche captureInterval e captureIntervalSupport. Due modalità aggiuntive ("video" and "walkaround")sono supportate dal livello API 2, quindi il livello API 2 supporta interamente ["image", "interval", "video", "walkaround"], dove "video" rappresenta la modalità di acquisizione video e "walkaround" la modalità per acquisire due immagini in sequenza: la prima con gli utenti in piedi in qualsiasi posizione rispetto alla videocamera e la seconda con l'utente dall'altra parte della fotocamera (rispetto al primo punto d'osservazione). In questo modo la fotocamera può rimuovere gli utenti dall'immagine finale combinando le due immagini. Se "walkaround" è supportato dalla fotocamera e impostato come modalità di acquisizione attuale, il client dovrebbe aspettarsi di inviare due comandi takePicture alla fotocamera, dove la risposta del primo comando (al termine) indica che la fotocamera è pronta a scattare la seconda immagine, mentre il secondo dovrebbe restituire l'immagine finale al termine.
Per aggiungere altre modalità di acquisizione non ancora supportate, aggiungi un trattino basso ( _ ) alle modalità specifiche del fornitore. Questa opzione è stata modificata nel livello API 2. |
r |
captureStatus |
Stringa | Stato attuale dell'acquisizione. Il valore predefinito è "idle". Questo è utile per determinare lo stato della videocamera al momento della prima connessione a un'app. Se la videocamera si trova nel bel mezzo delle riprese, potrebbe essere necessario arrestarla prima di chiedere di fare altre cose, ad esempio un'altra ripresa video. Questa opzione è stata aggiunta nel livello API 2.1. |
rw |
captureStatusSupport |
Array di stringhe | Elenco degli stati di acquisizione attualmente disponibile; Per impostazione predefinita, dovrebbe essere ["idle", "shooting"] se è supportata la ripresa video. È possibile fornire anche altre statue, ad esempio "downloading". Questa opzione è stata aggiunta nel livello API 2.1. |
r |
exposureProgram |
Numero | Programma di esposizione corrente. | rw |
exposureProgramSupport |
Array di numeri | Elenco dei programmi di esposizione attualmente disponibili; ad esempio [0, 1, 2, 3, 4]. Ogni numero intero rappresenta un diverso programma di esposizione:
ExposureProgram.
|
r |
iso |
Numero | Impostazione attuale della velocità ISO. | rw |
isoSupport |
Array di numeri | Livello API 1: elenco delle impostazioni ISO attualmente disponibili; ad esempio Livello API 2: elenco delle impostazioni ISO attualmente disponibili; ad esempio Questa opzione è stata modificata nel livello API 2. |
r |
shutterSpeed |
Numero | Impostazione attuale del tempo di esposizione. | rw |
shutterSpeedSupport |
Array di numeri | Livello API 1: elenco dei tempi di esposizione attualmente disponibili; ad esempio Livello API 2: elenco dei tempi di esposizione attualmente disponibili; ad esempio Questa opzione è stata modificata nel livello API 2. |
r |
aperture |
Numero | Impostazione dell'apertura attuale, in f-stop. | rw |
apertureSupport |
Array di numeri | Livello API 1: elenco delle impostazioni di apertura attualmente disponibili, espresso in Livello API 2: elenco delle impostazioni di apertura attualmente disponibili, espresso in |
r |
whiteBalance |
Stringa | Impostazione corrente del bilanciamento del bianco; ad esempio daylight. Il valore predefinito è auto. |
rw |
whiteBalanceSupport |
Array di stringhe | L'elenco di impostazioni di bilanciamento del bianco attualmente disponibili. Può essere un sottoinsieme dell'elenco predefinito:[ "auto", "incandescent", "fluorescent", "daylight", "cloudy-daylight", "shade", "twilight"]. Valori per ciascuno:
_vendor-setting |
r |
exposureCompensation |
Numero | Compensazione dell'esposizione attuale. | rw |
exposureCompensationSupport |
Array di numeri | Elenco delle compensazioni dell'esposizione attualmente disponibili, di solito nel passaggio 0.33 o
0,5; ad esempio: [-1, -0.67, -0.33, 0, 0.33, 0.67, 1] |
r |
fileFormat |
Oggetto | Tipo di file e risoluzione correnti. Il formato deve riflettere il valore corrente di {
"type": "jpeg",
"width": 2000,
"height": 1000
}
Se captureMode è video, una risposta appropriata potrebbe essere:
{
"type": "mp4",
"width": 1920,
"height": 1080,
"framerate": 30
}Questa opzione è stata modificata nel livello API 2. |
rw |
fileFormatSupport |
array di oggetti | Elenco dei formati file attualmente disponibili; Ad esempio: [
{
"type": "jpeg",
"width": 2000,
"height": 1000
},
{
"type": "jpeg",
"width": 200,
"height": 100
},
{
"type": "mp4",
"width": 1920,
"height": 1080,
"framerate": 24
},
{
"type": "mp4",
"width": 1280,
"height": 720,
"framerate": 30
},
...
]
Seleziona il seguente link per ulteriori informazioni su tutti i tipi.
Questa opzione è stata modificata nel livello API 2. |
r |
exposureDelay |
Numero | Ritardo attuale, in secondi, tra il comando takePicture e l'avvio dell'esposizione. |
rw |
exposureDelaySupport |
Array di numeri | Elenco dei ritardi di esposizione attualmente disponibile, in secondi; ad esempio: [0, 1, 2, 5, 10, 30, 60] |
r |
sleepDelay |
Numero | Ritardo attuale prima che la videocamera entri in modalità di sospensione, in secondi. | rw |
sleepDelaySupport |
Array di numeri | Elenco dei ritardi del sonno attualmente disponibili, in secondi; ad esempio, [30, 60, 120, 300, 600, 1800, 65535], dove 65535 disattiva la modalità sonno (la videocamera non entra in modalità di sospensione fino allo spegnimento) e deve essere supportata. |
r |
offDelay |
Numero | Ritardo attuale in secondi prima dello spegnimento della videocamera. | rw |
offDelaySupport |
Array di numeri | Elenco dei ritardi di interruzione corrente attualmente disponibile, in secondi; ad esempio, [1800, 3600, 7200, 65535], dove 65535 disattiva la modalità di spegnimento (la videocamera non si spegne fino a quando la batteria non si esaurisce o si spegne manualmente) e deve essere supportata. |
r |
totalSpace |
Numero | Sola lettura: numero di byte dello spazio di archiviazione totale. | r |
remainingSpace |
Numero | Sola lettura: numero di byte di spazio di archiviazione senza costi. | r |
remainingPictures |
Numero | Sola lettura: numero stimato di immagini rimanenti in base all'acquisizione corrente. dell'ambientazione. | r |
gpsInfo |
Oggetto | Informazioni GPS correnti. Imposta utilizzando {
"lat": 23.532,
"lng": -132.35
}
Le proprietà lat e lng sono in gradi decimali, con lat nell'intervallo, [-90, 90] e lng nell'intervallo, [-180, 180]. Quando fornita da uno smartphone, tieni presente che ogni posizione GPS è valida solo
fino al prossimo aggiornamento dallo smartphone. Lo smartphone deve stabilire quando eseguire l'aggiornamento
la posizione GPS; ad esempio, subito prima di ogni comando takePicture. 65535 comunica alla videocamera che la posizione GPS corrente non è valida e che la fotocamera
ignorarlo e utilizzare il proprio GPS, se esistente; ad esempio
setOptions({"gpsInfo": {"lat": 65535, "lng": 65535}}) indica che la posizione GPS è
non valido. |
rw |
dateTimeZone |
Stringa | Informazioni su data e ora correnti. Impostato da setOptions utilizzando data, ora e fuso orario dello smartphone. Il formato è YYYY:MM:DD HH:MM:SS+(-)HH:MM. L'ora è nel formato 24 ore, la data e l'ora sono separate da uno spazio vuoto,
etime zone è una differenza rispetto all'ora UTC; ad esempio, 2014:05:18 01:04:29+8:00 è il fuso orario della Cina (UTC+8:00) |
rw |
hdr |
Livello API 1: booleano Livello API 2: stringa |
Livello API 1: attiva/disattiva la modalità di acquisizione HDR. Il valore è Livello API 2: attuale modalità HDR del tipo String. Questa opzione è stata modificata nel livello API 2. |
rw |
hdrSupport |
Livello API 1: booleano Livello API 2: array di stringhe |
Livello API 1: il valore Livello API 2: se non supporti la modalità HDR,
Questa opzione è stata modificata nel livello API 2. |
r |
exposureBracket |
Oggetto | Impostazione corrente della parentesi di esposizione. Disponibile solo quando hdrSupport == true (livello API 1) o hdrSupport contiene almeno una modalità HDR (livello API 2). Se la fotocamera utilizza l'esposizione a forcella manuale, l'oggetto contiene due voci:
{
"shots": 3,
"increment": 1.33
}
Se la fotocamera utilizza l'esposizione automatica a forcella, l'oggetto contiene:
{
"autoMode": true
}
Livello API 1: il valore predefinito è Livello API 2: il valore predefinito è vuoto {} quando Questa opzione è stata modificata nel livello API 2. |
rw |
exposureBracketSupport |
Oggetto | Impostazioni della parentesi di esposizione attualmente disponibili; Ad esempio: {
"autoMode": true,
"shotsSupport": [1, 3, 5, 7],
"incrementSupport": [0.33, 0.67, 1, 1.33, 1.67, 2]
}
Livello API 1: il valore predefinito è Livello API 2: il valore predefinito è Questa opzione è stata modificata nel livello API 2. |
r |
gyro |
Booleano | Imposta true per attivare il modulo giroscopio della fotocamera o false per disattivare questa funzionalità. Il valore predefinito è true se la videocamera la supporta, altrimenti false. Questa impostazione può essere true solo quando gyroSupport == true. |
rw |
gyroSupport |
Booleano | Se la fotocamera dispone di un giroscopio, questo valore deve essere true, altrimenti false. |
r |
gps |
Booleano | Attiva/disattiva il modulo GPS della fotocamera. Il valore deve essere true per l'attivazione o false per disattivarla. Il valore predefinito è true se la videocamera lo supporta, altrimenti false. L'impostazione è true solo quando gpsSupport == true. |
rw |
gpsSupport |
Booleano | Questo valore deve essere true se la fotocamera ha un proprio modulo GPS, altrimenti false. |
r |
imageStabilization |
Stringa | Attuale operazione di stabilizzazione dell'immagine; ad esempio off. |
rw |
imageStabilizationSupport |
Array di stringhe | Sono attualmente disponibili opzioni di stabilizzazione dell'immagine. L'elenco predefinito è ["off", "on"].Se la fotocamera non supporta la stabilizzazione dell'immagine, restituisci ["off"], altrimenti restituisce ["off", "on"]. far precedere le stringhe specifiche del fornitore da un trattino basso ( _ ); ad esempio [ "off", "_horizontal_stabilization", "_vibration_correction" ]. |
r |
wifiPassword |
Stringa | Deve essere costituita da almeno 8 caratteri e contenere lettere, numeri, simboli, ma non spazi. Può essere modificato solo quando la videocamera è connessa a un dispositivo client. Una volta modificato, la videocamera deve disconnettersi in modo che l'utente debba riconnettersi utilizzando il nuovo
wifiPassword.La fotocamera deve fornire un meccanismo di ripristino nel caso in cui venga dimenticata la password. Ad esempio, un pulsante di ripristino per ripristinare la password predefinita di fabbrica. |
w |
previewFormat |
Oggetto | Risoluzione corrente dell'anteprima in tempo reale; Ad esempio: {
"width": 640,
"height": 320,
"framerate": 24
}Questa opzione è stata aggiunta al livello API 2. |
rw |
previewFormatSupport |
array di oggetti | Formati di anteprima in tempo reale attualmente supportati: Ad esempio: [
{
"width": 640,
"height": 320,
"framerate": 24
},
...
{
"width": 1280,
"height": 720,
"framerate": 24
}
]
Questa opzione è stata aggiunta al livello API 2. |
r |
captureInterval |
Numero | Intervallo attuale tra l'acquisizione di due immagini consecutive, in seconds.
Questa opzione è stata aggiunta al livello API 2. |
rw |
captureIntervalSupport |
Oggetto | Intervalli minimi e massimi consentiti tra l'acquisizione di due immagini consecutive, in secondi; Ad esempio: {
"minInterval": 10,
"maxInterval": 60
}Potrebbe variare a seconda del fileFormat.
Questa opzione è stata aggiunta al livello API 2. |
r |
captureNumber |
Numero | Numero di immagini da acquisire per una sessione di acquisizione a intervalli. Il valore predefinito è 0, a indicare che l'acquisizione deve essere terminata in modo esplicito dal comando stopCapture. altrimenti l'acquisizione si interrompe automaticamente dopo aver acquisito le immagini del numero specificato. L'acquisizione può essere interrotta anche quando la fotocamera è scarica o quando è stata spenta intenzionalmente.
Questa opzione è stata aggiunta al livello API 2. |
rw |
captureNumberSupport |
Oggetto | Numero minimo e massimo di immagini che possono essere acquisite durante un'acquisizione a intervalli; Ad esempio: {
"minNumber": 2,
"maxNumber": 50
}Potrebbe cambiare a seconda dello spazio di archiviazione rimanente.
Questa opzione è stata aggiunta al livello API 2. |
r |
remainingVideoSeconds |
Numero | Numero stimato di seconds per il video rimanente in base all'impostazione di acquisizione corrente.
Questa opzione è stata aggiunta al livello API 2. |
r |
pollingDelay |
Numero | Intervallo minimo in secondi tra due richieste di polling dello stato consecutive. I clienti devono utilizzare questo campo come guida per il comportamento dei sondaggi sullo stato. Ad esempio, durante lo stitching di un'immagine, i clienti potrebbero dover chiedere periodicamente alla videocamera di eseguire lo stitching per vedere se completa lo stitching. Le diverse videocamere hanno un supporto diverso. ad esempio, alcune videocamere sono in grado di gestire il polling di stato ogni secondo, mentre altre supportano intervalli più lunghi.
Questa opzione è stata aggiunta al livello API 2. |
r |
delayProcessing |
Booleano | True quando l'elaborazione (ad es. l'unione) ha una priorità inferiore rispetto all'acquisizione o, in altre parole, è consentita un'altra acquisizione prima del termine dell'elaborazione dell'immagine acquisita precedente. Questa opzione è vivamente consigliata, soprattutto per le fotocamere che richiedono tempi di elaborazione lunghi.
Questa opzione è stata aggiunta al livello API 2. |
rw |
delayProcessingSupport |
Array booleano |
Questa opzione è stata aggiunta al livello API 2. |
r |
clientVersion |
Numero | Il livello API che il client decide di utilizzare. Il valore predefinito è 1 se
camera supporta sia il livello API 1 che il livello 2, in modo che i client
Il livello API 1 continua a funzionare con la fotocamera senza alcuna modifica. predefinita
a 2 se la videocamera supporta solo il livello API 2, che non è
delle API consigliate prima della migrazione
al livello API 2. Se la videocamera
supporta solo il livello API 2, la richiesta che tenta di impostarla su 1 dovrebbe
non riuscito. Se il valore di Questa opzione è stata aggiunta al livello API 2. |
rw |
photoStitchingSupport |
Array di stringhe | Elenco di opzioni di unione per le foto. Torna al progetto
Questa opzione è stata aggiunta nel livello API 2.1. |
r |
photoStitching |
Stringa | Opzione di unione corrente per le foto, ad esempio
Questa opzione è stata aggiunta nel livello API 2.1. |
rw |
videoStitchingSupport |
Array di stringhe | Elenco delle opzioni di unione per i video. Torna al progetto
Questa opzione è stata aggiunta nel livello API 2.1. |
r |
videoStitching |
Stringa | Opzione di unione corrente per i video, ad es.
Questa opzione è stata aggiunta nel livello API 2.1. |
rw |
videoGPSSupport |
Array di stringhe | Elenco di opzioni GPS durante l'acquisizione video. Torna al progetto
Questa opzione è stata aggiunta nel livello API 2.1. |
r |
videoGPS |
Stringa | Opzione corrente per il supporto GPS durante l'acquisizione video, ad esempio
Questa opzione è stata aggiunta nel livello API 2.1. |
rw |
_vendorSpecific |
[type] (facoltativo) | Opzioni di fotocamera aggiuntive specifiche del fornitore. Aggiungi il prefisso alle stringhe specifiche del fornitore un trattino basso ( _). |