NaturalVoiceSAPIAdapter

View English README

这是一个 SAPI 5 文本转语音（TTS）引擎，可以利用 Azure AI 语音服务 提供的 自然/神经网络语音（natural/neural voices），包括：

• Windows 11 上 Narrator 的自然语音
• Microsoft Edge“朗读”功能提供的在线自然语音
• 如果你拥有有效的订阅密钥，还可以使用 Azure AI 语音服务提供的在线自然语音

任何支持 SAPI 5 语音的应用程序都可以通过此 TTS 引擎使用上述自然语音。

更多技术信息请参阅 wiki 页面。

系统要求

最低测试平台：Windows XP SP3 和 Windows XP Professional x64 Edition SP2（仅限 32 位）。

支持本地 Narrator 语音的最低平台：Windows 7 RTM，x86 32/64 位。

支持通过 Microsoft Store 安装 Narrator 语音的最低平台：Windows 10，版本 17763。

如何在 Windows 11 上安装 Narrator 自然语音？

如果你打算使用本程序，不再建议在 Windows 11 上安装 Narrator 自然语音，因为这些语音的最新版本已无法与本程序兼容。建议改用最后一个可用版本。

如果安装本程序后 Narrator 停止工作，可尝试暂时卸载所有 Narrator 语音包作为临时解决方案。

我使用的是 Windows XP/Vista/7/8/10。能否使用 Windows 11 的 Narrator 自然语音？

Windows XP/Vista：很遗憾，这些平台不支持本地 Narrator 语音。但在线语音（包括 Edge 和 Azure 语音）仍然可用。

Windows 10（版本 17763 或更高）：你可以通过这些链接选择并安装 Windows 11 的 Narrator 语音。

Windows 7/8/10（版本低于 17763）：

1. 从此处下载语音的 MSIX 文件。
2. 准备一个文件夹用于存放语音子文件夹。确保该路径中不包含非 ASCII 字符。
3. 将 MSIX 文件当作 ZIP 文件解压到其子文件夹中。你可以在同一个父文件夹下放置多个语音子文件夹。确保子文件夹名称中也不包含非 ASCII 字符。
4. 在安装程序中将该父文件夹设置为“本地语音路径”。
5. 不要在该父文件夹中放置除语音子文件夹以外的其他内容，否则可能导致语音加载失败。

Windows 10 的 Narrator 本身不直接支持自然语音，但它支持 SAPI 5 语音。因此，你可以通过本引擎在 Windows 10 上使用 Windows 11 的 Narrator 语音。

它能在未来的 Windows 版本上运行吗？

本引擎使用从系统文件中提取的加密密钥来调用语音，因此更像是一种“hack”而非官方解决方案。

目前，微软尚未允许第三方应用使用 Narrator/Edge 语音，因此该功能可能随时失效，例如在系统更新之后。

安装

1. 从 Releases 页面下载 zip 文件。
2. 将文件解压到某个文件夹中。安装后请勿移动、重命名或删除这些文件。如需移动或删除，请先卸载本程序。
3. 运行 Installer.exe。
4. 在“安装状态”部分，程序会显示 32 位和 64 位版本是否已安装：
   • 32 位版本适用于 32 位程序，64 位版本适用于 64 位程序。
   • 在 64 位系统上，若希望所有程序（32 位和 64 位）都能使用，需同时安装两个版本。
   • 在 32 位系统上，“64 位”行不会显示。
5. 点击“安装/卸载”。需要管理员权限。
6. 选择你希望使用的语音类型。默认启用本地 Narrator 语音（如支持）和 Microsoft Edge 朗读在线语音：
   • 在线语音需要互联网连接，且可能较慢或不够稳定。如果你只想使用本地 Narrator 语音，可以取消勾选“启用 Microsoft Edge 在线语音”和“启用 Azure 在线语音”。
   • 由于在线语音种类繁多，默认仅包含你首选语言及英语（美国）的语音，以避免语音列表过于冗长。点击“更改...”可调整包含的语言。
   • Azure 语音需要订阅密钥（API 密钥）及其区域。点击“设置 Azure 密钥”输入你的密钥。你可以访问 Azure 门户，进入你的语音服务资源，然后前往 资源管理 > 密钥和终结点 复制密钥和区域。
