Optionen

In der folgenden Tabelle finden Sie alle Optionen, die für camera.setOptions und camera.getOptions verfügbar sind. Eine Option kann nicht geändert werden, wenn die entsprechende Unterstützung leer ist oder nur eine Option enthält.

Name Typ Beschreibung Lesen/Schreiben
captureMode String Aktueller Erfassungsmodus. Standardwert: image. rw
captureModeSupport String-Array Liste der Aufnahmemodi, die derzeit verfügbar sind. Die Mindestanforderung für API-Ebene 1 ist ["image"] und die Mindestanforderung für API-Ebene 2 ["image", "interval"], wobei mit "interval" der Modus zum Erfassen einer Reihe von Bildern in einem bestimmten Intervall dargestellt wird, siehe auch captureInterval und captureIntervalSupport. Von API-Level 2 werden zwei weitere Modi unterstützt: ("video" and "walkaround"). Der vollständige, von API-Level 2 unterstützte Satz ist also ["image", "interval", "video", "walkaround"], wobei "video" für den Videoaufnahmemodus und "walkaround" für den Modus zum Aufnehmen von zwei Bildern hintereinander steht, wobei der erste Nutzer irgendwo relativ zur Kamera steht und der zweite mit den Nutzern auf der gegenüberliegenden Seite (bezogen auf den ersten Standpunkt). So kann die Kamera die Nutzer aus dem fertigen Bild entfernen, indem sie die beiden Bilder kombiniert. Wenn "walkaround" von der Kamera unterstützt und als aktueller Aufnahmemodus festgelegt wird, sollte der Client davon ausgehen, zwei takePicture-Befehle an die Kamera zu senden. Die Antwort des ersten Befehls (wenn dieser abgeschlossen ist) gibt an, dass die Kamera bereit ist, das zweite Bild aufzunehmen, und der zweite Befehl das endgültige Bild zurückgeben soll, sobald dieser abgeschlossen ist.

Wenn Sie weitere Erfassungsmodi hinzufügen möchten, die noch nicht unterstützt werden, setzen Sie vor dem Anbieter bitte einen Unterstrich ( _).

Diese Option wurde in API-Level 2 geändert.

 r
captureStatus String Aktueller Aufnahmestatus. Standardeinstellung ist "idle". Das ist nützlich, um den Status der Kamera zu bestimmen, wenn sie das erste Mal mit einer App verbunden wird. Wenn sich die Kamera mitten in der Aufnahme eines Videos befindet, muss sie möglicherweise beendet werden, bevor andere Befehle ausgeführt werden, z.B. ein anderes Videodreh.

Diese Option wurde in API-Level 2.1 hinzugefügt.

 rw
captureStatusSupport String-Array Liste der verfügbaren Aufnahmestatus. Standardmäßig sollte sie ["idle", "shooting"] lauten, wenn Videoaufnahmen unterstützt werden. Andere Statuen wie "downloading" können ebenfalls angegeben werden.

Diese Option wurde in API-Level 2.1 hinzugefügt.

 r
exposureProgram Zahl Aktuelles Belichtungsprogramm. rw
exposureProgramSupport Zahlenarray Liste mit derzeit verfügbaren Kontaktprogrammen, z. B. [0, 1, 2, 3, 4]. Jede Ganzzahl steht für ein anderes Belichtungsprogramm:
  • 0 = Nicht definiert
  • 1 = Manuell
  • 2 = Normales Programm
  • 3 = Blendenpriorität
  • 4 = Verschlusspriorität
Klicken Sie auf den folgenden Link, um weitere Informationen zu ExposureProgram herunterzuladen. 		r
iso Zahl Aktuelle Einstellung für die ISO-Geschwindigkeit. rw
isoSupport Zahlenarray

API-Ebene 1:Liste der verfügbaren ISO-Einstellungen, z. B. [100, 200, 400, 800,1600] oder [] im Modus auto.

