harmony 鸿蒙OHAudio

  • 2023-10-30
  • 浏览 (826)

OHAudio

Overview

The OHAudio module provides native APIs of the audio module.

\@syscap SystemCapability.Multimedia.Audio.Core

Since

10

Summary

Files

Name Description
native_audiocapturer.h Declares the functions related to an audio capturer.
File to include: <ohaudio/native_audiocapturer.h>
Library: libohaudio.so
native_audiorenderer.h Declares the functions related to an audio renderer.
File to include: <ohaudio/native_audiorenderer.h>
Library: libohaudio.so
native_audiostream_base.h Declares the basic data structure of OHAudio.
File to include: <ohaudio/native_audiostream_base.h>
Library: libohaudio.so
native_audiostreambuilder.h Declares the functions related to the audio stream builder.
File to include: <ohaudio/native_audiostreambuilder.h>
Library: libohaudio.so

Structs

Name Description
OH_AudioRenderer_Callbacks_Struct Defines a pointer to the callback functions related to an audio renderer.
OH_AudioCapturer_Callbacks_Struct Defines a pointer to the callback functions related to an audio capturer.

Types

Name Description
OH_AudioStreamBuilder Defines an audio stream builder.
OH_AudioRenderer Defines an audio renderer.
OH_AudioCapturer Defines an audio capturer.
OH_AudioRenderer_Callbacks Defines a pointer to the callback functions related to an audio renderer.
OH_AudioCapturer_Callbacks Defines a pointer to the callback functions related to an audio capturer.

Enums

Name Description
OH_AudioStream_Result { AUDIOSTREAM_SUCCESS, AUDIOSTREAM_ERROR_INVALID_PARAM, AUDIOSTREAM_ERROR_ILLEGAL_STATE, AUDIOSTREAM_ERROR_SYSTEM } Enumerates the audio stream result codes.
OH_AudioStream_Type { AUDIOSTREAM_TYPE_RENDERER = 1, AUDIOSTREAM_TYPE_CAPTURER = 2 } Enumerates the audio stream types.
OH_AudioStream_SampleFormat { AUDIOSTREAM_SAMPLE_U8 = 0, AUDIOSTREAM_SAMPLE_S16LE = 1, AUDIOSTREAM_SAMPLE_S24LE = 2, AUDIOSTREAM_SAMPLE_S32LE = 3 } Enumerates the sampling formats of audio streams.
OH_AudioStream_EncodingType { AUDIOSTREAM_ENCODING_TYPE_RAW = 0 } Enumerates the encoding types of audio streams.
OH_AudioStream_Usage { AUDIOSTREAM_USAGE_UNKNOWN = 0, AUDIOSTREAM_USAGE_MUSIC = 1, AUDIOSTREAM_USAGE_COMMUNICATION = 2, AUDIOSTREAM_USAGE_GAME = 11 } Enumerates the usage scenarios of audio output streams.
OH_AudioStream_LatencyMode { AUDIOSTREAM_LATENCY_MODE_NORMAL = 0, AUDIOSTREAM_LATENCY_MODE_FAST = 1} Enumerates the latency modes of audio streams.
OH_AudioStream_State {
AUDIOSTREAM_STATE_INVALID = -1, AUDIOSTREAM_STATE_PREPARED = 1, AUDIOSTREAM_STATE_RUNNING = 2, AUDIOSTREAM_STATE_STOPPED = 3,
AUDIOSTREAM_STATE_RELEASED = 4, AUDIOSTREAM_STATE_PAUSED = 5
}
Enumerates the audio stream states.
OH_AudioStream_SourceType { AUDIOSTREAM_SOURCE_TYPE_INVALID = -1, AUDIOSTREAM_SOURCE_TYPE_MIC, AUDIOSTREAM_SOURCE_TYPE_VOICE_RECOGNITION = 1, AUDIOSTREAM_SOURCE_TYPE_VOICE_COMMUNICATION = 7 } Enumerates the usage scenarios of audio input streams.

Functions

