为何Blazor WebAssembly（.NET 6.0）中Microsoft.CognitiveServices.Speech无法工作？

问题情况 #

你的.NET控制台用Azure Speech SDK完全正常，PowerShell、curl调用也没毛病，但Blazor里写这段代码时，speechConfig是空的，还蹦出Cannot find member named 'SpeechConfig'的错误：

string speechKey = "<...>";
string speechRegion = "<...>";

var speechConfig = SpeechConfig.FromSubscription(speechKey, speechRegion);

核心原因 #

Blazor WebAssembly运行在浏览器环境中，和控制台的.NET原生运行时存在差异，Azure Speech SDK在WASM环境下必须依赖专门的JavaScript绑定脚本，未正确配置时就会出现类型无法识别的错误。

解决步骤 #

1. 安装对应NuGet包
   给Blazor项目安装Microsoft.CognitiveServices.Speech NuGet包，建议选用最新稳定版本。

2. 引入JS绑定脚本
   打开Blazor项目的wwwroot/index.html，在页面中加入Azure Speech SDK为WebAssembly环境提供的JavaScript绑定脚本（该脚本可从Azure语音服务官方渠道获取）。

3. 确认命名空间引用
   在使用SpeechConfig的代码文件顶部，确保添加了正确的命名空间：

   using Microsoft.CognitiveServices.Speech;
   

4. 线程兼容处理（可选）
   如果后续调用Speech SDK其他方法时出现线程相关报错，可将代码包裹在InvokeAsync中执行，适配Blazor的同步上下文：

   await InvokeAsync(() => 
   {
       var speechConfig = SpeechConfig.FromSubscription(speechKey, speechRegion);
       // 后续业务逻辑
   });
   

控制台应用直接依赖.NET原生的SDK实现，而Blazor WASM需要通过JS桥接才能调用Speech SDK的API，这是两个环境的核心差异，配置好以上步骤即可解决问题。

内容的提问来源于stack exchange，提问作者zen