harmony 鸿蒙OHAudio

2023-10-30 浏览 (1344)

OHAudio

概述

提供音频模块Native接口定义。

@syscap SystemCapability.Multimedia.Audio.Core

起始版本：

10

汇总

文件

名称描述
native_audiocapturer.h声明输入类型的音频流相关接口。
引用文件：<ohaudio/native_audiocapturer.h>
库：libohaudio.so
native_audiorenderer.h声明输出类型的音频流相关接口。
引用文件：<ohaudio/native_audiorenderer.h>
库：libohaudio.so
native_audiostream_base.h声明OHAudio基础的数据结构。
引用文件：<ohaudio/native_audiostream_base.h>
库：libohaudio.so
native_audiostreambuilder.h声明音频流构造器相关接口。
引用文件：<ohaudio/native_audiostreambuilder.h>
库：libohaudio.so

结构体

名称描述
OH_AudioRenderer_Callbacks_Struct声明输出音频流的回调函数指针。
OH_AudioCapturer_Callbacks_Struct声明输入音频流的回调函数指针。

类型定义

名称描述
OH_AudioStreamBuilder声明音频流的构造器。
OH_AudioRenderer声明输出音频流。
OH_AudioCapturer声明输入音频流。
OH_AudioRenderer_Callbacks声明输出音频流的回调函数指针。
OH_AudioCapturer_Callbacks声明输入音频流的回调函数指针。

枚举

名称描述
OH_AudioStream_Result { AUDIOSTREAM_SUCCESS, AUDIOSTREAM_ERROR_INVALID_PARAM, AUDIOSTREAM_ERROR_ILLEGAL_STATE, AUDIOSTREAM_ERROR_SYSTEM }音频结果码。
OH_AudioStream_Type { AUDIOSTREAM_TYPE_RENDERER = 1, AUDIOSTREAM_TYPE_CAPTURER = 2 }音频流类型。
OH_AudioStream_SampleFormat { AUDIOSTREAM_SAMPLE_U8 = 0, AUDIOSTREAM_SAMPLE_S16LE = 1, AUDIOSTREAM_SAMPLE_S24LE = 2, AUDIOSTREAM_SAMPLE_S32LE = 3 }定义音频流采样格式。
OH_AudioStream_EncodingType { AUDIOSTREAM_ENCODING_TYPE_RAW = 0 }定义音频流编码类型。
OH_AudioStream_Usage { AUDIOSTREAM_USAGE_UNKNOWN = 0, AUDIOSTREAM_USAGE_MUSIC = 1, AUDIOSTREAM_USAGE_COMMUNICATION = 2, AUDIOSTREAM_USAGE_GAME = 11 }定义音频流使用场景。
OH_AudioStream_LatencyMode { AUDIOSTREAM_LATENCY_MODE_NORMAL = 0, AUDIOSTREAM_LATENCY_MODE_FAST = 1}定义音频时延模式。
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
}		定义音频流的状态。
OH_AudioStream_SourceType { AUDIOSTREAM_SOURCE_TYPE_INVALID = -1, AUDIOSTREAM_SOURCE_TYPE_MIC, AUDIOSTREAM_SOURCE_TYPE_VOICE_RECOGNITION = 1, AUDIOSTREAM_SOURCE_TYPE_VOICE_COMMUNICATION = 7 }定义音频流使用场景。

函数

