openharmony 鸿蒙 capi-media-asset-capi-h

2025-06-16 浏览 (1)

media_asset_capi.h

概述

定义与媒体资源相关的API。提供获取图像或视频信息的能力。

库： libmedia_asset_manager.so

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

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

起始版本： 12

相关模块： MediaAssetManager

汇总

函数

名称描述
MediaLibrary_ErrorCode OH_MediaAsset_GetUri(OH_MediaAsset* mediaAsset, const char** uri)获取媒体资产的uri。
MediaLibrary_ErrorCode OH_MediaAsset_GetMediaType(OH_MediaAsset* mediaAsset, MediaLibrary_MediaType* mediaType)获取媒体资源类型。
MediaLibrary_ErrorCode OH_MediaAsset_GetMediaSubType(OH_MediaAsset* mediaAsset,MediaLibrary_MediaSubType* mediaSubType)获取媒体资源子类型。
MediaLibrary_ErrorCode OH_MediaAsset_GetDisplayName(OH_MediaAsset* mediaAsset, const char** displayName)获取媒体资源的显示名称。
MediaLibrary_ErrorCode OH_MediaAsset_GetSize(OH_MediaAsset* mediaAsset, uint32_t* size)获取媒体资产的文件大小。
MediaLibrary_ErrorCode OH_MediaAsset_GetDateAdded(OH_MediaAsset* mediaAsset, uint32_t* dateAdded)获取资产添加日期。
MediaLibrary_ErrorCode OH_MediaAsset_GetDateModified(OH_MediaAsset* mediaAsset, uint32_t* dateModified)获取资产的修改日期。
MediaLibrary_ErrorCode OH_MediaAsset_GetDateTaken(OH_MediaAsset* mediaAsset, uint32_t* dateTaken)获取资产的拍摄日期。
MediaLibrary_ErrorCode OH_MediaAsset_GetDateAddedMs(OH_MediaAsset* mediaAsset, uint32_t* dateAddedMs)获取资产的添加时间（毫秒）。
MediaLibrary_ErrorCode OH_MediaAsset_GetDateModifiedMs(OH_MediaAsset* mediaAsset, uint32_t* dateModifiedMs)获取资产的修改时间（毫秒）。
MediaLibrary_ErrorCode OH_MediaAsset_GetDuration(OH_MediaAsset* mediaAsset, uint32_t* duration)获取媒体资源的持续时间（毫秒）。
MediaLibrary_ErrorCode OH_MediaAsset_GetWidth(OH_MediaAsset* mediaAsset, uint32_t* width)获取媒体资源的图像宽度（像素）。
MediaLibrary_ErrorCode OH_MediaAsset_GetHeight(OH_MediaAsset* mediaAsset, uint32_t* height)获取媒体资源的图像高度（像素）。
MediaLibrary_ErrorCode OH_MediaAsset_GetOrientation(OH_MediaAsset* mediaAsset, uint32_t* orientation)获取图像的旋转角度，单位为度。
MediaLibrary_ErrorCode OH_MediaAsset_IsFavorite(OH_MediaAsset* mediaAsset, uint32_t* favorite)获取资产的收藏状态。
MediaLibrary_ErrorCode OH_MediaAsset_GetTitle(OH_MediaAsset* mediaAsset, const char** title)获取媒体资产的标题。
MediaLibrary_ErrorCode OH_MediaAsset_Release(OH_MediaAsset* mediaAsset)释放媒体资产。

函数说明

OH_MediaAsset_GetUri()

MediaLibrary_ErrorCode OH_MediaAsset_GetUri(OH_MediaAsset* mediaAsset, const char** uri)

描述

获取媒体资产的uri。

起始版本： 12

参数：

参数项描述
OH_MediaAsset* mediaAssetOH_MediaAsset实例。
const char** uri媒体资产的uri。

返回：

类型说明
MediaLibrary_ErrorCodeMEDIA_LIBRARY_OK：方法调用成功。
MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：
1. 未指定强制参数。
2. 参数类型不正确。
3. 参数验证失败。
MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。

OH_MediaAsset_GetMediaType()

MediaLibrary_ErrorCode OH_MediaAsset_GetMediaType(OH_MediaAsset* mediaAsset, MediaLibrary_MediaType* mediaType)

描述

获取媒体资源类型。

起始版本： 13

参数：

参数项描述
OH_MediaAsset* mediaAssetOH_MediaAsset实例。
MediaLibrary_MediaType* mediaType媒体资源类型。

返回：

类型说明
MediaLibrary_ErrorCodeMEDIA_LIBRARY_OK：方法调用成功。
MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：
1. 未指定强制参数。
2. 参数类型不正确。
3. 参数验证失败。
MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。

OH_MediaAsset_GetMediaSubType()

MediaLibrary_ErrorCode OH_MediaAsset_GetMediaSubType(OH_MediaAsset* mediaAsset,MediaLibrary_MediaSubType* mediaSubType)

描述

获取媒体资源子类型。

起始版本： 13

参数：

参数项描述
OH_MediaAsset* mediaAssetOH_MediaAsset实例。
MediaLibrary_MediaSubType* mediaSubType媒体资源子类型。

