設定指定屬性的值,例如 GPS 開啟/關閉、日期和時間、ISO、白平衡、快門速度、睡眠/關機延遲時間等。這個指令已在 API 級別 2 中修改。
參數
- sessionId:使用
camera.startSession
指令取得類型字串的不重複工作階段 ID。這個欄位已在 API 級別 2 中淘汰。 - options:設定屬性的 JSON
<key, value>
組合。這個值可以是以下任何類型:String
、String Array
、Number
、Number Array
、Boolean
、Object
、Object Array
。請參閱選項。
成果
- 這個指令不會傳回任何結果。
錯誤
- missingParameter:缺少一或多個必要參數;例如,未指定
options
。 - invalidParameterName:一或多個輸入參數選項/選項名稱無法辨識或不受支援。舉例來說,如果在
Options
中的clientVersion
為 1 時使用 API 級別 2 的選項 (例如captureInterval
),就應傳回此代碼。 - 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." } } |