AVSource
Overview
The AVSource module provides the functions for constructing audio and video resource objects.
System capability: SystemCapability.Multimedia.Media.Spliter
Since: 10
Summary
File
| Name | Description |
|---|---|
| native_avsource.h | Declares the native APIs used for audio and video demuxing. |
Types
| Name | Description |
|---|---|
| typedef struct OH_AVSource OH_AVSource | Defines a struct that describes a native object for the media source interface. |
Functions
| Name | Description |
|---|---|
| OH_AVSource * OH_AVSource_CreateWithURI (char *uri) | Creates an OH_AVSource instance based on a URI. |
| OH_AVSource * OH_AVSource_CreateWithFD (int32_t fd, int64_t offset, int64_t size) | Creates an OH_AVSource instance based on a file descriptor (FD). |
| OH_AVErrCode OH_AVSource_Destroy (OH_AVSource *source) | Destroys an OH_AVSource instance and clears internal resources. |
| OH_AVFormat * OH_AVSource_GetSourceFormat (OH_AVSource *source) | Obtains the basic information about a media resource. |
| OH_AVFormat * OH_AVSource_GetTrackFormat (OH_AVSource *source, uint32_t trackIndex) | Obtains the basic information about a track. |
Type Description
OH_AVSource
typedef struct OH_AVSource OH_AVSource
Description Defines a struct that describes a native object for the media source interface.
Since: 10
Function Description
OH_AVSource_CreateWithFD()
OH_AVSource* OH_AVSource_CreateWithFD (int32_t fd, int64_t offset, int64_t size)
Description
Creates an OH_AVSource instance based on an FD.
You can release the instance by calling OH_AVSource_Destroy.
If offset is not the start position of the file or size is not the file size, undefined errors such as creation failure and demuxing failure may occur due to incomplete data obtained.
System capability: SystemCapability.Multimedia.Media.Spliter
Since: 10
Parameters
| Name | Description |
|---|---|
| fd | FD of a media resource file. |
| offset | Position from which data is to read. |
| size | File size, in bytes. |
Returns
Returns the pointer to an OH_AVSource instance.
OH_AVSource_CreateWithURI()
OH_AVSource* OH_AVSource_CreateWithURI (char *uri)
Description
Create an OH_AVSource instance object based on a URI. You can release the instance by calling OH_AVSource_Destroy.
System capability: SystemCapability.Multimedia.Media.Spliter
Since: 10
Parameters
| Name | Description |
|---|---|
| uri | URI of the media resource. |
Returns
Returns the pointer to an OH_AVSource instance.
OH_AVSource_Destroy()
OH_AVErrCode OH_AVSource_Destroy (OH_AVSource *source)
Description
Destroys an OH_AVSource instance and clears internal resources.
An instance can be destroyed only once. The destroyed instance cannot be used until it is re-created. You are advised to set the pointer to NULL after the instance is destroyed.
System capability: SystemCapability.Multimedia.Media.Spliter
Since: 10
Parameters
| Name | Description |
|---|---|
| source | Pointer to an OH_AVSource instance. |
Returns
Returns AV_ERR_OK if the operation is successful; returns an error code defined in OH_AVErrCode otherwise.
OH_AVSource_GetSourceFormat()
OH_AVFormat* OH_AVSource_GetSourceFormat (OH_AVSource *source)
Description
Obtains the basic information about a media resource.
System capability: SystemCapability.Multimedia.Media.Spliter
Since: 10
Parameters
| Name | Description |
|---|---|
| source | Pointer to an OH_AVSource instance. |
Returns
Returns the basic information obtained.
OH_AVSource_GetTrackFormat()
OH_AVFormat* OH_AVSource_GetTrackFormat (OH_AVSource *source, uint32_t trackIndex)
Description
Obtains the basic information about a track.
System capability: SystemCapability.Multimedia.Media.Spliter
Since: 10
Parameters
| Name | Description |
|---|---|
| source | Pointer to an OH_AVSource instance. |
| trackIndex | Index of the track whose information is to be obtained. |
Returns
Returns the basic information obtained.