media_asset_change_request_capi.h

Overview

The media_asset_change_request_capi.h file declares the APIs related to media asset change requests. You can use the APIs to change media assets.

Library: libmedia_asset_manager.so

File to include: <multimedia/media_library/media_asset_change_request_capi.h>

System capability: SystemCapability.FileManagement.PhotoAccessHelper.Core

Since: 12

Related module: MediaAssetManager

Summary

Functions

Name	Description
OH_MediaAssetChangeRequest* OH_MediaAssetChangeRequest_Create(OH_MediaAsset* mediaAsset)	Creates an OH_MediaAssetChangeRequest instance.
MediaLibrary_ErrorCode OH_MediaAssetChangeRequest_AddResourceWithUri(OH_MediaAssetChangeRequest* changeRequest,MediaLibrary_ResourceType resourceType, char* fileUri)	Adds a resource of the given URI.
MediaLibrary_ErrorCode OH_MediaAssetChangeRequest_AddResourceWithBuffer(OH_MediaAssetChangeRequest* changeRequest,MediaLibrary_ResourceType resourceType, uint8_t* buffer, uint32_t length)	Adds a resource using ArrayBuffer data.
MediaLibrary_ErrorCode OH_MediaAssetChangeRequest_GetWriteCacheHandler(OH_MediaAssetChangeRequest* changeRequest,int32_t* fd)	Obtains the handler used for writing a file to cache.
MediaLibrary_ErrorCode OH_MediaAssetChangeRequest_SaveCameraPhoto(OH_MediaAssetChangeRequest* changeRequest,MediaLibrary_ImageFileType imageFileType)	Saves the photo taken by the camera.
MediaLibrary_ErrorCode OH_MediaAssetChangeRequest_DiscardCameraPhoto(OH_MediaAssetChangeRequest* changeRequest)	Discards the photo taken by the camera.
MediaLibrary_ErrorCode OH_MediaAssetChangeRequest_Release(OH_MediaAssetChangeRequest* changeRequest)	Releases an OH_MediaAssetChangeRequest instance.

Function Description

OH_MediaAssetChangeRequest_Create()

OH_MediaAssetChangeRequest* OH_MediaAssetChangeRequest_Create(OH_MediaAsset* mediaAsset)

Description

Creates an OH_MediaAssetChangeRequest instance.

Since: 12

Parameters

Parameter	Description
OH_MediaAsset* mediaAsset	Pointer to an OH_MediaAsset instance.

Return value

Type	Description
OH_MediaAssetChangeRequest*	MEDIA_LIBRARY_OK: operation success. MEDIA_LIBRARY_PARAMETER_ERROR: incorrect parameters. Possible causes: 1. A mandatory parameter is not specified. 2. A parameter type is incorrect. 3. Parameter verification fails. MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR: internal system error.

OH_MediaAssetChangeRequest_AddResourceWithUri()

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

Description

Adds a resource of the given URI.

Since: 13

Parameters

Parameter	Description
OH_MediaAssetChangeRequest* changeRequest	Pointer to the OH_MediaAssetChangeRequest instance.
MediaLibrary_ResourceType resourceType	Type of the resource to add, which is specified by MediaLibrary_ResourceType.
char* fileUri	Pointer to the URI of the file.

Return value

Type	Description
MediaLibrary_ErrorCode	MEDIA_LIBRARY_OK: operation success. MEDIA_LIBRARY_PARAMETER_ERROR: incorrect parameters. Possible causes: 1. A mandatory parameter is not specified. 2. A parameter type is incorrect. 3. Parameter verification fails. MEDIA_LIBRARY_NO_SUCH_FILE: The file does not exist. MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR: internal system error. MEDIA_LIBRARY_OPERATION_NOT_SUPPORTED: unsupported operation.

OH_MediaAssetChangeRequest_AddResourceWithBuffer()

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

Description

Adds a resource using ArrayBuffer data.

Since: 12

Parameters

Parameter	Description
OH_MediaAssetChangeRequest* changeRequest	Pointer to the OH_MediaAssetChangeRequest instance.
MediaLibrary_ResourceType resourceType	Type of the resource to add.
uint8_t* buffer	Pointer to the data buffer.
uint32_t length	Length of the data buffer.

Return value

