Google uses AI technology to translate content into your preferred language. AI translations can contain errors.
iOS 上的网络连接
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
Home API for iOS 的某些功能因网络连接状态和是否存在 hub 而异。
表 1 和表 2 说明了在不同条件下,不同类型的设备适用于哪些使用场景。
- 本地是指用户在与设备相同的 Wi-Fi 网络上运行控制器(例如 Google Home app (GHA) 或第三方应用)的情况(换句话说,用户在家中)。
- “远程”是指用户:
- 在单独的 Wi-Fi 网络上运行控制器(例如 GHA 或第三方应用)
(换句话说,用户不在家中)
,或者
- 使用 Google Home for web。
__表 1:hub 处于“在线”状态时的 Home API 连接功能
| 使用场景 |
Matter 设备类型
|
云设备类型 |
| 本地 |
遥控器 |
本地 |
遥控器 |
| 调试并添加设备 |
|
|
无 |
无 |
| 添加设备 |
无 |
无 |
|
|
| 查看设备状态 |
|
|
|
|
| 控制设备 |
|
|
|
|
| 使用设备创建自动化操作 |
|
|
|
|
| 使用设备运行自动化操作 |
|
|
|
|
__表 2:hub 处于“离线”状态时的 Home API 连接功能
| 使用场景 |
Matter 设备类型
|
云设备类型 |
| 本地 |
遥控器 |
本地 |
遥控器 |
| 调试并添加设备 |
|
|
无 |
无 |
| 添加设备 |
无 |
无 |
|
|
| 查看设备状态 |
|
|
|
|
| 控制设备 |
|
|
|
|
| 使用设备创建自动化操作 |
|
|
|
|
| 使用设备运行自动化操作 |
|
|
|
|
| 将设备分配到其他房间 |
|
|
|
|
| 移除设备 |
|
|
|
|
问题排查
下表列出了如何解决各种与 hub 相关的场景中出现的问题:
__表:问题排查场景
| 场景 |
预期行为 |
建议用户采取的操作 |
| Matter 设备状态 |
hub 状态 |
控制设备 |
自动化操作 |
| ONLINE-PEER 或 ONLINE-REMOTE |
在线(仅一个有效状态) |
|
|
无需采取补救措施。 |
| ONLINE-DIRECT |
没有 hub |
|
|
将 hub 添加到结构中,并确保其已连接到 Wi-Fi 网络。 |
| ONLINE-DIRECT |
在线 |
|
|
将 hub 配置为使用与手机相同的 Wi-Fi 网络。
或者,将新 hub 添加到结构中,并确保其已连接到
Wi-Fi 网络。 |
| ONLINE-DIRECT |
离线 |
|
|
确保 hub 已插好。 |
| 离线 |
没有 hub |
|
|
- 如果用户不在家中,则这是预期行为。将
受支持的 hub 添加到
住宅,以便远程控制设备和设置自动化操作。
- 如果用户在家中,请确保设备已插好,并且手机
已连接到与 Matter
设备相同的 Wi-Fi 网络。
|
| 离线 |
在线 |
|
|
确保设备已插好。 |
| 离线 |
离线 |
|
|
确保 hub 已插好。 |
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2026-02-04。
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["不正确的信息","incorrectInformation","thumb-down"],["信息/样本不足","notEnoughInformationSamples","thumb-down"],["太复杂","tooComplicated","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2026-02-04。"],[],[]]