Name Description
OH_AudioCapturer_Release (OH_AudioCapturer *capturer) Releases an audio capturer.
OH_AudioCapturer_Start (OH_AudioCapturer *capturer) Starts an audio capturer.
OH_AudioCapturer_Pause (OH_AudioCapturer *capturer) Pauses an audio capturer.
OH_AudioCapturer_Stop (OH_AudioCapturer *capturer) Stops an audio capturer.
OH_AudioCapturer_Flush (OH_AudioCapturer *capturer) Flushes obtained audio data.
OH_AudioCapturer_GetCurrentState (OH_AudioCapturer *capturer, OH_AudioStream_State *state) Obtains the state of an audio capturer.
OH_AudioCapturer_GetLatencyMode (OH_AudioCapturer *capturer, OH_AudioStream_LatencyMode *latencyMode) Obtains the latency mode of an audio capturer.
OH_AudioCapturer_GetStreamId (OH_AudioCapturer *capturer, uint32_t *streamId) Obtains the stream ID of an audio capturer.
OH_AudioCapturer_GetSamplingRate (OH_AudioCapturer *capturer, int32_t *rate) Obtains the sampling rate of an audio capturer.
OH_AudioCapturer_GetChannelCount (OH_AudioCapturer *capturer, int32_t *channelCount) Obtains the number of channels for an audio capturer.
OH_AudioCapturer_GetSampleFormat (OH_AudioCapturer *capturer, OH_AudioStream_SampleFormat *sampleFormat) Obtains the sampling format of an audio capturer.
OH_AudioCapturer_GetEncodingType (OH_AudioCapturer *capturer, OH_AudioStream_EncodingType *encodingType) Obtains the encoding type of an audio capturer.
OH_AudioCapturer_GetCapturerInfo (OH_AudioCapturer *capturer, OH_AudioStream_SourceType *sourceType) Obtains the usage scenario of an audio capturer.
OH_AudioRenderer_Release (OH_AudioRenderer *renderer) Releases an audio renderer.
OH_AudioRenderer_Start (OH_AudioRenderer *renderer) Starts an audio renderer.
OH_AudioRenderer_Pause (OH_AudioRenderer *renderer) Pauses an audio renderer.
OH_AudioRenderer_Stop (OH_AudioRenderer *renderer) Stops an audio renderer.
OH_AudioRenderer_Flush (OH_AudioRenderer *renderer) Flushes written audio data.
OH_AudioRenderer_GetCurrentState (OH_AudioRenderer *renderer, OH_AudioStream_State *state) Obtains the state of an audio renderer.
OH_AudioRenderer_GetSamplingRate (OH_AudioRenderer *renderer, int32_t *rate) Obtains the sampling rate of an audio renderer.
OH_AudioRenderer_GetStreamId (OH_AudioRenderer *renderer, uint32_t *streamId) Obtains the stream ID of an audio renderer.
OH_AudioRenderer_GetChannelCount (OH_AudioRenderer *renderer, int32_t *channelCount) Obtains the number of channels for an audio renderer.
OH_AudioRenderer_GetSampleFormat (OH_AudioRenderer *renderer, OH_AudioStream_SampleFormat *sampleFormat) Obtains the sampling format of an audio renderer.
OH_AudioRenderer_GetLatencyMode (OH_AudioRenderer *renderer, OH_AudioStream_LatencyMode *latencyMode) Obtains the latency mode of an audio renderer.
OH_AudioRenderer_GetRendererInfo (OH_AudioRenderer *renderer, OH_AudioStream_Usage *usage) Obtains the usage scenario of an audio renderer.
OH_AudioRenderer_GetEncodingType (OH_AudioRenderer *renderer, OH_AudioStream_EncodingType *encodingType) Obtains the encoding type of an audio renderer.
OH_AudioStreamBuilder_Create (OH_AudioStreamBuilder **builder, OH_AudioStream_Type type) Creates an audio stream builder, which can be an audio renderer or capturer.
OH_AudioStreamBuilder_Destroy (OH_AudioStreamBuilder *builder) Destroys an audio stream builder.
OH_AudioStreamBuilder_SetSamplingRate (OH_AudioStreamBuilder *builder, int32_t rate) Sets the sampling rate of an audio stream.
OH_AudioStreamBuilder_SetChannelCount (OH_AudioStreamBuilder *builder, int32_t channelCount) Sets the number of channels for an audio stream.
OH_AudioStreamBuilder_SetSampleFormat (OH_AudioStreamBuilder *builder, OH_AudioStream_SampleFormat format) Sets the sampling format of an audio stream.
OH_AudioStreamBuilder_SetEncodingType (OH_AudioStreamBuilder *builder, OH_AudioStream_EncodingType encodingType) Sets the encoding type of an audio stream.
OH_AudioStreamBuilder_SetLatencyMode (OH_AudioStreamBuilder *builder, OH_AudioStream_LatencyMode latencyMode) Sets the latency mode of an audio stream.
OH_AudioStreamBuilder_SetRendererInfo (OH_AudioStreamBuilder *builder, OH_AudioStream_Usage usage) Sets the usage scenario of an audio renderer.
OH_AudioStreamBuilder_SetCapturerInfo (OH_AudioStreamBuilder *builder, OH_AudioStream_SourceType sourceType) Sets the usage scenario of an audio capturer.
OH_AudioStreamBuilder_SetRendererCallback (OH_AudioStreamBuilder *builder, OH_AudioRenderer_Callbacks callbacks, void *userData) Sets callbacks for an audio renderer.
OH_AudioStreamBuilder_SetCapturerCallback (OH_AudioStreamBuilder *builder, OH_AudioCapturer_Callbacks callbacks, void *userData) Sets callbacks for an audio capturer.
OH_AudioStreamBuilder_GenerateRenderer (OH_AudioStreamBuilder *builder, OH_AudioRenderer **audioRenderer) Creates an audio renderer instance.
OH_AudioStreamBuilder_GenerateCapturer (OH_AudioStreamBuilder *builder, OH_AudioCapturer **audioCapturer) Creates an audio capturer instance.