Type	Description
MediaLibrary_ErrorCode	MEDIA_LIBRARY_OK: operation success. MEDIA_LIBRARY_PARAMETER_ERROR: incorrect parameters. Possible causes: 1. A mandatory parameter is not specified. 2. A parameter type is incorrect. 3. Parameter verification fails. MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR: internal system error. MEDIA_LIBRARY_OPERATION_NOT_SUPPORTED: unsupported operation.

OH_MediaAssetChangeRequest_GetWriteCacheHandler()

MediaLibrary_ErrorCode OH_MediaAssetChangeRequest_GetWriteCacheHandler(OH_MediaAssetChangeRequest* changeRequest,int32_t* fd)

Description

Obtains the handler used for writing a file to cache.

Required permissions: ohos.permission.WRITE_IMAGEVIDEO

Since: 13

Parameters

Parameter	Description
OH_MediaAssetChangeRequest* changeRequest	Pointer to the OH_MediaAssetChangeRequest instance.
int32_t* fd	Pointer to the file descriptor (FD) obtained.

Return value

Type	Description
MediaLibrary_ErrorCode	MEDIA_LIBRARY_OK: operation success. MEDIA_LIBRARY_PARAMETER_ERROR: incorrect parameters. Possible causes: 1. A mandatory parameter is not specified. 2. A parameter type is incorrect. 3. Parameter verification fails. MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR: internal system error. MEDIA_LIBRARY_PERMISSION_DENIED: no access permission. MEDIA_LIBRARY_OPERATION_NOT_SUPPORTED: unsupported operation.

OH_MediaAssetChangeRequest_SaveCameraPhoto()

MediaLibrary_ErrorCode OH_MediaAssetChangeRequest_SaveCameraPhoto(OH_MediaAssetChangeRequest* changeRequest,MediaLibrary_ImageFileType imageFileType)

Description

Saves the photo taken by the camera.

Since: 12

Parameters

Parameter	Description
OH_MediaAssetChangeRequest* changeRequest	Pointer to the OH_MediaAssetChangeRequest instance.
MediaLibrary_ImageFileType imageFileType	Type of the image file of the photo.

Return value

Type	Description
MediaLibrary_ErrorCode	MEDIA_LIBRARY_OK: operation success. MEDIA_LIBRARY_PARAMETER_ERROR: incorrect parameters. Possible causes: 1. A mandatory parameter is not specified. 2. A parameter type is incorrect. 3. Parameter verification fails. MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR: internal system error. MEDIA_LIBRARY_OPERATION_NOT_SUPPORTED: unsupported operation.

OH_MediaAssetChangeRequest_DiscardCameraPhoto()

MediaLibrary_ErrorCode OH_MediaAssetChangeRequest_DiscardCameraPhoto(OH_MediaAssetChangeRequest* changeRequest)

Description

Discards the photo taken by the camera.

Since: 12

Parameters

Parameter	Description
OH_MediaAssetChangeRequest* changeRequest	Pointer to the OH_MediaAssetChangeRequest instance.

Return value

Type	Description
MediaLibrary_ErrorCode	MEDIA_LIBRARY_OK: operation success. MEDIA_LIBRARY_PARAMETER_ERROR: incorrect parameters. Possible causes: 1. A mandatory parameter is not specified. 2. A parameter type is incorrect. 3. Parameter verification fails. MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR: internal system error. MEDIA_LIBRARY_OPERATION_NOT_SUPPORTED: unsupported operation.

OH_MediaAssetChangeRequest_Release()

MediaLibrary_ErrorCode OH_MediaAssetChangeRequest_Release(OH_MediaAssetChangeRequest* changeRequest)

Description

Releases an OH_MediaAssetChangeRequest instance.

Since: 12

Parameters

Parameter	Description
OH_MediaAssetChangeRequest* changeRequest	Pointer to the OH_MediaAssetChangeRequest instance.

Return value

Type	Description
MediaLibrary_ErrorCode	MEDIA_LIBRARY_OK: operation success. MEDIA_LIBRARY_PARAMETER_ERROR: incorrect parameters. Possible causes: 1. A mandatory parameter is not specified. 2. A parameter type is incorrect. 3. Parameter verification fails.

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Media Library Kit (Media File Management Service)

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