harmony 鸿蒙media_asset_base_capi.h

2025-06-16
浏览 (2)

media_asset_base_capi.h

概述

定义了媒体资产管理器的结构和枚举。

库： libmedia_asset_manager.so

引用文件：

系统能力： SystemCapability.FileManagement.PhotoAccessHelper.Core

起始版本： 12

相关模块： MediaAssetManager

汇总

结构体

枚举

函数

|名称|typedef关键字|描述| |–|–|–| |typedef void (*OH_MediaLibrary_OnDataPrepared)(int32_t result, MediaLibrary_RequestId requestId)|OH_MediaLibrary_OnDataPrepared|当所请求的媒体资源准备完成时会触发回调。| |typedef void (*OH_MediaLibrary_OnImageDataPrepared)(MediaLibrary_ErrorCode result,MediaLibrary_RequestId requestId, MediaLibrary_MediaQuality mediaQuality, MediaLibrary_MediaContentType type,OH_ImageSourceNative* imageSourceNative)|OH_MediaLibrary_OnImageDataPrepared|当请求的图像源准备就绪时会触发回调。| |typedef void (*OH_MediaLibrary_OnMovingPhotoDataPrepared)(MediaLibrary_ErrorCode result,MediaLibrary_RequestId requestId, MediaLibrary_MediaQuality mediaQuality, MediaLibrary_MediaContentType type,OH_MovingPhoto* movingPhoto)|OH_MediaLibrary_OnMovingPhotoDataPrepared|当请求的动态照片准备就绪时会触发回调。|

变量

|名称|描述| |–|–| |static const int32_t UUID_STR_MAX_LENGTH = 37|定义UUID最大长度。这个常量定义了UUID字符串的最大长度。
起始版本： 12|

枚举类型说明

MediaLibrary_ErrorCode

enum MediaLibrary_ErrorCode

描述

媒体库错误代码的枚举。

起始版本： 12

MediaLibrary_DeliveryMode

enum MediaLibrary_DeliveryMode

描述

请求资源分发模式。

快速分发：不考虑资源质量，直接基于现有资源返回。

高质量分发：返回高质量资源，若没有，则触发生成高质量资源，成功后才返回。

均衡分发：若存在高质量资源，则直接返回高质量资源。否则，先返回低质量资源，并触发生成高质量资源，成功后再返回一次高质量资源。

起始版本： 12

MediaLibrary_MediaType

enum MediaLibrary_MediaType

描述

媒体类型的枚举。

起始版本： 12

|枚举项|描述| |–|–| |MEDIA_LIBRARY_IMAGE = 1|图像资产。| |MEDIA_LIBRARY_VIDEO = 2|视频资产。|

MediaLibrary_MediaSubType

enum MediaLibrary_MediaSubType

描述

媒体资源子类型的枚举。

起始版本： 12

MediaLibrary_ResourceType

enum MediaLibrary_ResourceType

描述

资源类型的枚举。

起始版本： 12

|枚举项|描述| |–|–| |MEDIA_LIBRARY_IMAGE_RESOURCE = 1|图像资源。| |MEDIA_LIBRARY_VIDEO_RESOURCE = 2|视频资源。|

MediaLibrary_ImageFileType

enum MediaLibrary_ImageFileType

描述

图像文件类型的枚举。

起始版本： 12

|枚举项|描述| |–|–| |MEDIA_LIBRARY_IMAGE_JPEG = 1|JPEG类型。|

MediaLibrary_MediaQuality

enum MediaLibrary_MediaQuality

描述

媒体资源质量枚举。

此枚举与请求媒体资源时定义的分发模式有关。

快速分发：不考虑资源质量，直接基于现有资源返回。

高质量分发：返回高质量资源，若没有，则触发生成高质量资源，成功后才返回。

均衡分发：若存在高质量资源，则直接返回高质量资源。否则，先返回低质量资源，并触发生成高质量资源，成功后再返回一次高质量资源。

起始版本： 12

|枚举项|描述| |–|–| |MEDIA_LIBRARY_QUALITY_FAST = 1|不考虑资源质量，直接返回的现有资源。| |MEDIA_LIBRARY_QUALITY_FULL = 2|高质量资源。|

MediaLibrary_MediaContentType

enum MediaLibrary_MediaContentType

描述

媒体内容类型的枚举。

起始版本： 12

|枚举项|描述| |–|–| |MEDIA_LIBRARY_COMPRESSED = 1|压缩媒体内容类型。| |MEDIA_LIBRARY_PICTURE_OBJECT = 2|图片对象媒体内容类型。|

函数说明

OH_MediaLibrary_OnDataPrepared()

typedef void (*OH_MediaLibrary_OnDataPrepared)(int32_t result, MediaLibrary_RequestId requestId)

描述

当所请求的媒体资源准备完成时会触发回调。

起始版本： 12

参数：

|参数项|描述| |–|–| |int32_t result|请求资源处理的结果。| | MediaLibrary_RequestId requestId|请求Id。|

OH_MediaLibrary_OnImageDataPrepared()

typedef void (*OH_MediaLibrary_OnImageDataPrepared)(MediaLibrary_ErrorCode result,MediaLibrary_RequestId requestId, MediaLibrary_MediaQuality mediaQuality, MediaLibrary_MediaContentType type,OH_ImageSourceNative* imageSourceNative)

描述

当请求的图像源准备就绪时会触发回调。

起始版本： 12

参数：

OH_MediaLibrary_OnMovingPhotoDataPrepared()

typedef void (*OH_MediaLibrary_OnMovingPhotoDataPrepared)(MediaLibrary_ErrorCode result,MediaLibrary_RequestId requestId, MediaLibrary_MediaQuality mediaQuality, MediaLibrary_MediaContentType type,OH_MovingPhoto* movingPhoto)

描述

当请求的动态照片准备就绪时会触发回调。

起始版本： 13

参数：