# 分贝测量仪

**Repository Path**: sihuangtech/decibel-meter

## Basic Information

- **Project Name**: 分贝测量仪
- **Description**: 分贝测量仪 - 基于Flutter的跨平台专业声级测量分析应用。实时分贝监测、频谱可视化、加密数据记录、OSHA/NIOSH剂量计，全平台原生音频采集支持。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-05
- **Last Updated**: 2025-10-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 分贝测量仪（Flutter）— 跨平台声压级分析

[English Version (英文文档)](./README.md)

## 简介

分贝测量仪（Decibel Meter）是一款基于 Flutter 的跨平台应用（Android、iOS、macOS、Windows、Linux），用于实时分贝（SPL）测量、可视化与数据管理。

## 核心功能

- **实时分贝测量**：约 20–160 dB 范围，支持 dBA/dBC/dBZ 加权，快速/慢速响应，麦克风校准偏移
- **丰富可视化**：实时波形、频谱（FFT）、SPL 柱状条、历史曲线
- **数据管理**：测量记录（SQLite）、CSV/JSON 导出、录音与播放、分享功能
- **剂量计**：OSHA/NIOSH 听力负荷评估与预警
- **设置中心**：加权/响应选项、校准、主题模式、自动保存、历史保留天数
- **无障碍设计**：适配多终端（移动/桌面）的响应式界面
- **数据安全**：SQLCipher 加密数据库 + 安全密钥存储


## 项目结构

```
lib/
├── main.dart
├── core/
├── data/
│   ├── datasources/
│   │   ├── audio/          # 各平台 PCM 捕获/桥接
│   │   └── local/          # 加密数据库
│   ├── models/
│   ├── repositories/
│   └── services/
├── domain/
│   ├── entities/
│   ├── repositories/
│   └── usecases/
└── presentation/
    ├── providers/
    ├── screens/
    ├── widgets/            # 波形/频谱/SPL 组件
    └── theme/
```

## 依赖库

### 音频处理
- `noise_meter`
- `flutter_audio_capture`
- `record`

### 状态管理
- `provider`

### 数据持久化
- `sqflite_sqlcipher`
- `shared_preferences`
- `flutter_secure_storage`
- `path_provider`
- `path`

### 图表与UI
- `fl_chart`
- `syncfusion_flutter_charts`
- `google_fonts`
- `flutter_svg`

### 工具类
- `intl`
- `uuid`

## 安装配置

### 环境要求
- Flutter SDK (推荐 3.22+)

### 安装步骤
```bash
# 获取依赖
flutter pub get

# 从零开始安装
flutter pub add noise_meter permission_handler
flutter pub add provider
flutter pub add sqflite_sqlcipher shared_preferences flutter_secure_storage path_provider path
flutter pub add fl_chart syncfusion_flutter_charts
flutter pub add record
flutter pub add google_fonts flutter_svg
flutter pub add intl uuid
```

## 平台权限配置

### Android
- `RECORD_AUDIO`
- `WRITE_EXTERNAL_STORAGE`（导出/录音时需要）

### iOS/macOS
- `NSMicrophoneUsageDescription`（Info.plist）

### macOS
- `com.apple.security.device.audio-input`（entitlements）

### Windows/Linux
- 通过操作系统接入麦克风（WASAPI/PulseAudio）

## 运行与构建

### Android
```bash
flutter run -d android
```

### iOS
```bash
flutter run -d ios  # 需要 Xcode 配置
```

### macOS
```bash
flutter run -d macos  # 首次需要允许麦克风权限
```

### Windows
```bash
flutter run -d windows
```

### Linux
```bash
# 安装依赖
sudo apt-get update && sudo apt-get install -y libpulse-dev

# 运行
flutter run -d linux
```

## 桌面原生音频实现

### 通道命名规范
- **方法通道**：`audio_capture_ctrl`（start/stop，接受 sampleRate/bufferSize）
- **事件通道**：`audio_capture_stream`（持续发送 PCM 浮点数据）

### 各平台实现
- **macOS**：使用 AVAudioEngine
- **Windows**：使用 WASAPI（共享模式）
- **Linux**：使用 PulseAudio 简单 API

### Dart 统一接口
- macOS/Windows/Linux 使用相同的 Dart 封装
- AnalyzerProvider 读取 `Stream<Float32List>` 即可

### 开发注意事项
- 若本机编辑器对 C/C++ 报"找不到头文件"，通常是本地索引未带上 CMake 的 include/link 参数（假阳性）
- 请以 flutter run/build 的实际输出为准
- 如构建失败，请把日志贴给我们定位修复（可能需要补充系统开发库或调整 CMake）

## 数据安全与隐私

### 数据库安全
- 采用 `sqflite_sqlcipher`，加密文件 `decibel_meter_enc.db`

### 密钥管理
- 首次启动随机生成密钥并保存在 `flutter_secure_storage`

### 隐私保护
- 不记录隐私数据与密钥
- 导出/分享需用户主动触发

## 测试与质量

### 代码质量
- `flutter analyze` 保持 0 问题

### 测试建议
- 补充单元/Widget/集成测试（Provider、Service、数据导出等）

### 性能优化
- 保持 UI 绘制流畅
- 音频捕获线程与主线程隔离

## 路线图

- [ ] 噪音分类 AI：接入 TFLite 或端侧推理
- [ ] 桌面音频增强：设备选择、缓冲优化
- [ ] 可视化样式与无障碍细化
- [ ] 自动化测试与 CI
- [ ] 未加密数据库迁移策略

## 常见问题

### 1. 桌面构建头文件错误？
多为编辑器索引假阳性。请以 flutter run/build 输出为准；Linux 需安装 libpulse-dev。

### 2. 频谱/波形无变化？
确认已授予麦克风权限；在桌面端检查系统输入设备与音量。

### 3. 导出路径与分享失败？
确认写入权限；在 iOS 需使用系统分享面板，在 Android 12+ 适配存储策略。

## 贡献与开源

- 欢迎 PR，遵循 Flutter 官方风格与项目现有约定
- 许可证：本项目采用 Apache License 2.0，详见 [LICENSE](LICENSE)

## 联系

如需问题反馈或功能请求，请提交 Issue。

## 星标历史

[![Star History Chart](https://api.star-history.com/svg?repos=sihuangtech/decibel-meter&type=Date)](https://www.star-history.com/#sihuangtech/decibel-meter&Date)