名称描述
OH_AudioCapturer_Release (OH_AudioCapturer *capturer)释放输入音频流。
OH_AudioCapturer_Start (OH_AudioCapturer *capturer)开始获取音频数据。
OH_AudioCapturer_Pause (OH_AudioCapturer *capturer)暂停输入音频流。
OH_AudioCapturer_Stop (OH_AudioCapturer *capturer)停止输入音频流
OH_AudioCapturer_Flush (OH_AudioCapturer *capturer)丢弃获取的音频数据。
OH_AudioCapturer_GetCurrentState (OH_AudioCapturer *capturer, OH_AudioStream_State *state)查询当前输入音频流状态。
OH_AudioCapturer_GetLatencyMode (OH_AudioCapturer *capturer, OH_AudioStream_LatencyMode *latencyMode)查询当前输入音频流时延模式。
OH_AudioCapturer_GetStreamId (OH_AudioCapturer *capturer, uint32_t *streamId)查询当前输入音频流ID。
OH_AudioCapturer_GetSamplingRate (OH_AudioCapturer *capturer, int32_t *rate)查询当前输入音频流采样率。
OH_AudioCapturer_GetChannelCount (OH_AudioCapturer *capturer, int32_t *channelCount)查询当前输入音频流通道数。
OH_AudioCapturer_GetSampleFormat (OH_AudioCapturer *capturer, OH_AudioStream_SampleFormat *sampleFormat)查询当前输入音频流采样格式。
OH_AudioCapturer_GetEncodingType (OH_AudioCapturer *capturer, OH_AudioStream_EncodingType *encodingType)查询当前输入音频流编码类型。
OH_AudioCapturer_GetCapturerInfo (OH_AudioCapturer *capturer, OH_AudioStream_SourceType *sourceType)查询当前输入音频流工作场景类型。
OH_AudioRenderer_Release (OH_AudioRenderer *renderer)释放输出音频流。
OH_AudioRenderer_Start (OH_AudioRenderer *renderer)开始输出音频数据。
OH_AudioRenderer_Pause (OH_AudioRenderer *renderer)暂停输出音频流。
OH_AudioRenderer_Stop (OH_AudioRenderer *renderer)停止输出音频流
OH_AudioRenderer_Flush (OH_AudioRenderer *renderer)丢弃已经写入的音频数据。
OH_AudioRenderer_GetCurrentState (OH_AudioRenderer *renderer, OH_AudioStream_State *state)查询当前输出音频流状态。
OH_AudioRenderer_GetSamplingRate (OH_AudioRenderer *renderer, int32_t *rate)查询当前输出音频流采样率。
OH_AudioRenderer_GetStreamId (OH_AudioRenderer *renderer, uint32_t *streamId)查询当前输出音频流ID。
OH_AudioRenderer_GetChannelCount (OH_AudioRenderer *renderer, int32_t *channelCount)查询当前输出音频流通道数。
OH_AudioRenderer_GetSampleFormat (OH_AudioRenderer *renderer, OH_AudioStream_SampleFormat *sampleFormat)查询当前输出音频流采样格式。
OH_AudioRenderer_GetLatencyMode (OH_AudioRenderer *renderer, OH_AudioStream_LatencyMode *latencyMode)查询当前输出音频流时延模式。
OH_AudioRenderer_GetRendererInfo (OH_AudioRenderer *renderer, OH_AudioStream_Usage *usage)查询当前输出音频流工作场景类型。
OH_AudioRenderer_GetEncodingType (OH_AudioRenderer *renderer, OH_AudioStream_EncodingType *encodingType)查询当前输出音频流编码类型。
OH_AudioStreamBuilder_Create (OH_AudioStreamBuilder **builder, OH_AudioStream_Type type)创建一个输入或者输出类型的音频流构造器。
OH_AudioStreamBuilder_Destroy (OH_AudioStreamBuilder *builder)销毁一个音频流构造器。
OH_AudioStreamBuilder_SetSamplingRate (OH_AudioStreamBuilder *builder, int32_t rate)设置音频流的采样率属性。
OH_AudioStreamBuilder_SetChannelCount (OH_AudioStreamBuilder *builder, int32_t channelCount)设置音频流的通道数属性。
OH_AudioStreamBuilder_SetSampleFormat (OH_AudioStreamBuilder *builder, OH_AudioStream_SampleFormat format)设置音频流的采样格式属性。
OH_AudioStreamBuilder_SetEncodingType (OH_AudioStreamBuilder *builder, OH_AudioStream_EncodingType encodingType)设置音频流的编码类型属性。
OH_AudioStreamBuilder_SetLatencyMode (OH_AudioStreamBuilder *builder, OH_AudioStream_LatencyMode latencyMode)设置音频流的时延模式。
OH_AudioStreamBuilder_SetRendererInfo (OH_AudioStreamBuilder *builder, OH_AudioStream_Usage usage)设置输出音频流的工作场景。
OH_AudioStreamBuilder_SetCapturerInfo (OH_AudioStreamBuilder *builder, OH_AudioStream_SourceType sourceType)设置输入音频流的工作场景。
OH_AudioStreamBuilder_SetRendererCallback (OH_AudioStreamBuilder *builder, OH_AudioRenderer_Callbacks callbacks, void *userData)设置输出音频流的回调。
OH_AudioStreamBuilder_SetCapturerCallback (OH_AudioStreamBuilder *builder, OH_AudioCapturer_Callbacks callbacks, void *userData)设置输入音频流的回调。
OH_AudioStreamBuilder_GenerateRenderer (OH_AudioStreamBuilder *builder, OH_AudioRenderer **audioRenderer)创建输出音频流实例。
OH_AudioStreamBuilder_GenerateCapturer (OH_AudioStreamBuilder *builder, OH_AudioCapturer **audioCapturer)创建输入音频流实例。

