选项

下表显示了可在 camera.setOptions 和 camera.getOptions 之前设置和获取的所有选项。当选项对应的支持内容为空或仅包含一个选项时，该选项无法更改。

名称 类型 说明 读写
captureMode 字符串 当前拍摄模式。默认为 image. rw
captureModeSupport 字符串数组 目前可用的拍摄模式列表。API 级别 1 的最低要求为 ["image"]，API 级别 2 的最低要求为 ["image", "interval"]，其中 "interval" 表示以特定间隔拍摄一系列图像的模式，另请参阅 captureInterval 和 captureIntervalSupport。API 级别 2 支持另外两种模式 ("video" and "walkaround")，因此 API 级别 2 支持的完整模式为 ["image", "interval", "video", "walkaround"]，其中 "video" 表示视频拍摄模式，"walkaround" 表示按顺序拍摄两张图片的模式，第一种是用户站在相对于相机的任何位置，第二种则用户站在相机的对面（相对于第一个立点）。这样，相机就可以合并两张图片，从最终图片中移除用户。当相机支持 "walkaround" 并设置为当前拍摄模式时，客户端应该会向相机发送两个 takePicture 命令，其中第一个命令的响应（完成后）表示相机已准备好拍摄第二张图片，而第二个命令应在完成后返回最终图片。

要添加更多尚不支持的捕获模式，请在供应商特定模式前面加上下划线 ( _ ) 作为前缀。

此选项在 API 级别 2 中进行了修改。

 r
captureStatus 字符串 当前拍摄状态。默认值为 "idle"。这有助于确定摄像头首次连接到应用时的状态。如果相机在拍摄视频的过程中，可能需要先停止相机，然后才能执行执行其他操作，例如另一个视频拍摄过程

此选项是在 API 级别 2.1 中添加的。

 rw
captureStatusSupport 字符串数组 目前可用的拍摄状态列表；如果支持视频拍摄，则应默认设置为 ["idle", "shooting"]。也可以提供其他雕像，例如"downloading"。

此选项是在 API 级别 2.1 中添加的。

 r
exposureProgram 数字 当前的接触计划。 rw
exposureProgramSupport 数字数组 目前可用的接触计划列表；例如 [0, 1, 2, 3, 4]。每个整数代表一个不同的曝光程序： <ph type="x-smartling-placeholder">
    </ph>
  • 0 = 未定义
  • 1 = 人工
  • 2 = 正常程序
  • 3 = 光圈优先
  • 4 = 快门优先
。 请点击以下链接，下载有关ExposureProgram的更多详细信息。 		r
iso 数字 当前的 ISO 速度设置。 rw
isoSupport 数字数组

API 级别 1：当前可用的 ISO 设置列表；例如，在 auto 模式下使用 [100, 200, 400, 800,1600] 或 []。

API 级别 2：当前可用的 ISO 设置列表；例如 [0, 100, 200, 400, 800, 1600]，其中 0 表示 auto 模式。

此选项在 API 级别 2 中进行了修改。

 r
shutterSpeed 数字 当前的快门速度设置。 rw
shutterSpeedSupport 数字数组

API 级别 1：当前可用的快门速度列表；例如，在 auto 模式下使用 [0.067, 0.033, 0.017,0.008] 或 []。

API 级别 2：当前可用的快门速度列表；例如 [0, 0.067, 0.033, 0.017, 0.008]，其中 0 表示 auto 模式。

此选项在 API 级别 2 中进行了修改。

 r
aperture 数字 当前光圈设置（以光圈为单位）。 rw
apertureSupport 数字数组

API 级别 1：当前可用的光圈设置列表，以 f/number 表示；用于 例如 [1.4, 2, 2.8, 4, 5.6, 8, 11] 或 []（当处于 auto 模式时）。

API 级别 2：当前可用的光圈设置列表，以 f/number 表示；例如 [0, 1.4, 2, 2.8, 4, 5.6, 8, 11]，其中 0 表示 auto 模式。

 r
whiteBalance 字符串 当前白平衡设置；例如 daylight。默认值为 auto。 rw
whiteBalanceSupport 字符串数组 当前可用的白平衡设置列表，可以是预定义列表的子集：[ "auto", "incandescent", "fluorescent", "daylight", "cloudy-daylight", "shade", "twilight"]。各选项的值： <ph type="x-smartling-placeholder">
    </ph>
  • incandescent，约 320 万
  • fluorescent，约 400 万
  • datalight，约 520 万
  • cloudy-daylight，约 600 万
  • shade，约 700 万
  • twilight，约 1200 万
