camera.setOptions

设置指定属性的值;例如,GPS 开启/关闭、日期和时间 ISO、白平衡、快门速度、休眠/关机延迟等。此命令已在 API 级别 2 中修改。

参数

  • sessionId::字符串类型的唯一会话标识符,获取 使用 camera.startSession 命令。 此字段在 API 级别 2 中已废弃。
  • options:要设置的属性的 JSON <key, value> 对。通过 值可以是以下任意类型:StringString ArrayNumberNumber ArrayBooleanObjectObject Array。请参阅 选项

结果

  • 此命令未返回任何结果。

错误

  • missingParameter:一个或多个必需参数缺失;用于 例如,未指定 options
  • invalidParameterName:一个或多个输入参数选项 名称无法识别或不受支持,例如则应该返回此代码, 当 clientVersion 时使用 API 级别 2 中的选项(例如 captureInterval) 为 1。Options
  • 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."
    }
}