蜂控设备在线却没画面?用故障检测看清卡在哪一层
在蜂控设备墙右键设备,进入“调试与日志 → 故障检测”,可以按设备通道、accSys、访问路径、服务连接和实际取图逐层定位;共享设备还会继续检查公共平台、RTC 与分享端设备。
设备在蜂控里显示在线,却一直等待首帧、串流打不开或只能看不能控制时,先运行一次“故障检测”。 它适合使用 USB、Wi-Fi ADB、ACC、Runner 19013 或设备分享的用户。入口在设备墙:右键目标设备,打开“调试与日志”,选择“故障检测”。
这项检测不会重启手机、重启 accSys,也不会修改设备配置。它会沿着蜂控当前实际使用的连接路径逐项读取状态,比只看一个“在线”圆点更容易判断问题发生在哪一层。
为什么“在线”不等于“画面可用”
一台设备能出现在设备墙,通常只说明蜂控已经识别到它,或者仍保留着设备记录。完整画面还要经过几步:电脑能否到达设备、accSys 是否可用、19012 访问路径是否畅通、服务协议是否能回应、设备能否真正生成一张图片。
USB 设备尤其容易让人误判。Android 官方说明,adb devices 中的 device 状态只代表设备已连接到 ADB Server,并不保证 Android 已经完全启动并可正常工作;offline 则代表未连接或没有响应。查看 Android ADB 状态说明
所以,蜂控不会把“ADB 在线”直接当作“屏幕正常”。故障检测会继续验证后面的实际链路。
检测结果应该怎么看
检测窗口会显示总结果、耗时和每一项状态。界面只保留容易阅读的摘要,重点看下面几层。
1. 设备通道
这一项回答“蜂控能不能到达设备”。
- USB: 检查 USB ADB 是否在线并已授权。
- Wi-Fi ADB: 实际发送一条轻量命令,确认网络 ADB 不只是被扫描到,而是真的能执行。
- Runner 19013: 检查定制系统提供的 Runner 服务及命令接口。
- ACC 直连: 设备已有 accSys 19012 服务时,不要求额外的 ADB 通道。
如果这里失败,先处理数据线、USB 调试授权、Wi-Fi 网络或 Runner 服务。后面的 accSys 与画面检测可能会被跳过,因为上游通道还没有建立。
2. 运行环境与 accSys 进程
对于需要蜂控部署 accSys 的设备,系统会检查设备运行环境以及 accSys 进程。纯 ACC 直连没有 ADB 或 Runner 进程查询通道时,这一项显示“跳过”是正常的,服务是否可用会由后面的协议检测确认。
某些定制 ROM 可能隐藏进程名,导致进程查询没有返回常规结果。蜂控会把协议握手和实际取图作为更强的证据:如果 19012 通信和取图都正常,不会仅凭进程名查不到就把设备判成故障。
3. 19012 访问路径
这一项回答“电脑通过什么路径访问 accSys”。不同接入方式走的路径不同:
- USB: 检查本机到设备 19012 的 ADB 转发隧道;已有转发不可达时,会重新建立一次再验证。Android 官方文档也把
adb forward定义为从电脑端口到设备端口的转发机制。查看 ADB 端口转发说明 - Wi-Fi ADB: 优先检查设备局域网 IP 的 19012 直连;协议层还可以识别 Wi-Fi ADB 设备通道。
- Runner 19013: Runner 用于探测、部署和拉起 accSys,画面服务仍通过 19012 验证。
- ACC: 直接检查设备已有的 19012 服务。
如果设备通道正常而访问路径失败,问题通常已经缩小到端口、转发或 accSys 监听状态,而不是整台手机离线。
4. accSys 连接
端口能连通,还要确认 accSys 协议能握手并回应。蜂控会建立与设备一致的服务连接并执行 Ping,显示这次协议往返耗时。
这里正常,说明控制服务已经能通信;它并不等于取图一定成功,所以检测还会继续到最后一层。
5. 实际取图
最后,蜂控会请求一张 256 像素宽的 JPEG 诊断图,并在成功时显示预览。这是判断“设备在线但为什么没画面”的关键一步。
- 成功: 屏幕墙取图链路可用,报告会说明拿到的是新图还是最近有效帧。
- 提醒:设备息屏: accSys 连接仍然正常,只是当前无法生成图片。屏幕墙会通过现有控制通道尝试唤醒并立即重取,不需要先重启 accSys。
- 提醒:截图繁忙: 服务和端口仍活着,屏幕墙会保留最后有效帧并短间隔重试。此时不要把它误判成 USB 隧道断开。
- 异常: 协议正常但持续拿不到有效图片,才需要结合详细报告继续检查设备端截图能力。
如果故障只在某一台设备出现,可以先点“重新检测”,并观察亮屏后实际取图是否恢复。若多台设备同时在同一层失败,再检查共同的电脑网络、ADB 或分享通道。
分享设备为什么会多几项检测
共享设备不在接收方电脑旁边,蜂控会先检查公共平台连接和分享方在线状态,再检查 WebRTC 点对点连接、RPC、实时控制、屏幕墙和视频数据通道。RPC 通道可用后,检测还会让分享方电脑对真实设备执行同一套底层检查,并把结果带回来。
WebRTC 官方文档说明,两个端需要通过信令交换连接信息,再利用 ICE、STUN 或 TURN 建立可用路径。了解 WebRTC 建连过程 因此“公共平台已连接”只说明信令入口在线,不等于视频和控制数据通道都已经打开。
常见判断方式是:
- 分享方未上线: 先让提供设备的那台蜂控保持登录和联网。
- 点对点连接失败: 查看报告里的 signaling、ICE、TURN 与 DataChannel 状态。
- 视频能看但不能控制: 重点核对控制权限和实时控制数据通道。
- RTC 已连接但分享端设备检测失败: 问题已经在分享方设备侧,可继续看报告中的“分享端”各项结果。
完整的分享使用方式可查看蜂控设备分享指南。
什么时候应该复制详细报告
检测窗口只展示简短结论;点击“复制详细报告”会带上每一步的技术明细、连接类型、耗时、近期 accSys 生命周期记录和设备运行日志。预览图片数据会被省略,认证令牌、密码与常见密钥字段会自动脱敏。
向支持人员求助时,建议同时提供:
- 完整复制的故障检测报告;
- 发生问题的大致时间;
- 蜂控中的设备编号和连接方式;
- 当时是屏幕墙没图、串流失败、不能控制,还是某个操作失败;
- 问题是否会在亮屏、重新检测或重新接线后变化。
不要只截一张“15 秒后重试”的图片,也不要发送密码、分享码或仍在使用的 API Key。详细报告能让支持人员判断是设备通道、accSys、取图还是 RTC,而不是再让你从头重复一遍所有操作。
一套更省时间的排查顺序
- 在设备墙右键目标设备,运行“调试与日志 → 故障检测”。
- 找到第一项“异常”或“提醒”,不要只看最后的总结果。
- 设备通道失败,先处理连接;19012 路径失败,处理端口或隧道;协议正常但取图提醒,先亮屏并重新检测。
- 分享设备按“公共平台 → 分享方在线 → WebRTC 数据通道 → 分享端设备”顺序看。
- 仍未恢复时复制详细报告,再联系支持。
第一次接入设备时,可先看USB、Wi-Fi、ACC 与分享设备怎么选;如果连接正常而失败发生在自动化步骤,再转到蜂控自动化失败排查。这样可以把“设备连接问题”和“业务流程问题”分开,不必反复重启所有组件。