API-Ebene 2: Liste der verfügbaren ISO-Einstellungen, z. B. [0, 100, 200, 400, 800, 1600], wobei 0 für den auto-Modus steht.

Diese Option wurde in API-Level 2 geändert.

 r
shutterSpeed Zahl Aktuelle Einstellung für die Verschlusszeit. rw
shutterSpeedSupport Zahlenarray

API-Level 1:Liste der verfügbaren Belichtungszeiten, z. B. [0.067, 0.033, 0.017,0.008] oder [] im Modus auto.

API-Level 2:Liste der aktuell verfügbaren Verschlusszeiten, z. B. [0, 0.067, 0.033, 0.017, 0.008], wobei 0 für den auto-Modus steht.

Diese Option wurde in API-Level 2 geändert.

 r
aperture Zahl Aktuelle Blendenöffnung, in Blendenstufen. rw
apertureSupport Zahlenarray

API-Ebene 1: Liste der verfügbaren Blendenöffnungen, angegeben in f/number. Beispiel: [1.4, 2, 2.8, 4, 5.6, 8, 11] oder [] im auto-Modus.

API-Ebene 2: Liste mit verfügbaren Blendenöffnungen, angegeben in f/number. Beispiel: [0, 1.4, 2, 2.8, 4, 5.6, 8, 11], wobei 0 für den auto-Modus steht.

 r
whiteBalance String Aktuelle Einstellung für den Weißabgleich, z. B. daylight Die Standardeinstellung ist auto. rw
whiteBalanceSupport String-Array Die Liste der aktuell verfügbaren Weißabgleicheinstellungen kann eine Teilmenge der vordefinierten Liste sein: [ "auto", "incandescent", "fluorescent", "daylight", "cloudy-daylight", "shade", "twilight"]. Werte für die einzelnen Elemente:
  • incandescent, ca. 3.200.000
  • fluorescent, ca. 4.000.000
  • datalight, ca. 5.200.000
  • cloudy-daylight, ca. 6.000.000
  • shade, ca. 7.000.000
  • twilight, ca. 12.000.000
Stellen Sie anbieterspezifische Einstellungsnamen mit einem Unterstrich voran, z. B.: _vendor-setting		 r
exposureCompensation Zahl Aktuelle Belichtungskorrektur. rw
exposureCompensationSupport Zahlenarray Liste der aktuell verfügbaren Kontaktkompensationen, normalerweise in Schritt 0.33 oder 0.5. Beispiel: [-1, -0.67, -0.33, 0, 0.33, 0.67, 1] r
fileFormat Object

Aktueller Dateityp und aktuelle Auflösung. Das Format sollte dem aktuellen Wert von captureMode entsprechen. Wenn captureMode beispielsweise image ist, könnte eine entsprechende Antwort so aussehen:

{
    "type": "jpeg",
    "width": 2000,
    "height": 1000
}
Wenn captureMode den Wert video hat, wäre eine mögliche Antwort: 
{
    "type": "mp4",
    "width": 1920,
    "height": 1080,
    "framerate": 30
}

Diese Option wurde in API-Level 2 geändert.

 rw
fileFormatSupport Objekt-Array

Liste der verfügbaren Dateiformate, z. B.:

[
    {
    "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
    },
    ...
]
Klicken Sie auf den folgenden Link, um weitere Informationen zu allen Typen zu erhalten.

Diese Option wurde in API-Level 2 geändert.

 r
