1# ICameraDevice
2
3
4## 概述
5
6定义Camera设备基本的操作。
7
8设置流回调接口、更新控制参数、执行metadata相关操作。
9
10**起始版本：** 3.2
11
12**相关模块：**[Camera](_camera_v10.md)
13
14
15## 汇总
16
17
18### Public 成员函数
19
20| 名称 | 描述 |
21| -------- | -------- |
22| [GetStreamOperator](#getstreamoperator) ([in] [IStreamOperatorCallback](interface_i_stream_operator_callback_v10.md) callbackObj, [out] [IStreamOperator](interface_i_stream_operator_v10.md) streamOperator) | 获取流操作句柄。 |
23| [UpdateSettings](#updatesettings) ([in] unsigned char[] settings) | 更新设备控制参数。 |
24| [SetResultMode](#setresultmode) ([in] enum [ResultCallbackMode](_camera_v10.md#resultcallbackmode) mode) | 设置metadata上报模式，逐帧上报还是设备状态变化时上报。 |
25| [GetEnabledResults](#getenabledresults) ([out] int[] results) | 查询使能的metadata。 |
26| [EnableResult](#enableresult) ([in] int[] results) | 打开metadata上报开关。 |
27| [DisableResult](#disableresult) ([in] int[] results) | 关闭metadata上报开关。 |
28| [Close](#close) () | 关闭当前Camera设备。 |
29
30
31## 成员函数说明
32
33
34### Close()
35
36```
37ICameraDevice::Close ()
38```
39
40**描述**
41
42关闭当前Camera设备。
43
44**起始版本：** 3.2
45
46**参见：**
47
48OpenCamera
49
50
51### DisableResult()
52
53```
54ICameraDevice::DisableResult ([in] int[] results)
55```
56
57**描述**
58
59关闭metadata上报开关。
60
61屏蔽之后，相应的**OnResult**不再上报，需[EnableResult](#enableresult)使能之后才上报。
62
63**起始版本：** 3.2
64
65**参数:**
66
67| 名称 | 描述 |
68| -------- | -------- |
69| results | 需要关闭上报开关的metadata。 |
70
71**返回：**
72
73NO_ERROR 表示执行成功。
74
75其他值表示执行失败，具体错误码查看[CamRetCode](_camera_v10.md#camretcode)。
76
77**参见：**
78
79[EnableResult](#enableresult)
80
81
82### EnableResult()
83
84```
85ICameraDevice::EnableResult ([in] int[] results)
86```
87
88**描述**
89
90打开metadata上报开关。
91
92**OnResult**只上报此接口使能后的metadata。
93
94**起始版本：** 3.2
95
96**参数:**
97
98| 名称 | 描述 |
99| -------- | -------- |
100| results | 需要打开上报开关的多个metadata。 |
101
102**返回：**
103
104NO_ERROR 表示执行成功。
105
106其他值表示执行失败，具体错误码查看[CamRetCode](_camera_v10.md#camretcode)。
107
108**参见：**
109
110[DisableResult](#disableresult)
111
112
113### GetEnabledResults()
114
115```
116ICameraDevice::GetEnabledResults ([out] int[] results)
117```
118
119**描述**
120
121查询使能的metadata。
122
123[EnableResult](#enableresult)使能需要上报的metadata之后，可通过此接口查询使能的metadata。
124
125**起始版本：** 3.2
126
127**参数:**
128
129| 名称 | 描述 |
130| -------- | -------- |
131| results | 所有使能的metadata的ID数组。 |
132
133**返回：**
134
135NO_ERROR 表示执行成功。
136
137其他值表示执行失败，具体错误码查看[CamRetCode](_camera_v10.md#camretcode)。
138
139
140### GetStreamOperator()
141
142```
143ICameraDevice::GetStreamOperator ([in] IStreamOperatorCallback callbackObj, [out] IStreamOperator streamOperator )
144```
145
146**描述**
147
148获取流操作句柄。
149
150**起始版本：** 3.2
151
152**参数:**
153
154| 名称 | 描述 |
155| -------- | -------- |
156| callbackObj | 设置流回调接口，详细可查看[IStreamOperatorCallback](interface_i_stream_operator_callback_v10.md)， 用于上报捕获开始[OnCaptureStarted](interface_i_stream_operator_callback_v10.md#oncapturestarted)，捕获结束[OnCaptureEnded](interface_i_stream_operator_callback_v10.md#oncaptureended)， 捕获错误等信息[OnCaptureError](interface_i_stream_operator_callback_v10.md#oncaptureerror)。 |
157| streamOperator | 返回流操作句柄。 |
158
159**返回：**
160
161NO_ERROR 表示执行成功。
162
163其他值表示执行失败，具体错误码查看[CamRetCode](_camera_v10.md#camretcode)。
164
165
166### SetResultMode()
167
168```
169ICameraDevice::SetResultMode ([in] enum ResultCallbackMode mode)
170```
171
172**描述**
173
174设置metadata上报模式，逐帧上报还是设备状态变化时上报。
175
176**起始版本：** 3.2
177
178**参数:**
179
180| 名称 | 描述 |
181| -------- | -------- |
182| mode | metadata的上报模式，逐帧上报或者设备状态变化时上报，查看[ResultCallbackMode](_camera_v10.md#resultcallbackmode)。 |
183
184**返回：**
185
186NO_ERROR 表示执行成功。
187
188其他值表示执行失败，具体错误码查看[CamRetCode](_camera_v10.md#camretcode)。
189
190
191### UpdateSettings()
192
193```
194ICameraDevice::UpdateSettings ([in] unsigned char[] settings)
195```
196
197**描述**
198
199更新设备控制参数。
200
201**起始版本：** 3.2
202
203**参数:**
204
205| 名称 | 描述 |
206| -------- | -------- |
207| settings | Camera设置参数，包括sensor帧率，3A相关参数等。 |
208
209**返回：**
210
211NO_ERROR 表示执行成功。
212
213其他值表示执行失败，具体错误码查看[CamRetCode](_camera_v10.md#camretcode)。
214