变量

名称描述
(*OH_AudioRenderer_Callbacks_Struct::OH_AudioRenderer_OnWriteData )(OH_AudioRenderer *renderer, void *userData, void *buffer, int32_t lenth)该函数指针将指向用于写入音频数据的回调函数。
(*OH_AudioCapturer_Callbacks_Struct::OH_AudioCapturer_OnReadData )(OH_AudioCapturer *capturer, void *userData, void *buffer, int32_t lenth)该函数指针将指向用于读取音频数据的回调函数。

类型定义说明

OH_AudioCapturer

typedef struct OH_AudioCapturerStruct OH_AudioCapturer

描述：

声明输入音频流。

输入音频流的实例被用来获取音频数据。

@syscap SystemCapability.Multimedia.Audio.Core

起始版本：

10

OH_AudioCapturer_Callbacks

typedef struct OH_AudioCapturer_Callbacks_Struct OH_AudioCapturer_Callbacks

描述：

声明输入音频流的回调函数指针。

@syscap SystemCapability.Multimedia.Audio.Core

起始版本：

10

OH_AudioRenderer

typedef struct OH_AudioRendererStruct OH_AudioRenderer

描述：

声明输出音频流。

输出音频流的实例被用来播放音频数据。

@syscap SystemCapability.Multimedia.Audio.Core

起始版本：

10

OH_AudioRenderer_Callbacks

typedef struct OH_AudioRenderer_Callbacks_Struct OH_AudioRenderer_Callbacks

描述：

声明输出音频流的回调函数指针。

@syscap SystemCapability.Multimedia.Audio.Core

起始版本：

10

OH_AudioStreamBuilder

typedef struct OH_AudioStreamBuilderStruct OH_AudioStreamBuilder

描述：

声明音频流的构造器。

构造器实例通常被用来设置音频流属性和创建音频流。

@syscap SystemCapability.Multimedia.Audio.Core

起始版本：

10

枚举类型说明

OH_AudioStream_EncodingType

enum OH_AudioStream_EncodingType

描述：

定义音频流编码类型。

@syscap SystemCapability.Multimedia.Audio.Core

起始版本：

10

枚举值描述
AUDIOSTREAM_ENCODING_TYPE_RAWPCM编码。

OH_AudioStream_LatencyMode

enum OH_AudioStream_LatencyMode

描述：

定义音频时延模式。

@syscap SystemCapability.Multimedia.Audio.Core

起始版本：

10

枚举值描述
AUDIOSTREAM_LATENCY_MODE_NORMAL该模式代表一个普通时延的音频流。
AUDIOSTREAM_LATENCY_MODE_FAST该模式代表一个低时延的音频流。

OH_AudioStream_Result

enum OH_AudioStream_Result

描述：

音频结果码。

@syscap SystemCapability.Multimedia.Audio.Core

起始版本：

10

枚举值描述
AUDIOSTREAM_SUCCESS操作成功
AUDIOSTREAM_ERROR_INVALID_PARAM入参错误。
AUDIOSTREAM_ERROR_ILLEGAL_STATE非法状态。
AUDIOSTREAM_ERROR_SYSTEM系统通用错误。

OH_AudioStream_SampleFormat

enum OH_AudioStream_SampleFormat

描述：

定义音频流采样格式。

@syscap SystemCapability.Multimedia.Audio.Core

起始版本：

10

枚举值描述
AUDIOSTREAM_SAMPLE_U8Unsigned 8位。
AUDIOSTREAM_SAMPLE_S16LEShort 16位小端。
AUDIOSTREAM_SAMPLE_S24LEShort 24位小端。
AUDIOSTREAM_SAMPLE_S32LEShort 32位小端。

OH_AudioStream_SourceType

enum OH_AudioStream_SourceType

描述：

定义音频流使用场景。

通常用来描述音频输入流的使用场景。

@syscap SystemCapability.Multimedia.Audio.Core

起始版本：

10

