你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
AudioDataStream 类
表示用于以流的形式操作音频数据的音频数据流。
从语音合成结果生成音频数据流 (类型 SpeechSynthesisResult) 或关键字识别结果 (类型 KeywordRecognitionResult) 。
- 继承
-
builtins.objectAudioDataStream
构造函数
AudioDataStream(result=None)
参数
名称 | 说明 |
---|---|
result
|
语音合成或关键字识别结果。 默认值: None
|
方法
can_read_data |
检查流是否有足够的数据需要读取,从指定的位置开始 ((如果指定) )。 |
detach_input |
阻止更多数据进入流。 |
read_data |
从音频数据流中读取音频数据,从指定的位置 ((如果指定) )。 要读取的最大字节数取决于audio_buffer的大小。 如果没有立即可用的数据,read_data () 将阻止,直到下一个数据可用。 |
save_to_wav_file |
以同步方式将音频数据保存到文件。 |
save_to_wav_file_async |
以异步方式将音频数据保存到文件。 |
can_read_data
检查流是否有足够的数据需要读取,从指定的位置开始 ((如果指定) )。
can_read_data(requested_bytes: int, pos: int | None = None) -> bool
参数
名称 | 说明 |
---|---|
requested_bytes
必需
|
请求的数据大小(以字节为单位)。 |
pos
|
要开始的位置。 如果未提供此参数,将从当前位置开始。 默认值: None
|
返回
类型 | 说明 |
---|---|
指示结果的布尔值 |
detach_input
阻止更多数据进入流。
detach_input()
read_data
从音频数据流中读取音频数据,从指定的位置 ((如果指定) )。 要读取的最大字节数取决于audio_buffer的大小。 如果没有立即可用的数据,read_data () 将阻止,直到下一个数据可用。
read_data(audio_buffer: bytes, pos: int | None = None) -> int
参数
名称 | 说明 |
---|---|
audio_buffer
必需
|
用于接收音频数据的缓冲区。 |
pos
|
要开始的位置。 如果未提供此参数,将从当前位置开始。 默认值: None
|
返回
类型 | 说明 |
---|---|
填充的字节数;如果流到达其末尾且没有更多可用数据,则为 0。 |
save_to_wav_file
以同步方式将音频数据保存到文件。
save_to_wav_file(file_name: str)
参数
名称 | 说明 |
---|---|
file_name
必需
|
要保存到的文件的名称 |
save_to_wav_file_async
以异步方式将音频数据保存到文件。
save_to_wav_file_async(file_name: str)
参数
名称 | 说明 |
---|---|
file_name
必需
|
要保存到的文件的名称 |
返回
类型 | 说明 |
---|---|
表示保存的异步操作。 |
属性
cancellation_details
语音合成被取消的原因。
如果没有取消,则返回 None 。
position
音频数据流的当前位置。
properties
为此 AudioDataStream 定义的属性及其值的集合。
status
音频数据流的当前状态。