aparat.Zrób zdjęcie

To zdjęcie walcowe równoodległościowe z zapisywaniem współrzędnych szerokości i długości geograficznej w danych EXIF (jeśli aparat ma własny GPS lub GPS jest włączony na połączonych telefonach komórkowych). W razie potrzeby wywołaj camera.setOptions przed wywołaniem tego polecenia. To polecenie zostało zmodyfikowane na poziomie API 2.

Parametry

  • sessionId: unikalny identyfikator sesji uzyskany za pomocą polecenia camera.startSession . To pole zostało wycofane w interfejsie API poziomu 2.

Wyniki

  • Poziom API 1
    • fileUri: identyfikator URI przechwyconego obrazu. Producenci decydują, czy stosować bezwzględne czy względne identyfikatory URI. Na przykład „http://android.com/robots.txt” to bezwzględny identyfikator URI, a „robots.txt” to względny identyfikator URI. Klienci mogą traktować ten identyfikator jako nieprzejrzysty identyfikator.
  • Poziom API 2
    • fileUrl: bezwzględny URL przechwyconego obrazu. Można go pobrać bezpośrednio z serwera HTTP kamery. Pamiętaj, że to polecenie nie zwraca wartości fileUrl natychmiast, ponieważ wykonywanie zdjęcia (w tym łączenie w aparacie) zwykle zajmuje sporo czasu (może się różnić z sekund do minut). Postęp wykonywania polecenia uzyskuje się przez okresowe sprawdzanie kamery przy użyciu interfejsu API /osc/commands/status. Wynik fileUrl jest zwracany po zakończeniu polecenia. Jeśli właściwość delayProcessing ma wartość true (prawda), jest to bezwzględny URL obrazu podglądu, którego można używać w ProcesObrazie jako danych wejściowych do przetworzenia obrazu. W przeciwnym razie jest to bezwzględny URL ostatecznego przetworzonego obrazu.

Błędy

  • missingParameter: brak parametru sessionId. Ten kod błędu został wycofany w interfejsie API poziomu 2.
  • NieprawidłowyParametrName: nazwa parametru jest nierozpoznana, np. sessionId nie jest rozpoznawana na poziomie 2 interfejsu API.
  • ErrorParameterValue: zostaje rozpoznana nazwa parametru wejściowego, ale jego wartość jest nieprawidłowa, np. 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 filmu. Ten kod błędu został dodany w interfejsie API poziomu 2.

Command I/O
Dane wejściowe (poziom interfejsu API 1) 
{
    "parameters": {
        "sessionId": "12ABC3"
    }
}
Dane wyjściowe polecenia (poziom 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 (poziom interfejsu API 2) 
none
Dane wyjściowe polecenia (poziom 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."
    }
}