Optionen

In der folgenden Tabelle sind alle Optionen aufgeführt, die mit camera.setOptions und camera.getOptions festgelegt und abgerufen werden können. 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 Aufnahmemodus. Standardeinstellung: image. rw
captureModeSupport String-Array Liste der aktuell verfügbaren Aufnahmemodi. Die Mindestanforderung für API-Level 1 ist ["image"] und die Mindestanforderung für API-Level 2 ist ["image", "interval"]. Dabei steht "interval" für den Modus zum Aufnehmen einer Reihe von Bildern, die in einem bestimmten Abstand aufgenommen werden. Weitere Informationen findest du unter captureInterval und captureIntervalSupport. Zwei zusätzliche Modi ("video" and "walkaround")werden von API-Ebene 2 unterstützt, sodass der vollständig unterstützte Satz von API-Ebene 2 ["image", "interval", "video", "walkaround"] ist, wobei "video" den Videoaufnahmemodus und "walkaround" den Modus zur Aufnahme von zwei Bildern darstellt, wobei beim ersten Modus die Nutzer irgendwo in Bezug zur Kamera stehen und beim zweiten die Nutzer auf der gegenüberliegenden Seite (relativ zum ersten Standpunkt) der Kamera stehen. So kann die Kamera die Nutzenden aus dem endgültigen Bild entfernen, indem sie die beiden Bilder kombiniert. Wenn "walkaround" von der Kamera unterstützt wird und auf den aktuellen Aufnahmemodus festgelegt ist, sollte der Client damit rechnen, zwei "takePicture"-Befehle an die Kamera zu senden. Die Antwort des ersten Befehls (nach Abschluss des Vorgangs) gibt an, dass die Kamera zur Aufnahme des zweiten Bildes bereit ist und der zweite Befehl das endgültige Bild zurückgeben soll, wenn der Vorgang abgeschlossen ist.

Wenn Sie weitere Erfassungsmodi hinzufügen möchten, die noch nicht unterstützt werden, stellen Sie den anbieterspezifischen Modi einen Unterstrich ( _ ) voran.

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

 r
captureStatus String Aktueller Erfassungsstatus. Standardeinstellung ist "idle". Dies ist hilfreich, um den Status der Kamera zu ermitteln, wenn sie zum ersten Mal mit einer App verbunden wird. Wenn die Kamera gerade ein Video aufzeichnet, muss sie möglicherweise angehalten werden, bevor andere Aktionen ausgeführt werden können, z.B. noch ein Videodreh.

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

 rw
captureStatusSupport String-Array Liste der derzeit verfügbaren Aufnahmestatus Standardmäßig sollte ["idle", "shooting"] lauten, wenn die Videoaufnahme unterstützt wird. Es können auch andere Statuen bereitgestellt werden, z.B. "downloading"

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

 r
exposureProgram Zahl Aktuelles Belichtungsprogramm. rw
exposureProgramSupport Zahlen-Array Liste der aktuell verfügbaren Belichtungsprogramme z. B. [0, 1, 2, 3, 4]. Jede Ganzzahl steht für ein anderes Belichtungsprogramm: <ph type="x-smartling-placeholder">
    </ph>
  • 0 = Nicht definiert
  • 1 = Manuell
  • 2 = Normales Programm
  • 3 = Zeitautomatik
  • 4 = Blendenpriorität
Über den folgenden Link kannst du weitere Details zu ExposureProgram herunterladen. 		r
iso Zahl Aktuelle Einstellung der ISO-Empfindlichkeit. rw
isoSupport Zahlen-Array

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

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

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

 r
shutterSpeed Zahl Aktuelle Einstellung für die Belichtungszeit. rw
shutterSpeedSupport Zahlen-Array

API-Ebene 1:Liste der aktuell verfügbaren Belichtungszeiten z. B. [0.067, 0.033, 0.017,0.008] oder [], wenn es sich im auto-Modus befindet.

API-Ebene 2:Liste der aktuell verfügbaren Belichtungszeiten Beispiel: [0, 0.067, 0.033, 0.017, 0.008], wobei 0 für den Modus auto steht.

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

 r
aperture Zahl Aktuelle Blendeneinstellung, in Blendenstufen. rw
apertureSupport Zahlen-Array

API-Ebene 1:Liste der derzeit verfügbaren Blendeneinstellungen in f/number für Beispiel: [1.4, 2, 2.8, 4, 5.6, 8, 11] oder [], wenn der Modus auto ist.

