camera.setOptions

设置指定属性的值；例如，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."
    }
}