camera.setOptions

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

參數

  • sessionId:使用 camera.startSession 指令取得類型字串的不重複工作階段 ID。這個欄位已在 API 級別 2 中淘汰。
  • options:設定屬性的 JSON <key, value> 組合。這個值可以是以下任何類型:StringString ArrayNumberNumber ArrayBooleanObjectObject 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."
    }
}