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