v0.2.9

This version fixes the following issues:

• Voice events are not triggered correctly (#82)
• An x86 TtsApplication.exe is incorrectly placed in the ARM64 folder

---

此版本修复了以下问题：

• 语音事件不会正确触发 (#82)
• x86 版本的 TtsApplication.exe 被错误地放在了 ARM64 文件夹中

v0.2.8

This version fixes compatibility issues with older Windows versions, such as Windows 7. (#80)

---

此版本修复了与旧版 Windows 系统（如 Windows 7）的兼容问题。(#80)

v0.2.7

This version fixes the following issues.

• Microsoft Edge online voices not working (#70)
• The ARM64 version not working with x64 apps (#65)
• The "Log level" combo box having more and more items after each installation/uninstallation

---

此版本修复了下列问题。

• Microsoft Edge 在线语音不工作 (#70)
• ARM64 版本不能在 x64 应用中使用 (#65)
• “日志级别”下拉框在每次安装/卸载后，出现多余的项目

v0.2.6

New Feature

Added an option to include all multilingual voices regardless of current language settings in the "Included languages" option.

By default, multilingual voices are filtered by their primary language. For example, the voice Microsoft AndrewMultilingual Online (Natural) - English (United States) also supports other languages, but the primary language is English (United States), so it will not be listed if English (United States) is not in your language list.

If you want to use those multilingual voices whose primary language isn't in your language list, you can enable "Include all multilingual voices" in the "Included languages" dialog.

Improvement

The delay after stopping speech is reduced.

This can prevent screen readers from going unresponsive when browsing through items quickly.

Fix

Fixed a problem where changing from custom language selection to "User's preferred languages / &display language" did not work correctly.

---

新功能

在“包括语言”选项中新增了“包括所有多语言语音”选项，可显示所有多语言语音，而不受当前语言设置的限制。

默认情况下，多语言 (multilingual) 语音会根据其主要语言进行筛选。例如，语音 Microsoft AndrewMultilingual Online (Natural) - English (United States) 虽然支持其他语言，但其主要语言是 English (United States)（即 “英语 (美国)”），因此如果你的语言列表中不包含“英语 (美国)”，它将不会显示。

如果希望使用这些主要语言不在语言列表中的多语言语音，可以在“包括语言”对话框中启用“包括所有多语言语音”选项。

改进

缩短了停止朗读后的延迟。

避免了使用屏幕阅读器快速在项目之间跳转时，产生短暂无响应的问题。

修复

修复了指定自定义语言列表后，切换到“用户首选语言 / 显示语言”，无法正常工作的问题。

v0.2.5

• Fixed a problem where some applications crash or cannot work correctly when this engine is installed because of CRT version collision. (#49)
• Azure Speech SDK is downgraded to 1.41.1 for the fix above. As a result, the non-ASCII path bug is re-introduced, and the local voice path is again limited to ASCII-only characters.

---

• 修复了安装此引擎后，由于 CRT 版本冲突，一些应用程序崩溃或者不能正常工作的问题。 (#49)
• 为了修复上面的问题，Azure Speech SDK 被降级到了 1.41.1 版本，因此，非 ASCII 路径的 bug 被再次引入。本地语音路径又只能包含 ASCII 字符了。

v0.2.4

• Fixed a problem where Narrator could not start after installing this engine. Now this engine will not be loaded in Narrator on Windows 11 to prevent collision with Narrator's own natural voice system.
• The local voice path is no longer limited to ASCII-only characters, as Azure Speech SDK has fixed the bug.
• Because of the change in voice decryption keys, installed Narrator natural voices are disabled in this version. Please download the voice packs, unzip them into a folder, and set the folder as "local voice path".
• "Local voice path" is no longer limited to the direct parent folder of voice subfolders. You can now specify the unzipped folder itself to use a single voice, or specify a folder with a complex hierarchy inside, and this engine should be able to automatically find every voice folder.

---

• 修复了安装该引擎后讲述人不能正常启动的问题。该引擎将不再在 Windows 11 的讲述人中加载，以免与讲述人自身的自然语音系统冲突。
• 本地语音路径不再仅限 ASCII 字符，因为 Azure Speech SDK 修复了此问题。
• 由于语音密钥的变更，该版本中将不再能够使用已安装的讲述人自然语音。请下载语音包，解压至一个文件夹，并将其设为“本地语音路径”。
• “本地语音路径”不再仅限语音子文件夹的直接上层文件夹。现在可以指定语音包解压出的文件夹本身以使用单个语音，也可以指定内部具有复杂层级结构的文件夹，该引擎将自动寻找其中的每一个语音文件夹。

v0.2.3

Fixes

• Installation failure on older Windows versions (e.g. Windows 7) saying "Some files could not be found"
• "Invalid SSML" error when there are space characters after a custom XML tag

See also release notes for v0.2.1.

修复问题

• 在旧版 Windows 系统（例如 Windows 7）上安装失败，提示“找不到某些文件”
• 自定义 XML 标签后面有空格字符时，出现 Invalid SSML 错误

另见 v0.2.1 的发布说明。

v0.2.2

Fixes

• Voice list JSON files cannot be downloaded correctly
• Extra <prosody> SSML tags will cause the Edge voice server to reject the SSML. The Edge voices allow no more than two <prosody> tags, so this is fixed by discarding excessive prosody changes (changes in volume, rate, pitch, etc.).

See also release notes for v0.2.1.

修复问题

• 语音列表 JSON 文件不能正确下载
• 多余的 <prosody> 标签会使 Edge 语音服务器拒绝该 SSML。Edge 语音不允许 <prosody> 标签超过两个，所以解决方法是丢弃多出的 prosody 更改（如音量、语速、音调等）。

另见 v0.2.1 的发布说明。

Release v0.2.1

New features

• Adds support for pure ARM64 processes. (Older versions support x86, x64, and ARM64EC processes)
  When you click "Install 64-bit" on an ARM64 system, both x64 and ARM64 versions will be installed.
• Adds support for PAC proxy when the system is configured to "automatically detect proxy settings" or "use automatic configuration scripts". (Older versions support manually configured proxy server)
  Note that only HTTP proxies without authentication are supported.

Fixes

• Words separated by XML tags are "glued together" without spaces when using Edge voices (mentioned in #8)
• Edge voices cannot be accessed directly with a Chinese mainland IP address. Fixed by generating the Sec-MS-GEC token. See this issue comment in edge-tts for the algorithm.
• The installer's UI language is not English when running under Wine in a language other than Chinese or English (mentioned in #19)
• Custom XML tags not recognized by SAPI are not handled correctly, causing "Invalid SSML" errors like in this issue.
• Other bug fixes that improve stability when using online voices.

Other changes

• The installer's main dialog now saves your changes immediately (to address the "changes lost" issue mentioned in #20 and #23). Other dialogs still require you to click "OK" to save the changes, or "Cancel" to discard the changes.

新功能

• 新增对纯 ARM64 进程的支持。（旧版本支持 x86，x64，以及 ARM64EC 进程）
  在 ARM64 系统上选择“安装 64 位”时，x64 和 ARM64 版本均会被安装。
• 新增对 PAC 代理的支持，前提是系统设置为“自动检测代理设置”或“使用自动设置脚本”。（旧版本支持手动配置的代理服务器）
  注意仅支持无需认证的 HTTP 代理。

修复问题

• 使用 Edge 语音时，用 XML 标签分隔的单词会“黏在一起”，没有空格分隔（#8 中提及）
• Edge 语音无法使用中国大陆 IP 地址直接访问。使用生成 Sec-MS-GEC 的方法解决了问题。算法参见 edge-tts 中的这条 issue 评论。
• 在 Wine 中使用时，环境语言不是中文或英文时，安装程序的界面语言不是英文（#19 中提及）
• SAPI 不识别的自定义 XML 标签没有被正确处理，导致出现 Invalid SSML 问题，例如这个 issue。
• 其他改进了在线语音稳定性的 bug 修复。

其他更改

• 安装程序的主界面现在会立即保存更改（以解决 #20 和 #23 中提到的“更改丢失”问题）。其他对话框依然需要点击“确定”保存更改，或点击“取消”放弃更改。

Release v0.2

New features

• Supports enumerating Azure voices; adds UI for entering Azure API key and region (#9)
• Local Narrator voices are now supported on Windows 7; see README or this for how to download and use the voices on Windows 7
• Support for customized included language list for online voices (#7)
• Logging system that saves error messages into log files (%LOCALAPPDATA%\NaturalVoiceSAPIAdapter\log.#.txt) for troubleshooting

Fixes

• With Microsoft Edge online voices, NVDA's continuous reading stops after the first sentence (#8)
• websocketpp logs output to stdout (#14)
• Events out of sync for client apps using C# System.Speech (#16)

Other changes

• Voices with invalid locale IDs are no longer included by default, including Javanese and Sundanese voices. This might prevent crashing some apps when choosing to use all supported languages. If those languages are still needed, check LanguageForUnknownLocales in Configurable registry values.

新功能

• 支持列举 Azure 语音列表；添加输入 Azure 密钥和区域的界面 (#9)
• 本地讲述人自然语音现已支持 Windows 7；参考自述文件或这里以了解如何在 Windows 7 上下载和使用这些语音
• 支持自定义在线语音包含的语言的列表 (#7)
• 日志系统，将错误信息保存在日志文件中 (%LOCALAPPDATA%\NaturalVoiceSAPIAdapter\log.#.txt)

修复问题

• 使用 Edge 在线语音时，NVDA 的连续朗读会停留在第一句话 (#8)
• websocketpp 的日志输出到了 stdout (#14)
• 使用 C# System.Speech 的客户端程序收到的事件时间不同步 (#16)

其他更改

• 默认不再包含 locale ID 无效的语言，例如爪哇语和巽他语。这可能会减少一些选择了“所有支持的语言”导致客户端崩溃的情况。如果仍然需要使用这些语言，可以参考可配置注册表值中的 LanguageForUnknownLocales 的说明。