camera.getOptions

返回所请求属性的当前设置。此命令已在 API 级别 2 中修改。

参数

  • sessionId:：获取的字符串类型的唯一标识符 使用 camera.startSession 命令。 此字段在 API 级别 2 中已废弃。
  • optionNames：要返回的属性名称的字符串数组。

结果

  • options：所请求属性的 JSON <key, value> 对。 该值可以是以下任何类型：String、String Array、Number、 Number Array、Boolean、Object、Object Array。请参阅 选项。

错误

  • missingParameter：一个或多个必需参数缺失； 例如，未指定 optionNames。
  • invalid 参数 Name：一个或多个输入参数名称或选项 名称无法识别或不受支持，例如则应该返回此代码， 当 clientVersion 时使用 API 级别 2 中的选项（例如 captureInterval） 为 1。Options
  • invalidParameterValue:：可以识别输入参数名称，但 一个或多个值无效；例如，sessionId 不存在， 处于无效状态，或其数据类型不正确。此错误代码已弃用 API 级别 2，因为当任何选项名称无效时，invalidParameterName 。

命令 I/O
命令输入（API 级别 1） 
{
  "parameters": {
      "sessionId": "12ABC3",
      "optionNames": [
          "iso",
          "isoSupport"
      ]
  }
}
命令输出（API 级别 1） 
{
  "results": {
      "options": {
           "iso": 200,
           "isoSupport": [100, 200, 400, 800, 1600]
      }
  }
}
命令输出（错误）（API 级别 1） 
{
  "error": {
      "code": "invalidParameterName",
      "message": "Parameter optionNames contains unrecognized option XYZ."
   }
}
命令输入（API 级别 2） 
{
  "parameters": {
      "optionNames": [
          "iso",
          "isoSupport"
      ]
  }
}
命令输出（API 级别 2） 
{
  "results": {
      "options": {
           "iso": 200,
           "isoSupport": [100, 200, 400, 800, 1600]
      }
  }
}
命令输出（错误）（API 级别 2） 
{
  "error": {
      "code": "invalidParameterName",
      "message": "Parameter optionNames contains unrecognized option XYZ."
   }
}