# angle-detector

**Repository Path**: kingsunrain/angle-detector

## Basic Information

- **Project Name**: angle-detector
- **Description**: Android 角度检测器 APP - 实时检测手机与水平面夹角
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-05-10
- **Last Updated**: 2026-05-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 角度检测器 (Angle Detector)

一款用于实时检测手机平面与水平面夹角的 Android 应用。

## 功能特性

- **实时角度检测**：显示手机倾斜角度（0°~90°）
- **状态指示**：水平放置（绿色）、倾斜中（黄色）、接近竖直（红色）
- **数据平滑**：使用低通滤波算法，减少抖动
- **三轴显示**：实时显示加速度计 X/Y/Z 轴数据

## 技术规格

| 项目 | 详情 |
|------|------|
| 最低版本 | Android 14 (API 34) |
| 目标版本 | Android 15 (API 35) |
| 核心算法 | 加速度计 + 低通滤波 |

## 安装

下载 `angle-detector.apk`，在 Android 14+ 设备上安装即可。

## 原理说明

角度计算公式：
```
angle = acos(|z| / √(x² + y² + z²))
```

- 手机水平时：z ≈ 9.8 m/s²，角度 ≈ 0°
- 手机竖直时：z ≈ 0，角度 ≈ 90°

## 构建

```bash
# 使用构建脚本
bash build_apk.sh
```

## 许可证

MIT License