Variables

Name Description
(*OH_AudioRenderer_Callbacks_Struct::OH_AudioRenderer_OnWriteData )(OH_AudioRenderer *renderer, void *userData, void *buffer, int32_t lenth) Defines a function pointer to the callback function used to write audio data.
(*OH_AudioCapturer_Callbacks_Struct::OH_AudioCapturer_OnReadData )(OH_AudioCapturer *capturer, void *userData, void *buffer, int32_t lenth) Defines a function pointer to the callback function used to read audio data.

Type Description

OH_AudioCapturer

typedef struct OH_AudioCapturerStruct OH_AudioCapturer

Description

Defines an audio capturer.

An audio capturer instance is used to capture audio data.

\@syscap SystemCapability.Multimedia.Audio.Core

Since

10

OH_AudioCapturer_Callbacks

typedef struct OH_AudioCapturer_Callbacks_Struct OH_AudioCapturer_Callbacks

Description

Defines a pointer to the callback functions related to an audio capturer.

\@syscap SystemCapability.Multimedia.Audio.Core

Since

10

OH_AudioRenderer

typedef struct OH_AudioRendererStruct OH_AudioRenderer

Description

Defines an audio renderer.

An audio renderer instance is used to render audio data.

\@syscap SystemCapability.Multimedia.Audio.Core

Since

10

OH_AudioRenderer_Callbacks

typedef struct OH_AudioRenderer_Callbacks_Struct OH_AudioRenderer_Callbacks

Description

Defines a pointer to the callback functions related to an audio renderer.

\@syscap SystemCapability.Multimedia.Audio.Core

Since

10

OH_AudioStreamBuilder

typedef struct OH_AudioStreamBuilderStruct OH_AudioStreamBuilder

Description

Defines an audio stream builder.

An audio stream builder instance is often used to create an audio stream and set its attributes.

\@syscap SystemCapability.Multimedia.Audio.Core

Since

10

Enum Description

OH_AudioStream_EncodingType

enum OH_AudioStream_EncodingType

Description

Enumerates the encoding types of audio streams.

\@syscap SystemCapability.Multimedia.Audio.Core

Since

10

Value Description
AUDIOSTREAM_ENCODING_TYPE_RAW PCM encoding.

OH_AudioStream_LatencyMode

