aparat.getImage

Zwraca obraz w pełnym rozmiarze lub przeskalowany z określonym identyfikatorem URI. Parametry wejściowe obejmują rozwiązanie problemu. To jedyne polecenie, które powinno zwrócić błąd, Content-Type: image/jpeg. Wszystkie inne polecenia zwracają wartość Content-Type: application/json;charset=utf-8. To polecenie zostało wycofane w interfejsie API poziomu 2.

Parametry

  • fileUri: identyfikator URI pliku docelowego. Producenci decydują, czy używać bezwzględnych czy względnych identyfikatorów URI. Klienci mogą traktować ten identyfikator jako nieprzejrzysty identyfikator.
  • maxSize: (opcjonalny) maksymalny rozmiar żądanego obrazu; max(scaledimage_width, scaledimage_height). Jeśli obraz maxSize zostanie pominięty lub większy niż obraz w pełnym rozmiarze, zostanie zwrócony obraz w pełnym rozmiarze.

Wyniki

  • content: dane binarne obrazu, w tym odpowiadające im (np. skalowane) metadane w nagłówku obrazu.

Błędy

  • missingParameter: nie podano wymaganego parametru fileUri.
  • NieprawidłowyParametrName: nazwa parametru wejściowego nie jest rozpoznawana.
  • ErrorParameterValue: rozpoznawana jest nazwa parametru wejściowego, ale jego wartość jest nieprawidłowa, np. wartość fileUri nie istnieje, ma nieprawidłowy typ danych lub parametr maxSize ma nieprawidłowy typ danych.

Command I/O
Polecenie 
{
    "parameters": {
        "fileUri": "file URI",
        "maxSize": 400
    }
}
Dane wyjściowe polecenia 
Image binary data
Dane wyjściowe polecenia (błąd) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter fileUri doesn't exist."
    }
}