aparat.Zrób zdjęcie

Rejestruje obraz walcowy równoodległościowy i zapisuje współrzędne szerokości i długości geograficznej na EXIF (jeśli aparat ma własny GPS lub jest włączony po podłączeniu telefonów komórkowych). Zadzwoń pod numer camera.setOptions przed tym wywołaniem polecenia. To polecenie zostało zmienione na poziomie interfejsu API 2.

Parametry

  • sessionId: unikalny identyfikator sesji uzyskany z camera.startSession . To pole zostało wycofane na poziomie interfejsu API 2.

Wyniki

  • Poziom API 1
    • fileUri: identyfikator URI przechwyconego obrazu. Producenci decydują o użyciu bezwzględnych czy względnych identyfikatorów URI; np. "http://android.com/robots.txt" jest bezwzględny identyfikator URI, a „robots.txt” jest względnym identyfikatorem URI. Klienci mogą leczyć jako nieprzezroczysty identyfikator.
  • Poziom 2 interfejsu API
    • fileUrl: bezwzględny adres URL przechwyconego obrazu, którego może służy do pobierania danych bezpośrednio z serwera HTTP kamery. Proszę pamiętaj, że to polecenie nie zwraca kodu fileUrl od razu, ponieważ (w tym zszywanie w aparacie) zwykle zajmuje trochę czasu (różni się sekund do minut). Postęp polecenia jest określany jako okresowo odpytywać kamerę przy użyciu interfejsu API /osc/commands/status; fileUrl to wynik zwracany po zakończeniu wykonywania polecenia. Kiedy delayProcessing to wartość prawda, to bezwzględny URL podglądu. który może zostać użyty jako dane wejściowe w procesie przetwarzania obrazu W przeciwnym razie jest to bezwzględny URL przetworzonego obrazu.

Błędy

  • brak parametru: brakuje parametru sessionId. Ten kod błędu został wycofany w interfejsie API poziomu 2.
  • invalidparameterName:nazwa parametru nie została rozpoznana, np. Identyfikator sessionId nie jest rozpoznawany na poziomie API 2.
  • invalidParameterValue::nazwa parametru wejściowego została rozpoznana, , ale jego wartość jest nieprawidłowa; na przykład sessionId nie istnieje, nie jest już aktywny lub jego typ danych jest nieprawidłowy. Ten kod błędu został wycofany w interfejsie API poziomu 2.
  • disableCommand: polecenie jest obecnie wyłączone. np. Kamera jest w trybie nagrywania filmów. Ten kod błędu został dodany na poziomie 2 interfejsu API.

Polecenie I/O
Dane wejściowe polecenia (poziom interfejsu API 1) 
{
    "parameters": {
        "sessionId": "12ABC3"
    }
}
Dane wyjściowe polecenia (poziom interfejsu API 1) 
{
    "results": {
        "fileUri": "file URI"
    }
}
Dane wyjściowe polecenia (błąd) (poziom interfejsu API 1) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter sessionId doesn't exist."
    }
}
Dane wejściowe polecenia (poziom interfejsu API 2) 
none
Dane wyjściowe polecenia (poziom interfejsu API 2) 
{
    "results": {
        "fileUrl": "Absolute file URL"
    }
}
Dane wyjściowe polecenia (błąd) (poziom interfejsu API 2) 
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}