exposureDelay Zahl Aktuelle Verzögerung zwischen dem Befehl takePicture und dem Start des Kontakts in Sekunden. rw
exposureDelaySupport Zahlenarray Liste der derzeit verfügbaren Verzögerungen bei der Belichtung in Sekunden, z. B. [0, 1, 2, 5, 10, 30, 60] r
sleepDelay Zahl Aktuelle Verzögerung, bevor die Kamera in den Ruhemodus wechselt. rw
sleepDelaySupport Zahlenarray Liste der derzeit verfügbaren Schlafverzögerungen in Sekunden, z. B. [30, 60, 120, 300, 600, 1800, 65535], wo 65535 den Schlafmodus deaktiviert (die Kamera schaltet sich erst nach dem Ausschalten aus) und muss unterstützt werden. r
offDelay Zahl Aktuelle Verzögerung in Sekunden, bevor die Kamera ausgeschaltet wird. rw
offDelaySupport Zahlenarray Liste der derzeit verzögerten Abschaltverzögerungen, z. B. [1800, 3600, 7200, 65535], bei dem 65535 den Abschaltmodus deaktiviert hat (die Kamera wird erst abgeschaltet, wenn der Akku vollständig entladen oder manuell ausgeschaltet ist) und unterstützt werden muss. r
totalSpace Zahl Schreibgeschützt: Anzahl der Byte des Gesamtspeichers. r
remainingSpace Zahl Schreibgeschützt: Anzahl der Byte an freiem Speicherplatz. r
remainingPictures Zahl Schreibgeschützt: die geschätzte Anzahl der verbleibenden Bilder basierend auf der aktuellen Einstellung für die Aufnahme r
gpsInfo Object

Aktuelle GPS-Informationen. Mit setOptions über GPS des Smartphones einstellen:

{
    "lat": 23.532,
    "lng": -132.35
}
Die Properties lat und lng sind Dezimalgrade, wobei lat im Bereich [-90, 90] und lng im Bereich [-180, 180] enthalten ist. Hinweis: Jeder GPS-Standort ist nur bis zum nächsten Update über das Telefon gültig. Das Smartphone muss bestimmen, wann der GPS-Standort aktualisiert werden soll, etwa direkt vor jedem takePicture-Befehl. 65535 benachrichtigt die Kamera, dass der aktuelle GPS-Standort ungültig ist und die Kamera ihn ignorieren und ihr eigenes GPS verwenden soll, falls sie vorhanden ist. Beispiel: setOptions({"gpsInfo": {"lat": 65535, "lng": 65535}}) bedeutet, dass der GPS-Standort ungültig ist.		 rw
dateTimeZone String Aktuelle Informationen zu Datum und Uhrzeit. Von setOptions mit Datum, Uhrzeit und Zeitzone des Smartphones festgelegt. Das Format ist YYYY:MM:DD HH:MM:SS+(-)HH:MM. Die Uhrzeit wird im 24-Stunden-Format angegeben. Datum und Uhrzeit werden durch Leerzeichen getrennt. Die Zeitzone ist eine Abweichung zur UTC-Zeit. Zum Beispiel ist 2014:05:18 01:04:29+8:00 die chinesische Zeitzone (UTC+8:00) rw
hdr

API-Ebene 1:Boolesch

API-Ebene 2: String

API-Ebene 1:HDR-Aufnahmemodus aktivieren/deaktivieren. Der Wert ist true, um HDR zu aktivieren, oder false, um ihn zu deaktivieren. Der Standardwert ist false. Die Einstellung kann nur true sein, wenn hdrSupport auch true ist.

API-Ebene 2: Aktueller HDR-Modus des Stringtyps.

Diese Option wurde in API-Level 2 geändert.

 rw
hdrSupport

API-Ebene 1: Boolesch

API-Ebene 2: String-Array

API-Level 1: Der Wert true gibt an, dass die Kamera HDR unterstützt. Mit der Einstellung false wird eine Kamera ohne HDR angegeben.

API-Level 2:Wenn du den HDR-Modus nicht unterstützt, ist er [“off”]. Wenn du einen HDR-Modus unterstützt, ist er [“off”, “hdr”]. Wenn mehrere HDR-Modi (verschiedene Algorithmen) unterstützt werden, ist es [“off”, “hdr”, “hdr1”, “hdr2”, ...].

Diese Option wurde in API-Level 2 geändert.

 r