。 为供应商专用设置名称添加下划线前缀；例如：_vendor-setting		 r
exposureCompensation 数字 当前曝光补偿。 rw
exposureCompensationSupport 数字数组 当前可用的曝光补偿列表，通常在步骤 0.33 或 0.5；例如：[-1, -0.67, -0.33, 0, 0.33, 0.67, 1] r
fileFormat 对象

当前文件类型和分辨率。格式应反映 captureMode 的当前值。例如，如果 captureMode 为 image，则相应的响应可以是：

{
    "type": "jpeg",
    "width": 2000,
    "height": 1000
}
如果 captureMode 为 video，则相应的响应可能是： 
{
    "type": "mp4",
    "width": 1920,
    "height": 1080,
    "framerate": 30
}

此选项在 API 级别 2 中进行了修改。

 rw
fileFormatSupport 对象数组

目前可用的文件格式列表；例如：

[
    {
    "type": "jpeg",
    "width": 2000,
    "height": 1000
    },
    {
    "type": "jpeg",
    "width": 200,
    "height": 100
    },
    {
    "type": "mp4",
    "width": 1920,
    "height": 1080,
    "framerate": 24
    },
    {
    "type": "mp4",
    "width": 1280,
    "height": 720,
    "framerate": 30
    },
    ...
]
请访问以下链接，详细了解所有类型。

此选项在 API 级别 2 中进行了修改。

 r
exposureDelay 数字 takePicture 命令与曝光开始之间的当前延迟时间（以秒为单位）。 rw
exposureDelaySupport 数字数组 当前可用的曝光延迟时间列表（以秒为单位）；例如：[0, 1, 2, 5, 10, 30, 60] r
sleepDelay 数字 摄像头进入休眠状态前的当前延迟时间（以秒为单位）。 rw
sleepDelaySupport 数字数组 当前可用的休眠延迟列表（以秒为单位）；例如 [30, 60, 120, 300, 600, 1800, 65535]，其中 65535 会停用睡眠模式（相机在关机后不会进入休眠状态），并且必须支持。 r
offDelay 数字 摄像头关机前的当前延迟时间（以秒为单位）。 rw
offDelaySupport 数字数组 当前可用的关机延迟列表（以秒为单位）；例如 [1800, 3600, 7200, 65535]，其中 65535 用于停用关机模式（相机不会关机，直到电池耗尽或手动关机），并且必须支持。 r
totalSpace 数字 只读：总存储空间的字节数。 r
remainingSpace 数字 只读：可用存储空间的字节数。 r
remainingPictures 数字 只读：根据当前拍摄的照片估算得出的剩余照片数量 设置。 r
gpsInfo 对象

当前 GPS 信息。通过 setOptions 和手机 GPS 进行设置：

{
    "lat": 23.532,
    "lng": -132.35
}
lat 和 lng 属性采用十进制度数表示，其中 lat 的范围是 [-90, 90]，lng 的范围是 [-180, 180]。请注意，如果手机提供，每个 GPS 位置都有效， 直到手机下次更新为止。手机必须确定何时更新 GPS 位置信息；例如，放在每个 takePicture 命令前面。65535 会通知相机当前的 GPS 位置无效，并且相机 应忽略它并使用自己的 GPS（如果存在）；例如 setOptions({"gpsInfo": {"lat": 65535, "lng": 65535}}) 表示 GPS 位置 无效。		 rw
dateTimeZone 字符串 当前日期和时间信息。由 setOptions 使用手机的日期、时间和时区进行设置。格式为 YYYY:MM:DD HH:MM:SS+(-)HH:MM。时间采用 24 小时制，日期和时间由空格分隔， 时区是相对于世界协调时间 (UTC) 的偏移量；例如，2014:05:18 01:04:29+8:00 是中国时区 (UTC+8:00) rw
hdr

API 级别 1：布尔值

API 级别 2：字符串

API 级别 1：启用/停用 HDR 拍摄模式。值为 true 表示启用 HDR，值为 false 表示停用 HDR。默认值为 false。 仅当 hdrSupport 为 true 时，设置才可以为 true。

API 级别 2：字符串类型的当前 HDR 模式。

此选项在 API 级别 2 中进行了修改。

 rw
hdrSupport

API 级别 1：布尔值

API 级别 2：字符串数组

