TAG功能介绍

静态属性查询

OHOS_ABILITY_CAMERA_POSITION

查询相机的位置信息，例如前置、后置等，位置信息定义如下：

OHOS_ABILITY_CAMERA_POSITION	用于查询相机的位置信息
OHOS_CAMERA_POSITION_FRONT	前置
OHOS_CAMERA_POSITION_BACK	后置
OHOS_CAMERA_POSITION_OTHER	其他

OHOS_ABILITY_CAMERA_TYPE

查询相机的功能类型，例如广角、长焦等，类型定义如下：

OHOS_ABILITY_CAMERA_TYPE	用于查询相机的功能类型
OHOS_CAMERA_TYPE_WIDE_ANGLE	广角镜头
OHOS_CAMERA_TYPE_ULTRA_WIDE	超广角镜头
OHOS_CAMERA_TYPE_TELTPHOTO	长焦镜头
OHOS_CAMERA_TYPE_TRUE_DEAPTH	景深镜头
OHOS_CAMERA_TYPE_LOGICAL	逻辑镜头
OHOS_CAMERA_TYPE_UNSPECIFIED	未定义镜头

OHOS_ABILITY_CAMERA_CONNECTION_TYPE

查询相机的链接类型，例如板载、USB外接、远程等，类型定义如下：

OHOS_ABILITY_CAMERA_CONNECTION_TYPE	查询相机设备的连接类型
OHOS_CAMERA_CONNECTION_TYPE_BUILTIN	板载相机
OHOS_CAMERA_CONNECTION_TYPE_USB_PLUGIN	USB外接相机
OHOS_CAMERA_CONNECTION_TYPE_REMOTE	远程相机

OHOS_ABILITY_FOCAL_LENGTH

查询相机的镜头焦距，浮点型数值。

OHOS_SENSOR_ORIENTATION

32位整型数值，表示镜头的安装角度，通常指镜头想对于设备正常握持方向的偏转角度。

分辨率及图像格式控制

OHOS_ABILITY_STREAM_AVAILABLE_BASIC_CONFIGURATIONS

用于查询支持的分辨率及图像格式，32位整型数组，格式如下：

[图像格式1, 分辨率宽， 分辨率高， 图像格式2, 分辨率宽， 分辨率高， ......]

格式举例：

[1, 640, 480, 4, 1280, 960]

图像格式信息定义如下：

OHOS_ABILITY_STREAM_AVAILABLE_BASIC_CONFIGURATIONS	查询支持的分辨率及图像格式
OHOS_CAMERA_FORMAT_RGBA_8888 = 1	RGBA8888
OHOS_CAMERA_FORMAT_YCBCR_420_888 = 2	YCBCR420_888
OHOS_CAMERA_FORMAT_YCRCB_420_SP = 3	YCRCB420_SP
OHOS_CAMERA_FORMAT_JPEG = 4	JPEG

OHOS_CONTROL_FPS_RANGES

32位整型数组，用于下发帧率范围。

基于模式的基础规格及特性能力查询

OHOS_ABILITY_STREAM_AVAILABLE_EXTEND_CONFIGURATIONS

按照模式场景及流类型查询基础规格及特性能力，32位整型数组，格式如下：

[模式1, 流类型1, 能力信息1, 能力信息2, ..., 结束符, 流类型2, 能力信息1, 能力信息2, ..., 结束符，结束符号，模式2, 流类型1, 能力信息1, 能力信息2, ..., 结束符, 流类型2, 能力信息1, 能力信息2, ..., 结束符，结束符]

结束符约定为-1，其中能力信息格式为：

[图像格式，分辨率宽， 分辨率高， 固定帧率， 动态帧率下限， 动态帧率上限， 特性能力1, 特性能力2, ...， 结束符]

其中特性能力采用其对应查询TAG表示。

格式举例：

[0, 0, 1, 640, 480, 0, 0, 0, -1, 1, 1, 640, 480, 30, 30, 30, -1, 2, 4, 1280, 960, 0, 0, 0, -1, -1, 1, 0, 1, 640, 480, 0, 0, 0, 虚化, 滤镜, 美颜, -1, 1, 2, 4, 1280, 960, 0, 0, 0, 虚化, -1, -1]

