- 先搞清楚原理:伴侣是怎么连上编辑器的
- 第 1 步:确认用的是哪个码
- 第 2 步:确认手机能上网
- 第 3 步:首次打开,把权限全给了
- 第 4 步:别让系统把伴侣「杀后台」
- 第 5 步:确认电脑端在线
- 第 6 步:码输对了还是没反应?重启两边重来
- 第 7 步:伴侣 App 本身打开就白屏/无反应
- 第 8 步:连上了但屏幕一直转圈、不同步
- 第 9 步:还不行?用这条路径兜底
- 常见问题
- 下一步
一句话结论:AI 伴侣连不上,九成出在三件事上——6 位码输错了或过期了、手机没联网(或被限制后台)、首次使用没给权限。按下面从第 1 步到第 10 步逐项排查,基本都能解决。特别说明一点:中文网的 AI 伴侣走中转服务器连接,手机和电脑不需要在同一个 WiFi——手机用流量也能连,这是很多人卡住却不自知的地方。
先搞清楚原理:伴侣是怎么连上编辑器的
AI 伴侣(Companion)是装在手机上的一个 App,作用是让你在电脑网页里拖积木,手机上立刻看到效果,不用每次都编译安装。
连接过程是这样的:
- 电脑网页上点「连接 → AI 伴侣」,会显示一个二维码和 6 位码;
- 手机打开 AI 伴侣 App,输入这 6 位码(或扫码);
- 伴侣 App 通过我们的中转服务器找到你电脑上的编辑器会话,建立连接(底层走 WebRTC)。
因为走的是中转服务器,只要手机能上网(WiFi 或流量都行),就能连上编辑器。电脑那边也必须能上网,且浏览器标签页不能关。
实测环境:Windows 10 + Chrome 浏览器;手机端华为 Mate 40(HarmonyOS 4)、Redmi K50(MIUI 14)、iPhone 13 均实测通过。手机未与电脑同一网络、直接用 4G/5G 流量连接成功。
机房版 / 离线版用户先看这里: 这两版的 AI 伴侣通讯已经纯本地化——编辑器和伴侣在同一局域网里直接通信,不访问任何外部服务器,没有外网也能连。排查思路和在线版不同:
- 第 2 步「手机能上网」改为「手机和电脑在同一局域网」(都连机房的路由器/WiFi 即可,该网络不需要通外网);
- 第 5 步「中转服务器」相关的检查可以跳过,改为查电脑防火墙有没有拦本地端口、两台设备是不是同一网段;
- 权限(第 3 步)、杀后台(第 4 步)、干净重连(第 6 步)这些步骤两版通用;
- 机房上课更省事的选择是编辑器自带的模拟器:不用装伴侣、不用配对,教学演示优先用它,真机留给需要传感器、摄像头、扫码的环节。
第 1 步:确认用的是哪个码
新手最容易犯的错:码输对了,但码不是当前这个会话的。
- 6 位码每次点「连接 → AI 伴侣」都可能变化,关掉弹窗再打开,码就换新的了;
- 输码前,先在电脑网页上点一次「连接 → AI 伴侣」,让弹窗保持打开状态,再用手机输这个弹窗里显示的码;
- 不要用昨天、上周记下来的旧码,旧码一定连不上。
第 2 步:确认手机能上网
打开手机的浏览器,随便开一个网页试试。如果网页都打不开,伴侣肯定连不上。
- 学校机房常见坑:电脑在机房内网里,手机连的 WiFi 需要网页认证(弹出一个登录页那种),没认证就上不了网;
- 用流量的同学注意:个别流量套餐对非浏览器 App 限速或限制,换个 WiFi 再试一次。
再强调一次:手机和电脑不需要同一个 WiFi。手机开流量、电脑连校园网,照样能连。
第 3 步:首次打开,把权限全给了
Android 6.0 以上,权限要在运行时弹窗里同意。第一次打开伴侣 App,通常会依次弹出:
- 相机权限(扫码用)——选「允许」;
- 存储/文件权限(加载素材用)——选「允许」;
- 通知权限——建议允许,连接状态会提示。
如果当时手快点成「拒绝」了,去手机设置里补:
- 华为/荣耀:设置 → 应用和服务 → 应用管理 → AI 伴侣 → 权限,全部改为允许;
- 小米/Redmi:设置 → 应用设置 → 应用管理 → AI 伴侣 → 权限管理;
- OPPO/vivo:设置 → 应用 → 权限管理,找到 AI 伴侣逐项打开。
第 4 步:别让系统把伴侣「杀后台」
国产手机的后台管理比较激进,伴侣切到后台几秒就被杀掉,是「点了连接没反应」的高发原因。
- 小米:设置 → 应用设置 → 应用管理 → AI 伴侣 → 省电策略 → 改为「无限制」;最近任务里长按伴侣卡片,点锁图标锁定;
- 华为:设置 → 应用 → 应用启动管理 → AI 伴侣 → 关闭「自动管理」,允许自启动、关联启动、后台活动;
- OPPO/vivo:在最近任务里下拉伴侣卡片出现锁,或在电池设置里允许后台运行。
调试期间尽量让伴侣停留在前台,屏幕别锁。
第 5 步:确认电脑端在线
中转服务器要同时找到你的手机和电脑。电脑端注意:
- 浏览器标签页别关、别最小化到任务栏后长时间休眠;
- 电脑别开着断了网的休眠状态;
- 个别公司/学校网络会拦截 WebRTC 或长连接,换手机热点给电脑用,是最快的验证方法——电脑连手机热点后能连上,就说明是电脑那边网络的限制,不是你的操作问题。
第 6 步:码输对了还是没反应?重启两边重来
按这个顺序做一遍「干净重连」:
- 手机上把 AI 伴侣彻底划掉(不是退到后台);
- 电脑网页上点「断开连接」(或直接刷新页面);
- 电脑重新点「连接 → AI 伴侣」,拿到新的 6 位码;
- 手机重新打开伴侣,立刻输入新码,点连接。
大多数「莫名其妙连不上」在这一步就解决了。
第 7 步:伴侣 App 本身打开就白屏/无反应
如果你说的是伴侣 App 一打开就没反应、界面空白(还没到输码那一步),通常是这几个原因:
- 安装包不完整:卸载后重新下载安装一遍;
- 手机系统太老:Android 7 以下可能有兼容问题,换台新一点的手机;
- 安装时被手机管家拦截:小米/华为安装时提示「风险应用」的,选「仍要安装」;
- 用错包:iOS 手机装了安卓包、或者装了别的平台的伴侣,一定要用官网上对应系统的安装包。
装好后先单独打开伴侣 App,能正常显示输码界面,再进行连接。
第 8 步:连上了但屏幕一直转圈、不同步
这属于「半连接」状态,试试:
- 手机和电脑各自刷新:电脑刷新页面重新生成码,手机重新输码;
- 网络切一次:手机 WiFi 和流量来回切一下,触发重连;
- 检查电脑是否开了 VPN 或代理,关掉再试。
第 9 步:还不行?用这条路径兜底
如果以上都试过还不行,可以暂时绕开伴侣,验证项目本身没问题:
- 直接「编译」生成 APK,用微信/QQ/数据线传到手机上安装运行。慢一点,但能确认积木逻辑是对的;
- 鸿蒙手机(HarmonyOS NEXT)用户注意:安卓 APK 装不了,要用我们提供的鸿蒙 HAP 编译和鸿蒙版 AI 伴侣,步骤见官网鸿蒙专区。
常见问题
Q:必须和电脑连同一个 WiFi 吗? 在线版(fun123.cn)不需要:走中转服务器连接,手机用流量也能连,这是和很多其他平台不一样的地方。机房版/离线版则是纯本地通信:只要手机和电脑在同一个局域网就行,完全不需要外网。
Q:6 位码和二维码扫哪个方便? 都行。二维码更省事,但需要先给相机权限;扫不了码就手动输码。
Q:输码界面一直「连接中」最后超时? 按第 5、6 步处理:电脑网络换个环境(手机热点)验证,再做一次干净重连。
Q:连接成功了,改积木手机上没变化? 点一下手机伴侣 App 把它带到前台,屏幕会自动刷新到最新状态。
下一步
伴侣连上之后,建议做一个最小测试:拖一个按钮和一个标签,给按钮写「点击后改标签文字」的积木,点一下手机上的按钮,看到文字变了,整条链路就是通的。如果遇到组件和积木的具体问题,可以先查组件中文文档,里面每个组件的属性、事件、方法都有中文说明。
本文由 App Inventor 2 中文网整理,实测环境为 Windows 10 / Chrome,多款国产手机实测通过。如有新的报错情况,欢迎反馈补充。
扫码添加客服咨询