完成第一次遥控操作

将 Tactra 连接到 Home Assistant,尝试一个控制项,再将房间设备保存为媒体配置。请从 iPhone、iPad 或 Mac 开始。Apple Watch 用户请参阅配对 iPhone 指南

1. 检查连接与设备

在同一台 Apple 设备的浏览器中打开 Home Assistant 地址。确认您能够登录,并控制要使用的音箱、电视或功放。尝试一个具体操作,例如调整音量或暂停播放。

如果操作在 Home Assistant 中失败,请先解决集成或设备连接问题。关于媒体控制与电视导航的区别,请检查兼容性

2. 从 Tactra 登录

打开 Tactra,选择发现的 Home Assistant 服务器,或输入您在浏览器中使用的地址。连接家庭网络内的服务器时,请允许访问本地网络。继续前往 Home Assistant 登录页面,使用您的 Home Assistant 账户登录。

Home Assistant 可能会将 https://tactra.dev 显示为 App 身份标识。您输入的服务器仍然是受控服务器。登录后返回 Tactra,等待设备出现。

如果您明确选择使用长期访问令牌,而不是 App 登录,请打开 高级设置 → 访问令牌。请妥善保管令牌,支持人员从不需要这些令牌。

3. 测试音频控制

打开 控制,在 音频目标 中选择音箱或功放,然后小幅调整音量。确认正确设备的音量发生变化。旋钮需要绝对音量支持;功能较少的设备会显示较少的控制项。

控制界面中,音频目标选择位于播放控制和音量旋钮上方
调整音量前,先选择实际发声的设备。截屏为英文界面。

4. 将房间保存为媒体配置

打开 设置 → 媒体系统 → 添加系统。为配置起一个容易识别的名称。分配显示设备、导航设备、音频设备和播放设备。同一设备可以承担多个角色。

保存并选择该配置,分别测试导航、音量和播放。如果 Apple TV 负责导航,而功放负责音频,请参阅电视与功放分步指南

如果没有响应

  • 找不到服务器: 手动输入地址,并检查本地网络权限。设备发现和可访问性是不同的检查。
  • 没有显示设备: 确认选中了正确的 Home Assistant 实例,且媒体实体可用。
  • 错误的设备响应: 检查角色分配和自定义按钮映射。
  • 缺少控制项: 在 Home Assistant 中测试相同操作,确认设备提供该功能。

如果无法缩小问题范围,请使用支持检查清单