连接前的状态盘点

在助手发起连接之前,先确认四个前提都已就位。任何一条没满足,电视上的对话框都不会出现,你只会看到助手那头报超时。

前提 怎么确认 没做到怎么办
开发者选项已开启 电视"设置→关于"连按 Build 七次后出现 回到第 2 章 ct-0202 操作
无线调试已打开 开发者选项里"无线调试"开关为开 打开它,记下页面显示的状态
电脑电视同一 Wi-Fi 两者连的是同一路由器 换个网络再试
IP 与端口无误 示例地址 192.168.1.50,端口通常 5555 按 ct-0302 的方法重新核对

四条全绿,才让助手发起连接。顺序很重要:先自查,再连接,别让助手在错误的地基上盖楼。

两种确认对话框

无线调试的首次连接,安全机制要求"人"在电视上亲自点头。根据电视系统版本与配对方式的不同,你会遇到一种或两种对话框:

  1. 配对对话框。部分系统版本下,首次使用需要先在无线调试菜单里完成设备配对:电视显示一组配对码,助手那头发起配对,由你在电视上确认"是这台电脑吗"。
  2. 授权对话框。配对完成后,电脑发起调试连接,电视弹出"允许此计算机进行调试吗"之类的询问。这一下点是必须的——它是整个流程里唯一由你亲手授权的时刻,也是项目安全承诺的落点:未经你点头,谁也改不了你的电视。

无论遇到哪种对话框,处理原则都一样:对话框出现在电视上,就必须由你拿遥控器确认。助手在电脑这头按部就班地等,你在沙发那头按 OK。两边配合,连接才建立得起来。

操作步骤:从助手发起到连接建立

下面是把助手指令与人工确认交叉在一起的完整步骤。每步后面都附了"预期看到什么",照着核对即可。

  1. 让助手发起连接。典型命令形态是 python3 tools/tv.py --ip 192.168.1.50 shell(你的实际 IP 以 ct-0302 填的为准;端口若不是默认的 5555,按工具 --help 的说明指定)。预期:助手回复"正在连接",同时电视屏幕亮起。
  2. 盯住电视屏幕。预期:几秒内弹出配对或授权对话框,显示一串配对码或"允许调试"字样。
  3. 用遥控器把焦点移到"允许""确定""配对"上,按 OK。预期:对话框消失,电视可能短暂黑屏一下,随后回到原画面。
  4. 回到电脑看助手反馈。预期:助手报告连接成功,并给出电视的基本信息(型号、系统版本等),说明它已经能通过 ADB 与电视对话了。
  5. 若第 2 步的对话框迟迟不出现,不要反复点助手那里的"重试"。先按下文的排查表过一遍,多半是某个前提没满足。
flowchart TD
    A[助手发起连接] --> B[电视弹出配对或授权对话框]
    B --> C{你按 OK 确认?}
    C -->|是| D[连接建立]
    C -->|否或超时| E[连接失败]
    E --> F[按排查表检查]
    F --> A
    D --> G[助手回报电视信息]

每一步的确认点

步骤 预期看到什么 没看到怎么办
发起连接 助手显示正在连接 检查命令里的 IP 是否填对
电视端 弹出配对/授权对话框 查排查表
按 OK 后 对话框消失,画面恢复 检查是否选错了按钮("取消"会直接断)
助手端 连接成功,回报电视信息 授权可能超时,让助手重发一次
首次命令执行 有正常的回显输出 见下文排障

失败排查表

现象 最可能的原因 处理
电视毫无反应 IP 填错;电视不在线;两者不在同一网段 核对 IP 与 Wi-Fi,ping 一下电视更稳
报端口连不上 端口不是 5555,或无线调试没开 以电视无线调试页面显示为准,用工具参数指定端口
对话框出现过又消失 授权超时 让助手重新发起,这次守在电视旁
显示已授权但仍断开 电视休眠或系统杀掉了调试服务 唤醒电视重试;必要时关掉电视的休眠策略
换了电脑连不上 新电脑需要重新授权 在新电脑上重走一次配对授权
助手在沙箱里连不上 沙箱够不到你的局域网 用 relay.py 做端口转发,见 ct-0404

有一条经验值得记住:授权对话框是有时效的。它不会一直在屏幕上等你,弹出来就去点,别让它晾着。

授权之后:连接进入了什么状态

连接建立后,电视就把这台电脑加进了"已授权的调试设备"名单。这意味着:只要电视开着无线调试、电脑在同一个网络里,双方就能再次握手,一般不再需要重新确认。方便是方便,但也意味着授权是一项需要归还的权限——流程结束后要记得撤销,本篇末尾会讲。

同时请理解这个授权的边界:它只允许通过 ADB 执行电视开放给机主的操作,比如项目使用的 pm disable-user(等同于设置→应用→停用)。它不授予 Root 权限,不能刷机,也不能绕过任何 DRM。授权不是把电视交出去,只是借出一扇有围栏的门。

安全提醒:授权要记得还

走完全部流程、测试收尾之后,有两件收尾动作与连接直接相关,本书在 ct-0305 会详细展开,这里先埋个伏笔:

  1. 关闭电视的无线调试开关,从根上断掉 ADB 通道。
  2. 如果电视提供"已授权设备"管理入口,把当前电脑从中撤销,让这次授权彻底失效。

养成"借了要还"的习惯,你的电视在下次需要精简之前,都处于一个干净、封闭的状态。

常见问题

问:电视上一直不弹对话框,助手反复超时,哪儿错了?

答:按顺序查四项前提:无线调试真的开了吗?IP 抄对了吗?电脑电视在同一 Wi-Fi 吗?端口是 5555 吗?九成的"不弹窗"都是这四项之一出了问题。

问:对话框弹出来了,手一抖按了"取消",怎么办?

答:没关系,授权没建立而已。让助手重新发起连接,电视会再次询问,这次稳稳地按 OK。

问:这次授权了,下次重启电视还要再点吗?

答:多数情况下电视会记住已授权的电脑,重启后重连不需要再次确认;但如果电视系统升级或清理了授权列表,可能要重新走一遍。遇到时按本篇步骤再来一次即可。

小结

连接授权是整个流程里唯一"非点不可"的人工动作:助手负责把请求送到,你负责在电视上点头。记住三件事——发起前先自查四项前提、对话框弹出手要快、授权是借出去的权限用完要还。连接打通后,下一篇 ct-0304 我们面对真正需要动脑子的环节:禁用清单的生成与人工把关。