1# media_asset_change_request_capi.h 2 3## 概述 4 5定义与媒体资产更改请求相关的API。提供更改资产的能力。 6 7**库：** libmedia_asset_manager.so 8 9**引用文件：** <multimedia/media_library/media_asset_change_request_capi.h> 10 11**系统能力：** SystemCapability.FileManagement.PhotoAccessHelper.Core 12 13**起始版本：** 12 14 15**相关模块：** [MediaAssetManager](capi-mediaassetmanager.md) 16 17## 汇总 18 19### 函数 20 21| 名称 | 描述 | 22| -- | -- | 23| [OH_MediaAssetChangeRequest* OH_MediaAssetChangeRequest_Create(OH_MediaAsset* mediaAsset)](#oh_mediaassetchangerequest_create) | 创建[OH_MediaAssetChangeRequest](capi-mediaassetmanager-oh-mediaassetchangerequest.md)实例。 | 24| [MediaLibrary_ErrorCode OH_MediaAssetChangeRequest_AddResourceWithUri(OH_MediaAssetChangeRequest* changeRequest, MediaLibrary_ResourceType resourceType, char* fileUri)](#oh_mediaassetchangerequest_addresourcewithuri) | 通过文件uri添加资源。 | 25| [MediaLibrary_ErrorCode OH_MediaAssetChangeRequest_AddResourceWithBuffer(OH_MediaAssetChangeRequest* changeRequest, MediaLibrary_ResourceType resourceType, uint8_t* buffer, uint32_t length)](#oh_mediaassetchangerequest_addresourcewithbuffer) | 通过ArrayBuffer数据添加资源。 | 26| [MediaLibrary_ErrorCode OH_MediaAssetChangeRequest_GetWriteCacheHandler(OH_MediaAssetChangeRequest* changeRequest, int32_t* fd)](#oh_mediaassetchangerequest_getwritecachehandler) | 获取临时文件写句柄。 | 27| [MediaLibrary_ErrorCode OH_MediaAssetChangeRequest_SaveCameraPhoto(OH_MediaAssetChangeRequest* changeRequest, MediaLibrary_ImageFileType imageFileType)](#oh_mediaassetchangerequest_savecameraphoto) | 保存相机拍摄的照片资源。 | 28| [MediaLibrary_ErrorCode OH_MediaAssetChangeRequest_DiscardCameraPhoto(OH_MediaAssetChangeRequest* changeRequest)](#oh_mediaassetchangerequest_discardcameraphoto) | 丢弃相机拍摄的照片资源。 | 29| [MediaLibrary_ErrorCode OH_MediaAssetChangeRequest_Release(OH_MediaAssetChangeRequest* changeRequest)](#oh_mediaassetchangerequest_release) | 释放[OH_MediaAssetChangeRequest](capi-mediaassetmanager-oh-mediaassetchangerequest.md)实例。 | 30 31## 函数说明 32 33### OH_MediaAssetChangeRequest_Create() 34 35``` 36OH_MediaAssetChangeRequest* OH_MediaAssetChangeRequest_Create(OH_MediaAsset* mediaAsset) 37``` 38 39**描述** 40 41创建[OH_MediaAssetChangeRequest](capi-mediaassetmanager-oh-mediaassetchangerequest.md)实例。 42 43**起始版本：** 12 44 45 46**参数：** 47 48| 参数项 | 描述 | 49| -- | -- | 50| [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)* mediaAsset | [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)实例。 | 51 52**返回：** 53 54| 类型 | 说明 | 55| -- | -- | 56| [OH_MediaAssetChangeRequest](capi-mediaassetmanager-oh-mediaassetchangerequest.md)* | MEDIA_LIBRARY_OK：方法调用成功。<br> MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：<br> 1. 未指定强制参数。<br> 2. 参数类型不正确。<br> 3. 参数验证失败。<br> MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。 | 57 58### OH_MediaAssetChangeRequest_AddResourceWithUri() 59 60``` 61MediaLibrary_ErrorCode OH_MediaAssetChangeRequest_AddResourceWithUri(OH_MediaAssetChangeRequest* changeRequest,MediaLibrary_ResourceType resourceType, char* fileUri) 62``` 63 64**描述** 65 66通过文件uri添加资源。 67 68**起始版本：** 13 69 70 71**参数：** 72 73| 参数项 | 描述 | 74| -- | -- | 75| [OH_MediaAssetChangeRequest](capi-mediaassetmanager-oh-mediaassetchangerequest.md)* changeRequest | [OH_MediaAssetChangeRequest](capi-mediaassetmanager-oh-mediaassetchangerequest.md)实例。 | 76| [MediaLibrary_ResourceType](capi-media-asset-base-capi-h.md#medialibrary_resourcetype) resourceType | 要添加的资源的[MediaLibrary_ResourceType](capi-media-asset-base-capi-h.md#medialibrary_resourcetype)。 | 77| char* fileUri | 文件uri。 | 78 79**返回：** 80 81| 类型 | 说明 | 82| -- | -- | 83| [MediaLibrary_ErrorCode](capi-media-asset-base-capi-h.md#medialibrary_errorcode) | MEDIA_LIBRARY_OK：方法调用成功。<br> MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：<br> 1. 未指定强制参数。<br> 2. 参数类型不正确。<br> 3. 参数验证失败。<br> MEDIA_LIBRARY_NO_SUCH_FILE：文件不存在。<br> MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。<br> MEDIA_LIBRARY_OPERATION_NOT_SUPPORTED：不支持该操作。 | 84 85### OH_MediaAssetChangeRequest_AddResourceWithBuffer() 86 87``` 88MediaLibrary_ErrorCode OH_MediaAssetChangeRequest_AddResourceWithBuffer(OH_MediaAssetChangeRequest* changeRequest,MediaLibrary_ResourceType resourceType, uint8_t* buffer, uint32_t length) 89``` 90 91**描述** 92 93通过ArrayBuffer数据添加资源。 94 95**起始版本：** 12 96 97 98**参数：** 99 100| 参数项 | 描述 | 101| -- | -- | 102| [OH_MediaAssetChangeRequest](capi-mediaassetmanager-oh-mediaassetchangerequest.md)* changeRequest | [OH_MediaAssetChangeRequest](capi-mediaassetmanager-oh-mediaassetchangerequest.md)实例。 | 103| [MediaLibrary_ResourceType](capi-media-asset-base-capi-h.md#medialibrary_resourcetype) resourceType | 要添加的资源的类型。 | 104| uint8_t* buffer | 要添加的数据缓冲区。 | 105| uint32_t length | 数据缓冲区的长度。 | 106 107**返回：** 108 109| 类型 | 说明 | 110| -- | -- | 111| [MediaLibrary_ErrorCode](capi-media-asset-base-capi-h.md#medialibrary_errorcode) | MEDIA_LIBRARY_OK：方法调用成功。<br> MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：<br> 1. 未指定强制参数。<br> 2. 参数类型不正确。<br> 3. 参数验证失败。<br> MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。<br> MEDIA_LIBRARY_OPERATION_NOT_SUPPORTED：不支持该操作。 | 112 113### OH_MediaAssetChangeRequest_GetWriteCacheHandler() 114 115``` 116MediaLibrary_ErrorCode OH_MediaAssetChangeRequest_GetWriteCacheHandler(OH_MediaAssetChangeRequest* changeRequest,int32_t* fd) 117``` 118 119**描述** 120 121获取临时文件写句柄。 122 123**需要权限：** ohos.permission.WRITE_IMAGEVIDEO 124 125**起始版本：** 13 126 127 128**参数：** 129 130| 参数项 | 描述 | 131| -- | -- | 132| [OH_MediaAssetChangeRequest](capi-mediaassetmanager-oh-mediaassetchangerequest.md)* changeRequest | [OH_MediaAssetChangeRequest](capi-mediaassetmanager-oh-mediaassetchangerequest.md)实例。 | 133| int32_t* fd | 临时文件写句柄。 | 134 135**返回：** 136 137| 类型 | 说明 | 138| -- | -- | 139| [MediaLibrary_ErrorCode](capi-media-asset-base-capi-h.md#medialibrary_errorcode) | MEDIA_LIBRARY_OK：方法调用成功。<br> MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：<br> 1. 未指定强制参数。<br> 2. 参数类型不正确。<br> 3. 参数验证失败。<br> MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。<br> MEDIA_LIBRARY_PERMISSION_DENIED：没有权限。<br> MEDIA_LIBRARY_OPERATION_NOT_SUPPORTED：不支持该操作。 | 140 141### OH_MediaAssetChangeRequest_SaveCameraPhoto() 142 143``` 144MediaLibrary_ErrorCode OH_MediaAssetChangeRequest_SaveCameraPhoto(OH_MediaAssetChangeRequest* changeRequest,MediaLibrary_ImageFileType imageFileType) 145``` 146 147**描述** 148 149保存相机拍摄的照片资源。 150 151**起始版本：** 12 152 153 154**参数：** 155 156| 参数项 | 描述 | 157| -- | -- | 158| [OH_MediaAssetChangeRequest](capi-mediaassetmanager-oh-mediaassetchangerequest.md)* changeRequest | [OH_MediaAssetChangeRequest](capi-mediaassetmanager-oh-mediaassetchangerequest.md)实例。 | 159| [MediaLibrary_ImageFileType](capi-media-asset-base-capi-h.md#medialibrary_imagefiletype) imageFileType | 要保存的照片的图像文件类型。 | 160 161**返回：** 162 163| 类型 | 说明 | 164| -- | -- | 165| [MediaLibrary_ErrorCode](capi-media-asset-base-capi-h.md#medialibrary_errorcode) | MEDIA_LIBRARY_OK：方法调用成功。<br> MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：<br> 1. 未指定强制参数。<br> 2. 参数类型不正确。<br> 3. 参数验证失败。<br> MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。<br> MEDIA_LIBRARY_OPERATION_NOT_SUPPORTED：不支持该操作。 | 166 167### OH_MediaAssetChangeRequest_DiscardCameraPhoto() 168 169``` 170MediaLibrary_ErrorCode OH_MediaAssetChangeRequest_DiscardCameraPhoto(OH_MediaAssetChangeRequest* changeRequest) 171``` 172 173**描述** 174 175丢弃相机拍摄的照片资源。 176 177**起始版本：** 12 178 179 180**参数：** 181 182| 参数项 | 描述 | 183| -- | -- | 184| [OH_MediaAssetChangeRequest](capi-mediaassetmanager-oh-mediaassetchangerequest.md)* changeRequest | [OH_MediaAssetChangeRequest](capi-mediaassetmanager-oh-mediaassetchangerequest.md)实例。 | 185 186**返回：** 187 188| 类型 | 说明 | 189| -- | -- | 190| [MediaLibrary_ErrorCode](capi-media-asset-base-capi-h.md#medialibrary_errorcode) | MEDIA_LIBRARY_OK：方法调用成功。<br> MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：<br> 1. 未指定强制参数。<br> 2. 参数类型不正确。<br> 3. 参数验证失败。<br> MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。<br> MEDIA_LIBRARY_OPERATION_NOT_SUPPORTED：不支持该操作。 | 191 192### OH_MediaAssetChangeRequest_Release() 193 194``` 195MediaLibrary_ErrorCode OH_MediaAssetChangeRequest_Release(OH_MediaAssetChangeRequest* changeRequest) 196``` 197 198**描述** 199 200释放[OH_MediaAssetChangeRequest](capi-mediaassetmanager-oh-mediaassetchangerequest.md)实例。 201 202**起始版本：** 12 203 204 205**参数：** 206 207| 参数项 | 描述 | 208| -- | -- | 209| [OH_MediaAssetChangeRequest](capi-mediaassetmanager-oh-mediaassetchangerequest.md)* changeRequest | [OH_MediaAssetChangeRequest](capi-mediaassetmanager-oh-mediaassetchangerequest.md)实例。 | 210 211**返回：** 212 213| 类型 | 说明 | 214| -- | -- | 215| [MediaLibrary_ErrorCode](capi-media-asset-base-capi-h.md#medialibrary_errorcode) | MEDIA_LIBRARY_OK：方法调用成功。<br> MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：<br> 1. 未指定强制参数。<br> 2. 参数类型不正确。<br> 3. 参数验证失败。 | 216 217 218