AVSource

Overview

The AVSource module provides the functions for constructing media resource objects.

System capability: SystemCapability.Multimedia.Media.Spliter

Since: 10

Summary

File

Types

Functions

Type Description

OH_AVSource

typedef struct OH_AVSource OH_AVSource

Description

Defines a struct that describes a native object for the media resource interface.

Since: 10

Function Description

OH_AVSource_CreateWithDataSource()

OH_AVSource* OH_AVSource_CreateWithDataSource (OH_AVDataSource * dataSource)

Description

Creates an OH_AVSource instance with a user-defined data source. You can release the instance by calling OH_AVSource_Destroy.

System capability: SystemCapability.Multimedia.Media.Spliter

Since: 12

Parameters

Returns

Returns the pointer to the OH_AVSource instance created if the operation is successful; returns NULL otherwise.

The possible causes of an operation failure are as follows:

1. The value of dataSource is a null pointer.

2. The size of the data source is 0.

3. Setting the data source fails.

4. The memory is insufficient.

5. The decoder engine is a null pointer.

6. dataSource->readAt == nullptr.

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 demultiplexing failure may occur due to incomplete data obtained.

System capability: SystemCapability.Multimedia.Media.Spliter

Since: 10

Parameters

Returns

Returns the pointer to the OH_AVSource instance created if the operation is successful; returns NULL otherwise.

The possible causes of an operation failure are as follows:

1. The FD is invalid.

2. The offset is not the start position of the file.

3. The size is incorrect.

4. The resource is invalid.

5. The file format is not supported.

OH_AVSource_CreateWithURI()

OH_AVSource* OH_AVSource_CreateWithURI (char *uri)

Description

Create an OH_AVSource instance based on a URI. You can release the instance by calling OH_AVSource_Destroy.

System capability: SystemCapability.Multimedia.Media.Spliter

Since: 10

Parameters

Returns

Returns the pointer to the OH_AVSource instance created if the operation is successful; returns NULL otherwise.

The possible causes of an operation failure are as follows:

1. The network is abnormal.

2. The resource is invalid.

3. The file format is not supported.

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

Returns

Returns either of the following result codes:

AV_ERR_OK: The operation is successful.

AV_ERR_INVALID_VAL: The operation fails.

1. The source pointer is invalid.
2. The pointer is null or does not point to an **OH_AVSource** instance.

OH_AVSource_GetCustomMetadataFormat()

OH_AVFormat *OH_AVSource_GetCustomMetadataFormat(OH_AVSource *source)

Description

Obtains the basic information about custom metadata.

You must call OH_AVFormat_Destroy to release the OH_AVFormat instance when its lifecycle ends.

System capability: SystemCapability.Multimedia.Media.Spliter

Since: 18

Parameters

Returns

Returns the basic information about the metadata if the operation is successful; returns NULL otherwise.

The possible causes of an operation failure are as follows:

1. The source pointer is invalid.
2. The pointer is null or does not point to an OH_AVSource instance.
3. The source is not initialized.

OH_AVSource_GetSourceFormat()

OH_AVFormat* OH_AVSource_GetSourceFormat (OH_AVSource *source)

Description

Obtains the basic information about a media resource file.

You must call OH_AVFormat_Destroy to release the OH_AVFormat instance when its lifecycle ends.

System capability: SystemCapability.Multimedia.Media.Spliter

Since: 10

Parameters

Returns

Returns the basic information about the file if the operation is successful; returns NULL otherwise.

The possible causes of an operation failure are as follows:

1. The source pointer is invalid.
2. The pointer is null or does not point to an OH_AVSource instance.
3. The source is not initialized.

OH_AVSource_GetTrackFormat()

OH_AVFormat* OH_AVSource_GetTrackFormat (OH_AVSource *source, uint32_t trackIndex)

Description

Obtains the basic information about a track.

You must call OH_AVFormat_Destroy to release the OH_AVFormat instance when its lifecycle ends.

System capability: SystemCapability.Multimedia.Media.Spliter

Since: 10

Parameters

Returns

Returns the basic information about the track if the operation is successful; returns NULL otherwise.

The possible causes of an operation failure are as follows:

1. The value of source is invalid (either a null pointer or a pointer to a non-OH_AVSource instance).
2. The track index is out of range.
3. The source is not initialized.

你可能感兴趣的鸿蒙文章

harmony 鸿蒙AVCodec Kit

harmony 鸿蒙AVCapability

harmony 鸿蒙AVDemuxer

harmony 鸿蒙AVMuxer

harmony 鸿蒙AudioCodec

harmony 鸿蒙AudioDecoder

harmony 鸿蒙AudioEncoder

harmony 鸿蒙CodecBase

harmony 鸿蒙Core

harmony 鸿蒙DrmSubsample