PS: '虚化'为OHOS_ABILITY_SCENE_PORTRAIT_EFFECT_TYPES, '滤镜'为OHOS_ABILITY_SCENE_FILTER_TYPES, '美颜'为OHOS_ABILITY_SCENE_BEAUTY_TYPES。

拍照镜像控制

OHOS_CONTROL_CAPTURE_MIRROR_SUPPORTED

8位整型，用于查询是否支持拍照镜像，0表示不支持，1表示支持。

OHOS_CONTROL_CAPTURE_MIRROR

8位整型，用于下发控制拍照镜像，1表示开启镜像，0表示关闭。

缩放控制

OHOS_ABILITY_ZOOM_RATIO_RANGE

用于查询支持的缩放比例范围，浮点型数值区间，格式如下：

[ZOOM下限，ZOOM上限]

举例：

[1.000000, 6.000000] -- 缩放比例范围为1.0到1.0倍。

OHOS_ABILITY_SCENE_ZOOM_CAP

用于查询不同模式下的缩放比例范围，32位整型数组，格式如下:

[模式1， ZOOM下限， ZOOM上限， 模式2， ZOOM下限，ZOOM上限，...]

举例：

[0, 1, 5, 1, 1, 3] -- NORMAL模式下缩放比例为1～5倍， 人像模式下为1～3倍。

OHOS_CONTROL_ZOOM_RATIO

整型数值， 用于下发缩放比例。

对焦控制

OHOS_ABILITY_FOCUS_MODES

用于查询支持对焦模式，8位整型数组，格式如下：

[对焦模式1, 对焦模式2, ......]

举例：

[1, 2] -- 支持连续自动对焦和自动对焦

对焦模式类型定义如下：

OHOS_ABILITY_FOCUS_MODES	数值	用于查询支持的对焦模式
OHOS_CAMERA_FOCUS_MODE_MANUAL	0	手动
OHOS_CAMERA_FOCUS_MODE_CONTINUOUS_AUTO	1	连续自动
OHOS_CAMERA_FOCUS_MODE_AUTO	2	自动
OHOS_CAMERA_FOCUS_MODE_LOCKED	3	锁定

OHOS_CONTROL_FOCUS_MODE

8位整型，用于下发对焦模式。

曝光控制

OHOS_ABILITY_EXPOSURE_MODES

8位整型数组，查询支持的曝光模式，类型定义如下：

OHOS_ABILITY_EXPOSURE_MODES	用于查询支持的曝光模式
OHOS_CAMERA_EXPOSURE_MODE_MANUAL	手动
OHOS_CAMERA_EXPOSURE_MODE_CONTINUOUS_AUTO	连续自动
OHOS_CAMERA_EXPOSURE_MODE_AUTO	自动
OHOS_CAMERA_EXPOSURE_MODE_LOCKED	锁定

OHOS_CONTROL_EXPOSURE_MODE

8位整型，用于下发曝光模式。

曝光补偿控制

OHOS_CONTROL_AE_COMPENSATION_RANGE

用于查询自动曝光补偿范围，32位整型区间，格式如下：

[范围下限, 范围上限]

格式举例：

[-4, 4]

OHOS_CONTROL_AE_COMPENSATION_STEP

用于查询自动曝光补偿步长，rational类型，格式如下：

typedef struct camera_rational {
    int32_t numerator;
    int32_t denominator; 
} camera_rational_t;

格式举例：

[1, 2] -- 表示步长为1/2。

OHOS_CONTROL_AE_EXPOSURE_COMPENSATION

32位整型，用于下发曝光补偿值。

人类检测控制

OHOS_STATISTICS_FACE_DETECT_MODE

8位整型数值，用于查询是否支持人脸检测，取值0表示不支持，取值1表示支持。

OHOS_STATISTICS_FACE_DETECT_SWITCH

8位整型，用于下发人脸检测开关，1表示开启，0表示关闭。

