int appID = 0; // 腾讯云 appID
int projectID = 0; //腾讯云 projectID
String secretID = ""; //腾讯云 secretID
String secretKey = ""; // 腾讯云 secretKey
String? token = null; // 腾讯云 token（可选）

String engine_model_type = "16k_zh_en_speaker"; //设置引擎，不设置默认16k_zh_en_speaker
int filter_dirty = 0; //是否过滤脏词，具体的取值见API文档的filter_dirty参数
int filter_modal = 0; //过滤语气词具体的取值见API文档的filter_modal参数
int filter_punc = 0; //过滤句末的句号具体的取值见API文档的filter_punc参数
int convert_num_mode = 1; //是否进行阿拉伯数字智能转换。具体的取值见API文档的convert_num_mode参数
String hotword_id = ""; //热词id。具体的取值见API文档的hotword_id参数
String customization_id = ""; //自学习模型id,详情见API文档
int? vad_silence_time = 0; //语音断句检测阈值,详情见API文档
int needvad = 1; //人声切分,详情见API文档
int word_info = 0; //是否显示词级别时间戳,详情见API文档
int reinforce_hotword = 0; //热词增强功能,详情见API文档
double noise_threshold = 0; //噪音参数阈值,详情见API文档

bool is_compress = true; //是否开启音频压缩,开启后使用opus压缩传输数据
bool silence_detect = false; //静音检测功能,开启后检测到静音会停止识别
int silence_detect_duration = 5000; //静音检测时长,开启静音检测功能后生效
bool is_save_audio_file = false; //是否保存音频,仅对内置录音生效,格式为s16le,16000Hz,mono的pcm,开启后会通过NOTIFY类型的ASRData返回到上层,其中ASRData中info为以下的JSON格式{"type":"onAudioFile, "code": 0, "message": "audio file path"}
String audio_file_path = ""; //is_save_audio_file为true时,会将音频保存在指定位置

/// 自定义请求域名，仅替换 ws/wss 连接的域名部分；不传则使用默认内置国内域名 asr.cloud.tencent.com。
/// 仅传纯域名，无需带路径，例如境外用户可设置为 "asr.international.cloud.tencent.com"。
/// 注意：签名串始终使用默认内置国内域名计算，不受此参数影响。
String? host;

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                                             // 停止识别
release() async                                          // 释放资源
Future<void> writeContent(ContextPrompt contextPrompt)   // 在识别过程中发送临时热词/上下文prompt

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 ?? 0;
          var res = val.res ?? 0;
          var speakerId = val.speakerId;   // 话者分离：发言者ID
          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，具体取值参考服务端返回（仅部分引擎支持）
int? sentenceType;   //话者分离：句子状态类型，具体取值参考服务端返回（仅部分引擎支持）

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; //服务端返回的原始数据