类 AudioDataStream

class AudioDataStream
  : public std::enable_shared_from_this< AudioDataStream >

表示用于以流的形式操作音频数据的音频数据流。 在版本 1.4.0 中添加。

成员

属性

语法: public constPropertyCollection & Properties;

其他 SpeechSynthesisResult 属性的集合。

~AudioDataStream

语法: public inline ~AudioDataStream ( );

销毁 实例。

GetStatus

语法: public inline StreamStatus GetStatus ( );

获取音频数据流的当前状态。

返回

当前状态

CanReadData

语法: public inline bool CanReadData ( uint32_t bytesRequested );

检查流是否有足够的数据可以读取。

参数

  • bytesRequested 请求的数据大小(以字节为单位)。

返回

一个布尔值,指示流是否有足够的数据进行读取。

CanReadData

语法: public inline bool CanReadData ( uint32_t pos , uint32_t bytesRequested );

从指定位置开始,检查流是否有足够的数据要读取。

参数

  • pos 从流开始计数的位置。

  • bytesRequested 请求的数据大小(以字节为单位)。

返回

一个布尔值,指示流是否有足够的数据进行读取。

ReadData

语法: public inline uint32_t ReadData ( uint8_t * buffer , uint32_t bufferSize );

读取音频数据的区块并将其填充到给定的缓冲区。

参数

  • buffer 用于接收读取数据的缓冲区。

  • bufferSize 缓冲区的大小。

返回

填充到缓冲区的数据的大小,0 表示流结束

ReadData

语法: public inline uint32_t ReadData ( uint32_t pos , uint8_t * buffer , uint32_t bufferSize );

从指定位置开始,读取音频数据的区块并将其填充到给定的缓冲区。

参数

  • pos 从流开始计数的位置。

  • buffer 用于接收读取数据的缓冲区。

  • bufferSize 缓冲区的大小。

返回

填充到缓冲区的数据的大小,0 表示流结束

SaveToWavFile

语法: public inline void SaveToWavFile ( const std::string & fileName );

以同步方式将音频数据保存到文件。

参数

  • fileName 具有完整路径的文件名。

SaveToWavFileAsync

语法: public inline std::future< void > SaveToWavFileAsync ( const std::string & fileName );

以异步方式将音频数据保存到文件。

参数

  • fileName 具有完整路径的文件名。

返回

表示保存的异步操作。

GetPosition

语法: public inline uint32_t GetPosition ( );

获取音频数据流的当前位置。

返回

当前位置

SetPosition

语法: public inline void SetPosition ( uint32_t pos );

设置音频数据流的当前位置。

参数

  • pos 要设置的位置。

DetachInput

语法: public inline void DetachInput ( );

阻止更多数据进入流。

运算符 SPXAUDIOSTREAMHANDLE

语法: public inline explicit operator SPXAUDIOSTREAMHANDLE ( );

显式转换运算符。

返回

句柄。

FromWavFileInput

语法: public inline static std::shared_ptr< AudioDataStream > FromWavFileInput ( const std::string & fileName );

为指定的音频输入文件创建内存支持的 AudioDataStream。 在版本 1.14.0 中添加。

参数

  • fileName 指定音频输入文件。

返回

指向 AudioDataStream 的共享指针

FromResult

语法: public inline static std::shared_ptr< AudioDataStream > FromResult ( std::shared_ptr< SpeechSynthesisResult > result );

根据给定的语音合成结果创建内存支持的 AudioDataStream。

参数

  • result 语音合成结果。

返回

指向 AudioDataStream 的共享指针

FromResult

语法: public inline static std::shared_ptr< AudioDataStream > FromResult ( std::shared_ptr< KeywordRecognitionResult > result );

获取与给定 KeywordRecognition 结果关联的内存支持的 AudioDataStream。

参数

  • result关键字 (keyword) 识别结果。

返回

输入到 KeywordRecognizer 的音频流,从关键字的正前开始。