• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# IStreamOperator
2
3
4## **概述**
5
6定义Camera设备流操作。
7
8对Camera设备执行流的创建、配置与添加参数、属性获取、句柄绑定与解除、图像捕获与取消、流的转换以及流释放操作。
9
10流是指从底层设备输出，经本模块内部各环节处理，最终传递到上层服务或者应用的一组数据序列。 本模块支持的流的类型有预览流，录像流，拍照流等，更多类型可查看[StreamIntent](camera.md#streamintent)。
11
12**相关模块:**
13
14[Camera](camera.md)
15
16
17## **汇总**
18
19
20### Public 成员函数
21
22  | 名称 | 描述 |
23| -------- | -------- |
24| [IsStreamsSupported](#isstreamssupported) ([in] enum [OperationMode](camera.md#operationmode) mode, [in] unsigned char[] modeSetting, [in] struct [StreamInfo](_stream_info.md)[] infos, [out] enum [StreamSupportType](camera.md#streamsupporttype) type) | 查询是否支持添加参数对应的流。 |
25| [CreateStreams](#createstreams) ([in] struct [StreamInfo](_stream_info.md)[] streamInfos) | 创建流。 |
26| [ReleaseStreams](#releasestreams) ([in] int[] streamIds) | 释放流。 |
27| [CommitStreams](#commitstreams) ([in] enum [OperationMode](camera.md#operationmode) mode, [in] unsigned char[] modeSetting) | 配置流。 |
28| [GetStreamAttributes](#getstreamattributes) ([out] struct [StreamAttribute](_stream_attribute.md)[] attributes) | 获取流的属性。通过该接口获取的流属性可能会和[CreateStreams](#createstreams)输入的流信息存在差异。 |
29| [AttachBufferQueue](#attachbufferqueue) ([in] int streamId, [in] BufferProducerSequenceable bufferProducer) | 绑定生产者句柄和指定流。 |
30| [DetachBufferQueue](#detachbufferqueue) ([in] int streamId) | 解除生产者句柄和指定流的绑定关系。 |
31| [Capture](#capture) ([in] int captureId, [in] struct [CaptureInfo](_capture_info.md) info, [in] boolean isStreaming) | 捕获图像。 |
32| [CancelCapture](#cancelcapture) ([in] int captureId) | 取消连续捕获。捕获结束时，会调用[OnCaptureEnded](interface_i_stream_operator_callback.md#oncaptureended)来通知调用者捕获的帧计数等信息。 |
33| [ChangeToOfflineStream](#changetoofflinestream) ([in] int[] streamIds, [in] [IStreamOperatorCallback](interface_i_stream_operator_callback.md) callbackObj, [out] [IOfflineStreamOperator](interface_i_offline_stream_operator.md) offlineOperator) | 将指定流转换成离线流。 |
34
35
36## **成员函数说明**
37
38
39### AttachBufferQueue()
40
41
42```
43IStreamOperator::AttachBufferQueue ([in] int streamId, [in] BufferProducerSequenceable bufferProducer )
44```
45
46**描述：**
47
48绑定生产者句柄和指定流。
49
50如果在[CreateStreams](#createstreams)创建流时已经指定了生产者句柄，则不需要调用该接口。如果需要重新绑定， 需先调用[DetachBufferQueue](#detachbufferqueue)进行解绑，然后再绑定。 对于一些IOT设备，可能不需要或者不支持预览流的图像数据缓存流转，那么不需要绑定生产者句柄， 此时在创建流时[CreateStreams](#createstreams)的[StreamInfo](_stream_info.md)参数的生产者句柄bufferQueue_为空，而 tunneledMode_需设置为false。
51
52**参数:**
53
54  | 名称 | 描述 |
55| -------- | -------- |
56| streamId | 用于标识要绑定的流。 |
57| bufferProducer | 生产者句柄。 |
58
59**返回:**
60
61NO_ERROR 表示执行成功。
62
63其他值表示执行失败，具体错误码查看[CamRetCode](camera.md#camretcode)。
64
65**参见:**
66
67[DetachBufferQueue](#detachbufferqueue)
68
69
70### CancelCapture()
71
72
73```
74IStreamOperator::CancelCapture ([in] int captureId)
75```
76
77**描述：**
78
79取消连续捕获。捕获结束时，会调用[OnCaptureEnded](interface_i_stream_operator_callback.md#oncaptureended)来通知调用者捕获的帧计数等信息。
80
81**参数:**
82
83  | 名称 | 描述 |
84| -------- | -------- |
85| captureId | 用于标识要取消的捕获请求。 |
86
87**返回:**
88
89NO_ERROR 表示执行成功。
90
91其他值表示执行失败，具体错误码查看[CamRetCode](camera.md#camretcode)。
92
93**参见:**
94
95[Capture](#capture)
96
97
98### Capture()
99
100
101```
102IStreamOperator::Capture ([in] int captureId, [in] struct CaptureInfo info, [in] boolean isStreaming )
103```
104
105**描述：**
106
107捕获图像。
108
109本接口必须在调用[CommitStreams](#commitstreams)配置流之后调用。 图像捕获有两种模式，分别是连续捕获和单次捕获。
110
111- 连续捕获即触发之后模块内部进行连续的捕获，消费者可以连续收到图像数据，不需要多次调用本接口，若再次调用了本接口， 则停止当前捕获，更新捕获信息，再进行一次新的捕获，多用于预览、录像或者连拍场景。
112
113- 单次捕获即触发之后只捕获一帧图像数据，用于单次拍照场景。捕获启动时，会调用[OnCaptureStarted](interface_i_stream_operator_callback.md#oncapturestarted)来通知调用者捕获已经启动。
114
115- 连续捕获需调用[CancelCapture](#cancelcapture)来停止捕获。捕获结束时，会调用[OnCaptureEnded](interface_i_stream_operator_callback.md#oncaptureended)来通知调用者捕获的帧计数等信息。 [CaptureInfo](_capture_info.md)的[enableShutterCallback_](_capture_info.md#enableshuttercallback)使能OnFrameShutter，使能后每次捕获触发OnFrameShutter。 对于多个流同时捕获的场景，本模块内部保证同时上报多路流捕获数据。
116
117**参数:**
118
119  | 名称 | 描述 |
120| -------- | -------- |
121| captureId | 捕获请求的唯一标识，由调用者指定，调用者需保证在Camera设备打开期间，捕获请求ID是唯一的。 |
122| info | 捕获请求的参数信息，具体信息查看[CaptureInfo](_capture_info.md)。 |
123| isStreaming | 是否连续捕获，true表示连续捕获，否则为单次捕获。 |
124
125**返回:**
126
127NO_ERROR 表示执行成功。
128
129其他值表示执行失败，具体错误码查看[CamRetCode](camera.md#camretcode)。
130
131**参见:**
132
133[OnFrameShutter](interface_i_stream_operator_callback.md#onframeshutter)
134
135
136### ChangeToOfflineStream()
137
138
139```
140IStreamOperator::ChangeToOfflineStream ([in] int[] streamIds, [in] IStreamOperatorCallback callbackObj, [out] IOfflineStreamOperator offlineOperator )
141```
142
143**描述：**
144
145将指定流转换成离线流。
146
147离线流只能由拍照流转换而来，其他流不支持。 一些设备处理能力有限，可能导致拍照时算法处理时间较长，从而引起捕获请求堆积在模块内部，而转换为离线 流之后，可关闭底层设备，由离线流接替，进行后续的处理。
148
149**参数:**
150
151  | 名称 | 描述 |
152| -------- | -------- |
153| streamIds | 用于指定要转换成离线流的流集合。 |
154| callbackObj | 用于设置离线流的回调。 |
155| offlineOperator | 转换后的离线流。 |
156
157**返回:**
158
159NO_ERROR 表示执行成功。
160
161其他值表示执行失败，具体错误码查看[CamRetCode](camera.md#camretcode)。
162
163
164### CommitStreams()
165
166
167```
168IStreamOperator::CommitStreams ([in] enum OperationMode mode, [in] unsigned char[] modeSetting )
169```
170
171**描述：**
172
173配置流。
174
175本接口需在调用[CreateStreams](#createstreams)创建流之后调用。
176
177**参数:**
178
179  | 名称 | 描述 |
180| -------- | -------- |
181| mode | 流运行的模式，支持的模式定义在[OperationMode](camera.md#operationmode)。 |
182| modeSetting | 流的配置参数，包括帧率，ZOOM等信息。ZOOM：变焦 |
183
184**返回:**
185
186NO_ERROR 表示执行成功。
187
188其他值表示执行失败，具体错误码查看[CamRetCode](camera.md#camretcode)。
189
190
191### CreateStreams()
192
193
194```
195IStreamOperator::CreateStreams ([in] struct StreamInfo[] streamInfos)
196```
197
198**描述：**
199
200创建流。
201
202此函数接口依据输入的流信息创建流，调用该接口之前需先通过[IsStreamsSupported](#isstreamssupported)查询HAL是否支持要创建的流。
203
204**参数:**
205
206  | 名称 | 描述 |
207| -------- | -------- |
208| streamInfos | 流信息列表，流信息定义在[StreamInfo](_stream_info.md)。输入的流信息可能会被修改，需通过[GetStreamAttributes](#getstreamattributes)获取最新的流属性。 |
209
210**返回:**
211
212NO_ERROR 表示执行成功。
213
214其他值表示执行失败，具体错误码查看[CamRetCode](camera.md#camretcode)。
215
216
217### DetachBufferQueue()
218
219
220```
221IStreamOperator::DetachBufferQueue ([in] int streamId)
222```
223
224**描述：**
225
226解除生产者句柄和指定流的绑定关系。
227
228**参数:**
229
230  | 名称 | 描述 |
231| -------- | -------- |
232| streamId | 用于标识要解除绑定的流。 |
233
234**返回:**
235
236NO_ERROR 表示执行成功。
237
238其他值表示执行失败，具体错误码查看[CamRetCode](camera.md#camretcode)。
239
240**参见:**
241
242[AttachBufferQueue](#attachbufferqueue)
243
244
245### GetStreamAttributes()
246
247
248```
249IStreamOperator::GetStreamAttributes ([out] struct StreamAttribute[] attributes)
250```
251
252**描述：**
253
254获取流的属性。通过该接口获取的流属性可能会和[CreateStreams](#createstreams)输入的流信息存在差异。
255
256**参数:**
257
258  | 名称 | 描述 |
259| -------- | -------- |
260| attributes | 用于获取流的属性。在调用[CreateStreams](#createstreams)时，通过参数streamInfos携带的流信息可能会被重写。 |
261
262**返回:**
263
264NO_ERROR 表示执行成功。
265
266其他值表示执行失败，具体错误码查看[CamRetCode](camera.md#camretcode)。
267
268
269### IsStreamsSupported()
270
271
272```
273IStreamOperator::IsStreamsSupported ([in] enum OperationMode mode, [in] unsigned char[] modeSetting, [in] struct StreamInfo[] infos, [out] enum StreamSupportType type )
274```
275
276**描述：**
277
278查询是否支持添加参数对应的流。
279
280此函数接口根据输入的运行模式和配置信息以及当前模块中正在运行的流，查询是否支持动态添加流。
281
282- 如果本模块支持在不停止其他流的情况下添加新流，或者即使停止其他流但上层服务或应用不感知， 则通过type参数返回DYNAMIC_SUPPORTED，上层服务或应用可以直接添加新流；
283
284- 如果本模块支持添加新流但需要上层服务或应用先停止所有流的捕获，则通过type参数返回RE_CONFIGURED_REQUIRED;
285
286- 如果不支持添加输入的新流，则返回NOT_SUPPORTED。 此函数需要在调用[CreateStreams](#createstreams)创建流之前调用。
287
288**参数:**
289
290  | 名称 | 描述 |
291| -------- | -------- |
292| mode | 流的使用模式，支持的模式参考[OperationMode](camera.md#operationmode)。 |
293| modeSetting | 流的配置，包括帧率，3A等配置信息。3A：自动曝光 (AE)、自动聚焦 (AF)、自动白平衡 (AWB) |
294| infos | 流的配置信息，具体参考[StreamInfo](_stream_info.md)。 |
295| type | 对动态配置流的支持类型，支持类型定义在[StreamSupportType](camera.md#streamsupporttype)。 |
296
297**返回:**
298
299NO_ERROR 表示执行成功。
300
301其他值表示执行失败，具体错误码查看[CamRetCode](camera.md#camretcode)。
302
303
304### ReleaseStreams()
305
306
307```
308IStreamOperator::ReleaseStreams ([in] int[] streamIds)
309```
310
311**描述：**
312
313释放流。
314
315**参数:**
316
317  | 名称 | 描述 |
318| -------- | -------- |
319| streamIds | 要释放的流ID列表。 |
320
321**返回:**
322
323NO_ERROR 表示执行成功。
324
325其他值表示执行失败，具体错误码查看[CamRetCode](camera.md#camretcode)。
326