• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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