IStreamOperator

概述

定义Camera设备流操作。

对Camera设备执行流的创建、配置与添加参数、属性获取、句柄绑定与解除、图像捕获与取消、流的转换以及流释放操作。

流是指从底层设备输出，经本模块内部各环节处理，最终传递到上层服务或者应用的一组数据序列。本模块支持的流的类型有预览流，录像流，拍照流等，更多类型可查看StreamIntent。

相关模块:

Camera

汇总

Public 成员函数

成员函数说明

AttachBufferQueue()

IStreamOperator::AttachBufferQueue ([in] int streamId, [in] BufferProducerSequenceable bufferProducer )

描述:

绑定生产者句柄和指定流。

如果在CreateStreams创建流时已经指定了生产者句柄，则不需要调用该接口。如果需要重新绑定， 需先调用DetachBufferQueue进行解绑，然后再绑定。 对于一些IOT设备，可能不需要或者不支持预览流的图像数据缓存流转，那么不需要绑定生产者句柄， 此时在创建流时CreateStreams的StreamInfo参数的生产者句柄bufferQueue_为空，而 tunneledMode_需设置为false。

参数:

返回:

NO_ERROR 表示执行成功。

其他值表示执行失败，具体错误码查看CamRetCode。

参见:

DetachBufferQueue

CancelCapture()

IStreamOperator::CancelCapture ([in] int captureId)

描述:

取消连续捕获。捕获结束时，会调用OnCaptureEnded来通知调用者捕获的帧计数等信息。

参数:

返回:

NO_ERROR 表示执行成功。

其他值表示执行失败，具体错误码查看CamRetCode。

参见:

Capture

Capture()

IStreamOperator::Capture ([in] int captureId, [in] struct CaptureInfo info, [in] boolean isStreaming )

描述:

捕获图像。

本接口必须在调用CommitStreams配置流之后调用。 图像捕获有两种模式，分别是连续捕获和单次捕获。

• 连续捕获即触发之后模块内部进行连续的捕获，消费者可以连续收到图像数据，不需要多次调用本接口，若再次调用了本接口， 则停止当前捕获，更新捕获信息，再进行一次新的捕获，多用于预览、录像或者连拍场景。

• 单次捕获即触发之后只捕获一帧图像数据，用于单次拍照场景。捕获启动时，会调用OnCaptureStarted来通知调用者捕获已经启动。

• 连续捕获需调用CancelCapture来停止捕获。捕获结束时，会调用OnCaptureEnded来通知调用者捕获的帧计数等信息。 CaptureInfo的enableShutterCallback_使能OnFrameShutter，使能后每次捕获触发OnFrameShutter。 对于多个流同时捕获的场景，本模块内部保证同时上报多路流捕获数据。

参数:

返回:

NO_ERROR 表示执行成功。

其他值表示执行失败，具体错误码查看CamRetCode。

参见:

OnFrameShutter

ChangeToOfflineStream()

IStreamOperator::ChangeToOfflineStream ([in] int[] streamIds, [in] IStreamOperatorCallback callbackObj, [out] IOfflineStreamOperator offlineOperator )

描述:

将指定流转换成离线流。

离线流只能由拍照流转换而来，其他流不支持。 一些设备处理能力有限，可能导致拍照时算法处理时间较长，从而引起捕获请求堆积在模块内部，而转换为离线 流之后，可关闭底层设备，由离线流接替，进行后续的处理。

参数:

返回:

NO_ERROR 表示执行成功。

其他值表示执行失败，具体错误码查看CamRetCode。

CommitStreams()

IStreamOperator::CommitStreams ([in] enum OperationMode mode, [in] unsigned char[] modeSetting )

描述:

配置流。

本接口需在调用CreateStreams创建流之后调用。

参数:

返回:

NO_ERROR 表示执行成功。

其他值表示执行失败，具体错误码查看CamRetCode。

CreateStreams()

IStreamOperator::CreateStreams ([in] struct StreamInfo[] streamInfos)

描述:

创建流。

此函数接口依据输入的流信息创建流，调用该接口之前需先通过IsStreamsSupported查询HAL是否支持要创建的流。

参数:

返回:

NO_ERROR 表示执行成功。

其他值表示执行失败，具体错误码查看CamRetCode。

DetachBufferQueue()

IStreamOperator::DetachBufferQueue ([in] int streamId)

描述:

解除生产者句柄和指定流的绑定关系。

参数:

返回:

NO_ERROR 表示执行成功。

其他值表示执行失败，具体错误码查看CamRetCode。

参见:

AttachBufferQueue

GetStreamAttributes()

IStreamOperator::GetStreamAttributes ([out] struct StreamAttribute[] attributes)

描述:

获取流的属性。通过该接口获取的流属性可能会和CreateStreams输入的流信息存在差异。

参数:

返回:

NO_ERROR 表示执行成功。

其他值表示执行失败，具体错误码查看CamRetCode。

IsStreamsSupported()

IStreamOperator::IsStreamsSupported ([in] enum OperationMode mode, [in] unsigned char[] modeSetting, [in] struct StreamInfo[] infos, [out] enum StreamSupportType type )

描述:

查询是否支持添加参数对应的流。

此函数接口根据输入的运行模式和配置信息以及当前模块中正在运行的流，查询是否支持动态添加流。

• 如果本模块支持在不停止其他流的情况下添加新流，或者即使停止其他流但上层服务或应用不感知， 则通过type参数返回DYNAMIC_SUPPORTED，上层服务或应用可以直接添加新流；

• 如果本模块支持添加新流但需要上层服务或应用先停止所有流的捕获，则通过type参数返回RE_CONFIGURED_REQUIRED;

• 如果不支持添加输入的新流，则返回NOT_SUPPORTED。 此函数需要在调用CreateStreams创建流之前调用。

参数:

返回:

NO_ERROR 表示执行成功。

其他值表示执行失败，具体错误码查看CamRetCode。

ReleaseStreams()

IStreamOperator::ReleaseStreams ([in] int[] streamIds)

描述:

释放流。

参数:

返回:

NO_ERROR 表示执行成功。

其他值表示执行失败，具体错误码查看CamRetCode。