API 级别 1：值 true 表示相机支持 HDR。false 设置可识别没有 HDR 的相机。

API 级别 2：如果您不支持 HDR 模式， [“off”]；如果您支持一种 HDR 模式，则 [“off”, “hdr”]；如果支持多种 HDR 模式（基于不同算法），则 [“off”, “hdr”, “hdr1”, “hdr2”, ...]

此选项在 API 级别 2 中进行了修改。

 r
exposureBracket 对象 当前曝光包围设置设置。仅当 hdrSupport == true（API 级别 1）或 hdrSupport 包含至少一种 HDR 模式（API 级别 2）时可用。如果相机使用手动包围曝光，则该对象包含两个条目： <ph type="x-smartling-placeholder">
    </ph>
  1. shots，一个整数，包含要拍摄的照片数。
  2. increment：一个数字，其中包含镜头之间的 EV 增量。
。 例如： 
{
    "shots": 3,
    "increment": 1.33
}
如果相机使用自动包围曝光，则该对象包含： 
{
    "autoMode": true
}

API 级别 1：当 hdrSupport == false 时，默认为空 {}。当 hdr 为 true 时，由制造商决定默认值（例如，自动包围曝光）。

API 级别 2：当 hdrSupport 仅包含 "off" 时，默认为空 {}。否则，由制造商决定默认值（例如自动包围曝光）。

此选项在 API 级别 2 中进行了修改。

 rw
exposureBracketSupport 对象

当前可用的曝光包设置；例如：

{
    "autoMode": true,
    "shotsSupport": [1, 3, 5, 7],
    "incrementSupport": [0.33, 0.67, 1, 1.33, 1.67, 2]
}

API 级别 1：如果 hdrSupport == false，则默认为空 {}。如果为 hdrSupport == true，但不支持自动包围曝光，则 autoMode 将为 false。

API 级别 2：如果 hdrSupport 仅包含 "off"，则默认为空 {}。如果 hdrSupport 包含任何 HDR 模式，但不支持自动包围曝光，则 autoMode 将为 false。

此选项在 API 级别 2 中进行了修改。

 r
gyro 布尔值 设置为 true 可启用相机的陀螺仪模块，设置为 false 可停用此功能。如果相机支持，则默认为 true，否则为 false。仅当 gyroSupport == true 时，此设置才能设为 true。 rw
gyroSupport 布尔值 如果相机有陀螺仪，则此值应为 true，否则为 false。 r
gps 布尔值 启用/停用相机 GPS 模块。值必须为 true 才能启用，值必须为 false 才能停用。如果相机支持，默认值为 true，否则为 false。仅当 gpsSupport == true 时才设置为 true。 rw
gpsSupport 布尔值 如果相机有自己的 GPS 模块，则此值应为 true，否则为 false。 r
imageStabilization 字符串 当前图像防抖操作；例如 off。 rw
imageStabilizationSupport 字符串数组 目前提供防抖选项。预定义列表为 ["off", "on"]。如果相机不支持图像防抖功能，则返回 ["off"]，否则返回 ["off", "on"]。使用下划线 ( _ ) 作为供应商特定字符串的前缀例如 [ "off", "_horizontal_stabilization", "_vibration_correction" ]。 r
wifiPassword 字符串
至少 8 个字符，包含字母、数字和符号，但不包含空格。只有在相机连接到客户端设备时才能更改该设置。更改后，相机必须断开连接，因此用户必须使用新的 wifiPassword 重新连接。
相机必须提供重置机制，以防用户忘记密码；例如，使用重置按钮恢复出厂默认密码。
 w
previewFormat 对象

当前的实时预览分辨率；例如：

{
    "width": 640,
    "height": 320,
    "framerate": 24
}

此选项是在 API 级别 2 中添加的。

 rw
previewFormatSupport 对象数组

目前支持的实时预览格式；例如：

[
    {
    "width": 640,
    "height": 320,
    "framerate": 24
    },
    ...
    {
    "width": 1280,
    "height": 720,
    "framerate": 24
    }
]

此选项是在 API 级别 2 中添加的。

 r
captureInterval 数字 两张连续图片拍摄之间的当前时间间隔，以 seconds 为单位。

此选项是在 API 级别 2 中添加的。

 rw
captureIntervalSupport 对象

两次连续拍摄图像之间允许的最小和最大时间间隔（以秒为单位）；例如：

{
    "minInterval": 10,
    "maxInterval": 60
}
这可能因fileFormat而异。