API-Ebene 2:Liste der derzeit verfügbaren Blendeneinstellungen 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 Weißabgleicheinstellung: z. B. daylight. Die Standardeinstellung ist auto. rw
whiteBalanceSupport String-Array Die Liste der derzeit 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: <ph type="x-smartling-placeholder">
    </ph>
  • 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 anbieterspezifischen Einstellungsnamen einen Unterstrich voran. Beispiel: _vendor-setting		 r
exposureCompensation Zahl Aktuelle Belichtungskorrektur. rw
exposureCompensationSupport Zahlen-Array Liste der aktuell verfügbaren Belichtungskorrekturen, 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 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, könnte eine geeignete Antwort lauten: 
{
    "type": "mp4",
    "width": 1920,
    "height": 1080,
    "framerate": 30
}

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

 rw
fileFormatSupport Objekt-Array

Liste der aktuell verfügbaren Dateiformate Beispiel:

[
    {
    "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
    },
    ...
]
Unter dem folgenden Link finden Sie weitere Informationen zu allen Typen.

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

 r
exposureDelay Zahl Aktuelle Verzögerung zwischen dem Befehl takePicture und dem Start der Belichtung in Sekunden. rw
exposureDelaySupport Zahlen-Array Liste der aktuell verfügbaren Belichtungsverzögerungen in Sekunden Beispiel: [0, 1, 2, 5, 10, 30, 60] r
sleepDelay Zahl Aktuelle Verzögerung, bevor die Kamera in den Ruhemodus wechselt, in Sekunden. rw
sleepDelaySupport Zahlen-Array Liste der aktuell verfügbaren Schlafverzögerungen in Sekunden Beispiel: [30, 60, 120, 300, 600, 1800, 65535], wobei 65535 den Schlafmodus deaktiviert (die Kamera erst in den Ruhemodus wechselt, wenn sie ausgeschaltet wird) und unterstützt werden muss. r
offDelay Zahl Aktuelle Verzögerung in Sekunden, bevor die Kamera ausgeschaltet wird. rw
offDelaySupport Zahlen-Array Liste der aktuell verfügbaren Verzögerungen beim Ausschalten in Sekunden Beispiel: [1800, 3600, 7200, 65535], bei dem 65535 den Ausschalten-Modus deaktiviert (die Kamera schaltet sich erst aus, wenn der Akku leer ist oder manuell ausgeschaltet wird) und muss unterstützt werden. r
totalSpace Zahl Schreibgeschützt: Anzahl der Byte des Gesamtspeichers. r
remainingSpace Zahl Schreibgeschützt: Anzahl der Bytes des kostenlosen Speichers. r
remainingPictures Zahl Schreibgeschützt: geschätzte Anzahl der verbleibenden Bilder basierend auf der aktuellen Aufnahme Einstellung. r
gpsInfo Object

Aktuelle GPS-Informationen. Festgelegt über setOptions über das GPS des Smartphones:

{
    "lat": 23.532,
    "lng": -132.35
}
Die Eigenschaften lat und lng sind Dezimalgrad, wobei lat im Bereich, [-90, 90] und lng im Bereich [-180, 180] ist. Bei der Bereitstellung per Telefon ist zu beachten, dass jeder GPS-Standort nur gültig ist. bis zum nächsten Update auf deinem Smartphone. Das Smartphone muss feststellen, wann ein Update durchgeführt werden soll. den GPS-Standort, zum Beispiel direkt vor jedem takePicture-Befehl. 65535 benachrichtigt die Kamera, dass der aktuelle GPS-Standort ungültig ist, und die Kamera sollte es ignorieren und sein eigenes GPS verwenden, falls vorhanden; zum Beispiel setOptions({"gpsInfo": {"lat": 65535, "lng": 65535}}) bedeutet, dass der GPS-Standort ungültig.		 rw
dateTimeZone String Aktuelle Informationen zu Datum und Uhrzeit. Wird von setOptions anhand des Datums, der Uhrzeit und der 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 sind durch ein Leerzeichen voneinander getrennt, und die Zeitzone ist eine Zeitverschiebung zur koordinierten Weltzeit (UTC). Beispiel: 2014:05:18 01:04:29+8:00 ist 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 es zu deaktivieren. Der Standardwert ist false. Die Einstellung kann nur auf true festgelegt werden, wenn hdrSupport auch true ist.

API-Ebene 2:Aktueller HDR-Modus vom Typ „String“.

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 bedeutet, dass die Kamera HDR unterstützt. Mit der Einstellung „false“ wird eine Kamera ohne HDR identifiziert.

API-Level 2:Wenn Sie den HDR-Modus nicht unterstützen, ist es [“off”]; Wenn du einen HDR-Modus unterstützt, ist dieser [“off”, “hdr”], wenn mehrere HDR-Modi (basierend auf unterschiedlichen Algorithmen) unterstützt werden, ist dieser [“off”, “hdr”, “hdr1”, “hdr2”, ...]

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

 r
