camera.getImage

根據 URI 傳回完整大小或縮放圖片。輸入參數包含解析度。這是唯一應傳回 Content-Type: image/jpeg 的指令。所有其他指令都會傳回 Content-Type: application/json;charset=utf-8這個指令已在 API 級別 2 中淘汰。

參數

  • fileUri:目標檔案的 URI。製造商會決定要使用絕對還是相對 URI。用戶端可能會將這個 ID 視為不透明 ID。
  • 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."
    }
}