Flutter实现SpeechToText单例 仅在语音转文字页触发权限申请

speech_to_text库官方明确要求：initialize方法每个应用会话仅需调用一次，首次调用后设置的状态、错误回调无法重置，全局需持有唯一插件实例，SpeechToTextProvider是官方推荐的跨组件复用实例方案。

完全可以实现需求，既保证全应用生命周期仅执行一次STT初始化，又能做到权限弹窗仅在用户进入语音功能页时触发。
你当前的问题根源是把STT初始化逻辑放在了应用根State的initState中，应用启动时就会自动执行initialize()方法，而该方法会主动触发系统麦克风、语音识别权限申请，才会导致iOS端启动即弹权限框。 #

具体实现步骤 #

1. 封装懒加载单例服务 #

新建独立的STT服务文件，通过单例模式持有全局唯一的插件实例和Provider，用标记位控制初始化逻辑仅执行一次：

class SpeechService {
  // 全局单例
  static final SpeechService _instance = SpeechService._internal();
  factory SpeechService() => _instance;
  SpeechService._internal();

  final SpeechToText _speech = SpeechToText();
  SpeechToTextProvider? _speechProvider;
  bool _initialized = false;

  /// 对外暴露的Provider实例，供各页面调用
  SpeechToTextProvider? get provider => _speechProvider;

  /// 确保初始化完成，重复调用不会重复执行初始化逻辑
  Future<void> ensureInit() async {
    if (_initialized) return;
    
    _speechProvider = SpeechToTextProvider(_speech);
    await _speechProvider?.initialize();
    _initialized = true;
  }
}

2. 移除根节点的初始化逻辑 #

把之前写在应用根State里的所有STT相关代码全部删掉，包括speech、speechProvider变量声明，initSpeechState方法，以及initState里创建Provider、调用初始化的逻辑，彻底避免应用启动时触发插件初始化。

3. 在语音功能页触发初始化 #

仅在用户进入语音转文字功能页面时，调用单例的初始化方法：

@override
void initState() {
  super.initState();
  // 进入功能页才触发初始化，此时才会弹出系统权限申请
  SpeechService().ensureInit().then((_) {
    if (mounted) {
      // 初始化完成后刷新页面状态，即可正常调用listen/start/stop等方法
      setState(() {});
    }
  });
}

方案说明 #

• 完全符合库的单次初始化要求：全应用生命周期内initialize()仅会执行一次，全局持有同一个插件实例，不会出现回调无法重置的问题
• 权限弹窗触发时机完全可控：只有用户第一次进入语音功能页、首次执行初始化时才会弹出权限申请，后续进入页面因为已经完成初始化，不会重复触发权限校验弹窗
• 所有需要使用STT能力的页面，统一通过SpeechService().provider获取实例即可，不需要重复创建对象

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