返回：

类型说明
MediaLibrary_ErrorCodeMEDIA_LIBRARY_OK：方法调用成功。
MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：
1. 未指定强制参数。
2. 参数类型不正确。
3. 参数验证失败。
MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。

OH_MediaAsset_GetDisplayName()

MediaLibrary_ErrorCode OH_MediaAsset_GetDisplayName(OH_MediaAsset* mediaAsset, const char** displayName)

描述

获取媒体资源的显示名称。

起始版本： 12

参数：

参数项描述
OH_MediaAsset* mediaAssetOH_MediaAsset实例。
const char** displayName媒体资源的显示名称。

返回：

类型说明
MediaLibrary_ErrorCodeMEDIA_LIBRARY_OK：方法调用成功。
MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：
1. 未指定强制参数。
2. 参数类型不正确。
3. 参数验证失败。
MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。

OH_MediaAsset_GetSize()

MediaLibrary_ErrorCode OH_MediaAsset_GetSize(OH_MediaAsset* mediaAsset, uint32_t* size)

描述

获取媒体资产的文件大小。

起始版本： 12

参数：

参数项描述
OH_MediaAsset* mediaAssetOH_MediaAsset实例。
uint32_t* size媒体资源的文件大小（以字节为单位）。

返回：

类型说明
MediaLibrary_ErrorCodeMEDIA_LIBRARY_OK：方法调用成功。
MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：
1. 未指定强制参数。
2. 参数类型不正确。
3. 参数验证失败。
MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。

OH_MediaAsset_GetDateAdded()

MediaLibrary_ErrorCode OH_MediaAsset_GetDateAdded(OH_MediaAsset* mediaAsset, uint32_t* dateAdded)

描述

获取资产添加日期。

起始版本： 13

参数：

参数项描述
OH_MediaAsset* mediaAssetOH_MediaAsset实例。
uint32_t* dateAdded资产添加日期。该值是添加文件时间距1970年1月1日的秒数值。

返回：

类型说明
MediaLibrary_ErrorCodeMEDIA_LIBRARY_OK：方法调用成功。
MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：
1. 未指定强制参数。
2. 参数类型不正确。
3. 参数验证失败。
MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。

OH_MediaAsset_GetDateModified()

MediaLibrary_ErrorCode OH_MediaAsset_GetDateModified(OH_MediaAsset* mediaAsset, uint32_t* dateModified)

描述

获取资产的修改日期。

起始版本： 13

参数：

参数项描述
OH_MediaAsset* mediaAssetOH_MediaAsset实例。
uint32_t* dateModified资产的修改日期。该值是修改文件时间距1970年1月1日的秒数值，修改文件名不会改变此值，当文件内容发生修改时才会更新。

返回：

类型说明
MediaLibrary_ErrorCodeMEDIA_LIBRARY_OK：方法调用成功。
MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：
1. 未指定强制参数。
2. 参数类型不正确。
3. 参数验证失败。
MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。

OH_MediaAsset_GetDateTaken()

MediaLibrary_ErrorCode OH_MediaAsset_GetDateTaken(OH_MediaAsset* mediaAsset, uint32_t* dateTaken)

描述

获取资产的拍摄日期。

起始版本： 13

参数：

参数项描述
OH_MediaAsset* mediaAssetOH_MediaAsset实例。
uint32_t* dateTaken资产的拍摄日期。该值是文件拍照时间距1970年1月1日的秒数值。

返回：

类型说明
MediaLibrary_ErrorCodeMEDIA_LIBRARY_OK：方法调用成功。
MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：
1. 未指定强制参数。
2. 参数类型不正确。
3. 参数验证失败。
MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。

OH_MediaAsset_GetDateAddedMs()

MediaLibrary_ErrorCode OH_MediaAsset_GetDateAddedMs(OH_MediaAsset* mediaAsset, uint32_t* dateAddedMs)

描述

获取资产的添加时间（毫秒）。

起始版本： 13

参数：

参数项描述
OH_MediaAsset* mediaAssetOH_MediaAsset实例。
uint32_t* dateAddedMs资产的添加时间（毫秒）。该值是添加文件时间距1970年1月1日的毫秒数值。

返回：

类型说明
MediaLibrary_ErrorCodeMEDIA_LIBRARY_OK：方法调用成功。
MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：
1. 未指定强制参数。
2. 参数类型不正确。
3. 参数验证失败。
MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。

OH_MediaAsset_GetDateModifiedMs()

MediaLibrary_ErrorCode OH_MediaAsset_GetDateModifiedMs(OH_MediaAsset* mediaAsset, uint32_t* dateModifiedMs)

描述

获取资产的修改时间（毫秒）。

起始版本： 12

参数：

参数项描述
OH_MediaAsset* mediaAssetOH_MediaAsset实例。
uint32_t* dateModifiedMs资产的修改时间（毫秒）。该值是修改文件时间距1970年1月1日的毫秒数值，修改文件名不会改变此值，当文件内容发生修改时才会更新。

返回：

类型说明
MediaLibrary_ErrorCodeMEDIA_LIBRARY_OK：方法调用成功。
MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：
1. 未指定强制参数。
2. 参数类型不正确。
3. 参数验证失败。
MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。

