跳转到主要内容
SDK 接入

Paraformer 实时语音识别 C# SDK 接入

通过 C# SDK 向 Paraformer 流式发送音频并接收识别结果。

快速开始

按安装 SDK安装 SDK 并配置 API Key。 将示例音频保存为 asr_example.wav。示例分块读取文件,模拟实时输入,无需麦克风。 识别音频,在控制台打印每句话的最终文本。
using DashScope.Speech;

await using var client = new FunAsrSpeechTranscriber(new FunAsrTranscriberOptions
{
    Model = "paraformer-realtime-v2",
    Url = "wss://maas.qianwenaiapi.com/api-ws/v1/inference",
    Format = "wav",
    SampleRate = 16000,
});
client.SentenceEnd += (_, e) => Console.WriteLine(e.Sentence.Text);

using var audio = File.OpenRead("asr_example.wav");
byte[] buffer = new byte[3200];
await client.StartAsync();
int count;
while ((count = await audio.ReadAsync(buffer)) > 0)
{
    await client.SendAudioAsync(buffer.AsMemory(0, count));
    await Task.Delay(100);
}
await client.StopAsync();

调用步骤

  1. 创建 FunAsrSpeechTranscriber 实例,将 Model 设为 paraformer-realtime-v2(或 paraformer-realtime-8k-v2),并订阅 SentenceEnd 等事件。
  2. 调用 StartAsync 建立连接并发送 run-task,等待 task-started。
  3. 在 TranscriberStarted 之后调用 SendAudioAsync 按音频播放节奏持续上行音频帧。
  4. 在 SentenceEnd 中获取每句话的最终识别结果。
  5. 音频送完后调用 StopAsync,等待 task-finished(即 Completed)。
  6. 不再使用时调用 DisposeAsync 释放连接。

参数说明

创建 FunAsrSpeechTranscriber 时传入 FunAsrTranscriberOptions。可选字段为 null 时不发送给服务端。
参数类型默认值说明
Modelstringqwen-audio-3.1-asr-flash-streaming模型 ID;显式指定本系列模型。
Formatstringpcm音频格式。
SampleRateint16000音频采样率,单位 Hz(须与输入音频实际采样率一致)。
paraformer-realtime-v2 支持任意采样率;paraformer-realtime-8k-v2 仅支持 8000 Hz。
SemanticPunctuationEnabledbool?null是否启用语义断句。
MaxSentenceSilenceint?nullVAD 断句的静音阈值,单位毫秒。
MultiThresholdModeEnabledbool?null是否启用多阈值 VAD 断句。
DisfluencyRemovalEnabledbool?null是否过滤语气词。
Heartbeatbool?null持续发送静音音频时是否保持连接。
VocabularyIdstring?null预编译热词表 ID。
LanguageHintsIList<string>?null语种提示。
ExtraParametersJsonstring?nullJSON 对象字符串,合并到协议的 parameters 对象。