harmony 鸿蒙image_receiver_native.h

2025-06-12
浏览 (2)

image_receiver_native.h

概述

声明从native层获取图片数据的方法。

库： libimage_receiver.so

系统能力： SystemCapability.Multimedia.Image.ImageReceiver

起始版本： 12

相关模块： Image_NativeModule

汇总

结构体

|名称|typedef关键字|描述| |–|–|–| |OH_ImageReceiverNative|OH_ImageReceiverNative|OH_ImageReceiverNative是native层封装的图片接收器结构体，OH_ImageReceiverNative结构体不可直接操作，而是采用函数调用方式创建、释放结构体以及操作具体字段。| |OH_ImageReceiverOptions|OH_ImageReceiverOptions|用于定义OH_ImageReceiverOptions数据类型名称。|

函数

函数说明

OH_ImageReceiver_OnCallback()

typedef void (*OH_ImageReceiver_OnCallback)(OH_ImageReceiverNative *receiver)

描述

定义native层图片的回调方法。

起始版本： 12

OH_ImageReceiver_ImageArriveCallback()

typedef void (*OH_ImageReceiver_ImageArriveCallback)(OH_ImageReceiverNative *receiver, void *userData)

描述

ImageArrive事件的回调方法。

起始版本： 20

OH_ImageReceiverOptions_Create()

Image_ErrorCode OH_ImageReceiverOptions_Create(OH_ImageReceiverOptions **options)

描述

创建应用层OH_ImageReceiverOptions对象。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_ImageReceiverOptions **options|表示作为获取结果的 OH_ImageReceiverOptions对象的指针。|

返回：

|类型|说明| |–|–| |Image_ErrorCode|IMAGE_SUCCESS：执行成功。
IMAGE_BAD_PARAMETER：参数错误。
IMAGE_ALLOC_FAILED：申请内存失败。|

OH_ImageReceiverOptions_GetSize()

Image_ErrorCode OH_ImageReceiverOptions_GetSize(OH_ImageReceiverOptions* options, Image_Size* size)

描述

获取OH_ImageReceiverOptions对象的Image_Size信息。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_ImageReceiverOptions* options|表示OH_ImageReceiverOptions对象的指针。| |Image_Size* size|表示作为获取结果的Image_Size对象的指针。|

返回：

|类型|说明| |–|–| |Image_ErrorCode|IMAGE_SUCCESS：执行成功。
IMAGE_BAD_PARAMETER：参数错误。|

OH_ImageReceiverOptions_SetSize()

Image_ErrorCode OH_ImageReceiverOptions_SetSize(OH_ImageReceiverOptions* options, Image_Size size)

描述

设置OH_ImageReceiverOptions对象的Image_Size信息。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_ImageReceiverOptions* options|表示OH_ImageReceiverOptions对象的指针。| |Image_Size size|表示Image_Size对象的指针。|

返回：

|类型|说明| |–|–| |Image_ErrorCode|IMAGE_SUCCESS：执行成功。
IMAGE_BAD_PARAMETER：参数错误。|

OH_ImageReceiverOptions_GetCapacity()

Image_ErrorCode OH_ImageReceiverOptions_GetCapacity(OH_ImageReceiverOptions* options, int32_t* capacity)

描述

获取OH_ImageReceiverOptions对象的图片缓存容量的信息。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_ImageReceiverOptions* options|表示OH_ImageReceiverOptions对象的指针。| |int32_t* capacity|表示作为获取结果的图片缓存容量对象的指针。|

返回：

|类型|说明| |–|–| |Image_ErrorCode|IMAGE_SUCCESS：执行成功。
IMAGE_BAD_PARAMETER：参数错误。|

OH_ImageReceiverOptions_SetCapacity()

Image_ErrorCode OH_ImageReceiverOptions_SetCapacity(OH_ImageReceiverOptions* options, int32_t capacity)

描述

设置OH_ImageReceiverOptions对象的图片缓存容量的信息。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_ImageReceiverOptions* options|表示OH_ImageReceiverOptions对象的指针。| |int32_t capacity|表示图片缓存容量对象的指针。|

返回：

|类型|说明| |–|–| |Image_ErrorCode|IMAGE_SUCCESS：执行成功。
IMAGE_BAD_PARAMETER：参数错误。|

OH_ImageReceiverOptions_Release()

Image_ErrorCode OH_ImageReceiverOptions_Release(OH_ImageReceiverOptions* options)

描述

释放OH_ImageReceiverOptions对象。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_ImageReceiverOptions* options|表示OH_ImageReceiverOptions对象的指针。|