enum OH_AudioStream_LatencyMode

Description

Enumerates the latency modes of audio streams.

\@syscap SystemCapability.Multimedia.Audio.Core

Since

10

Value Description
AUDIOSTREAM_LATENCY_MODE_NORMAL Normal latency mode.
AUDIOSTREAM_LATENCY_MODE_FAST Low latency mode.

OH_AudioStream_Result

enum OH_AudioStream_Result

Description

Enumerates the audio stream result codes.

\@syscap SystemCapability.Multimedia.Audio.Core

Since

10

Value Description
AUDIOSTREAM_SUCCESS Operation successful.
AUDIOSTREAM_ERROR_INVALID_PARAM Invalid input parameter.
AUDIOSTREAM_ERROR_ILLEGAL_STATE Invalid state.
AUDIOSTREAM_ERROR_SYSTEM System error.

OH_AudioStream_SampleFormat

enum OH_AudioStream_SampleFormat

Description

Enumerates the sampling formats of audio streams.

\@syscap SystemCapability.Multimedia.Audio.Core

Since

10

Value Description
AUDIOSTREAM_SAMPLE_U8 Unsigned 8-bit.
AUDIOSTREAM_SAMPLE_S16LE Short 16-bit little-endian.
AUDIOSTREAM_SAMPLE_S24LE Short 24-bit little-endian.
AUDIOSTREAM_SAMPLE_S32LE Short 32-bit little-endian.

OH_AudioStream_SourceType

enum OH_AudioStream_SourceType

Description

Enumerates the usage scenarios of an audio capturer, that is, the usage scenarios of audio input streams.

\@syscap SystemCapability.Multimedia.Audio.Core

Since

10

Value Description
AUDIOSTREAM_SOURCE_TYPE_INVALID Invalid state.
AUDIOSTREAM_SOURCE_TYPE_MIC Audio recording.
AUDIOSTREAM_SOURCE_TYPE_VOICE_RECOGNITION Voice recognition.
AUDIOSTREAM_SOURCE_TYPE_VOICE_COMMUNICATION Voice communication.

OH_AudioStream_State

enum OH_AudioStream_State

Description

Enumerates the audio stream states.

\@syscap SystemCapability.Multimedia.Audio.Core

Since

10

Value Description
AUDIOSTREAM_STATE_INVALID Invalid state.
AUDIOSTREAM_STATE_PREPARED Prepared.
AUDIOSTREAM_STATE_RUNNING Running.
AUDIOSTREAM_STATE_STOPPED Stopped.
AUDIOSTREAM_STATE_RELEASED Released.
AUDIOSTREAM_STATE_PAUSED Paused.

OH_AudioStream_Type

enum OH_AudioStream_Type

Description

Enumerates the audio stream types.

\@syscap SystemCapability.Multimedia.Audio.Core

Since

10

Value Description
AUDIOSTREAM_TYPE_RENDERER The audio stream is an output stream.
AUDIOSTREAM_TYPE_CAPTURER The audio stream is an input stream.

OH_AudioStream_Usage

enum OH_AudioStream_Usage

Description

Enumerates the usage scenarios of an audio renderer, that is, the usage scenarios of audio output streams.

\@syscap SystemCapability.Multimedia.Audio.Core

Since

10

Value Description
AUDIOSTREAM_USAGE_UNKNOWN Undefined.
AUDIOSTREAM_USAGE_MUSIC Music.
AUDIOSTREAM_USAGE_COMMUNICATION Voice communication.
AUDIOSTREAM_USAGE_GAME Gaming.

Function Description

OH_AudioCapturer_Flush()

OH_AudioStream_Result OH_AudioCapturer_Flush (OH_AudioCapturer * capturer)

Description

Flushes obtained audio data.

Parameters

Name Description
capturer Pointer to an audio capturer instance created by OH_AudioStreamBuilder_GenerateCapturer.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioCapturer_GetCapturerInfo()

OH_AudioStream_Result OH_AudioCapturer_GetCapturerInfo (OH_AudioCapturer * capturer, OH_AudioStream_SourceType * sourceType )

Description

