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."
}
} |
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2024-08-21 UTC.
[null,null,["Ostatnia aktualizacja: 2024-08-21 UTC."],[[["Returns a full-size or scaled image based on its URI, with optional resizing using the `maxSize` parameter."],["This command is deprecated and was replaced in API level 2, primarily used for retrieving image data in JPEG format."],["Input requires a `fileUri` parameter, while `maxSize` is optional for scaling the output image."],["Output provides the image as binary data, including relevant metadata, or an error message in JSON format."],["Potential errors involve missing or invalid parameters, such as an incorrect `fileUri` or `maxSize` value."]]],["The command retrieves an image (full-size or scaled) via its URI, with `fileUri` being mandatory and `maxSize` (maximum dimension) being optional. If `maxSize` is omitted or exceeds the image's full size, the full-size image is provided. Output is image binary data, with `Content-Type: image/jpeg`. Errors include missing/invalid parameter or invalid value. It was deprecated in API level 2. Example input involves `fileUri` and `maxSize`. Example error is related to an invalid `fileUri`.\n"]]