exposureBracket Object Aktuelle Einstellung für die Belichtungsreihe. Nur verfügbar, wenn hdrSupport == true (API-Level 1) oder hdrSupport mindestens einen HDR-Modus (API-Level 2) enthält. Wenn für die Kamera eine Belichtungsreihe mit manueller Belichtung verwendet wird, enthält das Objekt zwei Einträge: <ph type="x-smartling-placeholder">
    </ph>
  1. shots: Eine Ganzzahl, die die Anzahl der aufzunehmenden Aufnahmen enthält.
  2. increment: eine Zahl, die ein lW-Intervall zwischen den Aufnahmen enthält.
Beispiel: 
{
    "shots": 3,
    "increment": 1.33
}
Wenn die Kamera die automatische Belichtungsreihe verwendet, enthält das Objekt: 
{
    "autoMode": true
}

API-Ebene 1: Bei hdrSupport == false ist die Standardeinstellung leer {}. Hersteller legen Standardwerte fest (z. B. für Belichtungsreihenautomatik), wenn für hdr der Wert true gilt.

API-Ebene 2: Die Standardeinstellung ist leer {}, wenn hdrSupport nur "off" enthält. Andernfalls legen die Hersteller Standardwerte fest (z. B. Belichtungsreihenautomatik).

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

 rw
exposureBracketSupport Object

Derzeit verfügbare Einstellungen für die Belichtungsreihe: Beispiel:

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

API-Ebene 1: Wenn hdrSupport == false standardmäßig leer ist, ist {} leer. Wenn hdrSupport == true, die Belichtungsreihenautomatik jedoch nicht unterstützt wird, ist für autoMode der Wert false.

API-Ebene 2: Die Standardeinstellung ist leer {}, wenn hdrSupport nur "off" enthält. Wenn „hdrSupport“ einen HDR-Modus enthält, die Belichtungsreihenautomatik aber nicht unterstützt wird, dann ist „autoMode“ auf „false“ gesetzt.

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. Die Standardeinstellung ist true, wenn dies von der Kamera unterstützt wird, andernfalls false. Diese Einstellung kann nur auf „true“ festgelegt werden, wenn gyroSupport == true. rw
gyroSupport Boolesch Wenn die Kamera ein Gyroskop hat, sollte dieser Wert true sein, andernfalls false. r
gps Boolesch Aktiviert/deaktiviert das GPS-Modul der Kamera. Der Wert muss true zum Aktivieren oder false zum Deaktivieren sein. Der Standardwert ist true, wenn die Kamera dies unterstützt, ansonsten false. Die Einstellung ist nur bei gpsSupport == true auf true festgelegt. 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 für die Bildstabilisierung verfügbar. Die vordefinierte Liste lautet ["off", "on"]. Wenn die Kamera die Bildstabilisierung nicht unterstützt, gib ["off"] zurück. Andernfalls wird ["off", "on"] zurückgegeben. Stellen Sie anbieterspezifischen Strings einen Unterstrich ( _ ) voran. z. B. [ "off", "_horizontal_stabilization", "_vibration_correction" ]. r
wifiPassword String
Er muss mindestens 8 Zeichen lang sein und Buchstaben, Ziffern und Symbole enthalten, aber keine Leerzeichen. Sie kann nur geändert werden, wenn die Kamera mit einem Clientgerät verbunden ist. Danach muss die Kamera vom Gerät getrennt werden und der Nutzer muss sich dann über das neue Gerät (wifiPassword) neu verbinden.
Die Kamera muss über einen Mechanismus zum Zurücksetzen verfügen, falls das Passwort vergessen wird. z. B. 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-Ebene 2 hinzugefügt.

 rw
previewFormatSupport Objekt-Array

Derzeit unterstützte Formate für die Livevorschau: Beispiel:

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

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

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

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

 rw
captureIntervalSupport Object

Minimale und maximale Intervalle in Sekunden zwischen der Aufnahme von zwei aufeinanderfolgenden Bildern Beispiel:

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

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

 r
captureNumber Zahl Anzahl der Bilder, die für eine Intervallerfassungssitzung aufgenommen werden sollen. Die Standardeinstellung ist 0. Dies bedeutet, dass die Erfassung explizit mit dem Befehl stopCapture beendet werden muss. Andernfalls wird die Erfassung automatisch beendet, nachdem Bilder der angegebenen Anzahl aufgenommen wurden. Die Aufnahme kann auch unterbrochen werden, wenn der Akku der Kamera leer ist oder sie absichtlich ausgeschaltet wurde.

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

 rw
