实时语音识别 V2

Future<ASRController> build() async            // 创建ASRController
void setCustomParam(String key, dynamic value) // 设置自定义参数（透传到native层）
void removeCustomParam(String key)             // 移除自定义参数
ASRControllerConfig clone()                    // 克隆当前配置

var _config = ASRControllerConfig();
_config.filter_dirty = 1;
_config.filter_modal = 0;
_config.filter_punc = 0;
var _controller = await _config.build();

Stream<ASRData> recognize() async*                      // 开始识别(内置录音)
Stream<ASRData> recognizeWithDataSource(Stream<Uint8List>? source) async*  // 开始识别(自定义数据源)
stop() async                                             // 停止识别
Future<void> cancel()                                    // 取消识别并把 SDK 状态强制重置回 none（iOS/Android 均生效）
release() async                                          // 释放资源
Future<void> writeContent(ContextPrompt contextPrompt)   // 在识别过程中发送临时热词/上下文prompt

// 以下 3 个 SDK 状态查询接口 iOS/Android 均已支持（V2 底层原生提供）
Future<ASRRecognizeState> getAudioRecognizeState()       // 查询 SDK 当前录音识别状态
Future<bool> canStartAudioRecognize()                    // 当前是否可以直接开启一次新的识别（等价 state == none）
Future<bool> needCancelToResetState()                    // 当前是否停留在 start/stop 中间态，需要先 cancel 重置

try {
    if (_controller != null) {
      await _controller?.release();
    }
    _controller = await _config.build();
    setState(() {
      _btn_onclick = stopRecognize;
    });
    await for (final val in _controller!.recognize()) {
      switch (val.type) {
        case ASRDataType.SLICE:
          var id = val.id!;
          var res = val.res!;
          var speakerId = val.speakerId;   // 说话人 ID：-1=未确定，0~9=对应说话人（V2 引擎下发）
          var sentenceType = val.sentenceType; // 句子类型：0=中间态（非稳态），1=稳态（最终确定结果）
          if (id >= _sentences.length) {
            for (var i = _sentences.length; i <= id; i++) {
              _sentences.add("");
            }
          }
          _sentences[id] = res;
          setState(() {
            _result = _sentences.map((e) => e).join("");
          });
          break;
        case ASRDataType.SUCCESS:
          setState(() {
            _btn_onclick = startRecognize;
            _result = val.result!;
            _sentences = [];
          });
          break;
      }
    }
  } on ASRError catch (e) {
    setState(() {
      _btn_onclick = startRecognize;
      _result = "错误码：${e.code} \\n错误信息: ${e.message} \\n详细信息: ${e.resp}";
    });
  } catch (e) {
    log(e.toString());
    setState(() {
      _btn_onclick = startRecognize;
    });
  }
}

ASRDataType type;    //数据类型
int? id;             //句子的sentence_id
String? res;         //数据类型为SLICE时返回的识别结果，具体格式参考服务端返回
String? result;      //数据类型为SUCCESS时返回的识别结果，具体格式参考服务端返回
String? info;        //数据类型为NOTIFY时携带的信息，具体格式参考服务端返回
int? speakerId;      //说话人 ID：-1=未确定，0~9=对应说话人。V2 引擎（如 16k_zh_en_speaker_2.0）下发
int? sentenceType;   //句子类型：0=中间态（非稳态，可能被后续结果修正），1=稳态（最终确定结果）。V2 引擎下发

{
  "code": 0,
  "message": "",
  "sentences": {
    "voice_text_str": "完整识别文本",
    "sentence_list": [
      {
        "sentence_id": 0,
        "sentence_type": 1,
        "speaker_id": 0,
        "sentence": "今天天气真好"
      },
      {
        "sentence_id": 1,
        "sentence_type": 0,
        "speaker_id": -1,
        "sentence": "是的啊"
      }
    ]
  },
  "speaker_context_id": "a1b2c3d4e5f6..."
}

enum ASRDataType {
  SLICE,
  SUCCESS,
  NOTIFY,
}

class ContextPrompt {
  String? contextType;       // 顶层 contextType（可选）
  List<PromptItem>? prompt;  // 结构化 prompt 列表
  String? hotwordList;       // 临时热词，格式同 hotword_list："词|权重,词|权重"
}

class PromptItem {
  String contextType;  // 上下文类型，由业务自定，如 "scene"、"domain" 等
  List<String> texts;  // 该类型下的提示词文本列表
}

final prompt = ContextPrompt(
  hotwordList: "订金|11,语音识别|5",
  contextType: "context",
  prompt: [
    PromptItem(contextType: "scene", texts: ["订金的胶带", "胶带反应"]),
    PromptItem(contextType: "domain", texts: ["订金"]),
  ],
);
await _controller!.writeContent(prompt);

int code; //错误码 iOS参考QCloudRealTimeClientErrCode Android参考ClientException
String message; //错误消息
String? resp; //服务端返回的原始数据