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."
    }
}