返回：

|类型|说明| |–|–| |Image_ErrorCode|IMAGE_SUCCESS：执行成功。
IMAGE_BAD_PARAMETER：参数错误。|

OH_ImageReceiverNative_Create()

Image_ErrorCode OH_ImageReceiverNative_Create(OH_ImageReceiverOptions* options, OH_ImageReceiverNative** receiver)

描述

创建应用层OH_ImageReceiverNative对象。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_ImageReceiverOptions* options|表示OH_ImageReceiverOptions对象的指针。| |OH_ImageReceiverNative** receiver|表示作为获取结果的OH_ImageReceiverNative对象的指针。|

返回：

|类型|说明| |–|–| |Image_ErrorCode|IMAGE_SUCCESS：执行成功。
IMAGE_BAD_PARAMETER：参数错误。
IMAGE_ALLOC_FAILED：申请内存失败。|

OH_ImageReceiverNative_GetReceivingSurfaceId()

Image_ErrorCode OH_ImageReceiverNative_GetReceivingSurfaceId(OH_ImageReceiverNative* receiver, uint64_t* surfaceId)

描述

通过OH_ImageReceiverNative获取SurfaceId。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_ImageReceiverNative* receiver|表示OH_ImageReceiverNative对象的指针。| |uint64_t* surfaceId|表示作为获取结果的id对象的指针。|

返回：

|类型|说明| |–|–| |Image_ErrorCode|IMAGE_SUCCESS：执行成功。
IMAGE_BAD_PARAMETER：参数错误。
IMAGE_UNKNOWN_ERROR：未知原因错误。|

OH_ImageReceiverNative_ReadLatestImage()

Image_ErrorCode OH_ImageReceiverNative_ReadLatestImage(OH_ImageReceiverNative* receiver, OH_ImageNative** image)

描述

通过OH_ImageReceiverNative获取最新的一张图片。

注意，此接口需要在OH_ImageReceiver_OnCallback回调后调用，才能正常的接收到数据。并且此接口返回的OH_ImageNative使用完毕后需要调用OH_ImageNative_Release方法释放，释放后才可以继续接收新的数据。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_ImageReceiverNative* receiver|表示OH_ImageReceiverNative对象的指针。| |OH_ImageNative** image|获取到的应用层的OH_ImageNative指针对象。|

返回：

|类型|说明| |–|–| |Image_ErrorCode|IMAGE_SUCCESS：执行成功。
IMAGE_BAD_PARAMETER：参数错误。
IMAGE_UNKNOWN_ERROR：未知原因错误。
IMAGE_ALLOC_FAILED：申请内存失败。|

OH_ImageReceiverNative_ReadNextImage()

Image_ErrorCode OH_ImageReceiverNative_ReadNextImage(OH_ImageReceiverNative* receiver, OH_ImageNative** image)

描述

通过OH_ImageReceiverNative获取下一张图片。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_ImageReceiverNative* receiver|表示OH_ImageReceiverNative对象的指针。| |OH_ImageNative** image|获取到的应用层的OH_ImageNative指针对象。|

返回：

OH_ImageReceiverNative_On()

Image_ErrorCode OH_ImageReceiverNative_On(OH_ImageReceiverNative* receiver, OH_ImageReceiver_OnCallback callback)

描述

注册一个OH_ImageReceiver_OnCallback回调事件。

每当接收到新的图片，该回调事件就会响应。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_ImageReceiverNative* receiver|表示OH_ImageReceiverNative对象的指针。| |OH_ImageReceiver_OnCallback callback|表示OH_ImageReceiver_OnCallback事件的回调函数。|

返回：

|类型|说明| |–|–| |Image_ErrorCode|IMAGE_SUCCESS：执行成功。
IMAGE_BAD_PARAMETER：参数错误。|

OH_ImageReceiverNative_Off()

Image_ErrorCode OH_ImageReceiverNative_Off(OH_ImageReceiverNative* receiver)

描述

关闭OH_ImageReceiver_OnCallback回调事件。

关闭被OH_ImageReceiverNative_On开启的回调事件。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_ImageReceiverNative* receiver|表示OH_ImageReceiverNative对象的指针。|

返回：

|类型|说明| |–|–| |Image_ErrorCode|IMAGE_SUCCESS：执行成功。
IMAGE_BAD_PARAMETER：参数错误。|

OH_ImageReceiverNative_GetSize()

Image_ErrorCode OH_ImageReceiverNative_GetSize(OH_ImageReceiverNative* receiver, Image_Size* size)

