camera.setOptions

設定指定屬性的值；例如：開啟/關閉 GPS、日期和時間 ISO、白平衡、快門速度、睡眠/關機延遲時間等。這個指令是在 API 級別 2 中修改。

參數

  • sessionId:類型字串的不重複工作階段 ID，取得 呼叫 camera.startSession 指令 這個欄位已在 API 級別 2 中淘汰。
  • options：要設定的屬性 JSON <key, value> 組合。 值可以是下列任一類型：String、String Array、Number、 Number Array、Boolean、Object、Object Array。詳情請見 選項。

結果

  • 這個指令未傳回任何結果。

錯誤

  • missingParameter：缺少一或多個必要參數；的 範例，並未指定 options。
  • INVALIDParameterName：一或多個輸入參數選項或選項 無法辨識或不支援的名稱，例如如果 當 clientVersion 時，系統會使用 API 級別 2 的選項 (例如 captureInterval) Options 為 1
  • invalidParameterValue:：一或多個輸入參數或選項名稱 ，但其值無效；例如資料類型不正確

指令 I/O
指令輸入 (API 級別 1) 
{
    "parameters": {
        "sessionId": "12ABC3",
        "options": {
            "isoBalance": 200
        }
    }
}
指令輸出 (API 級別 1) 
none
指令輸出 (錯誤) (API 級別 1) 
{
    "error": {
        "code": "invalidParameterName",
        "message": "Parameter options contains unsupported option isoBalance."
    }
}
指令輸入 (API 級別 2) 
{
    "parameters": {
        "options": {
            "iso": 200,
            "captureInterval": 20
        }
    }
}
指令輸出 (API 級別 2) 
none
指令輸出 (錯誤) (API 級別 2) 
{
    "error": {
        "code": "invalidParameterName",
        "message": "Parameter options contains unsupported option captureInterval."
    }
}