静音控制

OHOS_ABILITY_MUTE_MODES

8位整型数组，用于查询支持的静音模式，类型定义如下：

OHOS_ABILITY_MUTE_MODES	用于查询支持的静音模式
OHOS_CAMERA_MUTE_MODE_OFF	关闭或不支持
OHOS_CAMERA_MUTE_MODE_SOLID_COLOR_BLACK	黑色

OHOS_CONTROL_MUTE_MODE

8位整型，用于下发静音模式。

录像防抖控制

OHOS_ABILITY_VIDEO_STABILIZATION_MODES

8位整型数组，查询支持的视频防抖模式，类型定义如下：

OHOS_ABILITY_VIDEO_STABILIZATION_MODES	查询支持的视频防抖模式
OHOS_CAMERA_VIDEO_STABILIZATION_OFF	关闭或不支持
OHOS_CAMERA_VIDEO_STABILIZATION_LOW,	低
OHOS_CAMERA_VIDEO_STABILIZATION_MIDDLE,	中
OHOS_CAMERA_VIDEO_STABILIZATION_HIGH,	高
OHOS_CAMERA_VIDEO_STABILIZATION_AUTO,	自动

OHOS_CONTROL_VIDEO_STABILIZATION_MODE

8位整型，用于下发防抖模式。

闪光灯打闪模式控制

OHOS_ABILITY_FLASH__MODES

查询支持的闪光灯模式，8位整型数组，类型定义如下：

OHOS_ABILITY_FLASH_MODES	用于查询支持的闪光灯模式
OHOS_CAMERA_FLASH_MODE_CLOSE	关闭或不支持
OHOS_CAMERA_FLASH_MODE_OPEN	打开
OHOS_CAMERA_FLASH_MODE_AUTO	自动
OHOS_CAMERA_FLASH_MODE_ALWAYS_OPEN	始终开启

OHOS_CONTROL_FLASH__MODE

8位整型，用于下发打闪模式。

帧率控制

OHOS_ABILITY_FPS_RANGES

32位整型数组，用于查询支持的帧率范围。

OHOS_CONTROL_FPS_RANGES

32位整型数组，用于下发帧率范围。

状态反馈

OHOS_CONTROL_EXPOSURE_STATE

8位整型数值，查询当前曝光状态，定义如下：

OHOS_CONTROL_EXPOSURE_STATE	查询当前曝光状态
OHOS_CAMERA_EXPOSURE_STATE_SCAN	扫描中
OHOS_CAMERA_EXPOSURE_STATE_CONVERGED	已汇聚

OHOS_CONTROL_FOCUS_STATE

8位整型数值，查询当前对焦状态，定义如下：

OHOS_CONTROL_FOCUS_STATE	查询当前对焦状态
OHOS_CAMERA_FOCUS_STATE_SCAN	扫描中
OHOS_CAMERA_FOCUS_STATE_FOCUSED	已完成对焦
OHOS_CAMERA_FOCUS_STATE_UNFOCUSED	未完成对焦

OHOS_CONTROL_FLASH_STATE

8位整型数值，查询当前闪光灯状态，定义如下：

OHOS_CONTROL_FLASH_STATE	查询当前闪光灯状态
OHOS_CAMERA_FLASH_STATE_UNAVAILABLE	不可用
OHOS_CAMERA_FLASH_STATE_CHARGING	充电中
OHOS_CAMERA_FLASH_STATE_READY	就绪
OHOS_CAMERA_FLASH_STATE_FLASHING	打闪中
OHOS_CAMERA_FLASH_STATE_UNKNOWN	未知

TAG下发控制约定

增量控制约定

上层给HDI下发TAG参数时，仅需下发需要变更的参数，未下发的参数默认保持不变。

特殊行为约定

部分TAG在下发控制上存在其特有行为，汇总如下：

TAG名称	说明	控制逻辑
OHOS_JPEG_GPS_COORDINATES	设置JPEG图片的地理位置信息	只针对下发后的第一次拍照生效，每次拍照前需独立下发，不下发默认没有地理位置