设置指定属性的值;例如,GPS 开启/关闭、日期和时间、ISO、白平衡、快门速度、休眠/关机延迟等。此命令在 API 级别 2 中进行了修改。
参数
- sessionId::字符串类型的唯一会话标识符,可通过
camera.startSession
命令获取。此字段在 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." } } |