枚举值描述
AUDIOSTREAM_SOURCE_TYPE_INVALID不合法状态。
AUDIOSTREAM_SOURCE_TYPE_MIC录音。
AUDIOSTREAM_SOURCE_TYPE_VOICE_RECOGNITION语音识别。
AUDIOSTREAM_SOURCE_TYPE_VOICE_COMMUNICATION通话。

OH_AudioStream_State

enum OH_AudioStream_State

描述：

定义音频流的状态。

@syscap SystemCapability.Multimedia.Audio.Core

起始版本：

10

枚举值描述
AUDIOSTREAM_STATE_INVALID不合法的状态。
AUDIOSTREAM_STATE_PREPARED准备状态。
AUDIOSTREAM_STATE_RUNNING工作状态。
AUDIOSTREAM_STATE_STOPPED停止状态。
AUDIOSTREAM_STATE_RELEASED释放状态。
AUDIOSTREAM_STATE_PAUSED暂停状态。

OH_AudioStream_Type

enum OH_AudioStream_Type

描述：

音频流类型。

@syscap SystemCapability.Multimedia.Audio.Core

起始版本：

10

枚举值描述
AUDIOSTREAM_TYPE_RENDERER该类型代表音频流是输出流。
AUDIOSTREAM_TYPE_CAPTURER该类型代表音频流是输入流。

OH_AudioStream_Usage

enum OH_AudioStream_Usage

描述：

定义音频流使用场景。

通常用来描述音频输出流的使用场景。

@syscap SystemCapability.Multimedia.Audio.Core

起始版本：

10

枚举值描述
AUDIOSTREAM_USAGE_UNKNOWN未定义。
AUDIOSTREAM_USAGE_MUSIC音乐。
AUDIOSTREAM_USAGE_COMMUNICATION通话。
AUDIOSTREAM_USAGE_GAME游戏。

函数说明

OH_AudioCapturer_Flush()

OH_AudioStream_Result OH_AudioCapturer_Flush (OH_AudioCapturer * capturer)

描述：

丢弃获取的音频数据。

参数：

名称描述
capturer指向OH_AudioStreamBuilder_GenerateCapturer创建的音频流实例。

返回：

AUDIOSTREAM_SUCCESS 或者一个预期之外的错误。

起始版本：

10

OH_AudioCapturer_GetCapturerInfo()

OH_AudioStream_Result OH_AudioCapturer_GetCapturerInfo (OH_AudioCapturer * capturer, OH_AudioStream_SourceType * sourceType )

描述：

查询当前输入音频流工作场景类型。

参数：

名称描述
capturer指向OH_AudioStreamBuilder_GenerateCapturer创建的音频流实例。
sourceType指向一个用来接收输入类型音频流的工作场景的变量。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioCapturer_GetChannelCount()

OH_AudioStream_Result OH_AudioCapturer_GetChannelCount (OH_AudioCapturer * capturer, int32_t * channelCount )

描述：

查询当前输入音频流通道数。

参数：

名称描述
capturer指向OH_AudioStreamBuilder_GenerateCapturer创建的音频流实例。
channelCount指向一个用来接收音频流通道数的变量。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioCapturer_GetCurrentState()

OH_AudioStream_Result OH_AudioCapturer_GetCurrentState (OH_AudioCapturer * capturer, OH_AudioStream_State * state )

描述：

查询当前输入音频流状态。

参数：

名称描述
capturer指向OH_AudioStreamBuilder_GenerateCapturer创建的音频流实例。
state指向一个用来接收音频流状态的变量。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioCapturer_GetEncodingType()

OH_AudioStream_Result OH_AudioCapturer_GetEncodingType (OH_AudioCapturer * capturer, OH_AudioStream_EncodingType * encodingType )

描述：

查询当前输入音频流编码类型。

参数：

名称描述
capturer指向OH_AudioStreamBuilder_GenerateCapturer创建的音频流实例。
encodingType指向一个用来接收音频流编码类型的变量。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioCapturer_GetLatencyMode()

OH_AudioStream_Result OH_AudioCapturer_GetLatencyMode (OH_AudioCapturer * capturer, OH_AudioStream_LatencyMode * latencyMode )

描述：

查询当前输入音频流时延模式。

参数：

名称描述
capturer指向OH_AudioStreamBuilder_GenerateCapturer创建的音频流实例。
latencyMode指向一个用来接收音频流时延模式的变量。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioCapturer_GetSampleFormat()