此选项是在 API 级别 2 中添加的。

 r
captureNumber 数字 一个间隔拍摄时段要拍摄的图片数量。默认值为 0，表示需要通过 stopCapture 命令明确终止捕获；否则，在捕获指定数量的图像后，捕获会自动停止。如果摄像头没电或摄像头被故意关闭，拍照也会中断。

此选项是在 API 级别 2 中添加的。

 rw
captureNumberSupport 对象

间隔拍摄中可拍摄的图片数量下限和上限；例如：

{
    "minNumber": 2,
    "maxNumber": 50
}
存储空间可能会因剩余存储空间而异。

此选项是在 API 级别 2 中添加的。

 r
remainingVideoSeconds 数字 根据当前拍摄设置，剩余视频的估算数量（seconds）。

此选项是在 API 级别 2 中添加的。

 r
pollingDelay 数字 两个连续状态轮询请求之间的最小时间间隔（以秒为单位）。客户端应使用此字段来指导其状态轮询行为；例如，在拼接图片时，客户可能需要定期轮询摄像头，看看它是否完成了拼接。不同摄像头的支持不同；例如，有些相机每秒可以处理一次状态轮询，而其他相机则支持更长的时间间隔。

此选项是在 API 级别 2 中添加的。

 r
delayProcessing 布尔值 如果处理（例如拼接）的优先级低于拍摄优先级，即使用 True，即在上一张图像处理完成之前允许再次拍摄。我们强烈建议这样做，尤其是对于处理时间较长的相机。

此选项是在 API 级别 2 中添加的。

 rw
delayProcessingSupport 布尔值数组

[true] 表示处理（例如拼接）的优先级低于拍摄，并且默认情况下始终延迟。

[false] 表示在拍摄后立即进行处理。

[true, false] 表示可以在这两种模式之间选择。

此选项是在 API 级别 2 中添加的。

 r
clientVersion 数字

客户端决定使用的 API 级别。如果 相机同时支持 API 级别 1 和 2，这样 API 级别 1 仍可使用相机，没有任何变化；默认 如果相机仅支持 API 级别 2，则该值不是 2， 建议在客户迁移到 API 级别 2 之前。如果摄像头 仅支持 API 级别 2，尝试将其设置为 1 的请求应该 失败。如果 clientVersion 成功设为 2， 请求了 API 级别 1 中已弃用的命令， 应该会失败，并显示错误代码 unknownCommand。

此选项是在 API 级别 2 中添加的。

 rw
photoStitchingSupport 字符串数组

照片拼接选项列表。返程 [ondevice]（如果照片始终拼接在相机上）； 如果相机无法拼接照片，则为 [none]；以及 如果拼接可由用户配置，则为 [none,ondevice]。 使用下划线作为供应商专用设置名称的前缀，例如 _vendor-setting。

此选项是在 API 级别 2.1 中添加的。

 r
photoStitching 字符串

当前的照片拼接选项，例如 ondevice。如果为以下值，则默认为 ondevice： 支持。

此选项是在 API 级别 2.1 中添加的。

 rw
videoStitchingSupport 字符串数组

视频的拼接选项列表。返程 [ondevice]（如果视频始终拼接在摄像头上）； 如果相机无法拼接视频，则为 [none]；以及 如果拼接可由用户配置，则为 [none,ondevice]。 使用下划线作为供应商专用设置名称的前缀，例如 _vendor-setting。

此选项是在 API 级别 2.1 中添加的。

 r
videoStitching 字符串

当前的视频拼接选项，例如 ondevice。如果为以下值，则默认为 ondevice： 支持。

此选项是在 API 级别 2.1 中添加的。

 rw
videoGPSSupport 字符串数组

视频拍摄过程中的 GPS 选项列表。返程 如果相机可以连续拍摄 GPS 照片，则为 [continuous] 并将位置嵌入到视频中。返程 如果不能，则设为 [none]；如果不能，则设为 [none,continuous] 如果视频 GPS 支持可由用户配置。特定于供应商的前缀 设置名称时带有下划线，例如_vendor-setting。

此选项是在 API 级别 2.1 中添加的。

 r
videoGPS 字符串

视频拍摄期间支持 GPS 的选项，例如 continuous。如果为以下值，则默认为 continuous： 支持。

此选项是在 API 级别 2.1 中添加的。

 rw
_vendorSpecific [类型]（可选） 特定于供应商的其他摄像头选项。为供应商专用字符串添加前缀 下划线 ( _ )。