exposureBracket Object Aktuelle Einstellung für Belichtungsreihe. Nur verfügbar, wenn hdrSupport == true (API-Level 1) oder hdrSupport mindestens einen HDR-Modus enthält (API-Level 2). Wenn die Kamera die manuelle Belichtungsreihe verwendet, enthält das Objekt zwei Einträge:
  1. shots, eine Ganzzahl, die die Anzahl der aufzunehmenden Aufnahmen enthält.
  2. increment: eine Zahl mit einer Abstufung des Elektrofahrzeugs zwischen den Aufnahmen
Beispiel: 
{
    "shots": 3,
    "increment": 1.33
}
Wenn die Kamera die automatische Belichtungsreihe verwendet, enthält das Objekt: 
{
    "autoMode": true
}

API-Ebene 1:Standardmäßig ist {} auf hdrSupport == false gesetzt. Hersteller entscheiden Standardwerte (z. B. die Belichtungsreihe), wenn hdr auf true gesetzt ist.

API-Ebene 2:Standardmäßig ist {} leer, wenn hdrSupport nur "off" enthält. Andernfalls entscheiden Hersteller die Standardwerte, z. B. die Belichtungsreihe.

Diese Option wurde in API-Level 2 geändert.

 rw
exposureBracketSupport Object

Derzeit sind Einstellungen für die Belichtungsreihe verfügbar. Beispiel:

{
    "autoMode": true,
    "shotsSupport": [1, 3, 5, 7],
    "incrementSupport": [0.33, 0.67, 1, 1.33, 1.67, 2]
}

API-Level 1: Standardmäßig {} leer, wenn hdrSupport == false. Wenn hdrSupport == true, aber die Belichtungsreihe nicht unterstützt wird, dann ist autoMode false.

API-Ebene 2: Standardmäßig ist {} leer, wenn hdrSupport nur "off" enthält. Wenn hdrSupport einen HDR-Modus enthält, die Belichtungsreihenautomatik aber nicht unterstützt wird, gilt für autoMode der Wert false.

Diese Option wurde in API-Level 2 geändert.

 r
gyro Boolesch Legen Sie true fest, um das Gyroskopmodul der Kamera zu aktivieren, oder false, um diese Funktion zu deaktivieren. Wenn die Kamera dies unterstützt, wird standardmäßig true verwendet. Andernfalls false. Diese Einstellung kann nur true sein, wenn gyroSupport == true. rw
gyroSupport Boolesch Wenn die Kamera ein Gyroskop hat, sollte dieser Wert true sein. Andernfalls lautet er false. r
gps Boolesch Aktiviert/deaktiviert das Kamera-GPS-Modul. Zum Aktivieren muss der Wert true oder zum Deaktivieren false sein. Der Standardwert ist true, wenn die Kamera dies unterstützt, ansonsten false. Die Einstellung ist nur dann true, wenn gpsSupport == true. rw
gpsSupport Boolesch Dieser Wert sollte true lauten, wenn die Kamera ein eigenes GPS-Modul hat. Andernfalls false. r
imageStabilization String Aktueller Bildstabilisierungsvorgang, z. B. off rw
imageStabilizationSupport String-Array Derzeit sind Optionen zur Bildstabilisierung verfügbar. Die vordefinierte Liste lautet ["off", "on"].Wenn die Kamera die Bildstabilisierung nicht unterstützt, gib ["off"] zurück, andernfalls ["off", "on"]. Stellen Sie anbieterspezifische Strings mit einem Unterstrich ( _) voran, zum Beispiel [ "off", "_horizontal_stabilization", "_vibration_correction" ]. r
wifiPassword String
Mindestens 8 Zeichen lang, bestehend aus Buchstaben, Ziffern und Symbolen, aber ohne Leerzeichen. Sie kann nur geändert werden, wenn die Kamera mit einem Clientgerät verbunden ist. Nachdem die Kamera geändert wurde, muss die Kamera vom WLAN getrennt werden, sodass der Nutzer sich mit dem neuen wifiPassword neu verbinden muss.
Für den Fall, dass das Passwort vergessen wird, muss die Kamera einen Mechanismus zum Zurücksetzen haben, zum Beispiel eine Taste zum Zurücksetzen auf die Werkseinstellungen.
 w
