AqaraLink 开发者平台 API：能为开发者提供什么
面向集成商的 AqaraLink 开发者平台 API 详解：云端模块、消息推送、虚拟账号、App SDK 与 Matter 路径，附马来西亚支持信息。
开发者与集成商
马来西亚智能家居的 Matter 控制器：您真正需要什么
简要回答 — 要添加 Matter 配件（包括 Matter over Thread 设备），您需要一台 Matter 控制器，例如 Aqara Hub M3，并且必须在配对任何设备之前先在 Aqara Home 中完成设置。控制器运行后，Matter 设备就和其他设备一样在屏幕上配置。Zigbee 设备则不同：它们也可以添加到 Panel Hub S1 Plus，因为 S1 Plus 本身就是 Zigbee 网关。
大家常搞错的操作顺序
网上几乎每一则“我的 Matter 设备配不上”的帖子，都漏掉了同一个第一步。正确顺序是：
- 在 Aqara Home 中设置 Matter 控制器。Hub M3 就是 Aqara 用于此用途的控制器。
- 之后才添加 Matter 配件。
- 在屏幕上配置并控制它们。
如果先做第 3 步，您可能会花一整晚对着一个怎么也出不来的 Thread 设备。这不是马来西亚特有的问题，也不是固件问题，而是顺序问题。
Matter 与 Zigbee 各司其职
网上大多数对比表在这里出错，因为它们用同样的标准给 Matter 和 Zigbee 打分。两者并不是同一类东西。在马来西亚的家庭里，差别恰好体现在最关键的时刻：某个星期二晚上，光纤断线的时候。
| Matter | Zigbee | |
|---|---|---|
| 它是什么 | 智能家居设备的应用层标准，可运行于 Wi-Fi、Thread 或以太网之上 | 低功耗网状无线协议（Aqara 产品线采用 Zigbee 3.0） |
| 带来什么 | 互通性：设备无需专用桥接器即可加入不同生态 | 网状网络的可靠性、低功耗、传感器电池寿命长 |
| 典型供电方式 | 市电供电的配件 | 纽扣电池和电池，可用数月至数年 |
| 如何连到您的手机 | 通过 Matter 控制器，需先在 Aqara Home 中设置 | 通过 Zigbee 网关，可以是 Hub M3 或 S1 Plus |
| 网络中断时的典型表现 | 依赖云端的功能可能暂停；本地行为取决于设备 | 本地网状网络的自动化继续运行 |
Matter 并不是更好的无线协议，而是一种共同语言。当您希望设备能在多个生态中使用，或要购买从未测试过的厂商产品时，它才重要。对于满屋传感器、需要靠一颗电池运行两年的场景，Zigbee 才是更成熟、更稳妥的答案。
无论是莎阿南的有地住宅，还是赛博再也的公寓单位，您的设备大部分是传感器和开关，而不是特别的配件。Zigbee 能很好地胜任。
您到底需要哪一款网关
在马来西亚的 Aqara 产品线中，实际的选择落在两个设备之间：
- Hub M3：既是 Matter 控制器，也是 Zigbee 网关。只要要添加 Matter 配件，包括任何基于 Thread 的设备，就需要这一款。
- Panel Hub S1 Plus：壁挂面板，配备 6.9 英寸触摸屏、双频 2.4/5GHz Wi-Fi、Zigbee 3.0，配件通过 Matter 控制器添加后可在屏幕上控制，并内置两个继电器开关。关键在于，S1 Plus 本身就是 Zigbee 网关，因此 Zigbee 设备既可以添加到 M3，也可以添加到它。
产品线中的其他网关：Hub M200、Hub M100，以及 Camera Hub G3 和 Camera Hub G5 Pro 等摄像头网关。
实用建议：只要项目规划中有任何 Matter 配件，就应预算一台 Hub M3，放在中央且可靠的位置。如果项目只用 Zigbee，S1 Plus 就够用，还能给业主一块真正会用到的墙面面板。
网络中断时，您的自动化会怎样
这是有地住宅的用户最常问我们的问题，值得直接回答。
不依赖云端的 Zigbee 网状网络自动化会继续运行。如果走廊灯在下午 6 点亮起，是因为人体移动传感器触发了某条规则，那么这条规则由网关和网状网络执行。网关在您的局域网内，靠市电供电，不会理会 TM 或 Maxis 是否出了故障。Aqara 是以 Zigbee 为主的生态，一台 Zigbee 网关最多可在本地控制 128 台相关设备，对于双层住宅或有多个房间自动化的小型公寓单位来说，这个数字才是关键。
没有互联网时会受影响的功能：
- 推送到手机的通知
- 手机应用没有在本地缓存的内容
- 远程访问：例如您在槟城，想控制吉隆坡的家，或在办公室控制家里
- 经由云服务转发的语音助手指令
- 固件更新
所以，诚实的说法并不是“离线也能用”，而是：开关、传感器、场景和门锁继续运作；您的手机则变成一台遥控器，遥控一间本来就在运行的房子。
如果您是在新建的房子里布线，这也是不要一味追求最薄弱的 Wi-Fi 覆盖的理由。把网关放在中央位置的有线接口上，胜过放在楼上某人 5GHz 网状扩展器上的网关。
Thread 的小插曲
Matter over Thread 值得理解，而不是死记。Thread 是低功耗网状无线，所以更像 Zigbee 而不是 Wi-Fi：它需要边界路由器才能接入更大的网络，而在 Aqara 的配置中，这项工作由 Matter 控制器承担。您不需要为家中另外调试 Thread 边界路由器，控制器已处理好。
如果您是在为一栋楼做规格，实际结论与 Zigbee 相同：在施工期间就规划好网关的位置和电源。 请参阅我们的公寓交楼智能家居规格。
简短的决策清单
- 要添加任何 Matter 配件，包括 Matter over Thread？Hub M3，并先在 Aqara Home 中设置。
- 只用 Zigbee，想要一块家人会用的墙面面板？S1 Plus，它本身就是 Zigbee 网关。
- 传感器多、要电池寿命长、要离线自动化？Zigbee，毫无悬念。
- 设备必须能在多个生态中使用？这才是选择 Matter 的真正理由。
Aqara 生态可与 Apple HomeKit、Amazon Alexa 和 Google Assistant 配合使用；关于控制器与 Magic Pair 配对的开发者角度，请见 AqaraLink 开发者平台一文。在选择网关时，Zigbee、Wi-Fi 与 Matter 的比较，请见 Zigbee、Wi-Fi 还是 Matter：如何选择网关。
