harmony 鸿蒙IStreamOperator

2025-06-16
浏览 (187)

IStreamOperator

概述

定义Camera设备流操作。

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

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

起始版本： 4.0

相关模块：Camera

汇总

Public 成员函数

名称	描述
IsStreamsSupported_V1_1 ([in] enum OperationMode_V1_1 mode, [in] unsigned char[] modeSetting, [in] struct StreamInfo_V1_1[] infos, [out] enum StreamSupportType type)	查询是否支持添加参数对应的流。
CreateStreams_V1_1 ([in] struct StreamInfo_V1_1[] streamInfos)	创建流。
CommitStreams_V1_1 ([in] enum OperationMode_V1_1 mode, [in] unsigned char[] modeSetting)	配置流。

成员函数说明

CommitStreams_V1_1()

IStreamOperator::CommitStreams_V1_1 ([in] enum OperationMode_V1_1 mode, [in] unsigned char[] modeSetting)

描述

配置流。

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

起始版本： 4.0

参数:

名称	描述
mode	流运行的模式，支持的模式定义在OperationMode_V1_1。
modeSetting	流的配置参数，包括帧率，ZOOM等信息。ZOOM：变焦。

返回：

NO_ERROR 表示执行成功。

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

CreateStreams_V1_1()

IStreamOperator::CreateStreams_V1_1 ([in] struct StreamInfo_V1_1[] streamInfos)

描述

创建流。

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

起始版本： 4.0

参数:

名称	描述
streamInfos	流信息列表，流信息定义在StreamInfo。输入的流信息可能会被修改，需通过 GetStreamAttributes获取最新的流属性。

返回：

NO_ERROR 表示执行成功。

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

IsStreamsSupported_V1_1()

IStreamOperator::IsStreamsSupported_V1_1 ([in] enum OperationMode_V1_1 mode, [in] unsigned char[] modeSetting, [in] struct StreamInfo_V1_1[] infos, [out] enum StreamSupportType type)

描述

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

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

如果本模块支持在不停止其他流的情况下添加新流，或者即使停止其他流但上层服务或应用不感知，则通过type参数返回DYNAMIC_SUPPORTED，上层服务或应用可以直接添加新流；
如果本模块支持添加新流但需要上层服务或应用先停止所有流的捕获，则通过type参数返回RE_CONFIGURED_REQUIRED;
如果不支持添加输入的新流，则返回NOT_SUPPORTED。

此函数需要在调用CommitStreams_V1_1创建流之前调用。

起始版本： 4.0

参数:

名称	描述
mode	流的使用模式，支持的模式参考OperationMode_V1_1。
modeSetting	流的配置，包括帧率，3A等配置信息。3A：自动曝光 (AE)、自动聚焦 (AF)、自动白平衡 (AWB)。
infos	流的配置信息，具体参考StreamInfo。
type	对动态配置流的支持类型，支持类型定义在StreamSupportType。