harmony 鸿蒙media_asset_capi.h

  • 2025-06-16
  • 浏览 (6)

media_asset_capi.h

概述

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

库： libmedia_asset_manager.so

引用文件：

系统能力： 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* mediaAsset|OH_MediaAsset实例。| |const char** uri|媒体资产的uri。|

返回：

|类型|说明| |–|–| |MediaLibrary_ErrorCode|MEDIA_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* mediaAsset|OH_MediaAsset实例。| |MediaLibrary_MediaType* mediaType|媒体资源类型。|

返回：

|类型|说明| |–|–| |MediaLibrary_ErrorCode|MEDIA_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* mediaAsset|OH_MediaAsset实例。| |MediaLibrary_MediaSubType* mediaSubType|媒体资源子类型。|

返回：

|类型|说明| |–|–| |MediaLibrary_ErrorCode|MEDIA_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* mediaAsset|OH_MediaAsset实例。| |const char** displayName|媒体资源的显示名称。|

返回：

|类型|说明| |–|–| |MediaLibrary_ErrorCode|MEDIA_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* mediaAsset|OH_MediaAsset实例。| |uint32_t* size|媒体资源的文件大小（以字节为单位）。|

返回：

|类型|说明| |–|–| |MediaLibrary_ErrorCode|MEDIA_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* mediaAsset|OH_MediaAsset实例。| |uint32_t* dateAdded|资产添加日期。该值是添加文件时间距1970年1月1日的秒数值。|

返回：

|类型|说明| |–|–| |MediaLibrary_ErrorCode|MEDIA_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* mediaAsset|OH_MediaAsset实例。| |uint32_t* dateModified|资产的修改日期。该值是修改文件时间距1970年1月1日的秒数值，修改文件名不会改变此值，当文件内容发生修改时才会更新。|

返回：

|类型|说明| |–|–| |MediaLibrary_ErrorCode|MEDIA_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* mediaAsset|OH_MediaAsset实例。| |uint32_t* dateTaken|资产的拍摄日期。该值是文件拍照时间距1970年1月1日的秒数值。|

返回：

|类型|说明| |–|–| |MediaLibrary_ErrorCode|MEDIA_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* mediaAsset|OH_MediaAsset实例。| |uint32_t* dateAddedMs|资产的添加时间（毫秒）。该值是添加文件时间距1970年1月1日的毫秒数值。|

返回：

|类型|说明| |–|–| |MediaLibrary_ErrorCode|MEDIA_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* mediaAsset|OH_MediaAsset实例。| |uint32_t* dateModifiedMs|资产的修改时间（毫秒）。该值是修改文件时间距1970年1月1日的毫秒数值，修改文件名不会改变此值，当文件内容发生修改时才会更新。|

返回：

|类型|说明| |–|–| |MediaLibrary_ErrorCode|MEDIA_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* mediaAsset|OH_MediaAsset实例。| |uint32_t* duration|媒体资源的持续时间（毫秒）。|

返回：

|类型|说明| |–|–| |MediaLibrary_ErrorCode|MEDIA_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* mediaAsset|OH_MediaAsset实例。| |uint32_t* width|媒体资源的图像宽度（像素）。|

返回：

|类型|说明| |–|–| |MediaLibrary_ErrorCode|MEDIA_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* mediaAsset|OH_MediaAsset实例。| |uint32_t* height|媒体资源的图像高度（像素）。|

返回：

|类型|说明| |–|–| |MediaLibrary_ErrorCode|MEDIA_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* mediaAsset|OH_MediaAsset实例。| |uint32_t* orientation|图像的旋转角度，单位为度。|

返回：

|类型|说明| |–|–| |MediaLibrary_ErrorCode|MEDIA_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* mediaAsset|OH_MediaAsset实例。| |uint32_t* favorite|资产的收藏状态。|

返回：

|类型|说明| |–|–| |MediaLibrary_ErrorCode|MEDIA_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* mediaAsset|OH_MediaAsset实例。| |const char** title|媒体资产的标题。|

返回：

|类型|说明| |–|–| |MediaLibrary_ErrorCode|MEDIA_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* mediaAsset|OH_MediaAsset实例。|

返回：

|类型|说明| |–|–| |MediaLibrary_ErrorCode|MEDIA_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

0  赞
  • 所属分类： 后端技术
  • 本文标签： 软件 鸿蒙
  • 版权声明： 原创文章如转载，请注明本文链接: https://www.seaxiang.com/blog/23kI1Z
热门推荐
标签云
Linux Java Spring Spring Boot docker 大数据 前端 生活 maven golang 软件 spring cloud fintech mac vscode 其他 区块链 以太坊 V神 开发者 技术 股票 git greenplum 分布式事务 chrome mysql flink kafka 设计模式 原理 鸿蒙 seo
最新文章
本文目录