camera.getImage

URI を指定して、フルサイズ画像または拡大縮小された画像を返します。入力パラメータに解像度が含まれています。これは、Content-Type: image/jpeg を返す唯一のコマンドです。他のすべてのコマンドは Content-Type: application/json;charset=utf-8 を返します。このコマンドは API レベル 2 で非推奨になりました。

パラメータ

  • fileUri: ターゲット ファイルの URI。絶対 URI と相対 URI のどちらを使用するかはメーカーが決定します。クライアントはこれを不透明な識別子として扱うことができます。
  • maxSize: (省略可)リクエストされた画像の最大サイズ。max(scaledimage_width, scaledimage_height)。maxSize を省略するか、フルサイズの画像より大きい場合は、フルサイズの画像が返されます。

結果

  • content: 画像ヘッダー内の対応する(スケーリングされた)メタデータを含む画像バイナリデータ。

エラー

  • missingParameter: 必須の fileUri が指定されていません。
  • invalidParameterName: 入力パラメータ名を認識できません。
  • invalidParameterValue: 入力パラメータ名が認識されていますが、その値が無効です。たとえば、fileUri 値が存在しない、データ型が正しくない、maxSize のデータ型が正しくないなどです。

コマンド I/O

コマンド入力
{
    "parameters": {
        "fileUri": "file URI",
        "maxSize": 400
    }
}
コマンド出力
Image binary data
コマンド出力(エラー)
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter fileUri doesn't exist."
    }
}