패키지, 저장소 및 앱 카테고리 검색

GitHub 저장소tacshi/Soundcore

Soundcore

soundcore Work(안커 AI 녹음 콩 / D3200) 로컬 관리 앱: BLE 페어링 연결, 녹음 관리, AI 실시간 전사, Wi-Fi SoftAP 일괄 내보내기

Soundcore 프로젝트 이미지
스타
219
포크
49
최근 푸시(UTC)
2026. 10. 12.
프로젝트 상태
활성

원본 README

아래는 영문 원문 스냅샷입니다. 최신 내용은 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 작성자

Rocky Shi ↗

Auckland
언어DartSwiftShellKotlinRubyObjective-C

분류

사용 중인 의존성

의존성 목록 17 개

순위

프로젝트에 맞는 저장소를 선택하려면?

사용 목적에 따라 검색하고 개발 활동을 비교한 뒤 원본 저장소에서 요구 사항을 확인하세요.

  1. 이름, 작성자 또는 설명으로 검색하고 기술 주제로 범위를 좁힙니다.
  2. 스타, 포크, 최근 푸시를 함께 비교하세요. 스타는 관심의 지표이며 품질을 보장하지 않습니다.
  3. 사용하기 전에 GitHub에서 README, 라이선스, Issues를 확인하세요.

출처 및 관리

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

GitHub Docs — About repositories ↗