1# media_asset_capi.h
2
3
4## Overview
5
6Defines the APIs related to media assets.
7
8You can use the APIs to obtain image or video information.
9
10**System capability**: SystemCapability.FileManagement.PhotoAccessHelper.Core
11
12**Library**: libmedia_asset_manager.so
13
14**File to include**: <multimedia/media_library/media_asset_capi.h>
15
16**Since**: 12
17
18**Related module**: [MediaAssetManager](_media_asset_manager.md)
19
20
21## Summary
22
23
24### Functions
25
26| Name| Description|
27| -------- | -------- |
28| [MediaLibrary_ErrorCode](_media_asset_manager.md#medialibrary_errorcode) [OH_MediaAsset_GetUri](_media_asset_manager.md#oh_mediaasset_geturi) ([OH_MediaAsset](_media_asset_manager.md#oh_mediaasset) \*mediaAsset, const char \*\*uri) | Obtains the URI of a media asset. |
29| [MediaLibrary_ErrorCode](_media_asset_manager.md#medialibrary_errorcode) [OH_MediaAsset_GetMediaType](_media_asset_manager.md#oh_mediaasset_getmediatype) ([OH_MediaAsset](_media_asset_manager.md#oh_mediaasset) \*mediaAsset, [MediaLibrary_MediaType](_media_asset_manager.md#medialibrary_mediatype) \*mediaType) | Obtains the type of a media asset. |
30| [MediaLibrary_ErrorCode](_media_asset_manager.md#medialibrary_errorcode) [OH_MediaAsset_GetMediaSubType](_media_asset_manager.md#oh_mediaasset_getmediasubtype) ([OH_MediaAsset](_media_asset_manager.md#oh_mediaasset) \*mediaAsset, [MediaLibrary_MediaSubType](_media_asset_manager.md#medialibrary_mediasubtype) \*mediaSubType) | Obtains the subtype of a media asset. |
31| [MediaLibrary_ErrorCode](_media_asset_manager.md#medialibrary_errorcode) [OH_MediaAsset_GetDisplayName](_media_asset_manager.md#oh_mediaasset_getdisplayname) ([OH_MediaAsset](_media_asset_manager.md#oh_mediaasset) \*mediaAsset, const char \*\*displayName) | Obtains the displayed name of a media asset. |
32| [MediaLibrary_ErrorCode](_media_asset_manager.md#medialibrary_errorcode) [OH_MediaAsset_GetSize](_media_asset_manager.md#oh_mediaasset_getsize) ([OH_MediaAsset](_media_asset_manager.md#oh_mediaasset) \*mediaAsset, uint32_t \*size) | Obtains the size of a media asset file. |
33| [MediaLibrary_ErrorCode](_media_asset_manager.md#medialibrary_errorcode) [OH_MediaAsset_GetDateAdded](_media_asset_manager.md#oh_mediaasset_getdateadded) ([OH_MediaAsset](_media_asset_manager.md#oh_mediaasset) \*mediaAsset, uint32_t \*dateAdded) | Obtains the date when a media asset was added. |
34| [MediaLibrary_ErrorCode](_media_asset_manager.md#medialibrary_errorcode) [OH_MediaAsset_GetDateModified](_media_asset_manager.md#oh_mediaasset_getdatemodified) ([OH_MediaAsset](_media_asset_manager.md#oh_mediaasset) \*mediaAsset, uint32_t \*dateModified) | Obtains the date when a media asset was last modified. |
35| [MediaLibrary_ErrorCode](_media_asset_manager.md#medialibrary_errorcode) [OH_MediaAsset_GetDateTaken](_media_asset_manager.md#oh_mediaasset_getdatetaken) ([OH_MediaAsset](_media_asset_manager.md#oh_mediaasset) \*mediaAsset, uint32_t \*dateTaken) | Obtains the date when a media asset was taken. |
36| [MediaLibrary_ErrorCode](_media_asset_manager.md#medialibrary_errorcode) [OH_MediaAsset_GetDateAddedMs](_media_asset_manager.md#oh_mediaasset_getdateaddedms) ([OH_MediaAsset](_media_asset_manager.md#oh_mediaasset) \*mediaAsset, uint32_t \*dateAddedMs) | Obtains the date when a media asset was added, in ms. |
37| [MediaLibrary_ErrorCode](_media_asset_manager.md#medialibrary_errorcode) [OH_MediaAsset_GetDateModifiedMs](_media_asset_manager.md#oh_mediaasset_getdatemodifiedms) ([OH_MediaAsset](_media_asset_manager.md#oh_mediaasset) \*mediaAsset, uint32_t \*dateModifiedMs) | Obtains the date when a media asset was last modified, in ms. |
38| [MediaLibrary_ErrorCode](_media_asset_manager.md#medialibrary_errorcode) [OH_MediaAsset_GetDuration](_media_asset_manager.md#oh_mediaasset_getduration) ([OH_MediaAsset](_media_asset_manager.md#oh_mediaasset) \*mediaAsset, uint32_t \*duration) | Obtains the duration of a media asset, in ms. |
39| [MediaLibrary_ErrorCode](_media_asset_manager.md#medialibrary_errorcode) [OH_MediaAsset_GetWidth](_media_asset_manager.md#oh_mediaasset_getwidth) ([OH_MediaAsset](_media_asset_manager.md#oh_mediaasset) \*mediaAsset, uint32_t \*width) | Obtains the image width (in pixels) of a media asset. |
40| [MediaLibrary_ErrorCode](_media_asset_manager.md#medialibrary_errorcode) [OH_MediaAsset_GetHeight](_media_asset_manager.md#oh_mediaasset_getheight) ([OH_MediaAsset](_media_asset_manager.md#oh_mediaasset) \*mediaAsset, uint32_t \*height) | Obtains the image height (in pixels) of a media asset. |
41| [MediaLibrary_ErrorCode](_media_asset_manager.md#medialibrary_errorcode) [OH_MediaAsset_GetOrientation](_media_asset_manager.md#oh_mediaasset_getorientation) ([OH_MediaAsset](_media_asset_manager.md#oh_mediaasset) \*mediaAsset, uint32_t \*orientation) | Obtains the orientation of a media asset, in degrees. |
42| [MediaLibrary_ErrorCode](_media_asset_manager.md#medialibrary_errorcode) [OH_MediaAsset_IsFavorite](_media_asset_manager.md#oh_mediaasset_isfavorite) ([OH_MediaAsset](_media_asset_manager.md#oh_mediaasset) \*mediaAsset, uint32_t \*favorite) | Checks whether a media asset is favorited. |
43| [MediaLibrary_ErrorCode](_media_asset_manager.md#medialibrary_errorcode) [OH_MediaAsset_GetTitle](_media_asset_manager.md#oh_mediaasset_gettitle) ([OH_MediaAsset](_media_asset_manager.md#oh_mediaasset) \*mediaAsset, const char \*\*title) | Obtains the title of a media asset. |
44| [MediaLibrary_ErrorCode](_media_asset_manager.md#medialibrary_errorcode) [OH_MediaAsset_Release](_media_asset_manager.md#oh_mediaasset_release) ([OH_MediaAsset](_media_asset_manager.md#oh_mediaasset) \*mediaAsset) | Releases a media asset. |
45