Bilder verarbeiten, die bereits aufgenommen, aber noch nicht verarbeitet wurden
Dieser Befehl ist nur relevant, wenn Sie delayProcessing
unterstützen, da die Verarbeitung lange dauert. Wenn Sie delayProcessing
nicht unterstützen, sollte die Anfrage für diesen Befehl mit dem Fehlercode „disabledCommand“ fehlschlagen.
Dieser Befehl wurde in API-Level 2 hinzugefügt.
Parameter
- previewFileUrls:Eine Liste der URLs nicht verarbeiteter Bilder.
Wenn Sie alle nicht verarbeiteten Bilder in der Kamera verarbeiten möchten, ist dies [„all“].
Das Feld darf nicht leer sein. Wenn die Kamera Probleme bei der Verarbeitung eines Bilds hat, gibt sie keinen Fehler aus. Stattdessen sollte sie diese URL ignorieren und mit anderen fortfahren. Im Extremfall kann
previewToFinalFileUrls
als leeres JSONObject zurückgegeben werden.
Ergebnisse
- previewToFinalFileUrls:Ein JSONObject mit JSON-Paaren vom Typ <key, value="">, wobei jeder Schlüssel die absolute URL des Vorschaubilds ist und jeder Schlüssel das entsprechende endgültig verarbeitete Bild ist und zum direkten Download von der Kamera verwendet werden kann. Dieser Befehl ähnelt dem Befehl „camera.takePicture“ und gibt
previewToFinalFileUrls
nicht sofort zurück (mit Ausnahme eines Eckfalls, der weiter unten in diesem Abschnitt erläutert wird). Die Verarbeitung (einschließlich Stitching in der Kamera) dauert normalerweise eine Weile (variiert von Sekunden bis Minuten). Der Fortschritt des Befehls wird ermittelt, indem die Kamera regelmäßig über die /osc/commands/status API abgefragt wird.previewToFinalFileUrls
ist das Ergebnis, das bei Abschluss des Befehls zurückgegeben wird. Wenn die Verbindung zur Kamera unterbrochen wird, bevor der Befehl beendet ist, kann der Client mitlistFiles
die URLs der endgültigen Bilder abrufen, wenn die Kamera wieder verbunden ist, oder einen anderen „processPicture“-Befehl ausgeben, der sofortpreviewToFinalFileUrls
zurückgeben sollte, wenn die Bilder bereits vor dem erneuten Verbinden verarbeitet wurden.</key,>
Fehler
- disabledCommand:Wenn Sie keine Verzögerungsverarbeitung unterstützen.
- invalidParameterName: Der Name des Eingabeparameters wird nicht erkannt.
- invalidParameterValue:Der Name des Eingabeparameters wird erkannt, aber sein Wert ist ungültig. Beispielsweise ist jede URL in
previewFileUrls
ungültig.
Befehls-E/A | |
---|---|
Befehlseingabe | { "parameters": { "previewFileUrls": [ "previewFileUrl1", "previewFileUrl2", "previewFileUrl3", ... "previewFileUrln" ] } } |
Befehlsausgabe | { "results": { "previewToFinalFileUrls":{ "previewFileUrl1": "finalFileUrl1", "previewFileUrl2": "finalFileUrl2", "previewFileUrl3": "finalFileUrl3", ... "previewFileUrln": "finalFileUrln" } } } |
Befehlsausgabe (Fehler) | { "error": { "code": "disabledCommand", "message": "Command is currently disabled." } } |