wangyang
/
yx_speech_to_text_flutter
1
0
Fork 0
Code Pull Requests Actions Releases Activity
yx_speech_to_text_flutter/CHANGELOG.md

3.8 KiB
Raw Blame History

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.0.5] - 2026-01-17

⚡ Improved

  • 初始化不卡 UI：新增 useRecognizerIsolate 选项，将 sherpa_onnx recognizer 初始化/解码放到后台 isolate，避免初始化期间 UI 卡顿、进度动画不刷新
  • RecordingButton 体验优化：首次点击懒加载初始化时先让出一帧，确保加载动画能立即渲染

🐛 Fixed

  • 修复 RecordingButton 中防抖延迟导致的测试 pending timers 问题（改为可取消 Timer 并在 dispose 清理）
  • 修复测试环境下部分平台 API 不可用导致的失败（增加必要的 mock/容错）

[1.0.4] - 2025-01-23

🎉 Added - 多实例会话管理支持

  • 会话管理系统：新增完整的会话管理功能，支持同一页面多个独立的录音会话
  • YxAsrService 新方法：
    • registerSession() - 注册新会话
    • unregisterSession() - 注销会话
    • startListeningForSession() - 为特定会话开始录音
    • stopListeningForSession() - 为特定会话停止录音
    • getResultStreamForSession() - 获取特定会话的结果流
    • getStatusStreamForSession() - 获取特定会话的状态流
    • getRegisteredSessions() - 获取所有已注册的会话列表
    • getActiveSessionId() - 获取当前活跃的会话ID
  • RecordingButton 新参数：
    • sessionId - 会话ID参数，用于标识不同的录音实例
  • 智能会话切换：自动管理会话切换，同一时间只有一个会话活跃

🐛 Fixed

  • 修复同一页面多个 RecordingButton 状态同步问题
  • 修复录音结果分发到错误按钮的问题
  • 修复会话间状态互相干扰的问题

⚡ Improved

  • 优化会话切换逻辑，无缝切换不同会话
  • 改进资源管理，会话注销时自动清理资源
  • 增强错误处理，会话级别的错误追踪

📝 Changed

  • 保持完全向后兼容，现有代码无需修改
  • 识别结果同时发送到全局流和会话流（双重分发机制）

🎯 Use Cases

此版本主要解决以下场景：

  • ✅ 同一页面有多个录音输入框（如：问题反馈 + 本月总结）
  • ✅ 多个 RecordingButton 需要独立工作，互不干扰
  • ✅ 需要追踪特定录音按钮的状态和结果

💡 Breaking Changes

无破坏性更改，完全向后兼容。

📚 Documentation

  • 新增会话管理API文档
  • 更新使用示例，包含多实例场景
  • 添加会话管理最佳实践指南

[1.0.0] - 2025-08-26

Added

  • Initial release of YX ASR Flutter plugin
  • Real-time speech-to-text recognition for iOS and Android
  • Support for multiple languages and locales
  • Customizable RecordingButton widget with visual feedback
  • Comprehensive error handling and permission management
  • Stream-based API for results, errors, and status changes
  • On-device recognition support for iOS (iOS 13+)
  • Partial results support for real-time transcription
  • Example app demonstrating all features
  • Comprehensive documentation and API reference

Features

  • Cross-platform support (iOS 11+ and Android API 21+)
  • Minimal third-party dependencies
  • Proper lifecycle management
  • Permission handling for microphone access
  • Multiple recognition alternatives
  • Confidence scoring for recognition results
  • Cancellation support
  • Audio session management

Platform Support

  • iOS: Uses Speech framework with AVAudioEngine
  • Android: Uses SpeechRecognizer API with proper lifecycle management

Supported Languages

  • English (en-US, en-GB)
  • Chinese (zh-CN, zh-TW)
  • Japanese (ja-JP)
  • Korean (ko-KR)
  • Spanish (es-ES)
  • French (fr-FR)
  • German (de-DE)
  • Italian (it-IT)