7. 关闭安装程序窗口以应用更改。如需修改设置，可再次打开安装程序，且更改设置无需重新安装或管理员权限。

或者，你也可以使用 regsvr32 手动注册 DLL 文件。

高级用户可参考本程序的可配置注册表值列表。

测试

你可以使用 x86 和 x64 文件夹中的 TtsApplication.exe 来测试本引擎。

这是对 Windows-classic-samples 中的 TtsApplication 的修改版本，增加了中文翻译，并为音素（phoneme）/口型（viseme）事件提供了更详细的信息。

或者，你也可以前往控制面板 > 语音（Windows XP），或控制面板 > 语音识别 > 文本转语音（Windows Vista 及更高版本）进行测试。

使用的库

• Microsoft.CognitiveServices.Speech.Extension.Embedded.TTS
• websocketpp
• ASIO（独立版本）
• OpenSSL
• nlohmann/json
• YY-Thunks（用于 Windows XP 兼容性）
• spdlog

NaturalVoiceSAPIAdapter 快速上手指南

环境准备

系统要求

• 最低支持系统：Windows XP SP3（仅 32 位）或 Windows XP Professional x64 Edition SP2
• 本地 Narrator 自然语音支持：
  • Windows 7 RTM 及以上（x86/x64）
  • Windows 10 Build 17763 及以上可通过 Microsoft Store 安装 Narrator 语音包
• 推荐系统：Windows 10/11（需注意 Windows 11 最新版 Narrator 语音可能不兼容，建议使用最后可用版本）

前置依赖

• 若使用 Azure 在线语音，需提前在 Azure 门户 创建语音服务资源，并获取 订阅密钥（Key）和区域（Region）
• 确保系统已安装 .NET Framework（通常 Windows 自带）
• 安装路径不能包含中文或非 ASCII 字符

💡 国内用户建议使用 Azure 中国云（由世纪互联运营），访问 Azure 中国门户 获取密钥。

安装步骤

1. 从 Releases 页面 下载最新 ZIP 包（国内用户可尝试 GitHub 加速镜像）
2. 解压到纯英文路径目录（如 C:\NaturalVoiceSAPIAdapter），后续不要移动、重命名或删除该文件夹
3. 以管理员身份运行 Installer.exe
4. 在安装界面中：
   • 确认 32 位 和 64 位 版本均已安装（64 位系统需同时安装两者以兼容所有程序）
   • 根据需要选择启用的语音类型：
     • ✅ 默认启用本地 Narrator 语音（若系统支持）和 Microsoft Edge 在线语音
     • 🔌 如仅使用本地语音，可取消勾选 “Enable Microsoft Edge online voices” 和 “Enable Azure online voices”
     • 🌐 如使用 Azure 语音，点击 “Set Azure key” 输入你的订阅密钥和区域
5. 关闭安装窗口即生效。后续修改设置无需重新安装，也无需管理员权限。

⚠️ 不要直接使用 regsvr32 手动注册 DLL，除非你明确知道自己在做什么。

基本使用

方法一：使用内置测试工具

进入解压目录，根据你的程序架构运行对应测试程序：

# 32 位程序测试
x86\TtsApplication.exe

# 64 位程序测试
x64\TtsApplication.exe

该工具支持中文界面，并可查看音素（phoneme）和口型（viseme）事件详情。

方法二：通过系统语音设置测试

1. 打开 控制面板 > 语音识别 > 文字转语音（Windows Vista 及以后）
2. 在语音列表中选择以 NaturalVoiceSAPIAdapter 开头的语音
3. 点击“预览语音”即可试听

方法三：在你的 SAPI 5 应用中调用

任何支持 SAPI 5 的应用程序（如 NVDA、Balabolka、自研 TTS 软件）均可直接在语音选择菜单中使用本引擎提供的自然语音，无需额外编码。