README_zh.md
1# TAG功能介绍
2
3## 静态属性查询
4
5### OHOS\_ABILITY\_CAMERA\_POSITION
6查询相机的位置信息，例如前置、后置等，位置信息定义如下：
7
8| OHOS\_ABILITY\_CAMERA\_POSITION | 用于查询相机的位置信息 |
9| ------------------------------------ | ------------------ |
10| OHOS\_CAMERA\_POSITION\_FRONT | 前置 |
11| OHOS\_CAMERA\_POSITION\_BACK | 后置 |
12| OHOS\_CAMERA\_POSITION\_OTHER | 其他 |
13
14
15### OHOS\_ABILITY\_CAMERA_TYPE
16查询相机的功能类型，例如广角、长焦等，类型定义如下：
17
18| OHOS\_ABILITY\_CAMERA\_TYPE | 用于查询相机的功能类型 |
19| ---------------------------------| ------------------ |
20| OHOS\_CAMERA\_TYPE\_WIDE\_ANGLE | 广角镜头 |
21| OHOS\_CAMERA\_TYPE\_ULTRA\_WIDE | 超广角镜头 |
22| OHOS\_CAMERA\_TYPE\_TELTPHOTO | 长焦镜头 |
23| OHOS\_CAMERA\_TYPE\_TRUE\_DEAPTH | 景深镜头 |
24| OHOS\_CAMERA\_TYPE\_LOGICAL | 逻辑镜头 |
25| OHOS\_CAMERA\_TYPE\_UNSPECIFIED | 未定义镜头 |
26
27
28### OHOS\_ABILITY\_CAMERA\_CONNECTION\_TYPE
29查询相机的链接类型，例如板载、USB外接、远程等，类型定义如下：
30
31| OHOS\_ABILITY\_CAMERA\_CONNECTION\_TYPE | 查询相机设备的连接类型 |
32|-------------------------------------------------| ------------------ |
33| OHOS\_CAMERA\_CONNECTION\_TYPE\_BUILTIN | 板载相机 |
34| OHOS\_CAMERA\_CONNECTION\_TYPE\_USB\_PLUGIN | USB外接相机 |
35| OHOS\_CAMERA\_CONNECTION\_TYPE\_REMOTE | 远程相机 |
36
37
38### OHOS\_ABILITY\_FOCAL\_LENGTH
39查询相机的镜头焦距，浮点型数值。
40
41
42### OHOS\_SENSOR\_ORIENTATION
43
4432位整型数值，表示镜头的安装角度，通常指镜头想对于设备正常握持方向的偏转角度。
45
46
47## 分辨率及图像格式控制
48### OHOS\_ABILITY\_STREAM\_AVAILABLE\_BASIC\_CONFIGURATIONS
49用于查询支持的分辨率及图像格式，32位整型数组，格式如下：
50
51[图像格式1, 分辨率宽， 分辨率高， 图像格式2, 分辨率宽， 分辨率高， ......]
52
53格式举例：
54
55[1, 640, 480, 4, 1280, 960]
56
57图像格式信息定义如下：
58
59| OHOS\_ABILITY\_STREAM\_AVAILABLE\_BASIC\_CONFIGURATIONS | 查询支持的分辨率及图像格式 |
60| ------------------------------------------------------- | --------------------- |
61| OHOS\_CAMERA\_FORMAT\_RGBA\_8888 = 1 | RGBA8888 |
62| OHOS\_CAMERA\_FORMAT\_YCBCR\_420\_888 = 2 | YCBCR420_888 |
63| OHOS\_CAMERA\_FORMAT\_YCRCB\_420\_SP = 3 | YCRCB420_SP |
64| OHOS\_CAMERA\_FORMAT\_JPEG = 4 | JPEG |
65
66### OHOS\_CONTROL\_FPS\_RANGES
6732位整型数组，用于下发帧率范围。
68
69
70## 基于模式的基础规格及特性能力查询
71### OHOS\_ABILITY\_STREAM\_AVAILABLE\_EXTEND\_CONFIGURATIONS
72按照模式场景及流类型查询基础规格及特性能力，32位整型数组，格式如下：
73
74[模式1, 流类型1, 能力信息1, 能力信息2, ..., 结束符, 流类型2, 能力信息1, 能力信息2, ..., 结束符，结束符号，模式2, 流类型1, 能力信息1, 能力信息2, ..., 结束符, 流类型2, 能力信息1, 能力信息2, ..., 结束符，结束符]
75
76结束符约定为-1，其中能力信息格式为：
77
78[图像格式，分辨率宽， 分辨率高， 固定帧率， 动态帧率下限， 动态帧率上限， 特性能力1, 特性能力2, ...， 结束符]
79
80其中特性能力采用其对应查询TAG表示。
81
82格式举例：
83
84[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]
85
86PS: '虚化'为OHOS_ABILITY_SCENE_PORTRAIT_EFFECT_TYPES, '滤镜'为OHOS_ABILITY_SCENE_FILTER_TYPES, '美颜'为OHOS_ABILITY_SCENE_BEAUTY_TYPES。
87
88
89## 拍照镜像控制
90
91### OHOS\_CONTROL\_CAPTURE\_MIRROR\_SUPPORTED
928位整型，用于查询是否支持拍照镜像，0表示不支持，1表示支持。
93
94### OHOS\_CONTROL\_CAPTURE\_MIRROR
958位整型，用于下发控制拍照镜像，1表示开启镜像，0表示关闭。
96
97
98## 缩放控制
99
100### OHOS\_ABILITY\_ZOOM\_RATIO\_RANGE
101用于查询支持的缩放比例范围，浮点型数值区间，格式如下：
102
103[ZOOM下限，ZOOM上限]
104
105举例：
106
107[1.000000, 6.000000] -- 缩放比例范围为1.0到1.0倍。
108
109### OHOS\_ABILITY\_SCENE\_ZOOM\_CAP
110用于查询不同模式下的缩放比例范围，32位整型数组，格式如下:
111
112[模式1， ZOOM下限， ZOOM上限， 模式2， ZOOM下限，ZOOM上限，...]
113
114举例：
115
116[0, 1, 5, 1, 1, 3] -- NORMAL模式下缩放比例为1～5倍， 人像模式下为1～3倍。
117
118### OHOS\_CONTROL\_ZOOM\_RATIO
119整型数值， 用于下发缩放比例。
120
121
122## 对焦控制
123### OHOS\_ABILITY\_FOCUS_MODES
124用于查询支持对焦模式，8位整型数组，格式如下：
125
126[对焦模式1, 对焦模式2, ......]
127
128举例：
129
130[1, 2] -- 支持连续自动对焦和自动对焦
131
132对焦模式类型定义如下：
133
134| OHOS\_ABILITY\_FOCUS_MODES | 数值 | 用于查询支持的对焦模式 |
135| ------------------------------------------- | ---- |------------------- |
136| OHOS\_CAMERA\_FOCUS\_MODE\_MANUAL | 0 | 手动 |
137| OHOS\_CAMERA\_FOCUS\_MODE\_CONTINOUS_AUTO | 1 | 连续自动 |
138| OHOS\_CAMERA\_FOCUS\_MODE\_AUTO | 2 | 自动 |
139| OHOS\_CAMERA\_FOCUS\_MODE\_LOCKED | 3 | 锁定 |
140
141### OHOS\_CONTROL\_FOCUS\_MODE
1428位整型，用于下发对焦模式。
143
144
145## 曝光控制
146### OHOS\_ABILITY\_EXPOSURE\_MODES
1478位整型数组，查询支持的曝光模式，类型定义如下：
148
149| OHOS\_ABILITY\_EXPOSURE\_MODES | 用于查询支持的曝光模式 |
150| ------------------------------------------- | ------------------- |
151| OHOS\_CAMERA\_FOCUS\_MODE\_MANUAL | 手动 |
152| OHOS\_CAMERA\_FOCUS\_MODE\_CONTINOUS_AUTO | 连续自动 |
153| OHOS\_CAMERA\_FOCUS\_MODE\_AUTO | 自动 |
154| OHOS\_CAMERA\_FOCUS\_MODE\_LOCKED | 锁定 |
155
156### OHOS\_CONTROL\_EXPOSURE\_MODE
1578位整型，用于下发曝光模式。
158
159
160## 曝光补偿控制
161### OHOS\_CONTROL\_AE\_COMPENSATION\_RANGE
162用于查询自动曝光补偿范围，32位整型区间，格式如下：
163
164[范围下限, 范围上限]
165
166格式举例：
167
168[-4, 4]
169
170### OHOS\_CONTROL\_AE\_COMPENSATION\_STEP
171用于查询自动曝光补偿步长，rational类型，格式如下：
172
173```
174typedef struct camera_rational {
175 int32_t numerator;
176 int32_t denominator;
177} camera_rational_t;
178```
179
180格式举例：
181
182[1, 2] -- 表示步长为1/2。
183
184### OHOS\_CONTROL\_AE\_EXPOSURE\_COMPENSATION
18532位整型，用于下发曝光补偿值。
186
187
188## 人类检测控制
189### OHOS\_STATISTICS\_FACE\_DETECT\_MODE
1908位整型数值，用于查询是否支持人脸检测，取值0表示不支持，取值1表示支持。
191
192### OHOS\_STATISTICS\_FACE\_DETECT\_SWITCH
1938位整型，用于下发人脸检测开关，1表示开启，0表示关闭。
194
195
196## 静音控制
197### OHOS\_ABILITY\_MUTE\_MODES
1988位整型数组，用于查询支持的静音模式，类型定义如下：
199
200| OHOS\_ABILITY\_MUTE\_MODES | 用于查询支持的静音模式 |
201| ------------------------------------------------ | ------------------ |
202| OHOS\_CAMERA\_MUTE\_MODE\_OFF | 关闭或不支持 |
203| OHOS\_CAMERA\_MUTE\_MODE\_SOLID\_COLOR\_BLACK | 黑色 |
204
205### OHOS\_CONTROL\_MUTE\_MODE
2068位整型，用于下发静音模式。
207
208
209## 录像防抖控制
210### OHOS\_ABILITY\_VIDEO\_STABILIZATION\_MODES
2118位整型数组，查询支持的视频防抖模式，类型定义如下：
212
213| OHOS\_ABILITY\_VIDEO\_STABILIZATION\_MODES | 查询支持的视频防抖模式 |
214| ---------------------------------------------- | ------------------ |
215| OHOS\_CAMERA\_VIDEO\_STABILIZATION\_OFF | 关闭或不支持 |
216| OHOS\_CAMERA\_VIDEO\_STABILIZATION\_LOW, | 低 |
217| OHOS\_CAMERA\_VIDEO\_STABILIZATION\_MIDDLE, | 中 |
218| OHOS\_CAMERA\_VIDEO\_STABILIZATION\_HIGH, | 高 |
219| OHOS\_CAMERA\_VIDEO\_STABILIZATION\_AUTO, | 自动 |
220
221### OHOS\_CONTROL\_VIDEO\_STABILIZATION\_MODE
2228位整型，用于下发防抖模式。
223
224
225## 闪光灯打闪模式控制
226### OHOS\_ABILITY\_FLASH_\_MODES
227查询支持的闪光灯模式，8位整型数组，类型定义如下：
228
229| OHOS\_ABILITY\_FLASH\_MODES | 用于查询支持的闪光灯模式 |
230| ------------------------------------------ | ------------------- |
231| OHOS\_CAMERA\_FLASH\_MODE\_CLOSE | 关闭或不支持 |
232| OHOS\_CAMERA\_FLASH\_MODE\_OPEN | 打开 |
233| OHOS\_CAMERA\_FLASH\_MODE\_AUTO | 自动 |
234| OHOS\_CAMERA\_FLASH\_MODE\_ALWAYS_OPEN | 始终开启 |
235
236### OHOS\_CONTROL\_FLASH_\_MODE
2378位整型，用于下发打闪模式。
238
239
240## 帧率控制
241### OHOS\_ABILITY\_FPS\_RANGES
24232位整型数组，用于查询支持的帧率范围。
243
244### OHOS\_CONTROL\_FPS\_RANGES
24532位整型数组，用于下发帧率范围。
246
247## 状态反馈
248### OHOS\_CONTROL\_EXPOSURE\_STATE
2498位整型数值，查询当前曝光状态，定义如下：
250
251| OHOS\_CONTROL\_EXPOSURE\_STATE | 查询当前曝光状态 |
252| ------------------------------ | -------------- |
253|OHOS\_CAMERA\_EXPOSURE\_STATE\_SCAN|扫描中|
254|OHOS\_CAMERA\_EXPOSURE\_STATE\_CONVERGED|已汇聚|
255
256
257### OHOS\_CONTROL\_FOCUS\_STATE
2588位整型数值，查询当前对焦状态，定义如下：
259
260| OHOS\_CONTROL\_FOCUS\_STATE | 查询当前闪光灯状态 |
261| ---------------------------| ----------------- |
262|OHOS\_CAMERA\_FOCUS\_STATE\_SCAN | 扫描中 |
263|OHOS\_CAMERA\_FOCUS\_STATE\_FOCUSED | 已完成对焦 |
264|OHOS\_CAMERA\_FOCUS\_STATE\_UNFOCUSED | 未完成对焦 |
265
266### OHOS\_CONTROL\_FLASH\_STATE
2678位整型数值，查询当前闪光灯状态，定义如下：
268
269| OHOS\_CONTROL\_FLASH\_STATE | 查询当前闪光灯状态 |
270| ---------------------------| ----------------- |
271|OHOS\_CAMERA\_FLASH\_STATE\_UNAVAILABLE | 不可用 |
272|OHOS\_CAMERA\_FLASH\_STATE\_CHARGING | 充电中 |
273|OHOS\_CAMERA\_FLASH\_STATE\_READY | 就绪 |
274|OHOS\_CAMERA\_FLASH\_STATE\_FLASHING | 打闪中 |
275|OHOS\_CAMERA\_FLASH\_STATE\_UNKNOWN | 未知 |
276
277# TAG下发控制约定
278## 增量控制约定
279上层给HDI下发TAG参数时，仅需下发需要变更的参数，未下发的参数默认保持不变。
280
281## 特殊行为约定
282部分TAG在下发控制上存在其特有行为，汇总如下：
283
284| TAG名称 | 说明 | 控制逻辑|
285| ----------------------------- | ------| ------ |
286| OHOS\_JPEG\_GPS\_COORDINATES | 设置JPEG图片的地理位置信息 | 只针对下发后的第一次拍照生效，每次拍照前需独立下发，不下发默认没有地理位置|
287
288
289