media_asset_change_request_capi.h

概述

定义与媒体资产更改请求相关的API。提供更改资产的能力。

库： libmedia_asset_manager.so

引用文件：

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

起始版本： 12

相关模块： MediaAssetManager

汇总

函数

|名称|描述| |–|–| |OH_MediaAssetChangeRequest* OH_MediaAssetChangeRequest_Create(OH_MediaAsset* mediaAsset)|创建OH_MediaAssetChangeRequest实例。| |MediaLibrary_ErrorCode OH_MediaAssetChangeRequest_AddResourceWithUri(OH_MediaAssetChangeRequest* changeRequest,MediaLibrary_ResourceType resourceType, char* fileUri)|通过文件uri添加资源。| |MediaLibrary_ErrorCode OH_MediaAssetChangeRequest_AddResourceWithBuffer(OH_MediaAssetChangeRequest* changeRequest,MediaLibrary_ResourceType resourceType, uint8_t* buffer, uint32_t length)|通过ArrayBuffer数据添加资源。| |MediaLibrary_ErrorCode OH_MediaAssetChangeRequest_GetWriteCacheHandler(OH_MediaAssetChangeRequest* changeRequest,int32_t* fd)|获取临时文件写句柄。| |MediaLibrary_ErrorCode OH_MediaAssetChangeRequest_SaveCameraPhoto(OH_MediaAssetChangeRequest* changeRequest,MediaLibrary_ImageFileType imageFileType)|保存相机拍摄的照片资源。| |MediaLibrary_ErrorCode OH_MediaAssetChangeRequest_DiscardCameraPhoto(OH_MediaAssetChangeRequest* changeRequest)|丢弃相机拍摄的照片资源。| |MediaLibrary_ErrorCode OH_MediaAssetChangeRequest_Release(OH_MediaAssetChangeRequest* changeRequest)|释放OH_MediaAssetChangeRequest实例。|

函数说明

OH_MediaAssetChangeRequest_Create()

OH_MediaAssetChangeRequest* OH_MediaAssetChangeRequest_Create(OH_MediaAsset* mediaAsset)

描述

创建OH_MediaAssetChangeRequest实例。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_MediaAsset* mediaAsset|OH_MediaAsset实例。|

返回：

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

OH_MediaAssetChangeRequest_AddResourceWithUri()

MediaLibrary_ErrorCode OH_MediaAssetChangeRequest_AddResourceWithUri(OH_MediaAssetChangeRequest* changeRequest,MediaLibrary_ResourceType resourceType, char* fileUri)

描述

通过文件uri添加资源。

起始版本： 13

参数：

|参数项|描述| |–|–| |OH_MediaAssetChangeRequest* changeRequest|OH_MediaAssetChangeRequest实例。| |MediaLibrary_ResourceType resourceType|要添加的资源的MediaLibrary_ResourceType。| |char* fileUri|文件uri。|

返回：

|类型|说明| |–|–| |MediaLibrary_ErrorCode|MEDIA_LIBRARY_OK：方法调用成功。
MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：
1. 未指定强制参数。
2. 参数类型不正确。
3. 参数验证失败。
MEDIA_LIBRARY_NO_SUCH_FILE：文件不存在。
MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。
MEDIA_LIBRARY_OPERATION_NOT_SUPPORTED：不支持该操作。|

OH_MediaAssetChangeRequest_AddResourceWithBuffer()

MediaLibrary_ErrorCode OH_MediaAssetChangeRequest_AddResourceWithBuffer(OH_MediaAssetChangeRequest* changeRequest,MediaLibrary_ResourceType resourceType, uint8_t* buffer, uint32_t length)

描述

通过ArrayBuffer数据添加资源。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_MediaAssetChangeRequest* changeRequest|OH_MediaAssetChangeRequest实例。| |MediaLibrary_ResourceType resourceType|要添加的资源的类型。| |uint8_t* buffer|要添加的数据缓冲区。| |uint32_t length|数据缓冲区的长度。|

返回：

|类型|说明| |–|–| |MediaLibrary_ErrorCode|MEDIA_LIBRARY_OK：方法调用成功。
MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：
1. 未指定强制参数。
2. 参数类型不正确。
3. 参数验证失败。
MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。
MEDIA_LIBRARY_OPERATION_NOT_SUPPORTED：不支持该操作。|

OH_MediaAssetChangeRequest_GetWriteCacheHandler()

MediaLibrary_ErrorCode OH_MediaAssetChangeRequest_GetWriteCacheHandler(OH_MediaAssetChangeRequest* changeRequest,int32_t* fd)

描述

获取临时文件写句柄。

需要权限： ohos.permission.WRITE_IMAGEVIDEO

起始版本： 13

参数：

|参数项|描述| |–|–| |OH_MediaAssetChangeRequest* changeRequest|OH_MediaAssetChangeRequest实例。| |int32_t* fd|临时文件写句柄。|

返回：

|类型|说明| |–|–| |MediaLibrary_ErrorCode|MEDIA_LIBRARY_OK：方法调用成功。
MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：
1. 未指定强制参数。
2. 参数类型不正确。
3. 参数验证失败。
MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。
MEDIA_LIBRARY_PERMISSION_DENIED：没有权限。
MEDIA_LIBRARY_OPERATION_NOT_SUPPORTED：不支持该操作。|

OH_MediaAssetChangeRequest_SaveCameraPhoto()

MediaLibrary_ErrorCode OH_MediaAssetChangeRequest_SaveCameraPhoto(OH_MediaAssetChangeRequest* changeRequest,MediaLibrary_ImageFileType imageFileType)

描述

保存相机拍摄的照片资源。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_MediaAssetChangeRequest* changeRequest|OH_MediaAssetChangeRequest实例。| |MediaLibrary_ImageFileType imageFileType|要保存的照片的图像文件类型。|

返回：

|类型|说明| |–|–| |MediaLibrary_ErrorCode|MEDIA_LIBRARY_OK：方法调用成功。
MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：
1. 未指定强制参数。
2. 参数类型不正确。
3. 参数验证失败。
MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。
MEDIA_LIBRARY_OPERATION_NOT_SUPPORTED：不支持该操作。|

OH_MediaAssetChangeRequest_DiscardCameraPhoto()

MediaLibrary_ErrorCode OH_MediaAssetChangeRequest_DiscardCameraPhoto(OH_MediaAssetChangeRequest* changeRequest)

描述

丢弃相机拍摄的照片资源。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_MediaAssetChangeRequest* changeRequest|OH_MediaAssetChangeRequest实例。|

返回：

|类型|说明| |–|–| |MediaLibrary_ErrorCode|MEDIA_LIBRARY_OK：方法调用成功。
MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：
1. 未指定强制参数。
2. 参数类型不正确。
3. 参数验证失败。
MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。
MEDIA_LIBRARY_OPERATION_NOT_SUPPORTED：不支持该操作。|

OH_MediaAssetChangeRequest_Release()

MediaLibrary_ErrorCode OH_MediaAssetChangeRequest_Release(OH_MediaAssetChangeRequest* changeRequest)

描述

释放OH_MediaAssetChangeRequest实例。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_MediaAssetChangeRequest* changeRequest|OH_MediaAssetChangeRequest实例。|

返回：

|类型|说明| |–|–| |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_capi.h

harmony 鸿蒙media_asset_manager_capi.h

harmony 鸿蒙MediaAssetManager

harmony 鸿蒙MediaLibrary_RequestId

harmony 鸿蒙MediaLibrary_RequestOptions

harmony 鸿蒙moving_photo_capi.h

harmony 鸿蒙OH_MediaAsset