Files
AndroidDeviceStreaming/client/README.md
T

27 lines
1.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# ads-client(Rust 本地连接守护程序)
入口:`src/main.rs`。根目录构建:`cargo build -p ads-client --release --locked`。
```powershell
$env:ADS_CLIENT_TOKEN = '<本地端令牌>'
.\ads-client.exe --server wss://devices.example.com --device home-phone
```
默认监听 `127.0.0.1:15555`,取得独占设备租约后自动调用本地 ADB 连接;本地普通 `adb devices` 将列出该地址。每 5 秒尝试恢复 ADB 连接。首次调试仍需在手机上授权本地电脑的密钥。
- `--listen 127.0.0.1:15556`:修改端口,仅允许回环地址。
- `--adb <完整路径>`:指定 ADB 可执行文件。
- `--no-auto-connect`:仅提供转发入口,由用户手动 `adb connect`。
- Ctrl+C 释放租约,并在启用自动连接时执行该端点的 `adb disconnect`。
使用本地 ADB 的正常通道,可配合 Android Studio 和 `scrcpy -s 127.0.0.1:15555`。不要将 `ADB_SERVER_SOCKET` 指向远程服务,否则其他终端可能查询到另一台 ADB Server。
- `--transport auto`(默认):WebRTC P2P 优先,超时后按控制中心节点顺序回退。
- `--transport relay`:跳过 P2P,仍自动选择健康中继并在建立失败时尝试下一节点。
- `--p2p-public-only`:诊断选项,只交换 STUN 公网候选地址,用于排除 LAN/VPN 直连。
- `--status-file <JSON路径>`:输出当前 p2p/relay/mixed/negotiating/idle、通道数和节点 ID,供桌面展示。
节点断线会中断现有 TCP 流;本地 ADB 在重试后创建新通道,重新选择路线,不支持将原 TCP 流无缝迁移。旧中心或旧 agent 会协商回 v1 模式。
可选 `--lease-status-file <路径>` 输出 true/false,供虚拟 USB 启动器等待租约,不包含票据。USB 模式需加 `--no-auto-connect`,由 ads-usb 使用本地原始 adbd 端点,不能把 USB/IP 接到 5037。见 docs/windows-usb.md。