IAudioCapture

概述

AudioCapture音频录音接口。

提供音频录音支持的驱动能力，包括音频控制、音频属性、音频场景、音频音量、录制音频帧数据等。

Since:

3.2

Version:

1.0

相关模块:

Audio

汇总

Public 成员函数

成员函数说明

AddAudioEffect()

IAudioCapture::AddAudioEffect ([in] unsigned long effectid)

描述:

添加音频效果。

参数:

返回:

成功返回值0，失败返回负值。

AudioDevDump()

IAudioCapture::AudioDevDump ([in] int range, [in] int fd )

描述:

保存音频设备信息。

参数:

返回:

成功返回值0，失败返回负值。

CaptureFrame()

IAudioCapture::CaptureFrame ([out] byte[] frame, [in] unsigned long requestBytes )

描述:

从音频驱动中录制一帧输入数据（录音，音频上行数据）。

参数:

返回:

成功返回值0，失败返回负值。

CheckSceneCapability()

IAudioCapture::CheckSceneCapability ([in] struct AudioSceneDescriptor scene, [out] boolean supported )

描述:

判断某个音频场景能力是否支持。

参数:

返回:

成功返回值0，失败返回负值。

参见:

SelectScene

Flush()

IAudioCapture::Flush ()

描述:

刷新音频缓冲区buffer中的数据。

返回:

成功返回值0，失败返回负值。

GetCapturePosition()

IAudioCapture::GetCapturePosition ([out] unsigned long frames, [out] struct AudioTimeStamp time )

描述:

获取音频已输入的帧数。

参数:

返回:

成功返回值0，失败返回负值。

参见:

CaptureFrame

GetCurrentChannelId()

IAudioCapture::GetCurrentChannelId ([out] unsigned int channelId)

描述:

获取音频的数据通道ID。

参数:

返回:

成功返回值0，失败返回负值。

GetExtraParams()

IAudioCapture::GetExtraParams ([out] String keyValueList)

描述:

获取音频拓展参数。

参数:

返回:

成功返回值0，失败返回负值。

GetFrameBufferSize()

IAudioCapture::GetFrameBufferSize ([out] unsigned long bufferSize)

描述:

获取缓冲区大小。

参数:

返回:

成功返回值0，失败返回负值。

GetFrameCount()

IAudioCapture::GetFrameCount ([out] unsigned long count)

描述:

获取音频buffer中的音频帧数。

参数:

返回:

成功返回值0，失败返回负值。

GetFrameSize()

IAudioCapture::GetFrameSize ([out] unsigned long size)

描述:

获取一帧音频数据的长度（字节数）大小。

参数:

返回:

成功返回值0，失败返回负值。

GetGain()

IAudioCapture::GetGain ([out] float gain)

描述:

获取音频流的增益。

参数:

返回:

成功返回值0，失败返回负值。

参见:

GetGainThreshold

SetGain

GetGainThreshold()

IAudioCapture::GetGainThreshold ([out] float min, [out] float max )

描述:

获取音频流增益的阈值。

在具体的功能实现中，可以根据芯片平台的实际情况来进行处理：

• 可以使用实际的增益值，例如增益的范围为-50db ~ 6db。

• 也可以将增益范围设定为0.0~1.0，如果增益的范围为-50db ~ 6db， 则增益的映射关系为0.0表示静音（-50db），1.0表示最大增益（6db）。

参数:

返回:

成功返回值0，失败返回负值。

参见:

GetGain

SetGain

GetMmapPosition()

IAudioCapture::GetMmapPosition ([out] unsigned long frames, [out] struct AudioTimeStamp time )

描述:

获取当前mmap的读/写位置。

参数:

返回:

成功返回值0，失败返回负值。

GetMute()

IAudioCapture::GetMute ([out] boolean mute)

描述:

获取音频的静音状态。

参数:

返回:

成功返回值0，失败返回负值。

参见:

SetMute

GetSampleAttributes()

IAudioCapture::GetSampleAttributes ([out] struct AudioSampleAttributes attrs)

描述:

获取音频采样的属性参数。

参数:

返回:

成功返回值0，失败返回负值。

参见:

SetSampleAttributes

GetVolume()