描述

通过OH_ImageReceiverNative获取ImageReceiver的大小。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_ImageReceiverNative* receiver|表示OH_ImageReceiverNative对象的指针。| |Image_Size* size|表示作为获取结果的Image_Size对象的指针。|

返回：

|类型|说明| |–|–| |Image_ErrorCode|IMAGE_SUCCESS：执行成功。
IMAGE_BAD_PARAMETER：参数错误。|

OH_ImageReceiverNative_GetCapacity()

Image_ErrorCode OH_ImageReceiverNative_GetCapacity(OH_ImageReceiverNative* receiver, int32_t* capacity)

描述

通过OH_ImageReceiverNative获取ImageReceiver的容量。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_ImageReceiverNative* receiver|表示OH_ImageReceiverNative对象的指针。| |int32_t* capacity|表示作为获取结果的图片缓存容量对象的指针。|

返回：

|类型|说明| |–|–| |Image_ErrorCode|IMAGE_SUCCESS：执行成功。
IMAGE_BAD_PARAMETER：参数错误。|

OH_ImageReceiverNative_Release()

Image_ErrorCode OH_ImageReceiverNative_Release(OH_ImageReceiverNative* receiver)

描述

释放Native OH_ImageReceiverNative对象。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_ImageReceiverNative* receiver|表示OH_ImageReceiverNative对象的指针。|

返回：

|类型|说明| |–|–| |Image_ErrorCode|IMAGE_SUCCESS：执行成功。
IMAGE_BAD_PARAMETER：参数错误。|

OH_ImageReceiverNative_OnImageArrive()

Image_ErrorCode OH_ImageReceiverNative_OnImageArrive(OH_ImageReceiverNative *receiver,OH_ImageReceiver_ImageArriveCallback callback, void *userData)

描述

注册OH_ImageReceiver_ImageArriveCallback回调。

起始版本： 20

参数：

返回：

|类型|说明| |–|–| |Image_ErrorCode|IMAGE_SUCCESS：操作成功。
IMAGE_RECEIVER_INVALID_PARAMETER：参数错误。|

OH_ImageReceiverNative_OffImageArrive()

Image_ErrorCode OH_ImageReceiverNative_OffImageArrive(OH_ImageReceiverNative *receiver,OH_ImageReceiver_ImageArriveCallback callback)

描述

注销OH_ImageReceiver_ImageArriveCallback回调。

起始版本： 20

参数：

返回：

|类型|说明| |–|–| |Image_ErrorCode|IMAGE_SUCCESS：操作成功。
IMAGE_RECEIVER_INVALID_PARAMETER：参数错误，receiver或callback未注册。|

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Image Kit（图片处理服务）

harmony 鸿蒙Interface (AuxiliaryPicture)

harmony 鸿蒙Interface (Image)

harmony 鸿蒙Interface (ImageCreator)

harmony 鸿蒙Interface (ImagePacker)

harmony 鸿蒙Interface (ImageReceiver)

harmony 鸿蒙Interface (ImageSource)

harmony 鸿蒙Interface (Metadata)

harmony 鸿蒙Interface (Picture)

harmony 鸿蒙Interface (PixelMap)

0 赞

所属分类： 后端技术
本文标签：
版权声明： 原创文章如转载，请注明本文链接: https://m.seaxiang.com/blog/BBV1uz

harmony 鸿蒙image_receiver_native.h

image_receiver_native.h

概述

汇总

结构体

函数

函数说明

OH_ImageReceiver_OnCallback()

OH_ImageReceiver_ImageArriveCallback()

OH_ImageReceiverOptions_Create()

OH_ImageReceiverOptions_GetSize()

OH_ImageReceiverOptions_SetSize()

OH_ImageReceiverOptions_GetCapacity()

OH_ImageReceiverOptions_SetCapacity()

OH_ImageReceiverOptions_Release()

OH_ImageReceiverNative_Create()

OH_ImageReceiverNative_GetReceivingSurfaceId()

OH_ImageReceiverNative_ReadLatestImage()

OH_ImageReceiverNative_ReadNextImage()

OH_ImageReceiverNative_On()

OH_ImageReceiverNative_Off()

OH_ImageReceiverNative_GetSize()

OH_ImageReceiverNative_GetCapacity()

OH_ImageReceiverNative_Release()

OH_ImageReceiverNative_OnImageArrive()

OH_ImageReceiverNative_OffImageArrive()

你可能感兴趣的鸿蒙文章

热门推荐

标签云

最新文章

本文目录