OH_MediaAsset_GetDuration()

MediaLibrary_ErrorCode OH_MediaAsset_GetDuration(OH_MediaAsset* mediaAsset, uint32_t* duration)

描述

获取媒体资源的持续时间（毫秒）。

起始版本： 13

参数：

参数项描述
OH_MediaAsset* mediaAssetOH_MediaAsset实例。
uint32_t* duration媒体资源的持续时间（毫秒）。

返回：

类型说明
MediaLibrary_ErrorCodeMEDIA_LIBRARY_OK：方法调用成功。
MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：
1. 未指定强制参数。
2. 参数类型不正确。
3. 参数验证失败。
MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。

OH_MediaAsset_GetWidth()

MediaLibrary_ErrorCode OH_MediaAsset_GetWidth(OH_MediaAsset* mediaAsset, uint32_t* width)

描述

获取媒体资源的图像宽度（像素）。

起始版本： 12

参数：

参数项描述
OH_MediaAsset* mediaAssetOH_MediaAsset实例。
uint32_t* width媒体资源的图像宽度（像素）。

返回：

类型说明
MediaLibrary_ErrorCodeMEDIA_LIBRARY_OK：方法调用成功。
MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：
1. 未指定强制参数。
2. 参数类型不正确。
3. 参数验证失败。
MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。

OH_MediaAsset_GetHeight()

MediaLibrary_ErrorCode OH_MediaAsset_GetHeight(OH_MediaAsset* mediaAsset, uint32_t* height)

描述

获取媒体资源的图像高度（像素）。

起始版本： 12

参数：

参数项描述
OH_MediaAsset* mediaAssetOH_MediaAsset实例。
uint32_t* height媒体资源的图像高度（像素）。

返回：

类型说明
MediaLibrary_ErrorCodeMEDIA_LIBRARY_OK：方法调用成功。
MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：
1. 未指定强制参数。
2. 参数类型不正确。
3. 参数验证失败。
MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。

OH_MediaAsset_GetOrientation()

MediaLibrary_ErrorCode OH_MediaAsset_GetOrientation(OH_MediaAsset* mediaAsset, uint32_t* orientation)

描述

获取图像的旋转角度，单位为度。

起始版本： 12

参数：

参数项描述
OH_MediaAsset* mediaAssetOH_MediaAsset实例。
uint32_t* orientation图像的旋转角度，单位为度。

返回：

类型说明
MediaLibrary_ErrorCodeMEDIA_LIBRARY_OK：方法调用成功。
MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：
1. 未指定强制参数。
2. 参数类型不正确。
3. 参数验证失败。
MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。

OH_MediaAsset_IsFavorite()

MediaLibrary_ErrorCode OH_MediaAsset_IsFavorite(OH_MediaAsset* mediaAsset, uint32_t* favorite)

描述

获取资产的收藏状态。

起始版本： 13

参数：

参数项描述
OH_MediaAsset* mediaAssetOH_MediaAsset实例。
uint32_t* favorite资产的收藏状态。

返回：

类型说明
MediaLibrary_ErrorCodeMEDIA_LIBRARY_OK：方法调用成功。
MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：
1. 未指定强制参数。
2. 参数类型不正确。
3. 参数验证失败。
MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。

OH_MediaAsset_GetTitle()

MediaLibrary_ErrorCode OH_MediaAsset_GetTitle(OH_MediaAsset* mediaAsset, const char** title)

描述

获取媒体资产的标题。

起始版本： 13

参数：

参数项描述
OH_MediaAsset* mediaAssetOH_MediaAsset实例。
const char** title媒体资产的标题。

返回：

类型说明
MediaLibrary_ErrorCodeMEDIA_LIBRARY_OK：方法调用成功。
MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：
1. 未指定强制参数。
2. 参数类型不正确。
3. 参数验证失败。
MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。

OH_MediaAsset_Release()

MediaLibrary_ErrorCode OH_MediaAsset_Release(OH_MediaAsset* mediaAsset)

描述

释放媒体资产。

起始版本： 12

参数：

参数项描述
OH_MediaAsset* mediaAssetOH_MediaAsset实例。

返回：

类型说明
MediaLibrary_ErrorCodeMEDIA_LIBRARY_OK：方法调用成功。
MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：
1. 未指定强制参数。
2. 参数类型不正确。
3. 参数验证失败。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Media Library Kit（媒体文件管理服务）

harmony 鸿蒙media_access_helper_capi.h

harmony 鸿蒙media_asset_base_capi.h

harmony 鸿蒙media_asset_change_request_capi.h

harmony 鸿蒙media_asset_manager_capi.h

harmony 鸿蒙MediaAssetManager

harmony 鸿蒙MediaLibrary_RequestId

harmony 鸿蒙MediaLibrary_RequestOptions

harmony 鸿蒙moving_photo_capi.h

harmony 鸿蒙OH_MediaAsset

  • 所属分类： 后端技术
  • 本文标签： 软件 鸿蒙
  • 版权声明： 本文链接 https://seaxiang.com/blog/23kI1Z