import 'dart:async'; import 'dart:io'; import 'package:echomeet_device_sdk/echomeet_device_sdk.dart'; import 'package:get/get.dart'; import 'package:get_storage/get_storage.dart'; import 'package:permission_handler/permission_handler.dart'; import '../../core/utils/logger.dart'; import '../../core/utils/permission_util.dart'; import 'background_launch_consent.dart'; import 'agent_module_defaults.dart'; import '../models/user_Info.dart'; import 'network/api.dart'; /// 蓝讯方案设备(AI手机支架 / AI Pencil)的接入层。 /// /// 底层协议实现全部来自 echomeet 项目的 `recorder_holder` 插件,本类只是把 /// [EchoMeetDeviceSdk] 的流封装成 GetX 可观测状态,不重写任何蓝牙/Opus 逻辑。 /// /// 与项目原有的 [BleManager](杰理耳机链路)是两套独立的设备通路,互不影响: /// - 杰理耳机 → BleManager /// - 蓝讯支架 → 本服务 class HolderDeviceService extends GetxService { static const String _tag = 'HolderDeviceService'; static HolderDeviceService get to => Get.find(); final EchoMeetDeviceSdk _sdk = EchoMeetDeviceSdk.instance; /// 扫描到的设备 final RxList scanned = [].obs; /// 按 MAC 去重累积扫描结果。 /// /// 原生侧是「每扫到一个设备就单独上报一次」(notifyScanResult 传单元素列表), /// SDK 收到后会把整个结果流替换成这一条。如果直接 assignAll,目标设备刚进列表 /// 就会被下一个不匹配设备的空结果清掉,界面永远是空的。 /// echomeet 那边用的是 _byMac 累积(见 ble_scanner.dart),这里保持一致。 final Map _byAddress = {}; /// 连接状态 final Rx connection = EchoMeetConnectionState.disconnected.obs; /// 设备录音状态(SDK 上报) final Rx recording = const EchoMeetRecordingState().obs; /// 设备信息(电量 / 固件版本) final Rxn deviceInfo = Rxn(); final RxBool isScanning = false.obs; /// 当前连接设备的 MAC(连接时记下,SDK 未提供反查接口) final RxString connectedAddressRx = ''.obs; String get connectedAddress => connectedAddressRx.value; /// 当前连接设备的广播名(设备页据此选主图) final RxString connectedNameRx = ''.obs; String get connectedName => connectedNameRx.value; // ==================== 自动回连 ==================== static const String _lastDeviceKey = 'holder_last_device'; final GetStorage _storage = GetStorage(); Timer? _autoConnectTimer; int _autoAttempt = 0; /// 本地已绑定设备列表的存储键(服务端绑定失败时也保证设备管理页有记录) static const String _pairedListKey = 'holder_paired_devices'; /// 记住最近一次成功连接的设备,供开机/断连后自动回连, /// 同时写入本地已绑定列表(设备管理页会合并展示)。 void _rememberDevice(String name, String address) { if (address.isEmpty) return; _storage.write(_lastDeviceKey, {'name': name, 'address': address}); _savePaired(name, address); } /// 本地已绑定的支架列表 List get pairedDevices { final raw = _storage.read(_pairedListKey); if (raw == null) return const []; return raw.whereType().toList(growable: false); } void _savePaired(String name, String address) { final list = pairedDevices.toList(); final key = address.toUpperCase(); list.removeWhere( (e) => (e['address'] ?? '').toString().toUpperCase() == key); // 最近连接的排最前,供后续多设备回连按 MRU 顺序尝试 list.insert(0, {'name': name, 'address': address}); _storage.write(_pairedListKey, list); Logger.i(_tag, '本地已绑定列表更新,共 ${list.length} 台'); } /// 从本地已绑定列表移除(解绑用) void removePaired(String address) { final list = pairedDevices.toList(); final key = address.toUpperCase(); list.removeWhere( (e) => (e['address'] ?? '').toString().toUpperCase() == key); _storage.write(_pairedListKey, list); } Map? get _lastDevice => _storage.read(_lastDeviceKey); /// 是否有已绑定(记住)的支架 bool get hasPairedDevice => (_lastDevice?['address'] ?? '') != ''; /// 最近一次连接过的设备名。断连后设备页仍按它显示主图, /// 而不是退回默认图——用户看到的应该是"我的那台设备"。 String get lastDeviceName { final n = connectedNameRx.value; if (n.isNotEmpty) return n; return (_lastDevice?['name'] ?? '') as String; } /// 尝试自动回连。 /// /// Android 上 SDK 的 connect() 走的是 registerBackgroundScan(mac), /// 那本身就是系统级「后台扫到该 MAC 就连」的注册——设备开机进入广播范围时 /// 由原生层自动接上。所以自动回连的关键是:App 启动后 / 断连后重新注册一次。 /// 注册失败按退避重试,最多 [_maxAutoAttempts] 次。 static const int _maxAutoAttempts = 5; /// 本次运行里用户拒绝过系统蓝牙权限。拒绝后不再自动重试、不再反复弹框, /// 直到用户主动去连接页重试([resetPermissionDenied])。 bool _permissionDenied = false; void resetPermissionDenied() => _permissionDenied = false; Future tryAutoConnect({bool reset = true}) async { if (reset) _autoAttempt = 0; _autoConnectTimer?.cancel(); if (isConnected) return; // 自动回连 = 向系统注册蓝牙后台扫描 = 设备靠近时自启动本应用, // 未取得用户明示同意前不能做(应用商店合规检测项)。 // 这里只做静默检查,不弹窗——弹窗只在用户主动点连接时弹。 if (!BackgroundLaunchConsent.granted) { Logger.i(_tag, '用户未开启设备自动连接,跳过后台扫连注册'); return; } final last = _lastDevice; final address = (last?['address'] ?? '') as String; if (address.isEmpty) return; if (_permissionDenied) { Logger.i(_tag, '本次运行已被拒绝蓝牙权限,不再重复申请'); return; } // 合规(场景 1/2):后台自动回连是没有用户操作的流程,这里**只能查状态、 // 不能申请权限**——原来调 _sdk.requestPermission() 会让原生直接弹系统框, // 而且拒绝标记只存在内存里,重启 App 又会再弹一次,正好踩中场景 2。 // 没权限就安静地放弃自动回连,等用户自己去连接页点连接时再申请。 if (!await _hasBluetoothPermission()) { _permissionDenied = true; _autoConnectTimer?.cancel(); _autoAttempt = _maxAutoAttempts; Logger.w(_tag, '无蓝牙权限,自动回连中止(不弹框,等用户主动连接时再申请)'); return; } final name = (last?['name'] ?? 'Echomeet') as String; connectedNameRx.value = name; Logger.i(_tag, '自动回连注册: $name $address (第 ${_autoAttempt + 1} 次)'); connectedAddressRx.value = address; bool ok = false; try { ok = await _sdk.connect(name: name, address: address); } catch (e) { Logger.e(_tag, '自动回连注册异常: $e'); } // 注册成功后由原生后台扫连接管;这里只在注册失败时退避重试 if (!ok && ++_autoAttempt < _maxAutoAttempts) { final delay = Duration(seconds: 5 * _autoAttempt); _autoConnectTimer = Timer(delay, () => tryAutoConnect(reset: false)); } } StreamSubscription? _scanSub; StreamSubscription? _connSub; StreamSubscription? _recSub; StreamSubscription? _infoSub; /// 设备是否已连接 bool get isConnected => connection.value == EchoMeetConnectionState.connected; /// 设备当前是否正在录音(以 SDK 缓存的设备上报状态为准)。 /// /// 录音控制是 toggle 语义,下发前必须先看设备实际状态—— /// 设备已经在录时再发一次 toggle 会把它关掉。 bool get deviceIsRecording => recording.value.isRecording || _sdk.isRecording; /// 录音的 PCM 帧流(16kHz / 16bit / 单声道,Opus 已在原生侧解码) Stream get audioFrames => _sdk.audioFrames; @override void onInit() { super.onInit(); _sdk.ensureBound(); _scanSub = _sdk.scanResults.listen((list) { if (list.isEmpty) return; // 空批次不清空已发现列表 for (final d in list) { final key = d.address.isNotEmpty ? d.address : d.id; if (key.isEmpty) continue; _byAddress[key] = d; } scanned.assignAll(_byAddress.values.toList(growable: false)); }); _connSub = _sdk.connectionState.listen((s) { Logger.i(_tag, '连接状态: $s'); connection.value = s; if (s == EchoMeetConnectionState.connected) { _autoConnectTimer?.cancel(); _autoAttempt = 0; _rememberDevice('Echomeet', connectedAddressRx.value); // 首次连上支架 → AI 页铺开支架的默认功能编排 AgentDefaults.onHolderConnected(); } else if (s == EchoMeetConnectionState.disconnected && hasPairedDevice) { // 设备关机/走远导致的断连:重新挂上后台扫连,等它再开机 Logger.i(_tag, '连接断开,重新注册后台扫连等待设备上线'); Future.delayed(const Duration(seconds: 3), () => tryAutoConnect()); } }); _recSub = _sdk.recordingState.listen((s) => recording.value = s); _infoSub = _sdk.deviceInfo.listen((i) => deviceInfo.value = i); // App 启动后延迟一点再挂,等蓝牙栈和权限就绪 Future.delayed(const Duration(seconds: 3), () => tryAutoConnect()); } @override void onClose() { _scanSub?.cancel(); _connSub?.cancel(); _recSub?.cancel(); _infoSub?.cancel(); _autoConnectTimer?.cancel(); super.onClose(); } /// 支架 SDK 扫描/连接需要的蓝牙权限 static const List _btPermissions = [ Permission.bluetoothScan, Permission.bluetoothConnect, ]; /// 只查状态,不申请 Future _hasBluetoothPermission() async { if (!Platform.isAndroid) return true; for (final p in _btPermissions) { if (!await p.status.isGranted) return false; } return true; } /// 用户拒绝过且仍在 48h 冷却期 —— UI 据此把扫描/连接入口置灰 bool get isPermissionCoolingDown => Platform.isAndroid && PermissionUtil.instance.isAnyDenialCoolingDown(_btPermissions); /// 申请蓝牙权限(只允许在用户主动触发扫描/连接时调用) /// /// 合规(场景 1/2):SDK 的 requestPermission() 是原生直接弹系统框的, /// permission_handler 管不到,所以在这里手工加冷却闸:拒绝过就直接返回 false, /// 不再调用 SDK,重启 App 也一样——把拒绝状态落到 GetStorage 而不是内存变量。 Future requestPermission() async { if (await _hasBluetoothPermission()) return true; if (isPermissionCoolingDown) { Logger.i(_tag, '蓝牙权限已被拒绝,48h 冷却中,本次不再申请,请置灰入口'); return false; } final granted = await _sdk.requestPermission(); if (!granted) { await PermissionUtil.instance.markDenied(_btPermissions); } return granted; } Future startScan() async { if (!await requestPermission()) { Logger.w(_tag, '蓝牙权限被拒绝,无法扫描'); return; } _byAddress.clear(); scanned.clear(); isScanning.value = true; await _sdk.startScan(); } Future stopScan() async { await _sdk.stopScan(); isScanning.value = false; } Future connect(EchoMeetScannedDevice device) async { await stopScan(); Logger.i(_tag, '连接设备: ${device.name} ${device.address}'); connectedAddressRx.value = device.address; connectedNameRx.value = device.name; _rememberDevice(device.name, device.address); // 先向服务端登记绑定,设备管理页才有记录 await bindToServer(device); return _sdk.connectDevice(device); } /// 把支架登记到服务端的已绑定设备列表。 /// /// 走的是和杰理耳机同一个 user_binddevice 接口。蓝讯广播里没有杰理那套 /// pid/code 授权字段,所以 pid 用广播里的 hex(服务端可据此识别), /// code 留空——接口失败不阻断连接,只记日志。 Future bindToServer(EchoMeetScannedDevice device) async { if (!User.isLoggedIn()) { Logger.w(_tag, '未登录,跳过设备绑定登记'); return; } try { final resp = await Api.binddevice({ 'pid': device.advertisementHex, 'code': '', 'devicename': device.name, 'devicemac': device.address, }); Logger.i(_tag, '绑定接口返回: $resp'); final deviceJson = resp?['device']; if (deviceJson is Map) { User.instance.addUserDevice(UserDevice.fromJson(deviceJson)); Logger.i(_tag, '支架已登记到已绑定设备列表'); } else { Logger.w(_tag, '绑定接口未返回 device 字段,设备管理页可能看不到这台'); } } catch (e) { // 绑定失败不影响本次连接和录音,只是设备管理页没有记录 Logger.e(_tag, '支架绑定登记失败: $e'); } } /// 等待连接真正建立。 /// /// Android 上 [connect] 调的是 registerBackgroundScan,返回值只代表「后台扫连 /// 注册成功」,真正连上是异步的,要等 connectionState 流推 connected。 /// SDK 的 INTEGRATION.md 快速开始里也是这个流程。 Future waitConnected({ Duration timeout = const Duration(seconds: 25), }) async { if (isConnected) return true; final completer = Completer(); late final Worker worker; Timer? timer; void finish(bool ok) { if (completer.isCompleted) return; worker.dispose(); timer?.cancel(); completer.complete(ok); } worker = ever(connection, (s) { if (s == EchoMeetConnectionState.connected) { // 连上后主动拉一次电量,设备页右下角才有数可显示 refreshBattery(); finish(true); } if (s == EchoMeetConnectionState.error) finish(false); }); timer = Timer(timeout, () => finish(isConnected)); return completer.future; } /// 主动断开:同时清掉记忆,避免用户手动断开后又被自动连回 Future disconnect() async { _autoConnectTimer?.cancel(); final addr = connectedAddressRx.value; await _storage.remove(_lastDeviceKey); if (addr.isNotEmpty) removePaired(addr); await _sdk.disconnect(); } /// 打开设备编码器,让它开始往手机推 Opus 流。 /// /// 协议层是 `0xAA 0x05 0x02 0xB1 0x02 [CRC]`。这是唯一真正下发到设备的 /// 录音相关命令——`toggleRecording` 只切换原生的本地录音状态,不发 BLE 包。 Future openEncoder() => _sdk.openEncoder(); /// 切换设备录音状态。 /// /// 注意:原生的 toggleRecording **不发任何 BLE 包**,只切换 BleRecord 的 /// 本地 timerStatus / 文件写入状态。真正让设备推流的是 [openEncoder]。 Future startRecording() => _sdk.toggleRecording(); /// 停止设备录音。[fileName] 会作为设备端保存的文件名。 /// /// SDK 的 stopRecording 内部是 setNewName(name) + saveRecording(), /// 与 echomeet 的停止序列一致,直接复用。 Future stopRecording({String? fileName}) => _sdk.stopRecording(fileName: fileName); /// 暂停 / 恢复(SDK 是 toggle 语义) Future toggleRecording() => _sdk.toggleRecording(); Future refreshBattery() => _sdk.refreshBattery(); }