previewFormat Object

Aktuelle Auflösung der Livevorschau. Beispiel:

{
    "width": 640,
    "height": 320,
    "framerate": 24
}

Diese Option wurde in API-Level 2 hinzugefügt.

 rw
previewFormatSupport Objekt-Array

Derzeit unterstützte Livevorschauformate, z. B.:

[
    {
    "width": 640,
    "height": 320,
    "framerate": 24
    },
    ...
    {
    "width": 1280,
    "height": 720,
    "framerate": 24
    }
]

Diese Option wurde in API-Level 2 hinzugefügt.

 r
captureInterval Zahl Aktuelles Intervall zwischen zwei aufeinanderfolgenden Bildern in seconds.

Diese Option wurde in API-Level 2 hinzugefügt.

 rw
captureIntervalSupport Object

Minimale und maximale Abstände zwischen zwei aufeinanderfolgenden Bildern in Sekunden, z. B.:

{
    "minInterval": 10,
    "maxInterval": 60
}
Das kann je nach fileFormat variieren.

Diese Option wurde in API-Level 2 hinzugefügt.

 r
captureNumber Zahl Anzahl der Bilder, die für eine Aufnahme in einem Intervall aufgenommen werden sollen. Die Standardeinstellung ist 0. Das bedeutet, dass die Erfassung explizit durch den Befehl stopCapture beendet werden muss. Andernfalls wird die Erfassung automatisch beendet, nachdem sie Bilder mit der angegebenen Anzahl aufgenommen hat. Die Aufnahme kann auch unterbrochen werden, wenn der Akku der Kamera leer ist oder die Kamera absichtlich ausgeschaltet wird.

Diese Option wurde in API-Level 2 hinzugefügt.

 rw
captureNumberSupport Object

Mindest- und Höchstanzahl von Bildern, die während einer Intervallaufnahme erfasst werden können. Beispiel:

{
    "minNumber": 2,
    "maxNumber": 50
}
Das kann sich je nach verbleibendem Speicherplatz ändern.

Diese Option wurde in API-Level 2 hinzugefügt.

 r
remainingVideoSeconds Zahl Die geschätzte Anzahl von seconds für das verbleibende Video basiert auf der aktuellen Einstellung für die Aufnahme.

Diese Option wurde in API-Level 2 hinzugefügt.

 r
pollingDelay Zahl Mindestintervall in Sekunden zwischen zwei aufeinanderfolgenden Statusabfragen. Kunden können dieses Feld verwenden, um ihr Statusabfrageverhalten zu steuern. Wenn ein Bild beispielsweise zusammengefügt wird, muss der Kunde eventuell regelmäßig die Kamera abfragen, um zu sehen, ob das Zusammenfügen abgeschlossen ist. Die verschiedenen Kameras werden unterschiedlich unterstützt. Einige Kameras können z. B. alle Sekunden eine Statusabfrage ausführen, während andere ein längeres Intervall unterstützen.

Diese Option wurde in API-Level 2 hinzugefügt.

 r
delayProcessing Boolesch True während der Verarbeitung (z.B. beim Zusammenfügen) eine niedrigere Priorität hat als die Aufnahme, das heißt, eine andere Aufnahme ist zulässig, bevor die Verarbeitung des zuvor aufgenommenen Bilds abgeschlossen ist. Dies wird dringend empfohlen, insbesondere für Kameras, die eine lange Verarbeitungszeit benötigen.

Diese Option wurde in API-Level 2 hinzugefügt.

 rw
delayProcessingSupport Boolesches Array

[true] bedeutet, dass die Verarbeitung (z.B. das Zusammenfügen) eine niedrigere Priorität hat als die Aufzeichnung, und sie ist standardmäßig immer verzögert.