OH_AudioStream_Result OH_AudioCapturer_GetSampleFormat (OH_AudioCapturer * capturer, OH_AudioStream_SampleFormat * sampleFormat )

描述：

查询当前输入音频流采样格式。

参数：

名称描述
capturer指向OH_AudioStreamBuilder_GenerateCapturer创建的音频流实例。
sampleFormat指向一个用来接收音频流采样格式的变量。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioCapturer_GetSamplingRate()

OH_AudioStream_Result OH_AudioCapturer_GetSamplingRate (OH_AudioCapturer * capturer, int32_t * rate )

描述：

查询当前输入音频流采样率。

参数：

名称描述
capturer指向OH_AudioStreamBuilder_GenerateCapturer创建的音频流实例。
rate指向一个用来接收音频流采样率的变量。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioCapturer_GetStreamId()

OH_AudioStream_Result OH_AudioCapturer_GetStreamId (OH_AudioCapturer * capturer, uint32_t * streamId )

描述：

查询当前输入音频流ID。

参数：

名称描述
capturer指向OH_AudioStreamBuilder_GenerateCapturer创建的音频流实例。
streamId指向一个用来接收音频流ID的变量。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioCapturer_Pause()

OH_AudioStream_Result OH_AudioCapturer_Pause (OH_AudioCapturer * capturer)

描述：

暂停输入音频流。

参数：

名称描述
capturer指向OH_AudioStreamBuilder_GenerateCapturer创建的音频流实例。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioCapturer_Release()

OH_AudioStream_Result OH_AudioCapturer_Release (OH_AudioCapturer * capturer)

描述：

释放输入音频流。

参数：

名称描述
capturer指向OH_AudioStreamBuilder_GenerateCapturer创建的音频流实例。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioCapturer_Start()

OH_AudioStream_Result OH_AudioCapturer_Start (OH_AudioCapturer * capturer)

描述：

开始获取音频数据。

参数：

名称描述
capturer指向OH_AudioStreamBuilder_GenerateCapturer创建的音频流实例。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioCapturer_Stop()

OH_AudioStream_Result OH_AudioCapturer_Stop (OH_AudioCapturer * capturer)

描述：

停止输入音频流

参数：

名称描述
capturer指向OH_AudioStreamBuilder_GenerateCapturer创建的音频流实例。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioRenderer_Flush()

OH_AudioStream_Result OH_AudioRenderer_Flush (OH_AudioRenderer * renderer)

描述：

丢弃已经写入的音频数据。

参数：

名称描述
renderer指向OH_AudioStreamBuilder_GenerateRenderer创建的音频流实例。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioRenderer_GetChannelCount()

OH_AudioStream_Result OH_AudioRenderer_GetChannelCount (OH_AudioRenderer * renderer, int32_t * channelCount )

描述：

查询当前输出音频流通道数。

参数：

名称描述
renderer指向OH_AudioStreamBuilder_GenerateRenderer创建的音频流实例。
channelCount指向一个用来接收音频流通道数的变量。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioRenderer_GetCurrentState()

OH_AudioStream_Result OH_AudioRenderer_GetCurrentState (OH_AudioRenderer * renderer, OH_AudioStream_State * state )

描述：

查询当前输出音频流状态。

参数：

名称描述
renderer指向OH_AudioStreamBuilder_GenerateRenderer创建的音频流实例。
state指向一个用来接收音频流状态的变量。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioRenderer_GetEncodingType()

OH_AudioStream_Result OH_AudioRenderer_GetEncodingType (OH_AudioRenderer * renderer, OH_AudioStream_EncodingType * encodingType )

描述：

查询当前输出音频流编码类型。

参数：

名称描述
renderer指向OH_AudioStreamBuilder_GenerateRenderer创建的音频流实例。
encodingType指向一个用来接收音频流编码类型的变量。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioRenderer_GetLatencyMode()

OH_AudioStream_Result OH_AudioRenderer_GetLatencyMode (OH_AudioRenderer * renderer, OH_AudioStream_LatencyMode * latencyMode )

描述：

查询当前输出音频流时延模式。

参数：

名称描述
renderer指向OH_AudioStreamBuilder_GenerateRenderer创建的音频流实例。
latencyMode指向一个用来接收音频流时延模式的变量。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioRenderer_GetRendererInfo()