Obtains the usage scenario of an audio capturer.

Parameters

Name Description
capturer Pointer to an audio capturer instance created by OH_AudioStreamBuilder_GenerateCapturer.
sourceType Pointer to a variable used to receive the usage scenario.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioCapturer_GetChannelCount()

OH_AudioStream_Result OH_AudioCapturer_GetChannelCount (OH_AudioCapturer * capturer, int32_t * channelCount )

Description

Obtains the number of channels for an audio capturer.

Parameters

Name Description
capturer Pointer to an audio capturer instance created by OH_AudioStreamBuilder_GenerateCapturer.
channelCount Pointer to a variable used to receive the number of channels.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioCapturer_GetCurrentState()

OH_AudioStream_Result OH_AudioCapturer_GetCurrentState (OH_AudioCapturer * capturer, OH_AudioStream_State * state )

Description

Obtains the state of an audio capturer.

Parameters

Name Description
capturer Pointer to an audio capturer instance created by OH_AudioStreamBuilder_GenerateCapturer.
state Pointer to a variable used to receive the state.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioCapturer_GetEncodingType()

OH_AudioStream_Result OH_AudioCapturer_GetEncodingType (OH_AudioCapturer * capturer, OH_AudioStream_EncodingType * encodingType )

Description

Obtains the encoding type of an audio capturer.

Parameters

Name Description
capturer Pointer to an audio capturer instance created by OH_AudioStreamBuilder_GenerateCapturer.
encodingType Pointer to a variable used to receive the encoding type.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioCapturer_GetLatencyMode()

OH_AudioStream_Result OH_AudioCapturer_GetLatencyMode (OH_AudioCapturer * capturer, OH_AudioStream_LatencyMode * latencyMode )

Description

Obtains the latency mode of an audio capturer.

Parameters

Name Description
capturer Pointer to an audio capturer instance created by OH_AudioStreamBuilder_GenerateCapturer.
latencyMode Pointer to a variable used to receive the latency mode.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioCapturer_GetSampleFormat()

OH_AudioStream_Result OH_AudioCapturer_GetSampleFormat (OH_AudioCapturer * capturer, OH_AudioStream_SampleFormat * sampleFormat )

Description

Obtains the sampling format of an audio capturer.

Parameters

Name Description
capturer Pointer to an audio capturer instance created by OH_AudioStreamBuilder_GenerateCapturer.
sampleFormat Pointer to a variable used to receive the sampling format.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioCapturer_GetSamplingRate()

OH_AudioStream_Result OH_AudioCapturer_GetSamplingRate (OH_AudioCapturer * capturer, int32_t * rate )

Description

Obtains the sampling rate of an audio capturer.

Parameters

Name Description
capturer Pointer to an audio capturer instance created by OH_AudioStreamBuilder_GenerateCapturer.
rate Pointer to a variable used to receive the sampling rate.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioCapturer_GetStreamId()

OH_AudioStream_Result OH_AudioCapturer_GetStreamId (OH_AudioCapturer * capturer, uint32_t * streamId )

Description

Obtains the stream ID of an audio capturer.

Parameters

Name Description
capturer Pointer to an audio capturer instance created by OH_AudioStreamBuilder_GenerateCapturer.
streamId Pointer to a variable used to receive the stream ID.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioCapturer_Pause()

OH_AudioStream_Result OH_AudioCapturer_Pause (OH_AudioCapturer * capturer)

Description

Pauses an audio capturer.

Parameters

Name Description
capturer Pointer to an audio capturer instance created by OH_AudioStreamBuilder_GenerateCapturer.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioCapturer_Release()

OH_AudioStream_Result OH_AudioCapturer_Release (OH_AudioCapturer * capturer)

Description

Releases an audio capturer.

Parameters

Name Description
capturer Pointer to an audio capturer instance created by OH_AudioStreamBuilder_GenerateCapturer.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioCapturer_Start()

OH_AudioStream_Result OH_AudioCapturer_Start (OH_AudioCapturer * capturer)

Description

Starts an audio capturer.

Parameters

Name Description
capturer Pointer to an audio capturer instance created by OH_AudioStreamBuilder_GenerateCapturer.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioCapturer_Stop()

