HA Bridge

Appearance

连接中控设备 ​

把做好的仪表盘放到安卓手机、安卓平板、iPhone 或 iPad 上，日常直接查看和控制家里的设备。

推荐扫码连接，也可以在浏览器中手动输入配对码。 安卓使用 HA Bridge App；iPhone / iPad 使用 Chrome 或 Safari，添加到主屏幕后，像 App 一样从桌面全屏打开，面板功能与 App 相同。

使用前准备 ​

  • HA Bridge 已部署、激活，并连接 Home Assistant；
  • 仪表盘和控件已经编辑、绑定并保存；
  • 手机或平板能访问 HA Bridge 服务地址；
  • 按手机或平板的横竖屏方向，设置合适的仪表盘比例。

1. 在编辑器创建配对码 ​

  1. 打开要给中控使用的仪表盘，切换到「仪表盘」模式。
  2. 点击上方的「中控设备」。
  3. 填写设备名称，例如「客厅 iPad」，设置一个未使用的 6 位数字配对码，点击「添加」。

在仪表盘模式下打开中控设备设置

填写设备名称和固定 6 位配对码

配对码是固定的，不会随时间过期。建议每台设备创建一组独立配对码；同一码在另一台设备重新配对后，旧设备的凭证会失效。

2. 打开配对二维码 ​

在对应设备的配对码旁点击「扫码」。安卓 App 和苹果系统相机共用这一张二维码。

新版中控设备窗口中的扫码按钮

确认弹窗里的「手机可访问的连接地址」正确。手机与服务器在同一局域网时，可填写服务器的局域网 IP 和端口，例如 http://192.168.1.20:18080；远程使用时填写可访问的 HA Bridge 域名。

配对二维码和安卓 App 下载入口

地址怎么填

这里填写 HA Bridge 服务地址，不是 Home Assistant 地址。电脑的 localhost 或 127.0.0.1 不能给实体手机使用。截图中的地址、配对码与二维码均为示例，请扫描自己编辑器生成的二维码。

3. 安卓 App 扫码连接 ​

下载 HA Bridge 安卓 App（0.1.1 试用版，Android 7.0+）。扫码弹窗里也有同一下载入口，已安装旧版可直接覆盖安装。

  1. 在安卓手机或平板上下载安装 App。
  2. 打开 HA Bridge，点击「扫描二维码」，允许使用相机。
  3. 对准编辑器里的配对二维码，连接成功后自动进入面板。
HA Bridge 安卓 App 首页，点击扫描二维码开始配对
HA Bridge 安卓 App：点击「扫描二维码」即可连接。

以后打开 App 会自动恢复面板，正常使用无需重复扫码。

全屏时打开菜单 ​

使用安卓返回手势（从屏幕左侧或右侧边缘向内滑），或呼出系统导航栏后点「返回」，即可打开 HA Bridge 菜单。全屏播放视频时，先退出视频，再返回一次打开菜单。

配对失效后重新连接 ​

App 会记住原服务器地址，输入 6 位配对码并点击「连接」即可恢复，也可以重新扫码。菜单和连接失败页面都有「输入配对码重新连接」入口。服务地址改变时，请重新扫码。

安卓 App 重新连接页面，输入 6 位配对码连接，也可扫描二维码
配对失效后可直接输入配对码，不用再填写地址。

清除配对或更换仪表盘 ​

在菜单选择「重新扫码配对」，再确认「重新配对」，会清除此 App 保存的连接和登录状态，返回首次扫码页。编辑器中的配对码保持不变。 扫描目标仪表盘的二维码即可重新连接。

遇到「访问暂时受限」时，先检查 HA Bridge 授权或访问设置，再重试；App 会保留原配对信息。

4. iPhone / iPad 扫码连接 ​

扫码并连接 ​

  1. 用系统「相机」扫描编辑器中的二维码，点击识别出的链接。
  2. 在打开的页面点击「连接」，无需再输入地址或配对码。
  3. 面板打开后，会显示「添加到主屏幕」引导。
苹果浏览器识别二维码后显示连接 HA Bridge 页面
① 扫码后点击「连接」。
连接成功后的添加到主屏幕引导，说明 Chrome 和 Safari 均支持
② 按页面引导添加到主屏幕。

添加到主屏幕 ​

Chrome 和 Safari 都支持。 在当前浏览器中操作即可，下面的系统菜单截图以 Safari 为例：

  1. 打开浏览器的「分享」或「共享」菜单，入口也可能在「…」里。
  2. 选择「添加到主屏幕」；没看到时点「查看更多」或向下滚动。
  3. 名称保留 HA Bridge；如有「作为网页 App 打开」，保持开启，然后点击「添加」。
  4. 回到主屏幕，点击 HA Bridge 图标进入面板。
Safari 分享菜单中的添加到主屏幕选项
③ 分享菜单 → 添加到主屏幕。
系统添加页面显示 HA Bridge 图标和名称，作为网页 App 打开已开启
④ 确认名称，保持网页 App 开启，点击「添加」。

添加后从桌面图标全屏打开，面板功能与 App 相同。首次打开若提示配对，输入这台设备原来的 6 位配对码即可。不同系统和浏览器版本的菜单位置可能略有不同。

5. 备用方式：浏览器手动配对 ​

没有相机、暂时无法扫码，或从主屏幕打开后提示配对时，可以手动连接。这个入口在浏览器网页中。

  1. 在 Chrome、Safari 或其他浏览器中打开编辑器上方显示的「中控地址」，例如 http://192.168.1.20:18080/habridge/栖光。也可直接打开 http://192.168.1.20:18080/pair。
  2. 在配对页面输入管理员为这台设备设置的固定 6 位配对码。
  3. 点击「完成配对」，进入对应的仪表盘。

浏览器手动输入固定 6 位配对码并点击完成配对

完成后可继续按上面的步骤添加到主屏幕。无需重新创建一组配对码。

6. 管理设备与更新面板 ​

在编辑器的「中控设备」窗口中可以查看绑定状态、停用或重新启用配对码，以及删除配对关系。删除后需要重新创建配对码并连接。

修改布局、图片或控件时，回到编辑器操作并保存，再刷新设备上的面板。中控端只负责显示和控制，不显示编辑工具。

常见问题 ​

扫码后打不开页面 ​

先在手机浏览器中测试 HA Bridge 服务地址是否能打开，再检查地址、端口、网络和反向代理。手机不必与服务器在同一局域网，但必须能访问二维码中的地址。

App 识别不了二维码 ​

从本页下载最新的 HA Bridge 安卓 App，再扫描编辑器中「扫码」按钮生成的二维码。相机未获授权时，在系统设置中允许 App 使用相机。

配对码无效，或原来的设备不能用了 ​

检查 6 位数字是否正确、配对码是否被停用或删除，以及是否被另一台设备重新绑定。固定码没有倒计时；为每台设备分别创建配对码即可避免互相替换。

添加到主屏幕后又要求配对 ​

部分系统或浏览器环境需要在桌面入口里再配对一次。使用这台设备原来的固定码即可，不要另建临时码。

面板比例或内容不对 ​

检查仪表盘是否已保存、控件是否绑定实体，以及画布比例是否适合设备方向。摄像头播放和复杂 3D 的流畅程度还取决于设备、浏览器和视频格式。

让 Home Assistant 的日常使用更直观。

HA Bridge