La tabella seguente mostra tutte le opzioni disponibili per l'impostazione e la ricezione in base alla camera.setOptions e al camera.getOptions. Impossibile modificare un'opzione quando il supporto corrispondente è vuoto o contiene una sola opzione.
| Nome | Tipo | Descrizione | Lettura/scrittura |
|---|---|---|---|
captureMode |
Stringa | Modalità di acquisizione corrente. Valore predefinito: image. |
rw |
captureModeSupport |
Array di stringhe | Elenco delle modalità di acquisizione attualmente disponibili. Il requisito minimo per il livello API 1 è ["image"] e il requisito minimo per il livello API 2 è ["image", "interval"], dove "interval" rappresenta la modalità di acquisizione di una serie di immagini con intervalli di un certo intervallo; consulta anche captureInterval e captureIntervalSupport. Due modalità aggiuntive ("video" and "walkaround")sono supportate dal livello API 2, quindi il set completo supportato dal livello API 2 è ["image", "interval", "video", "walkaround"], dove "video" rappresenta la modalità di acquisizione video e "walkaround" rappresenta la modalità di acquisizione di due immagini in sequenza, la prima con gli utenti in piedi rispetto alla fotocamera e la seconda con gli utenti in piedi sul lato opposto (rispetto al primo punto in piedi) della fotocamera. In questo modo, la videocamera può rimuovere gli utenti dall'immagine finale combinando le due immagini. Se "walkaround" è supportato dalla fotocamera e impostato come modalità di acquisizione corrente, il client dovrebbe inviare alla videocamera due comandi takePicture, in cui la risposta del primo comando (al termine) indica che la fotocamera è pronta per scattare la seconda immagine, mentre il secondo comando dovrebbe restituire l'immagine finale al termine.
Per aggiungere altre modalità di acquisizione non ancora supportate, inserisci un trattino basso ( _) prima delle modalità specifiche del fornitore. Questa opzione è stata modificata nel livello API 2. |
r |
captureStatus |
Stringa | Stato attuale dell'acquisizione. Il valore predefinito è "idle". È utile per determinare lo stato della videocamera quando viene connesso per la prima volta a un'app. Se la videocamera si trova in mezzo a un video, potrebbe essere necessario fermarlo prima di poter fare altre cose, come nel caso di un'altra ripresa. Questa opzione è stata aggiunta al livello API 2.1. |
rw |
captureStatusSupport |
Array di stringhe | Elenco degli stati di acquisizione attualmente disponibili; per impostazione predefinita, se la registrazione video è supportata, il valore predefinito è ["idle", "shooting"]. Puoi anche fornire altre statue, ad esempio "downloading". Questa opzione è stata aggiunta al livello API 2.1. |
r |
exposureProgram |
Numero | Programma esposizione attuale. | rw |
exposureProgramSupport |
Array di numeri | Elenco dei programmi di esposizione attualmente disponibili, ad esempio [0, 1, 2, 3, 4]. Ogni numero intero rappresenta un programma di esposizione diverso:
ExposureProgram.
|
r |
iso |
Numero | Impostazione di velocità ISO corrente. | 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 dell'otturatore attuale. | rw |
shutterSpeedSupport |
Array di numeri | Livello API 1:elenco delle velocità dell'otturatore attualmente disponibili, ad esempio Livello API 2:elenco delle velocità dell'otturatore attualmente disponibili; ad esempio, Questa opzione è stata modificata nel livello API 2. |
r |
aperture |
Numero | Impostazione di apertura attuale, in f-stop. | rw |
apertureSupport |
Array di numeri | Livello API 1:elenco delle impostazioni di apertura attualmente disponibili, espresse in Livello API 2:elenco delle impostazioni di apertura attualmente disponibili, espresse in |
r |
whiteBalance |
Stringa | Impostazione del bilanciamento del bianco corrente; ad esempio, daylight. Il valore predefinito è auto. |
rw |
whiteBalanceSupport |
Array di stringhe | Elenco delle impostazioni di bilanciamento del bianco attualmente disponibili, che può essere un sottoinsieme dell'elenco predefinito: [ "auto", "incandescent", "fluorescent", "daylight", "cloudy-daylight", "shade", "twilight"]. Valori per ciascun elemento:
_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 dovrebbe 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 tra il comando takePicture e l'avvio dell'esposizione, in secondi. |
rw |
exposureDelaySupport |
Array di numeri | Elenco dei ritardi di esposizione attualmente disponibili, 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 di sospensione attualmente disponibili, in secondi; ad esempio, [30, 60, 120, 300, 600, 1800, 65535], dove 65535 disattiva la modalità sonno (la videocamera non dorme fino allo spegnimento) e deve essere supportata. |
r |
offDelay |
Numero | Ritardo attuale in secondi prima che la videocamera si spenga. | rw |
offDelaySupport |
Array di numeri | Elenco di ritardi di spegnimento attualmente disponibili, in secondi; ad esempio, [1800, 3600, 7200, 65535], dove 65535 disattiva la modalità di spegnimento (la videocamera non si spegne finché la batteria non è scarica o spenta 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'impostazione di acquisizione corrente. | r |
gpsInfo |
Oggetto | Informazioni GPS attuali. Imposta usando {
"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]. Se fornito da un telefono, tieni presente che ogni posizione GPS è valida solo fino al prossimo aggiornamento dal telefono. Il telefono deve determinare quando aggiornare la posizione GPS, ad esempio subito prima di ogni comando takePicture. 65535 avvisa la fotocamera che la posizione GPS corrente non è valida e la fotocamera deve ignorarla e utilizzare il proprio GPS, se esistente; ad esempio,
setOptions({"gpsInfo": {"lat": 65535, "lng": 65535}}) indica che la posizione GPS non è valida. |
rw |
dateTimeZone |
Stringa | Informazioni su data e ora attuali. Impostala entro il giorno setOptions utilizzando data, ora e fuso orario del telefono. Il formato è YYYY:MM:DD HH:MM:SS+(-)HH:MM. L'ora è in formato 24 ore, data e ora sono separate da uno spazio vuoto e il fuso orario è un offset rispetto all'ora UTC; ad esempio, 2014:05:18 01:04:29+8:00 è il fuso orario 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:modalità HDR corrente del tipo di stringa. Questa opzione è stata modificata nel livello API 2. |
rw |
hdrSupport |
Livello API 1: booleano Livello API 2: array di stringhe |
Livello API 1: un valore Livello API 2: se non si supporta la modalità HDR, è
Questa opzione è stata modificata nel livello API 2. |
r |
exposureBracket |
Oggetto | Impostazione corrente della fascia di esposizione. Disponibile solo quando hdrSupport == true (livello API 1) o hdrSupport contiene almeno una modalità HDR (livello API 2). Se la fotocamera utilizza il parentesi quadre per l'esposizione manuale, l'oggetto contiene due voci:
{
"shots": 3,
"increment": 1.33
}
Se la fotocamera utilizza il parentesi quadre dell'esposizione automatica, l'oggetto contiene:
{
"autoMode": true
}
Livello API 1:il valore predefinito è Livello API 2: il valore predefinito è {} quando Questa opzione è stata modificata nel livello API 2. |
rw |
exposureBracketSupport |
Oggetto | Impostazioni della sezione 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à. Imposta come valore predefinito true se la fotocamera supporta questa funzionalità, altrimenti false. Questa impostazione può essere true solo quando gyroSupport == true. |
rw |
gyroSupport |
Booleano | Se la fotocamera ha un giroscopio, questo valore deve essere true, altrimenti pari a 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 supportato dalla fotocamera, altrimenti false. L'impostazione è true solo quando gpsSupport == true. |
rw |
gpsSupport |
Booleano | Questo valore deve essere true se la videocamera ha il proprio modulo GPS, altrimenti false. |
r |
imageStabilization |
Stringa | Operazione di stabilizzazione dell'immagine corrente, ad esempio off. |
rw |
imageStabilizationSupport |
Array di stringhe | Opzioni di stabilizzazione dell'immagine attualmente disponibili. L'elenco predefinito è ["off", "on"].Se la fotocamera non supporta la stabilizzazione dell'immagine, restituisci ["off"] o restituisci ["off", "on"]. e le stringhe specifiche del fornitore precedute da un trattino basso ( _ ), ad esempio [ "off", "_horizontal_stabilization", "_vibration_correction" ]. |
r |
wifiPassword |
Stringa | Avere almeno 8 caratteri e contenere lettere, numeri, simboli, ma senza spazi. Può essere modificata solo quando la videocamera è collegata a un dispositivo client. Una volta cambiata la videocamera, quest'ultima deve disconnettersi, così l'utente deve riconnettersi usando la nuova
wifiPassword.La videocamera deve fornire un meccanismo di ripristino nel caso in cui la password venga dimenticata, ad esempio un pulsante di ripristino per ripristinare la password predefinita di fabbrica. |
w |
previewFormat |
Oggetto | Risoluzione di anteprima in tempo reale corrente; 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 di 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, il che significa che l'acquisizione deve essere terminata esplicitamente dal comando stop Capture; in caso contrario, l'acquisizione si interrompe automaticamente dopo l'acquisizione delle immagini del numero specificato. L'acquisizione può essere interrotta anche quando la videocamera ha la batteria scarica o quando viene 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 variare 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 consecutive di sondaggi sullo stato. I clienti devono utilizzare questo campo per guidare il comportamento del sondaggio di stato; ad esempio, quando unisce un'immagine, i clienti potrebbero dover effettuare sondaggi periodici sulla videocamera per vedere se il processo viene completato. Il supporto di differenti videocamere è diverso: ad esempio, alcune videocamere possono gestire i sondaggi di stato ogni secondo, mentre altre supportano intervalli più lunghi.
Questa opzione è stata aggiunta al livello API 2. |
r |
delayProcessing |
Booleano | True durante l'elaborazione (ad esempio, con unione) ha una priorità inferiore rispetto all'acquisizione o, in altre parole, è consentita un'altra acquisizione prima che l'elaborazione dell'immagine acquisita precedente sia terminata. Consigliamo vivamente questa opzione, soprattutto per le videocamere 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 la fotocamera supporta sia il livello API 1 che 2 in modo che i client scritti per il livello API 1 continuino a funzionare con la fotocamera senza alcuna modifica. Il valore predefinito è 2 se la fotocamera supporta solo il livello API 2, opzione non consigliata prima che i client eseguano la migrazione al livello API 2. Se la fotocamera supporta solo il livello API 2, la richiesta che tenta di impostarlo su 1 non dovrebbe riuscire. Se Questa opzione è stata aggiunta al livello API 2. |
rw |
photoStitchingSupport |
Array di stringhe | Elenco di opzioni di unione per le foto. Restituisce Questa opzione è stata aggiunta al livello API 2.1. |
r |
photoStitching |
Stringa | Opzione di stitching corrente per le foto, ad esempio
Questa opzione è stata aggiunta al livello API 2.1. |
rw |
videoStitchingSupport |
Array di stringhe | Elenco di opzioni di unione per i video. Restituisce
Questa opzione è stata aggiunta al livello API 2.1. |
r |
videoStitching |
Stringa | Opzione di stitching corrente per i video, ad esempio
Questa opzione è stata aggiunta al livello API 2.1. |
rw |
videoGPSSupport |
Array di stringhe | Elenco di opzioni GPS durante l'acquisizione del video. Torna
Questa opzione è stata aggiunta al livello API 2.1. |
r |
videoGPS |
Stringa | Opzione attuale per il supporto GPS durante l'acquisizione video, ad esempio Questa opzione è stata aggiunta al livello API 2.1. |
rw |
_vendorSpecific |
[type] (facoltativo) | Opzioni aggiuntive relative alla fotocamera specifiche del fornitore. e le stringhe specifiche del fornitore precedute da un trattino basso ( _ ). |