234 lines
5.0 KiB
Markdown
234 lines
5.0 KiB
Markdown
# 快速开始指南 - SkyLink Android App
|
||
|
||
## 🎯 5 分钟快速上手
|
||
|
||
### 1️⃣ 打开项目
|
||
|
||
```powershell
|
||
# 在 Windows PowerShell 中
|
||
cd d:\code\skyLink\skylink_android_app
|
||
# 然后用 Android Studio 打开此目录
|
||
```
|
||
|
||
### 2️⃣ 同步依赖
|
||
|
||
打开 Android Studio 后，点击：
|
||
- `File` -> `Sync Now` 或按 `Ctrl + Shift + O`
|
||
|
||
等待 Gradle 下载依赖（首次可能需要 2-5 分钟）
|
||
|
||
### 3️⃣ 连接设备
|
||
|
||
选择以下任一方式：
|
||
- **选项 A**: 连接 Android 手机（需启用 USB 调试）
|
||
- **选项 B**: 启动 Android 模拟器
|
||
|
||
### 4️⃣ 运行应用
|
||
|
||
点击工具栏的 ▶️ (Run) 按钮，或按 `Shift + F10`
|
||
|
||
### 5️⃣ 测试功能
|
||
|
||
应用启动后，您会看到：
|
||
|
||
**首页标签页 🏠**
|
||
- 视频显示区（黑色背景，等待视频流）
|
||
- GPS 信息显示
|
||
- 统计信息（FPS、速度、丢包率）
|
||
- 保存帧和录制按钮
|
||
|
||
**设置标签页 ⚙️**
|
||
- UDP 端口配置
|
||
- Ping 诊断工具
|
||
- 输入主机地址（例：8.8.8.8）
|
||
- 选择 Ping 参数
|
||
- 点击 🎯 单个 Ping 或 📊 多个 Ping
|
||
|
||
---
|
||
|
||
## 🎮 功能演示
|
||
|
||
### 测试 Ping 功能
|
||
|
||
#### 场景 1：Ping 谷歌 DNS
|
||
|
||
1. 点击底部 "⚙️ 设置" 标签页
|
||
2. 在 "目标主机" 框输入：`8.8.8.8`
|
||
3. 点击 "🎯 单个 Ping" 按钮
|
||
4. 等待结果显示（通常 1-5 秒）
|
||
|
||
**预期结果：**
|
||
```
|
||
✅ Ping 成功!
|
||
主机: 8.8.8.8
|
||
最小延迟: 20 ms
|
||
最大延迟: 50 ms
|
||
平均延迟: 35 ms
|
||
丢包率: 0.0%
|
||
```
|
||
|
||
#### 场景 2：并行诊断常见主机
|
||
|
||
1. 在设置页面点击 "📊 多个 Ping" 按钮
|
||
2. 系统将自动 Ping：
|
||
- 8.8.8.8 (谷歌 DNS)
|
||
- 1.1.1.1 (Cloudflare DNS)
|
||
- 114.114.114.114 (国内 DNS)
|
||
- 192.168.1.1 (本地网关)
|
||
|
||
**预期结果：** 并行显示所有主机的连接状态
|
||
|
||
---
|
||
|
||
## 📱 页面导航
|
||
|
||
### 底部导航栏
|
||
|
||
```
|
||
┌─────────────────────────────┐
|
||
│ [🏠 首页] [⚙️ 设置] │ ← 点击切换
|
||
└─────────────────────────────┘
|
||
```
|
||
|
||
### 返回导航
|
||
|
||
- 顶部左上角：返回上一页面（如果可用）
|
||
- Android 返回键：返回上一个 Fragment
|
||
|
||
---
|
||
|
||
## 🔧 常见配置
|
||
|
||
### 修改 UDP 监听端口
|
||
|
||
**当前默认**: 9999
|
||
|
||
在设置页面修改：
|
||
1. 点击 "⚙️ 设置" 标签页
|
||
2. 修改 "UDP 接收端口" 字段
|
||
3. 设置将自动保存
|
||
|
||
### 调整 Ping 参数
|
||
|
||
- **Ping 次数**: 1、2、4、8、16 可选
|
||
- **超时时间**: 1秒、3秒、5秒、10秒 可选
|
||
|
||
更长的超时时间适合网络较差的环境。
|
||
|
||
---
|
||
|
||
## 📊 首页数据说明
|
||
|
||
| 项目 | 说明 | 示例 |
|
||
|------|------|------|
|
||
| **FPS** | 视频帧率 | 30 fps |
|
||
| **Speed** | 接收速度 | 5000 KB/s |
|
||
| **Packet Loss** | 丢包率 | 0.5% |
|
||
| **Latitude** | 纬度 | 39.904030° |
|
||
| **Longitude** | 经度 | 116.407526° |
|
||
| **Altitude** | 高度 | 50.0 m |
|
||
|
||
---
|
||
|
||
## ⚠️ 故障排查
|
||
|
||
### 应用闪退
|
||
|
||
**解决方案：**
|
||
1. 检查 Android Studio 中的错误日志
|
||
2. 试试重新构建项目
|
||
3. 查看 Build 输出窗口
|
||
|
||
### Ping 无法工作
|
||
|
||
**检查清单：**
|
||
- [ ] 设备已连接网络？
|
||
- [ ] 输入的主机地址正确？
|
||
- [ ] 目标主机可达？（试试 8.8.8.8）
|
||
- [ ] 网络权限已授予？
|
||
|
||
### 导航栏不显示
|
||
|
||
**解决方案：**
|
||
1. 重新启动应用
|
||
2. 清理项目：`Build` -> `Clean Project`
|
||
3. 重新构建并运行
|
||
|
||
---
|
||
|
||
## 📚 进阶使用
|
||
|
||
### 在 Android 代码中使用 Ping
|
||
|
||
```kotlin
|
||
// 在 Fragment 或 Activity 中
|
||
lifecycleScope.launch {
|
||
val result = PingUtil.ping(
|
||
host = "8.8.8.8",
|
||
count = 4,
|
||
timeout = 5
|
||
)
|
||
|
||
if (result.isSuccess) {
|
||
println("✅ 连接成功，延迟: ${result.avgTime} ms")
|
||
} else {
|
||
println("❌ 连接失败: ${result.errorMessage}")
|
||
}
|
||
}
|
||
```
|
||
|
||
### 并行 Ping 多个主机
|
||
|
||
```kotlin
|
||
val hosts = listOf("8.8.8.8", "1.1.1.1", "114.114.114.114")
|
||
val results = PingUtil.pingMultipleParallel(hosts, count = 4, timeout = 5)
|
||
|
||
results.forEach { result ->
|
||
if (result.isSuccess) {
|
||
println("${result.host}: ${result.avgTime} ms")
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 🎓 学习资源
|
||
|
||
- 📖 [Android Fragments 文档](https://developer.android.com/guide/fragments)
|
||
- 📖 [Android Navigation 文档](https://developer.android.com/guide/navigation)
|
||
- 📖 [Kotlin Coroutines 指南](https://kotlinlang.org/docs/coroutines-overview.html)
|
||
|
||
---
|
||
|
||
## ❓ 常见问题
|
||
|
||
**Q: 应用启动后黑屏？**
|
||
A: 这是正常的！首页等待 UDP 视频流数据。确保有设备在发送数据到 UDP 端口 9999。
|
||
|
||
**Q: 如何修改 UDP 端口？**
|
||
A: 在设置页面修改 "UDP 接收端口" 字段，然后重启应用。
|
||
|
||
**Q: Ping 时间很长？**
|
||
A: 这可能是网络延迟或目标主机不可达。试试 Ping 谷歌 DNS (8.8.8.8)。
|
||
|
||
**Q: 如何保存数据？**
|
||
A: 首页的 "💾 保存帧" 按钮可保存当前视频帧。
|
||
|
||
---
|
||
|
||
## 📞 获取帮助
|
||
|
||
遇到问题？试试以下步骤：
|
||
|
||
1. 查看应用的 logcat 输出
|
||
2. 检查网络连接
|
||
3. 清理项目并重新构建
|
||
4. 重启 Android Studio
|
||
|
||
---
|
||
|
||
**祝您使用愉快！🚀**
|
||
|
||
最后更新: 2026-01-19
|
||
版本: 1.1.0
|