media_asset_base_capi.h

概述

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

OH_MediaAssetManager结构体：该结构体提供了从媒体库请求资源的能力。

MediaLibrary_RequestId结构体：在请求媒体库资源时返回的类型。请求Id用于取消请求。

MediaLibrary_DeliveryMode枚举：此枚举定义了请求资源的分发模式。

OH_MediaLibrary_OnDataPrepared函数指针：当所请求的媒体资源准备完成时会触发回调。

MediaLibrary_RequestOptions结构体：此结构体为媒体资源请求策略模式配置项。

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

库： libmedia_asset_manager.so

引用文件： <multimedia/media_library/media_asset_base_capi.h>

起始版本： 12

相关模块：MediaAssetManager

汇总

结构体

名称	描述
struct MediaLibrary_RequestId	定义请求Id。
struct MediaLibrary_RequestOptions	请求策略模式配置项。

类型定义

名称	描述
typedef struct OH_MediaAssetManager OH_MediaAssetManager	定义媒体资产管理器。
typedef struct OH_MediaAssetChangeRequest OH_MediaAssetChangeRequest	定义媒体资产更改请求。
typedef struct OH_MovingPhoto OH_MovingPhoto	定义动态照片。
typedef struct OH_MediaAsset OH_MediaAsset	定义媒体资产。
typedef struct MediaLibrary_RequestId MediaLibrary_RequestId	定义请求Id。
typedef enum MediaLibrary_ErrorCode MediaLibrary_ErrorCode	媒体库错误代码的枚举。
typedef enum MediaLibrary_DeliveryMode MediaLibrary_DeliveryMode	请求资源分发模式。
typedef struct MediaLibrary_RequestOptions MediaLibrary_RequestOptions	请求策略模式配置项。
typedef enum MediaLibrary_MediaType MediaLibrary_MediaType	媒体类型的枚举。
typedef enum MediaLibrary_MediaSubType MediaLibrary_MediaSubType	媒体资源子类型的枚举。
typedef enum MediaLibrary_ResourceType MediaLibrary_ResourceType	资源类型的枚举。
typedef enum MediaLibrary_ImageFileType MediaLibrary_ImageFileType	图像文件类型的枚举。
typedef enum MediaLibrary_MediaQuality MediaLibrary_MediaQuality	媒体资源质量枚举。
typedef enum MediaLibrary_MediaContentType MediaLibrary_MediaContentType	媒体内容类型的枚举。
typedef void(* OH_MediaLibrary_OnDataPrepared) (int32_t result, MediaLibrary_RequestId requestId)	当所请求的媒体资源准备完成时会触发回调。
typedef void(* OH_MediaLibrary_OnImageDataPrepared) (MediaLibrary_ErrorCode result, MediaLibrary_RequestId requestId, MediaLibrary_MediaQuality mediaQuality, MediaLibrary_MediaContentType type, OH_ImageSourceNative *imageSourceNative)	当请求的图像源准备就绪时调用。
typedef void(* OH_MediaLibrary_OnMovingPhotoDataPrepared) (MediaLibrary_ErrorCode result, MediaLibrary_RequestId requestId, MediaLibrary_MediaQuality mediaQuality, MediaLibrary_MediaContentType type, OH_MovingPhoto *movingPhoto)	当请求的动态照片准备就绪时调用。

枚举

名称	描述
MediaLibrary_ErrorCode { MEDIA_LIBRARY_OK = 0, MEDIA_LIBRARY_PERMISSION_DENIED = 201, MEDIA_LIBRARY_PARAMETER_ERROR = 401, MEDIA_LIBRARY_NO_SUCH_FILE = 23800101, MEDIA_LIBRARY_INVALID_DISPLAY_NAME = 23800102, MEDIA_LIBRARY_INVALID_ASSET_URI = 23800103, MEDIA_LIBRARY_INVALID_PHOTO_KEY = 23800104, MEDIA_LIBRARY_OPERATION_NOT_SUPPORTED = 23800201, MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR = 23800301 }	媒体库错误代码的枚举。
MediaLibrary_DeliveryMode { MEDIA_LIBRARY_FAST_MODE = 0, MEDIA_LIBRARY_HIGH_QUALITY_MODE = 1, MEDIA_LIBRARY_BALANCED_MODE = 2 }	请求资源分发模式。
MediaLibrary_MediaType { MEDIA_LIBRARY_IMAGE = 1, MEDIA_LIBRARY_VIDEO = 2 }	媒体类型的枚举。
MediaLibrary_MediaSubType { MEDIA_LIBRARY_DEFAULT = 0, MEDIA_LIBRARY_MOVING_PHOTO = 3, MEDIA_LIBRARY_BURST = 4 }	媒体资源子类型的枚举。
MediaLibrary_ResourceType { MEDIA_LIBRARY_IMAGE_RESOURCE = 1, MEDIA_LIBRARY_VIDEO_RESOURCE = 2 }	资源类型的枚举。
MediaLibrary_ImageFileType { MEDIA_LIBRARY_IMAGE_JPEG = 1 }	图像文件类型的枚举。
MediaLibrary_MediaQuality { MEDIA_LIBRARY_QUALITY_FAST = 1, MEDIA_LIBRARY_QUALITY_FULL = 2 }	媒体资源质量枚举。
MediaLibrary_MediaContentType { MEDIA_LIBRARY_COMPRESSED = 1, MEDIA_LIBRARY_PICTURE_OBJECT = 2 }	媒体内容类型的枚举。