类对象支持库（不是扁平命令）。路径：支持库 → 扩展类库 → 语音类。
类型名必须写完整「语音类」。声明时自动创建，一般无需再调 创建*。
硬约束
- 类型名必须写「语音类」。
- TTS 朗读；语速/音量/音色以方法与属性为准。
- 方法调用必须带括号。
快速开始
语音类 sp
sp.朗读("你好，世界")
语音类/创建
共 1 条。
创建语音
- 签名：
通用 创建语音() - 说明：创建语音会话。一般直接写「语音类 voice」即可。
语音类/方法
共 21 条。
朗读
- 签名：
逻辑 朗读(文本 内容) - 说明：异步朗读文本（非 XML）。成功返回真。
- 参数一│内容
同步朗读
- 签名：
逻辑 同步朗读(文本 内容) - 说明：同步朗读文本，直到说完再返回。
- 参数一│内容
朗读标记
- 签名：
逻辑 朗读标记(文本 内容) - 说明：异步按 SAPI XML/标记朗读（可用
/ / 等）。 - 参数一│内容: SAPI XML 文本
同步朗读标记
- 签名：
逻辑 同步朗读标记(文本 内容) - 说明：同步按 SAPI XML/标记朗读。
- 参数一│内容: SAPI XML 文本
停止朗读
- 签名：
逻辑 停止朗读() - 说明：停止当前朗读。
暂停朗读
- 签名：
逻辑 暂停朗读() - 说明：暂停当前朗读（可「继续朗读」）。
继续朗读
- 签名：
逻辑 继续朗读() - 说明：从暂停处继续朗读。
是否朗读中
- 签名：
逻辑 是否朗读中() - 说明：当前是否正在朗读（SAPI RunningState）。
等待朗读结束
- 签名：
逻辑 等待朗读结束([整数 超时毫秒=-1]) - 说明：等待异步朗读结束。省略或 -1=一直等；超时返回假。
- 参数一│[超时毫秒=-1]: 毫秒；省略或-1一直等
置语速
- 签名：
逻辑 置语速(整数 语速) - 说明：语速 -10..10，默认 0。
- 参数一│语速: -10..10
取语速
- 签名：
整数 取语速() - 说明：取当前语速。
置音量
- 签名：
逻辑 置音量(整数 音量) - 说明：音量 0..100，默认 100。
- 参数一│音量: 0..100
取音量
- 签名：
整数 取音量() - 说明：取当前音量。
置嗓音
- 签名：
逻辑 置嗓音(文本 名称) - 说明：按显示名或片段匹配嗓音；空=系统默认。
- 参数一│名称
取嗓音
- 签名：
文本 取嗓音() - 说明：当前已设置的嗓音名（可能为空表示默认）。
枚举嗓音
- 签名：
文本 枚举嗓音() - 说明：已安装嗓音列表，换行分隔。
置WAV采样率
- 签名：
逻辑 置WAV采样率(整数 采样率) - 说明：保存 WAV 时的采样率。允许 8000/11025/16000/22050/44100/48000，默认 22050。
- 参数一│采样率
取WAV采样率
- 签名：
整数 取WAV采样率() - 说明：取当前 WAV 采样率。
保存到文件
- 签名：
逻辑 保存到文件(文本 内容, 文本 路径) - 说明：同步朗读并保存为 WAV（使用当前 WAV 采样率）。
- 参数一│内容
- 参数二│路径:.wav
保存到字节集
- 签名：
字节集 保存到字节集(文本 内容) - 说明：同步朗读为 WAV 字节集（含文件头）；失败返回空。
- 参数一│内容
取最后错误
- 签名：
文本 取最后错误() - 说明：最近一次失败原因。
易错对照
| 错误 | 正确 |
|---|---|
| 类型写成「语音」 | 必须「语音类」 |