aparat.przetwórzObraz.

Przetwarzanie zdjęć, które zostały zrobione wcześniej, ale jeszcze nie zostały przetworzone. To polecenie ma zastosowanie tylko wtedy, gdy obsługujesz delayProcessing od cały proces trwa długo. Jeśli nie obsługujesz delayProcessing, jego żądanie powinno zakończyć się niepowodzeniem z wyłączonym kodem błędu. To polecenie zostało dodane na poziomie interfejsu API 2.

Parametry

  • previewFileUrls: lista adresów URL nieprzetworzonych obrazów. Jeśli chcesz przetwarzać wszystkie nieprzetworzone zdjęcia z aparatu, wybierz opcję ["all"]. Pole nie może być puste. Jeśli aparat ma problem z przetworzeniem obrazu, nie zwraca błędu, powinien jednak zignorować ten adres URL i wykonać ciąg innych, a w skrajnym przypadku previewToFinalFileUrls to zwracany jako pusty obiekt JSONObject.

Wyniki

  • previewToFinalFileUrls: obiekt JSONObject JSON <key, value=""> gdzie każdy klucz to bezwzględny URL obrazu podglądu, a każdy klucz to odpowiedni końcowy przetworzony obraz, który może zostać użyty do pobrania prosto z kamery. To polecenie jest podobne do Camera.takePicture i nie zwraca previewToFinalFileUrls (z wyjątkiem przypadku w rogu wyjaśnionego w dalszej części tego akapitu), ponieważ Przetwarzanie (w tym zszywanie w aparacie) zwykle zajmuje trochę czasu (różne od sekund do minut). Uzyskano postęp wykonywania polecenia od czasu do czasu odpytując kamerę przy użyciu interfejsu API /osc/commands/status; previewToFinalFileUrls to wynik zwrócony, gdy polecenie na ich końcu. Jeśli połączenie z kamerą zostanie utracone przed zakończeniem polecenia, klient może używać usługi listFiles aby uzyskać adresy URL ostatecznej wersji zdjęć po ponownym podłączeniu aparatu. inne polecenie productPicture, które powinno zwrócić previewToFinalFileUrls natychmiast, jeśli obrazy przed ponownym połączeniem.</key,>

Błędy

  • excludedCommand: jeśli nie obsługujesz opóźnionego przetwarzania.
  • invalidParametrName:nazwa parametru wejściowego to Nie rozpoznano.
  • invalidParameterValue::nazwa parametru wejściowego to rozpoznano, ale jego wartość jest nieprawidłowa; na przykład każdy URL w Wartość previewFileUrls jest nieprawidłowa.

Polecenie I/O
Dane wejściowe polecenia 
{
    "parameters": {
        "previewFileUrls": [
            "previewFileUrl1",
            "previewFileUrl2",
            "previewFileUrl3",
            ...
            "previewFileUrln"
        ]
    }
}
Dane wyjściowe polecenia 
{
    "results": {
        "previewToFinalFileUrls":{
            "previewFileUrl1": "finalFileUrl1",
            "previewFileUrl2": "finalFileUrl2",
            "previewFileUrl3": "finalFileUrl3",
            ...
            "previewFileUrln": "finalFileUrln"
        }
    }
}
Dane wyjściowe polecenia (błąd) 
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}