H07 Android应用 - 模块文档总览
本目录包含H07 Android应用的所有功能模块文档,每个文档基于实际代码实现编写,确保准确性和实用性。
📁 文档结构
modules/
├── communication/ # 通讯模块
│ ├── mqtt.md # MQTT通讯
│ ├── serial-port.md # 串口通讯
│ ├── ntrip.md # NTRIP差分数据
│ ├── bluetooth-spp.md # 经典蓝牙-SPP串口
│ ├── bluetooth-a2dp.md # 经典蓝牙-A2DP音频
│ ├── bluetooth-hfp.md # 经典蓝牙-HFP免提通话
│ ├── bluetooth-headset.md # 经典蓝牙-蓝牙耳机管理
│ └── bluetooth-ble.md # BLE低功耗蓝牙
├── media/ # 媒体相关
│ ├── photo.md # 拍照
│ ├── recording.md # 本地录屏
│ └── livekit-video.md # 实时音视频
├── voice/ # 语音播报模块
│ ├── audio-player.md # 音频播报
│ └── tts-manager.md # TTS语音播报
└── location/ # 定位模块
└── gps-rtk-uwb.md # GPS/RTK/UWB定位
🗂️ 模块分类
1. 通讯模块 (Communication)
MQTT通讯
- 文档: mqtt.md
- 核心类:
MqttClient - 功能: 物联网消息推送、设备状态上报、指令下发
- 使用场景: 位置上报、远程控制、报警推送
串口通讯
- 文档: serial-port.md
- 核心类:
SerialPort - 功能: UART串口通信、数据收发
- 使用场景: 外部传感器通信、MCU通信
NTRIP差分数据
- 文档: ntrip.md
- 核心类:
NtripManager,NtripClient - 功能: RTK差分数据接收、GGA位置上报、自动重连
- 使用场景: RTK高精度定位、厘米级定位
经典蓝牙-SPP串口
- 文档: bluetooth-spp.md
- 核心类:
BluetoothSppManager - 功能: 蓝牙串口通信、ASCII协议、录制控制
- 使用场景: 设备间数据传输、远程控制
经典蓝牙-A2DP音频
- 文档: bluetooth-a2dp.md
- 核心类:
BluetoothA2dpManager - 功能: 高质量音频流传输
- 使用场景: 连接蓝牙音箱、蓝牙耳机
经典蓝牙-HFP免提通话
- 文档: bluetooth-hfp.md
- 核心类:
BluetoothHfpManager - 功能: 免提电话、通话控制
- 使用场景: 蓝牙通话、语音对讲
经典蓝牙-蓝牙耳机管理
- 文档: bluetooth-headset.md
- 核心类:
BluetoothAudioRoutingManager - 功能: 音频路由切换、SCO连接管理
- 使用场景: 音频输出控制
BLE低功耗蓝牙
- 文档: bluetooth-ble.md
- 核心类:
BluetoothBleManager - 功能: BLE设备扫描、GATT服务、特征值读写
- 使用场景: 连接BLE传感器、低功耗设备
2. 拍照
- 文档: photo.md
- 核心类:
RecordingService,VideoRecorderAPI - 功能: 独立拍照、文字叠加、自动上传
- 使用场景: 现场拍照、证据留存
3. 本地录屏
- 文档: recording.md
- 核心类:
RecordingService - 功能: 后台录制、文字叠加、前台服务
- 使用场景: 现场录制、工作记录
4. 实时音视频
- 文档: livekit-video.md
- 核心类:
MainActivity,CustomTextFrameProcessor,CustomCapturePostProcessor - 功能: WebRTC实时音视频、视频水印、啸叫抑制
- 使用场景: 远程监控、视频会议、现场指挥
5. 语音播报模块 (Voice)
音频播报
- 文档: audio-player.md
- 核心类:
SoundPlayer - 功能: 预录制音频播放、报警语音(跌倒/脱帽/高温等)、系统状态播报
- 使用场景: 安全报警、环境报警、系统提示
TTS语音播报
- 文档: tts-manager.md
- 核心类:
TtsManager - 功能: 文字转语音、实时语音合成、多语言支持
- 使用场景: 动态文本播报、自定义语音提示
6. 定位模块 (Location)
GPS/RTK/UWB定位
- 文档: gps-rtk-uwb.md
- 核心类:
NativeLocationService,NtripManager,RtcmManager - 功能: GPS定位、RTK高精度定位、NTRIP差分数据
- 使用场景: 轨迹追踪、位置上报、精确定位
🎯 快速导航
按应用场景查找
| 场景 | 相关模块 |
|---|---|
| 设备通信 | MQTT、串口、NTRIP、蓝牙SPP |
| 音频功能 | A2DP、HFP、蓝牙耳机、音频播报、TTS |
| 视频功能 | 拍照、录屏、实时音视频 |
| 位置服务 | GPS/RTK定位 |
| 远程控制 | MQTT、蓝牙SPP |
| 数据采集 | BLE、串口、定位、NTRIP |
按技术栈查找
| 技术 | 相关模块 |
|---|---|
| 网络通信 | MQTT、LiveKit实时音视频、RTK/NTRIP |
| 蓝牙 | SPP、A2DP、HFP、BLE |
| 多媒体 | 拍照、录屏、音频播报、TTS |
| 硬件接口 | 串口、BLE、GPS |
| Android系统 | 音频路由、定位服务 |
📝 文档说明
文档特点
- 基于实际代码: 所有文档基于
D:\01-ZHOU-CODE\H07-Android-app源代码编写 - 完整API说明: 每个模块包含完整的API说明和参数
- 实用示例: 提供可直接运行的代码示例
- 注意事项: 列出常见问题和最佳实践
- 相关资源: 提供源码位置和扩展阅读
如何使用
- 新手: 从模块概述开始,了解功能和应用场景
- 开发: 查看核心API和使用示例
- 调试: 参考注意事项和常见问题
- 深入: 阅读源码和扩展资料
🔗 其他文档
📞 反馈与建议
如发现文档问题或有改进建议,请:
- 提交Issue
- 联系文档维护人员
- 直接修改并提交PR
更新日期: 2025-01-19
文档版本: v1.0
基于代码版本: H07 Android App (最新main分支)