[false] bedeutet, dass die Verarbeitung direkt nach der Erfassung erfolgt.

[true, false] bedeutet, dass die Wahl zwischen diesen beiden Modi besteht.

Diese Option wurde in API-Level 2 hinzugefügt.

 r
clientVersion Zahl

Das API-Level, das vom Client verwendet werden soll. Der Standardwert ist 1, wenn die Kamera sowohl API-Level 1 als auch 2 unterstützt, sodass Clients, die für API-Level 1 geschrieben wurden, weiterhin ohne Änderung mit der Kamera funktionieren. Der Standardwert ist 2, wenn die Kamera nur API-Level 2 unterstützt. Diese wird nicht empfohlen, bevor Clients zu API-Level 2 migrieren. Wenn die Kamera nur API-Level 2 unterstützt, sollte die Anfrage, sie auf 1 zu setzen, fehlschlagen. Wenn clientVersion auf 2 erfolgreich gesetzt ist und ein verworfener Befehl von API-Ebene 1 angefordert wird, sollte die Anfrage mit dem Fehlercode unknownCommand fehlschlagen.

Diese Option wurde in API-Level 2 hinzugefügt.

 rw
photoStitchingSupport String-Array

Liste der Stitching-Optionen für Fotos. Gib [ondevice] zurück, wenn die Kamera immer zusammengefügt wurde, [none], wenn die Kamera Fotos nicht zusammenfügen kann, und [none,ondevice], wenn der Zusammenfügung vom Nutzer konfiguriert werden kann. Stellen Sie anbieterspezifische Einstellungsnamen mit einem Unterstrich voran, z.B. _vendor-setting.

Diese Option wurde in API-Level 2.1 hinzugefügt.

 r
photoStitching String

Aktuelle Option zum Zusammenfügen von Fotos, z.B. ondevice. Die Standardeinstellung ist ondevice, wenn es unterstützt wird.

Diese Option wurde in API-Level 2.1 hinzugefügt.

 rw
videoStitchingSupport String-Array

Liste der Stitching-Optionen für Videos. Gibt [ondevice] zurück, wenn die Kamera immer zusammengefügt wurde, [none], wenn die Kamera keine Videos zusammenfügen kann, und [none,ondevice], wenn der Zusammenfügen vom Nutzer konfiguriert werden kann. Stellen Sie anbieterspezifische Einstellungsnamen mit einem Unterstrich voran, z.B. _vendor-setting.

Diese Option wurde in API-Level 2.1 hinzugefügt.

 r
videoStitching String

Aktuelle Stitching-Option für Videos, z.B. ondevice. Die Standardeinstellung ist ondevice, wenn es unterstützt wird.

Diese Option wurde in API-Level 2.1 hinzugefügt.

 rw
videoGPSSupport String-Array

Liste der GPS-Optionen bei der Videoaufnahme. Gibt [continuous] zurück, wenn die Kamera während der Videoaufzeichnung kontinuierlich GPS-Signale erfassen und die Standorte in das Video einbetten kann. Gibt [none] zurück, wenn dies nicht möglich ist, und [none,continuous], wenn die GPS-Unterstützung des Videos vom Nutzer konfiguriert werden kann. Stellen Sie anbieterspezifische Einstellungsnamen mit einem Unterstrich voran, z.B. _vendor-setting.

Diese Option wurde in API-Level 2.1 hinzugefügt.

 r
videoGPS String

Aktuelle Option für die GPS-Unterstützung bei der Videoaufnahme, z.B. continuous. Die Standardeinstellung ist continuous, wenn es unterstützt wird.

Diese Option wurde in API-Level 2.1 hinzugefügt.

 rw
_vendorSpecific [Typ] (optional) Anbieterspezifische zusätzliche Kameraoptionen Stellen Sie anbieterspezifische Strings mit einem Unterstrich ( _) voran.