OH_AudioStream_Result OH_AudioRenderer_GetRendererInfo (OH_AudioRenderer * renderer, OH_AudioStream_Usage * usage )

描述：

查询当前输出音频流工作场景类型。

参数：

名称描述
renderer指向OH_AudioStreamBuilder_GenerateRenderer创建的音频流实例。
usage指向一个用来接收输出类型音频流的工作场景的变量。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioRenderer_GetSampleFormat()

OH_AudioStream_Result OH_AudioRenderer_GetSampleFormat (OH_AudioRenderer * renderer, OH_AudioStream_SampleFormat * sampleFormat )

描述：

查询当前输出音频流采样格式。

参数：

名称描述
renderer指向OH_AudioStreamBuilder_GenerateRenderer创建的音频流实例。
sampleFormat指向一个用来接收音频流采样格式的变量。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioRenderer_GetSamplingRate()

OH_AudioStream_Result OH_AudioRenderer_GetSamplingRate (OH_AudioRenderer * renderer, int32_t * rate )

描述：

查询当前输出音频流采样率。

参数：

名称描述
renderer指向OH_AudioStreamBuilder_GenerateRenderer创建的音频流实例。
rate指向一个用来接收音频流采样率的变量。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioRenderer_GetStreamId()

OH_AudioStream_Result OH_AudioRenderer_GetStreamId (OH_AudioRenderer * renderer, uint32_t * streamId )

描述：

查询当前输出音频流ID。

参数：

名称描述
renderer指向OH_AudioStreamBuilder_GenerateRenderer创建的音频流实例。
streamId指向一个用来接收音频流ID的变量。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioRenderer_Pause()

OH_AudioStream_Result OH_AudioRenderer_Pause (OH_AudioRenderer * renderer)

描述：

暂停输出音频流。

参数：

名称描述
renderer指向OH_AudioStreamBuilder_GenerateRenderer创建的音频流实例。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioRenderer_Release()

OH_AudioStream_Result OH_AudioRenderer_Release (OH_AudioRenderer * renderer)

描述：

释放输出音频流。

参数：

名称描述
renderer指向OH_AudioStreamBuilder_GenerateRenderer创建的音频流实例。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioRenderer_Start()

OH_AudioStream_Result OH_AudioRenderer_Start (OH_AudioRenderer * renderer)

描述：

开始输出音频数据。

参数：

名称描述
renderer指向OH_AudioStreamBuilder_GenerateRenderer创建的音频流实例。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioRenderer_Stop()

OH_AudioStream_Result OH_AudioRenderer_Stop (OH_AudioRenderer * renderer)

描述：

停止输出音频流

参数：

名称描述
renderer指向OH_AudioStreamBuilder_GenerateRenderer创建的音频流实例。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioStreamBuilder_Create()

OH_AudioStream_Result OH_AudioStreamBuilder_Create (OH_AudioStreamBuilder ** builder, OH_AudioStream_Type type )

描述：

创建一个输入或者输出类型的音频流构造器。

当构造器不再使用时，需要调用OH_AudioStreamBuilder_Destroy()销毁它。

参数：

名称描述
builder该引用指向创建的构造器的结果。
type构造器的流类型。AUDIOSTREAM_TYPE_RENDERER or AUDIOSTREAM_TYPE_CAPTURER

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioStreamBuilder_Destroy()

OH_AudioStream_Result OH_AudioStreamBuilder_Destroy (OH_AudioStreamBuilder * builder)

描述：

销毁一个音频流构造器。

当构造器不再使用时，需要调用该函数销毁它。

参数：

名称描述
builder指向OH_AudioStreamBuilder_Create()创建的构造器实例。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioStreamBuilder_GenerateCapturer()

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

描述：

创建输入音频流实例。

参数：

名称描述
builder指向OH_AudioStreamBuilder_Create()创建的构造器实例。
audioCapturer指向输入音频流实例的指针，将被用来接收函数创建的结果。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioStreamBuilder_GenerateRenderer()

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

描述：

创建输出音频流实例。

参数：

名称描述
builder指向OH_AudioStreamBuilder_Create()创建的构造器实例。
audioRenderer指向输出音频流实例的指针，将被用来接收函数创建的结果。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioStreamBuilder_SetCapturerCallback()

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

描述：

设置输入音频流的回调。

参数：