IAudioCapture::GetVolume ([out] float volume)

描述:

获取一个音频流的音量。

参数:

返回:

成功返回值0，失败返回负值。

参见:

SetVolume

IsSupportsPauseAndResume()

IAudioCapture::IsSupportsPauseAndResume ([out] boolean supportPause, [out] boolean supportResume )

描述:

判断声卡是否支持音频录制的暂停和恢复功能。

参数:

返回:

成功返回值0，失败返回负值。

Pause()

IAudioCapture::Pause ()

描述:

暂停一个音频播放或录音处理。

返回:

成功返回值0，失败返回负值。

参见:

Resume

RemoveAudioEffect()

IAudioCapture::RemoveAudioEffect ([in] unsigned long effectid)

描述:

移除音频效果。

参数:

返回:

成功返回值0，失败返回负值。

ReqMmapBuffer()

IAudioCapture::ReqMmapBuffer ([in] int reqSize, [in] struct AudioMmapBufferDescripter desc )

描述:

请求mmap缓冲区。

参数:

返回:

成功返回值0，失败返回负值。

Resume()

IAudioCapture::Resume ()

描述:

恢复一个音频播放或录音处理。

返回:

成功返回值0，失败返回负值。

参见:

Pause

SelectScene()

IAudioCapture::SelectScene ([in] struct AudioSceneDescriptor scene)

描述:

选择音频场景。

• 选择一个非常具体的音频场景（应用场景和输出设备的组合），例如同样是使用手机中的喇叭作为输出设备。

  • 在媒体播放场景中，scene为media_speaker。
  • 在语音通话免提场景中，scene为voice_speaker。

• 只是选择一个音频场景，例如使用场景为媒体播放（media）、电影播放（movie）、游戏播放（game）。

• 只是选择一个音频输出设备，例如输出设备为听筒（receiver）、喇叭（speaker）、有线耳机（headset）。

参数:

返回:

成功返回值0，失败返回负值。

参见:

CheckSceneCapability

SetExtraParams()

IAudioCapture::SetExtraParams ([in] String keyValueList)

描述:

设置音频拓展参数。

参数:

返回:

成功返回值0，失败返回负值。

SetGain()

IAudioCapture::SetGain ([in] float gain)

描述:

设置音频流的增益。

参数:

返回:

成功返回值0，失败返回负值。

参见:

GetGainThreshold

GetGain

SetMute()

IAudioCapture::SetMute ([in] boolean mute)

描述:

设置音频的静音状态。

参数:

返回:

成功返回值0，失败返回负值。

参见:

GetMute

SetSampleAttributes()

IAudioCapture::SetSampleAttributes ([in] struct AudioSampleAttributes attrs)

描述:

设置音频采样的属性参数。

参数:

返回:

成功返回值0，失败返回负值。

参见:

GetSampleAttributes

SetVolume()

IAudioCapture::SetVolume ([in] float volume)

描述:

设置一个音频流的音量。

音量的取值范围是0.0~1.0，如果音频服务中的音量等级范围是0 ~ 15， 则音量的映射关系为0.0（或0）表示静音，1.0（或15）表示最大音量等级。

参数:

返回:

成功返回值0，失败返回负值。

Start()

IAudioCapture::Start ()

描述:

启动一个音频播放或录音处理。

返回:

成功返回值0，失败返回负值。

参见:

Stop

Stop()

IAudioCapture::Stop ()

描述:

停止一个音频播放或录音处理。

返回:

成功返回值0，失败返回负值。

参见:

Start

TurnStandbyMode()

IAudioCapture::TurnStandbyMode ()

描述:

设置或去设置设备的待机模式。

返回:

设置设备待机模式成功返回值0，再次执行后去设置待机模式成功返回正值，失败返回负值。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙HDI 参数参考

harmony 鸿蒙ActRecognitionEvent

harmony 鸿蒙Activation

harmony 鸿蒙ActivityRecognitionTypes.idl

harmony 鸿蒙AddFusion

harmony 鸿蒙Alignment

harmony 鸿蒙AllocInfo

harmony 鸿蒙ApduSimIORequestInfo

harmony 鸿蒙ArgMaxFusion

harmony 鸿蒙Audio