aparat.getImage

Zwraca pełny rozmiar lub przeskalowany obraz na podstawie jego identyfikatora URI. Parametry wejściowe obejmują i ich rozwiązania. Jest to jedyne polecenie, które powinno zwrócić błąd: Content-Type: image/jpeg. Pozostałe polecenia zwracają 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ą, bezwzględnych ani względnych identyfikatorów URI. Klienci mogą traktować go jako nieprzezroczysty identyfikator.
  • maxSize: (opcjonalny) maksymalny rozmiar żądanego obrazu. max(scaledimage_width, skalowana_wysokość_obrazu). Jeśli wartość maxSize jest pominięta lub większa niż obraz w pełnym rozmiarze, zwracany jest obraz w pełnym rozmiarze.

Wyniki

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

Błędy

  • missingParameters:nie określono wymaganego parametru fileUri.
  • invalidParametrName:nie udało się rozpoznać nazwy parametru wejściowego.
  • invalidParameterValue::nazwa parametru wejściowego została rozpoznana, ale jego wartość jest nieprawidłowy; np. wartość fileUri nie istnieje, jej typ danych jest nieprawidłowy, lub maxSize ma nieprawidłowy typ danych.

Polecenie I/O
Dane wejściowe polecenia 
{
    "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."
    }
}