flowzl/flyLink

Fork 0

Files

flowerstonezl 056289625c init

2026-01-19 17:08:49 +08:00

5.0 KiB

Raw Blame History

快速开始指南 - SkyLink Android App

🎯 5 分钟快速上手

1️⃣ 打开项目

# 在 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

点击底部 "⚙️ 设置" 标签页
在 "目标主机" 框输入：8.8.8.8
点击 "🎯 单个 Ping" 按钮
等待结果显示（通常 1-5 秒）

预期结果：

✅ Ping 成功!
主机: 8.8.8.8
最小延迟: 20 ms
最大延迟: 50 ms
平均延迟: 35 ms
丢包率: 0.0%

场景 2：并行诊断常见主机

在设置页面点击 "📊 多个 Ping" 按钮
系统将自动 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

在设置页面修改：

点击 "⚙️ 设置" 标签页
修改 "UDP 接收端口" 字段
设置将自动保存

调整 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

⚠️ 故障排查

应用闪退

解决方案：

检查 Android Studio 中的错误日志
试试重新构建项目
查看 Build 输出窗口

Ping 无法工作

检查清单：

设备已连接网络？
输入的主机地址正确？
目标主机可达？（试试 8.8.8.8）
网络权限已授予？

导航栏不显示

解决方案：

重新启动应用
清理项目：Build -> Clean Project
重新构建并运行

📚 进阶使用

在 Android 代码中使用 Ping

// 在 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 多个主机

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")
    }
}

🎓 学习资源

❓ 常见问题

Q: 应用启动后黑屏？ A: 这是正常的！首页等待 UDP 视频流数据。确保有设备在发送数据到 UDP 端口 9999。

Q: 如何修改 UDP 端口？ A: 在设置页面修改 "UDP 接收端口" 字段，然后重启应用。

Q: Ping 时间很长？ A: 这可能是网络延迟或目标主机不可达。试试 Ping 谷歌 DNS (8.8.8.8)。

Q: 如何保存数据？ A: 首页的 "💾 保存帧" 按钮可保存当前视频帧。

📞 获取帮助

遇到问题？试试以下步骤：

查看应用的 logcat 输出
检查网络连接
清理项目并重新构建
重启 Android Studio

祝您使用愉快！🚀

最后更新: 2026-01-19
版本: 1.1.0

5.0 KiB Raw Blame History Unescape Escape