Pakete, Repositories und App-Kategorien suchen

GitHub-Repositorytacshi/Soundcore

Soundcore

Lokale App für soundcore Work (Anker AI-Aufnahmepunkte / D3200): BLE-Kopplung und Verbindung, Aufnahme-Management, Echtzeit-Transkription mit KI, Massenexport über Wi-Fi SoftAP

Projektcover von Soundcore
Sterne
219
Forks
49
Letzter Push (UTC)
12.10.2026
Projektstatus
Aktiv

Original-README

Englischer Projektschnappschuss. Aktuelle Inhalte auf GitHub.

Soundcore Manager(安克录音豆)

soundcore Work(安克 AI 录音豆 / D3200)本地管理 App,基于逆向出的设备协议(见 PROTOCOL.md)用 Flutter 实现,脱离飞书 App 独立使用:BLE 配对连接、录音管理、AI 实时/批量转写、Wi‑Fi SoftAP 批量导出。

支持平台

平台 状态
Android BLE 扫描 / GATT
iOS BLE 扫描 / GATT
macOS BLE 扫描 / GATT(需 Bluetooth entitlement)

功能

  • 首页:浏览本地与设备端录音,下拉刷新、长按批量选择;点开详情阅读全文、翻译、播放、分享或重命名
  • 录音详情:实时转写与保存后的文本使用同一详情页;返回首页不停止录音,暂停后保留当前页面。向上滚动可阅读旧内容,点「最新内容」恢复跟随
  • 设备:电量(耳机 + 充电盒)、录音控制、配对绑定 / 解绑、恢复出厂设置
  • 设置:选择 Apple 设备端或 Soniox、准备语言、自动转写、API Key 管理与诊断日志
  • 扫描:首页顶部按钮触发底部弹窗(非独立 Tab)搜索并连接 BLE 设备
  • Wi‑Fi 批量导出:SoftAP 直连 + AES 解密,导出文件本地播放
  • iPhone 操作按钮:从锁屏或其他 App 打开本应用,并让已绑定的 D3200 立即开始录音

配置 iPhone 操作按钮

安装并至少连接一次录音豆后,在支持操作按钮的 iPhone 上打开:

  1. 设置 → 操作按钮 → 快捷指令。
  2. 选择 安克录音豆 → Start Recording。
  3. 长按操作按钮。App 会打开;如果录音豆暂时离线,会先自动重连再开始录音。

录音已经进行时再次运行快捷指令只会回到当前实时会话,不会重复发送开始命令。若 30 秒内找不到已绑定设备,请唤醒并靠近录音豆后重试。

项目结构

lib/
├── ai/          # Soniox STT(实时流式 + 批量文件)
├── audio/       # Ogg/Opus 封装、Opus→PCM 解码
├── ble/         # 扫描广播解析、GATT 服务、离线文件拉取、实时音频流
├── crypto/      # 设备端 ECDH / AES 会话加解密
├── protocol/    # 帧格式、命令字、数据模型
├── state/       # Provider 状态:设备连接、录音、转写、导出目录、App 设置
├── theme/       # 主题与配色
├── ui/          # 首页 / 设备 / 设置页面与组件
└── wifi/        # SoftAP 连接与批量导出服务

运行

# macOS(推荐用脚本)
./scripts/debug-mac.sh              # flutter run -d macos --debug
./scripts/debug-mac.sh --build-only # 仅构建 debug .app
./scripts/debug-mac.sh --open       # 构建 debug .app 并打开

# 其他平台
flutter run -d ios
flutter run -d android

构建

# macOS release + DMG → dist/soundcore-manager-<version>-macos.dmg
./scripts/build-dmg.sh
./scripts/build-dmg.sh --open       # 构建后在 Finder 中显示 DMG
./scripts/build-dmg.sh --skip-build # 打包已有的 Release .app

# iOS 真机安装(Xcode 签名)
./scripts/install-ios.sh

flutter build ios
flutter build apk   # 或 appbundle

测试

flutter test

覆盖协议帧编解码、设备加解密、Opus/Ogg 处理、导出目录、STT 数据模型等核心逻辑(test/)。

说明

  • Apple 设备端处理(iOS 26+,取决于设备和语言):D3200 实时音频与已保存录音可在 iPhone 上转写;支持实时单向翻译及已有转写文本的翻译。实时录音语言在设置中选择;已有录音可在转写或重新转写时选择语言,并按提示下载资源。Apple 处理失败不会自动切换到云端。面对面双向交流使用 Soniox。
  • Soniox 转写(可选):实时或批量生成转写。
    • 实时路径:BLE Opus → PCM16 → 对应服务商 WebSocket STT。
    • 批量路径:通过 Soniox 异步 Files API 上传 Ogg 文件。
    • Key 配置:export SONIOX_API_KEY=… 后重启 App,或在设置页粘贴保存。
  • Wi‑Fi SoftAP 批量导出 + 解密:BLE 连接后先做 ECDH 握手(0x2E/0x01)生成会话密钥;导出时打开设备 SoftAP → 加入 → WebSocket 拉取,每 160 字节分片用 1A07 头(soundcored3200 magic)中的单文件密钥做 AES‑CTR 解密。导出文件保存在 Documents/AnkerRecorder/exports 下,命名为 {fileId}.opus(握手失败则为 .opus.bin)。本地播放使用 just_audio 播放已导出文件。
  • 设备协议细节(服务/特征 UUID、命令字、加密流程等)见 PROTOCOL.md。
  • 请保持蓝牙开启;旧版 Android 扫描需授予定位权限。
  • 录音进行中修改处理服务、模式或语言,将在下次录音生效。已有 Soniox 配置会保留;支持 Apple 处理且未配置 Soniox 的新设置优先选择 Apple。
Rocky Shi GitHub avatar
GitHub-Autor

Rocky Shi ↗

Auckland
SprachenDartSwiftShellKotlinRubyObjective-C

Kategorien

Verwendete Abhängigkeiten

Abhängigkeiten 17 Einträge

Ranglisten

Wie wähle ich ein passendes Repository?

Nach Anwendungsfall filtern, Aktivität vergleichen und vor der Nutzung das Originalprojekt prüfen.

  1. Nach Name, Autor oder Beschreibung suchen und nach Thema eingrenzen.
  2. Sterne, Forks und letzte Pushes vergleichen. Sterne zeigen Interesse, garantieren aber keine Qualität.
  3. Vor der Nutzung README, Lizenz und Issues auf GitHub prüfen.

Quellen und Pflege

“A repository is the most basic element of GitHub.”

GitHub Docs — About repositories ↗