名称描述
builder指向OH_AudioStreamBuilder_Create()创建的构造器实例。
callbacks将被用来处理输入音频流相关事件的回调函数。
userData指向通过回调函数传递的应用数据指针。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioStreamBuilder_SetCapturerInfo()

OH_AudioStream_Result OH_AudioStreamBuilder_SetCapturerInfo (OH_AudioStreamBuilder * builder, OH_AudioStream_SourceType sourceType )

描述：

设置输入音频流的工作场景。

参数：

名称描述
builder指向OH_AudioStreamBuilder_Create()创建的构造器实例。
sourceType输入音频流属性，使用的工作场景。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioStreamBuilder_SetChannelCount()

OH_AudioStream_Result OH_AudioStreamBuilder_SetChannelCount (OH_AudioStreamBuilder * builder, int32_t channelCount )

描述：

设置音频流的通道数属性。

参数：

名称描述
builder指向OH_AudioStreamBuilder_Create()创建的构造器实例。
channelCount音频流通道数。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioStreamBuilder_SetEncodingType()

OH_AudioStream_Result OH_AudioStreamBuilder_SetEncodingType (OH_AudioStreamBuilder * builder, OH_AudioStream_EncodingType encodingType )

描述：

设置音频流的编码类型属性。

参数：

名称描述
builder指向OH_AudioStreamBuilder_Create()创建的构造器实例。
encodingType音频流编码类型, AUDIOSTREAM_ENCODING_PCM

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioStreamBuilder_SetLatencyMode()

OH_AudioStream_Result OH_AudioStreamBuilder_SetLatencyMode (OH_AudioStreamBuilder * builder, OH_AudioStream_LatencyMode latencyMode )

描述：

设置音频流的时延模式。

参数：

名称描述
builder指向OH_AudioStreamBuilder_Create()创建的构造器实例。
latencyMode音频流时延模式。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioStreamBuilder_SetRendererCallback()

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

描述：

设置输出音频流的回调。

参数：

名称描述
builder指向OH_AudioStreamBuilder_Create()创建的构造器实例。
callbacks将被用来处理输出音频流相关事件的回调函数。
userData指向通过回调函数传递的应用数据指针。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioStreamBuilder_SetRendererInfo()

OH_AudioStream_Result OH_AudioStreamBuilder_SetRendererInfo (OH_AudioStreamBuilder * builder, OH_AudioStream_Usage usage )

描述：

设置输出音频流的工作场景。

参数：

名称描述
builder指向OH_AudioStreamBuilder_Create()创建的构造器实例。
usage输出音频流属性，使用的工作场景。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioStreamBuilder_SetSampleFormat()

OH_AudioStream_Result OH_AudioStreamBuilder_SetSampleFormat (OH_AudioStreamBuilder * builder, OH_AudioStream_SampleFormat format )

描述：

设置音频流的采样格式属性。

参数：

名称描述
builder指向OH_AudioStreamBuilder_Create()创建的构造器实例。
format音频流采样格式。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

OH_AudioStreamBuilder_SetSamplingRate()

OH_AudioStream_Result OH_AudioStreamBuilder_SetSamplingRate (OH_AudioStreamBuilder * builder, int32_t rate )

描述：

设置音频流的采样率属性。

参数：

名称描述
builder指向OH_AudioStreamBuilder_Create()创建的构造器实例。
channelCount音频流采样率。

返回：

AUDIOSTREAM_SUCCESS 或者一个不期望发生的错误。

起始版本：

10

变量说明

OH_AudioCapturer_OnReadData

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

描述：

该函数指针将指向用于读取音频数据的回调函数。

起始版本：

10

OH_AudioRenderer_OnWriteData

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

描述：

该函数指针将指向用于写入音频数据的回调函数。

起始版本：

10

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Native API

harmony 鸿蒙AVCapability

harmony 鸿蒙AVDemuxer

harmony 鸿蒙AVMuxer

harmony 鸿蒙AVScreenCapture

harmony 鸿蒙AVSource

harmony 鸿蒙AudioDecoder

harmony 鸿蒙AudioEncoder

harmony 鸿蒙CodecBase

harmony 鸿蒙Core

  • 所属分类： 后端技术
  • 本文标签： 软件 鸿蒙
  • 版权声明： 本文链接 https://seaxiang.com/blog/ab4babc45c804525948ef2d94cfc91aa