OH_AudioStream_Result OH_AudioCapturer_Stop (OH_AudioCapturer * capturer)

Description

Stops an audio capturer.

Parameters

Name Description
capturer Pointer to an audio capturer instance created by OH_AudioStreamBuilder_GenerateCapturer.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioRenderer_Flush()

OH_AudioStream_Result OH_AudioRenderer_Flush (OH_AudioRenderer * renderer)

Description

Flushes written audio data.

Parameters

Name Description
renderer Pointer to an audio renderer instance created by OH_AudioStreamBuilder_GenerateRenderer.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioRenderer_GetChannelCount()

OH_AudioStream_Result OH_AudioRenderer_GetChannelCount (OH_AudioRenderer * renderer, int32_t * channelCount )

Description

Obtains the number of channels for an audio renderer.

Parameters

Name Description
renderer Pointer to an audio renderer instance created by OH_AudioStreamBuilder_GenerateRenderer.
channelCount Pointer to a variable used to receive the number of channels.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioRenderer_GetCurrentState()

OH_AudioStream_Result OH_AudioRenderer_GetCurrentState (OH_AudioRenderer * renderer, OH_AudioStream_State * state )

Description

Obtains the state of an audio renderer.

Parameters

Name Description
renderer Pointer to an audio renderer instance created by OH_AudioStreamBuilder_GenerateRenderer.
state Pointer to a variable used to receive the state.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioRenderer_GetEncodingType()

OH_AudioStream_Result OH_AudioRenderer_GetEncodingType (OH_AudioRenderer * renderer, OH_AudioStream_EncodingType * encodingType )

Description

Obtains the encoding type of an audio renderer.

Parameters

Name Description
renderer Pointer to an audio renderer instance created by OH_AudioStreamBuilder_GenerateRenderer.
encodingType Pointer to a variable used to receive the encoding type.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioRenderer_GetLatencyMode()

OH_AudioStream_Result OH_AudioRenderer_GetLatencyMode (OH_AudioRenderer * renderer, OH_AudioStream_LatencyMode * latencyMode )

Description

Obtains the latency mode of an audio renderer.

Parameters

Name Description
renderer Pointer to an audio renderer instance created by OH_AudioStreamBuilder_GenerateRenderer.
latencyMode Pointer to a variable used to receive the latency mode.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioRenderer_GetRendererInfo()

OH_AudioStream_Result OH_AudioRenderer_GetRendererInfo (OH_AudioRenderer * renderer, OH_AudioStream_Usage * usage )

Description

Obtains the usage scenario of an audio renderer.

Parameters

Name Description
renderer Pointer to an audio renderer instance created by OH_AudioStreamBuilder_GenerateRenderer.
usage Pointer to a variable used to receive the usage scenario.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioRenderer_GetSampleFormat()

OH_AudioStream_Result OH_AudioRenderer_GetSampleFormat (OH_AudioRenderer * renderer, OH_AudioStream_SampleFormat * sampleFormat )

Description

Obtains the sampling format of an audio renderer.

Parameters

Name Description
renderer Pointer to an audio renderer instance created by OH_AudioStreamBuilder_GenerateRenderer.
sampleFormat Pointer to a variable used to receive the sampling format.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioRenderer_GetSamplingRate()

OH_AudioStream_Result OH_AudioRenderer_GetSamplingRate (OH_AudioRenderer * renderer, int32_t * rate )

Description

Obtains the sampling rate of an audio renderer.

Parameters

Name Description
renderer Pointer to an audio renderer instance created by OH_AudioStreamBuilder_GenerateRenderer.
rate Pointer to a variable used to receive the sampling rate.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioRenderer_GetStreamId()

OH_AudioStream_Result OH_AudioRenderer_GetStreamId (OH_AudioRenderer * renderer, uint32_t * streamId )

Description

Obtains the stream ID of an audio renderer.

Parameters

Name Description
renderer Pointer to an audio renderer instance created by OH_AudioStreamBuilder_GenerateRenderer.
streamId Pointer to a variable used to receive the stream ID.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioRenderer_Pause()

