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. WynikfileUrl
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.
- 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
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." } } |