NaturalVoiceSAPIAdapter注册表配置完全参考每个可配置项的作用、默认值与调优建议【免费下载链接】NaturalVoiceSAPIAdapterMake Azure natural TTS voices accessible to any SAPI 5-compatible application.项目地址: https://gitcode.com/gh_mirrors/na/NaturalVoiceSAPIAdapterNaturalVoiceSAPIAdapter 是一款 SAPI 5 语音合成引擎让任何支持 SAPI 5 的程序如 Windows 讲述人、各类读屏与朗读软件都能使用 Azure AI 的自然/神经网络语音包括本地 Narrator 语音、Edge 在线语音和 Azure 在线语音。它的行为几乎完全由注册表配置驱动——本文给出 NaturalVoiceSAPIAdapter 注册表配置的完整清单每个可配置项的作用、数据类型、默认值与调优建议帮你快速完成个性化配置。一、注册表配置在哪里3 个配置位置总览所有配置都位于当前用户HKCU下因此修改无需管理员权限不同用户互不影响注册表路径作用配置项来源HKEY_CURRENT_USER\Software\NaturalVoiceSAPIAdapter全局开关、日志、崩溃转储Logger.cpp、TTSEngine.cpp...\Software\NaturalVoiceSAPIAdapter\Enumerator语音列表枚举哪些语音、用哪些语言VoiceTokenEnumerator.cpp...\Software\NaturalVoiceSAPIAdapter\Network代理与 WebSocket 连接池WSConnectionPool.cpp、NetUtils.cpp 这三个键的位置定义在 RegKey.h 中。日常使用推荐直接通过安装目录下的Installer.exe修改它会自动写入这些值高级用户也可以用regedit直接编辑。二、全局配置项Software\NaturalVoiceSAPIAdapter1️⃣ 日志相关配置排查问题第一步配置项类型默认值作用LogFileREG_SZ空使用默认路径自定义日志文件路径。留空时日志写到%LOCALAPPDATA%\NaturalVoiceSAPIAdapter\log.txt自动滚动3 个文件、每个 5MBLogLevelDWORD2日志级别0~6spdlog 标准0trace1debug2info3warn4error5critical6off。排查问题建议临时设为 1LogFlushLevelDWORD3日志达到该级别时立即刷盘默认 warnLogFlushIntervalDWORD0禁用按固定间隔秒定时刷盘EnableWebsocketppLogsDWORD0是否输出底层 websocketpp 库日志默认关闭多数错误已能体现在主日志中LogToConsoleDWORD0设为 1 后自动分配一个调试控制台实时显示日志EnableCrashDumpDWORD0设为 1 后崩溃时生成 minidump便于反馈问题CrashDumpTypeDWORD0x1003Aminidump 内容类型MiniDump 标志位组合一般无需改动2️⃣ 引擎行为配置配置项类型默认值作用EnableOnlineDelayOptimizationDWORD0针对在线语音的延迟优化开关。在线语音首次发声延迟较高开启后引擎会提前建立会话降低首包延迟ForceEnableAzureSpeechSDKDWORD0在 Windows 7 以下系统强制启用 Azure Speech SDKSDK 本身要求 Win7 及以上此开关用于特殊兼容场景UseAzureSpeechSDKForAzureVoicesDWORD0设为 1 后 Azure 语音优先走 Azure Speech SDK 而非内置的 REST API一般无需改动三、语音列表配置项...\NaturalVoiceSAPIAdapter\Enumerator这是日常调优最常用的区域决定声音列表里出现哪些语音配置项类型默认值作用DisableDWORD0设为 1 后该引擎完全不枚举任何语音相当于全局禁用NoNarratorVoicesDWORD0设为 1 后隐藏本地 Narrator 语音NoEdgeVoicesDWORD0设为 1 后隐藏 Edge 在线语音NoAzureVoicesDWORD0设为 1 后隐藏 Azure 在线语音EdgeVoiceAllLanguagesDWORD0设为 1 后 Edge 语音包含所有语言默认只显示首选语言英语EdgeVoiceAllMultilingualDWORD0设为 1 后额外包含多语言multilingual语音EdgeVoiceLanguagesREG_MULTI_SZ空自定义要包含的语言列表与上一项二选一使用EdgeVoicesOverrideAzureVoicesDWORD0设为 1 后同名语音优先显示 Edge 版而非 Azure 版NarratorVoicePathREG_SZ自动探测本地 Narrator 语音包目录。留空时自动探测 DLL 同目录或上一级的NarratorVoices文件夹AzureVoiceKeyREG_SZ空Azure 语音订阅密钥Subscription Key从 Azure Portal 的 Keys and Endpoint 页面复制AzureVoiceRegionREG_SZ空与密钥配套的区域Region。两者都填写后 Azure 语音才会出现在列表中DefaultErrorModeDWORD0枚举出错时的处理模式0~20默认行为2严格模式语音加载失败时直接报错而非跳过LanguageForUnknownLocalesREG_SZ空系统区域无法识别时的回退语言代码一般无需设置调优建议在线语音数量很多默认只显示首选语言英语是为了避免列表过于冗长。如果你需要更多语言勾选EdgeVoiceAllLanguages即可比逐项填EdgeVoiceLanguages省事。四、网络与连接池配置项...\NaturalVoiceSAPIAdapter\Network在线语音通过 WebSocket 长连接工作连接池参数直接影响稳定性与速度配置项类型默认值作用ProxyOverrideSystemDefaultDWORD0设为 1 后使用本键下自定义代理否则沿用系统代理设置ProxyServerREG_SZ空自定义代理服务器地址仅在上项为 1 时生效ProxyBypassREG_SZ空代理例外列表同上ConnectionPoolMinCountDWORD1连接池最小连接数ConnectionPoolMaxCountDWORDmax(10, 最小值)连接池最大连接数。高频朗读场景可适当调大减少新建连接的开销ConnectionKeepAliveIntervalDWORD20秒连接保活检查间隔ConnectionKeepAliveDurationDWORD0保活时长非 0 时引擎会周期性发送保活消息ConnectionMaxAgeDWORD210秒单条连接最大存活时间超龄连接会被替换避免被服务端断开后复用调优建议公司/校园网络如果系统代理设置不生效先检查是否支持自动代理 URL不行再用ProxyOverrideSystemDefault1ProxyServer手动指定。频繁卡顿、首句慢把ConnectionPoolMaxCount调到 15~20并确认ConnectionMaxAge不小于 210让连接被充分复用。这些参数在引擎初始化时读取WSConnectionPool.cpp修改后需重启正在朗读的程序才生效。五、单个语音的配置NaturalVoiceConfig 子键每个由该引擎提供的语音令牌下都有一个NaturalVoiceConfig子键由 VoiceTokenEnumerator.cpp 生成其中配置项类型默认值作用ErrorModeDWORD0该语音合成失败时的处理模式0~2语义同全局DefaultErrorMode用于对单个语音做差异化处理六、上手调优清单按场景速查只想用本地 Narrator 语音离线、最稳定设置NoEdgeVoices1、NoAzureVoices1需要 Azure 全部语音填好AzureVoiceKey与AzureVoiceRegion声音列表太乱/太长取消EdgeVoiceAllLanguages改用EdgeVoiceLanguages只留需要的语言想收集日志反馈问题LogLevel1问题复现后可选开EnableCrashDump1代理环境优先ProxyOverrideSystemDefault1 显式代理避免系统自动代理不被识别⚠️注意配置读取位置均为用户级注册表HKCU改完配置后建议重启目标朗读程序再验证效果regedit手工修改时 DWORD 值统一用 0/1 表示关/开。希望这份 NaturalVoiceSAPIAdapter 注册表配置参考能让你少踩坑——从日志级别到连接池每一项的作用与默认值都已列明按需调优即可获得最稳定的自然语音朗读体验。【免费下载链接】NaturalVoiceSAPIAdapterMake Azure natural TTS voices accessible to any SAPI 5-compatible application.项目地址: https://gitcode.com/gh_mirrors/na/NaturalVoiceSAPIAdapter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 NaturalVoiceSAPIAdapter注册表配置完全参考：每个可配置项的作用、默认值与调优建议
NaturalVoiceSAPIAdapter注册表配置完全参考每个可配置项的作用、默认值与调优建议【免费下载链接】NaturalVoiceSAPIAdapterMake Azure natural TTS voices accessible to any SAPI 5-compatible application.项目地址: https://gitcode.com/gh_mirrors/na/NaturalVoiceSAPIAdapterNaturalVoiceSAPIAdapter 是一款 SAPI 5 语音合成引擎让任何支持 SAPI 5 的程序如 Windows 讲述人、各类读屏与朗读软件都能使用 Azure AI 的自然/神经网络语音包括本地 Narrator 语音、Edge 在线语音和 Azure 在线语音。它的行为几乎完全由注册表配置驱动——本文给出 NaturalVoiceSAPIAdapter 注册表配置的完整清单每个可配置项的作用、数据类型、默认值与调优建议帮你快速完成个性化配置。一、注册表配置在哪里3 个配置位置总览所有配置都位于当前用户HKCU下因此修改无需管理员权限不同用户互不影响注册表路径作用配置项来源HKEY_CURRENT_USER\Software\NaturalVoiceSAPIAdapter全局开关、日志、崩溃转储Logger.cpp、TTSEngine.cpp...\Software\NaturalVoiceSAPIAdapter\Enumerator语音列表枚举哪些语音、用哪些语言VoiceTokenEnumerator.cpp...\Software\NaturalVoiceSAPIAdapter\Network代理与 WebSocket 连接池WSConnectionPool.cpp、NetUtils.cpp 这三个键的位置定义在 RegKey.h 中。日常使用推荐直接通过安装目录下的Installer.exe修改它会自动写入这些值高级用户也可以用regedit直接编辑。二、全局配置项Software\NaturalVoiceSAPIAdapter1️⃣ 日志相关配置排查问题第一步配置项类型默认值作用LogFileREG_SZ空使用默认路径自定义日志文件路径。留空时日志写到%LOCALAPPDATA%\NaturalVoiceSAPIAdapter\log.txt自动滚动3 个文件、每个 5MBLogLevelDWORD2日志级别0~6spdlog 标准0trace1debug2info3warn4error5critical6off。排查问题建议临时设为 1LogFlushLevelDWORD3日志达到该级别时立即刷盘默认 warnLogFlushIntervalDWORD0禁用按固定间隔秒定时刷盘EnableWebsocketppLogsDWORD0是否输出底层 websocketpp 库日志默认关闭多数错误已能体现在主日志中LogToConsoleDWORD0设为 1 后自动分配一个调试控制台实时显示日志EnableCrashDumpDWORD0设为 1 后崩溃时生成 minidump便于反馈问题CrashDumpTypeDWORD0x1003Aminidump 内容类型MiniDump 标志位组合一般无需改动2️⃣ 引擎行为配置配置项类型默认值作用EnableOnlineDelayOptimizationDWORD0针对在线语音的延迟优化开关。在线语音首次发声延迟较高开启后引擎会提前建立会话降低首包延迟ForceEnableAzureSpeechSDKDWORD0在 Windows 7 以下系统强制启用 Azure Speech SDKSDK 本身要求 Win7 及以上此开关用于特殊兼容场景UseAzureSpeechSDKForAzureVoicesDWORD0设为 1 后 Azure 语音优先走 Azure Speech SDK 而非内置的 REST API一般无需改动三、语音列表配置项...\NaturalVoiceSAPIAdapter\Enumerator这是日常调优最常用的区域决定声音列表里出现哪些语音配置项类型默认值作用DisableDWORD0设为 1 后该引擎完全不枚举任何语音相当于全局禁用NoNarratorVoicesDWORD0设为 1 后隐藏本地 Narrator 语音NoEdgeVoicesDWORD0设为 1 后隐藏 Edge 在线语音NoAzureVoicesDWORD0设为 1 后隐藏 Azure 在线语音EdgeVoiceAllLanguagesDWORD0设为 1 后 Edge 语音包含所有语言默认只显示首选语言英语EdgeVoiceAllMultilingualDWORD0设为 1 后额外包含多语言multilingual语音EdgeVoiceLanguagesREG_MULTI_SZ空自定义要包含的语言列表与上一项二选一使用EdgeVoicesOverrideAzureVoicesDWORD0设为 1 后同名语音优先显示 Edge 版而非 Azure 版NarratorVoicePathREG_SZ自动探测本地 Narrator 语音包目录。留空时自动探测 DLL 同目录或上一级的NarratorVoices文件夹AzureVoiceKeyREG_SZ空Azure 语音订阅密钥Subscription Key从 Azure Portal 的 Keys and Endpoint 页面复制AzureVoiceRegionREG_SZ空与密钥配套的区域Region。两者都填写后 Azure 语音才会出现在列表中DefaultErrorModeDWORD0枚举出错时的处理模式0~20默认行为2严格模式语音加载失败时直接报错而非跳过LanguageForUnknownLocalesREG_SZ空系统区域无法识别时的回退语言代码一般无需设置调优建议在线语音数量很多默认只显示首选语言英语是为了避免列表过于冗长。如果你需要更多语言勾选EdgeVoiceAllLanguages即可比逐项填EdgeVoiceLanguages省事。四、网络与连接池配置项...\NaturalVoiceSAPIAdapter\Network在线语音通过 WebSocket 长连接工作连接池参数直接影响稳定性与速度配置项类型默认值作用ProxyOverrideSystemDefaultDWORD0设为 1 后使用本键下自定义代理否则沿用系统代理设置ProxyServerREG_SZ空自定义代理服务器地址仅在上项为 1 时生效ProxyBypassREG_SZ空代理例外列表同上ConnectionPoolMinCountDWORD1连接池最小连接数ConnectionPoolMaxCountDWORDmax(10, 最小值)连接池最大连接数。高频朗读场景可适当调大减少新建连接的开销ConnectionKeepAliveIntervalDWORD20秒连接保活检查间隔ConnectionKeepAliveDurationDWORD0保活时长非 0 时引擎会周期性发送保活消息ConnectionMaxAgeDWORD210秒单条连接最大存活时间超龄连接会被替换避免被服务端断开后复用调优建议公司/校园网络如果系统代理设置不生效先检查是否支持自动代理 URL不行再用ProxyOverrideSystemDefault1ProxyServer手动指定。频繁卡顿、首句慢把ConnectionPoolMaxCount调到 15~20并确认ConnectionMaxAge不小于 210让连接被充分复用。这些参数在引擎初始化时读取WSConnectionPool.cpp修改后需重启正在朗读的程序才生效。五、单个语音的配置NaturalVoiceConfig 子键每个由该引擎提供的语音令牌下都有一个NaturalVoiceConfig子键由 VoiceTokenEnumerator.cpp 生成其中配置项类型默认值作用ErrorModeDWORD0该语音合成失败时的处理模式0~2语义同全局DefaultErrorMode用于对单个语音做差异化处理六、上手调优清单按场景速查只想用本地 Narrator 语音离线、最稳定设置NoEdgeVoices1、NoAzureVoices1需要 Azure 全部语音填好AzureVoiceKey与AzureVoiceRegion声音列表太乱/太长取消EdgeVoiceAllLanguages改用EdgeVoiceLanguages只留需要的语言想收集日志反馈问题LogLevel1问题复现后可选开EnableCrashDump1代理环境优先ProxyOverrideSystemDefault1 显式代理避免系统自动代理不被识别⚠️注意配置读取位置均为用户级注册表HKCU改完配置后建议重启目标朗读程序再验证效果regedit手工修改时 DWORD 值统一用 0/1 表示关/开。希望这份 NaturalVoiceSAPIAdapter 注册表配置参考能让你少踩坑——从日志级别到连接池每一项的作用与默认值都已列明按需调优即可获得最稳定的自然语音朗读体验。【免费下载链接】NaturalVoiceSAPIAdapterMake Azure natural TTS voices accessible to any SAPI 5-compatible application.项目地址: https://gitcode.com/gh_mirrors/na/NaturalVoiceSAPIAdapter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考