OH_AudioStream_Result OH_AudioRenderer_Pause (OH_AudioRenderer * renderer)

Description

Pauses an audio renderer.

Parameters

Name Description
renderer Pointer to an audio renderer instance created by OH_AudioStreamBuilder_GenerateRenderer.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioRenderer_Release()

OH_AudioStream_Result OH_AudioRenderer_Release (OH_AudioRenderer * renderer)

Description

Releases an audio renderer.

Parameters

Name Description
renderer Pointer to an audio renderer instance created by OH_AudioStreamBuilder_GenerateRenderer.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioRenderer_Start()

OH_AudioStream_Result OH_AudioRenderer_Start (OH_AudioRenderer * renderer)

Description

Starts an audio renderer.

Parameters

Name Description
renderer Pointer to an audio renderer instance created by OH_AudioStreamBuilder_GenerateRenderer.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioRenderer_Stop()

OH_AudioStream_Result OH_AudioRenderer_Stop (OH_AudioRenderer * renderer)

Description

Stops an audio renderer.

Parameters

Name Description
renderer Pointer to an audio renderer instance created by OH_AudioStreamBuilder_GenerateRenderer.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioStreamBuilder_Create()

OH_AudioStream_Result OH_AudioStreamBuilder_Create (OH_AudioStreamBuilder ** builder, OH_AudioStream_Type type )

Description

Creates an audio stream builder, which can be an audio renderer or capturer.

You need to call OH_AudioStreamBuilder_Destroy() to destroy the builder when it is no longer required.

Parameters

Name Description
builder Double pointer to the audio stream builder created.
type Type of the audio stream builder, which can be AUDIOSTREAM_TYPE_RENDERER or AUDIOSTREAM_TYPE_CAPTURER.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioStreamBuilder_Destroy()

OH_AudioStream_Result OH_AudioStreamBuilder_Destroy (OH_AudioStreamBuilder * builder)

Description

Destroys an audio stream builder when it is no longer required.

Parameters

Name Description
builder Pointer to an audio stream builder instance created by OH_AudioStreamBuilder_Create().

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioStreamBuilder_GenerateCapturer()

OH_AudioStream_Result OH_AudioStreamBuilder_GenerateCapturer (OH_AudioStreamBuilder * builder, OH_AudioCapturer ** audioCapturer )

Description

Creates an audio capturer instance.

Parameters

Name Description
builder Pointer to an audio stream builder instance created by OH_AudioStreamBuilder_Create().
audioCapturer Double pointer to the audio capturer instance created.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioStreamBuilder_GenerateRenderer()

OH_AudioStream_Result OH_AudioStreamBuilder_GenerateRenderer (OH_AudioStreamBuilder * builder, OH_AudioRenderer ** audioRenderer )

Description

Creates an audio renderer instance.

Parameters

Name Description
builder Pointer to an audio stream builder instance created by OH_AudioStreamBuilder_Create().
audioRenderer Double pointer to the audio renderer instance created.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioStreamBuilder_SetCapturerCallback()

OH_AudioStream_Result OH_AudioStreamBuilder_SetCapturerCallback (OH_AudioStreamBuilder * builder, OH_AudioCapturer_Callbacks callbacks, void * userData )

Description

Sets callbacks for an audio capturer.

Parameters

Name Description
builder Pointer to an audio stream builder instance created by OH_AudioStreamBuilder_Create().
callbacks Callback functions that will be used to process events related to input audio streams.
userData Pointer to the application data passed through the callback functions.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioStreamBuilder_SetCapturerInfo()

OH_AudioStream_Result OH_AudioStreamBuilder_SetCapturerInfo (OH_AudioStreamBuilder * builder, OH_AudioStream_SourceType sourceType )

Description

Sets the usage scenario of an audio capturer.

Parameters

Name Description
builder Pointer to an audio stream builder instance created by OH_AudioStreamBuilder_Create().
sourceType Usage scenario of the audio capturer.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioStreamBuilder_SetChannelCount()

OH_AudioStream_Result OH_AudioStreamBuilder_SetChannelCount (OH_AudioStreamBuilder * builder, int32_t channelCount )

