AirConsole游戏测试时手机无法作为控制器连接模拟器问题问询

该问题的常见诱因可分为以下几类： #

• 移动端浏览器权限与平台限制：AirConsole官方对网页版控制器的支持有严格的环境校验，安卓Chrome如果未授予通知权限、后台活动权限，或者自带的跟踪保护、广告拦截功能阻断了平台的心跳请求，就会被判定为不符合运行要求，平台会主动锁死输入框，连接超时后弹出引导下载App的提示。
• 模拟器网络可达性异常：虽然你的游戏文件托管在公网可访问的Web服务器上，但AirConsole模拟器默认监听本地私有端口，需要你的手机和运行模拟器的设备处于同一局域网段，且模拟器已经做好端口映射配置。如果移动端无法和模拟器建立稳定的WebSocket连接，30秒无响应后就会触发连接失败逻辑，跳转引导App下载。
• 开发者模式配置缺失：本地测试的自托管AirConsole游戏，需要提前在模拟器端的开发者设置中开启「允许网页端控制器连接」选项，默认测试环境会强制要求移动端使用官方App连接，仅正式上线到AirConsole平台的游戏才会开放网页端控制器的无限制访问权限。
• 浏览器兼容性问题：部分安卓Chrome版本对AirConsole控制器的输入框焦点捕获逻辑支持有缺陷，跳转至代码输入页后输入框无法正常获取焦点，导致无法输入内容，连续多次输入检测无响应后，平台也会判定网页端连接失效，触发App下载提示。

可按以下优先级快速排查： #

1. 确认手机和运行模拟器的设备连接至同一WiFi，没有开启VPN、代理类工具
2. 检查模拟器开发者设置中是否开启了网页端控制器支持开关
3. 临时关闭安卓Chrome的广告拦截、跟踪保护功能，授予AirConsole页面通知权限后重试

内容的提问来源于stack exchange，提问作者Patrick Langkau