captureNumberSupport Object

Mindest- und Höchstzahl von Bildern, die während einer Intervallerfassung aufgenommen werden können Beispiel:

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

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

 r
remainingVideoSeconds Zahl Geschätzte Anzahl von seconds für das verbleibende Video basierend auf den aktuellen Aufnahmeeinstellungen.

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

 r
pollingDelay Zahl Mindestintervall in Sekunden zwischen zwei aufeinanderfolgenden Statusabfrageanfragen. Kunden sollten dieses Feld als Leitfaden für ihr Statusabfrageverhalten verwenden. Beispielsweise kann es sein, dass Kunden beim Zusammenfügen von Bildern regelmäßig die Kamera abfragen müssen, um zu sehen, ob sie fertig zusammengefügt wurde. Verschiedene Kameras unterstützen unterschiedliche Funktionen: Beispielsweise können einige Kameras Statusabfragen im Sekundentakt ausführen, während andere längere Intervalle unterstützen.

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

 r
delayProcessing Boolesch True, wenn die Verarbeitung (z.B. Zusammenfügen) eine niedrigere Priorität hat als die Aufnahme, oder mit anderen Worten, eine weitere Aufnahme ist zulässig, bevor die Verarbeitung des zuvor aufgenommenen Bildes abgeschlossen ist. Dies wird dringend empfohlen, insbesondere bei Kameras, die eine lange Verarbeitungszeit benötigen.

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

 rw
delayProcessingSupport Boolesches Array

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

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

[true, false] bedeutet, dass Sie zwischen diesen beiden Modi wählen können.

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

 r
clientVersion Zahl

Die API-Ebene, die der Client verwendet. Der Standardwert ist 1, wenn Kamera unterstützt API Level 1 und 2, sodass Clients für API-Level 1 funktioniert weiterhin mit der Kamera, ohne dass Änderungen erforderlich sind. Standard auf 2 gesetzt, wenn die Kamera nur API-Level 2 unterstützt. empfohlen, bevor Kunden zu API-Level 2 migrieren. Wenn die Kamera unterstützt nur API Level 2, sollte die Anfrage, mit der es auf 1 gesetzt werden soll, scheitern. Wenn clientVersion erfolgreich auf 2 gesetzt wurde und ein eingestellten Befehl von API-Ebene 1 angefordert wird, sollte mit dem Fehlercode unknownCommand fehlschlagen.

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

 rw
photoStitchingSupport String-Array

Liste der Stitching-Optionen für Fotos. Zurückgeben [ondevice], wenn die Fotos immer mit der Kamera zusammengefügt werden, [none], wenn die Kamera keine Fotos zusammenfügen kann, und [none,ondevice], wenn das Stitching vom Nutzer konfiguriert werden kann. Stellen Sie anbieterspezifischen Einstellungsnamen einen Unterstrich voran, z.B. _vendor-setting

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

 r
photoStitching String

Aktuelle Stitching-Option für Fotos, z.B. ondevice Ist dies der Fall, ist ondevice die Standardeinstellung. unterstützt.

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

 rw
videoStitchingSupport String-Array

Liste der Stitching-Optionen für Videos. Zurückgeben [ondevice], wenn Videos immer mit der Kamera zusammengefügt werden, [none], wenn die Kamera keine Videos zusammenfügen kann [none,ondevice], wenn das Stitching vom Nutzer konfiguriert werden kann. Stellen Sie anbieterspezifischen Einstellungsnamen einen Unterstrich voran, z.B. _vendor-setting

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

 r
videoStitching String

Aktuelle Stitching-Option für Videos, z.B. ondevice Ist dies der Fall, ist ondevice die Standardeinstellung. unterstützt.

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

 rw
videoGPSSupport String-Array

Liste der GPS-Optionen während der Videoaufnahme. Zurückgeben [continuous], wenn die Kamera kontinuierlich GPS aufnehmen kann während der Videoaufnahme und betten Sie die Orte in das Video ein. Zurückgeben [none], wenn dies nicht möglich ist, und [none,continuous] Die GPS-Unterstützung für Videos kann vom Nutzer konfiguriert werden. Anbieterspezifisches Präfix Namen mit einem Unterstrich festlegen, z.B. _vendor-setting

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

 r
videoGPS String

Aktuelle Option für GPS-Unterstützung bei Videoaufnahmen, z.B. continuous Ist dies der Fall, ist continuous die Standardeinstellung. unterstützt.

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

 rw
_vendorSpecific [Typ] (optional) Anbieterspezifische zusätzliche Kameraoptionen. Stellen Sie anbieterspezifischen Strings das Präfix einen Unterstrich ( _ ).