Description

Sets the number of channels for an audio stream.

Parameters

Name Description
builder Pointer to an audio stream builder instance created by OH_AudioStreamBuilder_Create().
channelCount Number of channels.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioStreamBuilder_SetEncodingType()

OH_AudioStream_Result OH_AudioStreamBuilder_SetEncodingType (OH_AudioStreamBuilder * builder, OH_AudioStream_EncodingType encodingType )

Description

Sets the encoding type of an audio stream.

Parameters

Name Description
builder Pointer to an audio stream builder instance created by OH_AudioStreamBuilder_Create().
encodingType Encoding type, which can be AUDIOSTREAM_ENCODING_PCM.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioStreamBuilder_SetLatencyMode()

OH_AudioStream_Result OH_AudioStreamBuilder_SetLatencyMode (OH_AudioStreamBuilder * builder, OH_AudioStream_LatencyMode latencyMode )

Description

Sets the latency mode of an audio stream.

Parameters

Name Description
builder Pointer to an audio stream builder instance created by OH_AudioStreamBuilder_Create().
latencyMode Latency mode.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioStreamBuilder_SetRendererCallback()

OH_AudioStream_Result OH_AudioStreamBuilder_SetRendererCallback (OH_AudioStreamBuilder * builder, OH_AudioRenderer_Callbacks callbacks, void * userData )

Description

Sets callbacks for an audio renderer.

Parameters

Name Description
builder Pointer to an audio stream builder instance created by OH_AudioStreamBuilder_Create().
callbacks Callback functions that will be used to process events related to output audio streams.
userData Pointer to the application data passed through the callback functions.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioStreamBuilder_SetRendererInfo()

OH_AudioStream_Result OH_AudioStreamBuilder_SetRendererInfo (OH_AudioStreamBuilder * builder, OH_AudioStream_Usage usage )

Description

Sets the usage scenario of an audio renderer.

Parameters

Name Description
builder Pointer to an audio stream builder instance created by OH_AudioStreamBuilder_Create().
usage Usage scenario of the audio renderer.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioStreamBuilder_SetSampleFormat()

OH_AudioStream_Result OH_AudioStreamBuilder_SetSampleFormat (OH_AudioStreamBuilder * builder, OH_AudioStream_SampleFormat format )

Description

Sets the sampling format of an audio stream.

Parameters

Name Description
builder Pointer to an audio stream builder instance created by OH_AudioStreamBuilder_Create().
format Sampling format.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

OH_AudioStreamBuilder_SetSamplingRate()

OH_AudioStream_Result OH_AudioStreamBuilder_SetSamplingRate (OH_AudioStreamBuilder * builder, int32_t rate )

Description

Sets the sampling rate of an audio stream.

Parameters

Name Description
builder Pointer to an audio stream builder instance created by OH_AudioStreamBuilder_Create().
channelCount Sampling rate.

Returns

Returns AUDIOSTREAM_SUCCESS if the operation is successful; returns an error code otherwise.

Since

10

Variable Description

OH_AudioCapturer_OnReadData

int32_t(* OH_AudioCapturer_Callbacks_Struct::OH_AudioCapturer_OnReadData) (OH_AudioCapturer *capturer, void *userData, void *buffer, int32_t lenth)

Description

Defines a function pointer to the callback function used to read audio data.

Since

10

OH_AudioRenderer_OnWriteData

int32_t(* OH_AudioRenderer_Callbacks_Struct::OH_AudioRenderer_OnWriteData) (OH_AudioRenderer *renderer, void *userData, void *buffer, int32_t lenth)

Description

Defines a function pointer to the callback function used to write audio data.

Since

10

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Native APIs

harmony 鸿蒙AVCapability

harmony 鸿蒙AVDemuxer

harmony 鸿蒙AVMuxer

harmony 鸿蒙AVScreenCapture

harmony 鸿蒙AVSource

harmony 鸿蒙AudioDecoder

harmony 鸿蒙AudioEncoder

harmony 鸿蒙CodecBase

harmony 鸿蒙Core

0  赞