AmazHA 是一款面向 Amazfit 手表的 Home Assistant 应用，它运行在一份固定的 Zepp OS 机型列表上。这份列表既不是猜测，也不是营销说辞：它就是这款应用的安装包所针对构建的手表列表，Zepp App Store 也正是用它来决定谁可以安装。本文逐款讲解这份列表。
简短回答
AmazHA 可在 25 款搭载 Zepp OS 的 Amazfit 手表上运行，方形和圆形都有：GTS 4 和 GTR 4、Bip 6 和 Bip Max、Falcon，以及 Active、Balance、Cheetah 和 T-Rex 系列的型号。每一款得到的都是同一个应用、同样的界面。Active Edge、Bip 5 和 T-Rex 2 不受支持，Zepp OS API 级别低于 3.0 的手表也不受支持。
如果你只想了解自己的手表，请在下表中查找，或者直接跳到两分钟检查你的手表。
完整列表
全部 25 款受支持的型号，以及它们的形状和 AmazHA 绘制界面所用的屏幕尺寸。每一行都是“能”。
| 型号 | 形状 | 屏幕（像素） | AmazHA |
|---|---|---|---|
| Active | 方形 | 390×450 | 能 |
| Active 2 | 方形和圆形 | 390×450（方形）、466×466（圆形） | 能 |
| Active 2 Golf | 圆形 | 466×466 | 能 |
| Active 3 Premium | 圆形 | 466×466 | 能 |
| Active Max | 圆形 | 480×480 | 能 |
| Balance | 圆形 | 480×480 | 能 |
| Balance 2 | 圆形 | 480×480 | 能 |
| Balance 2 XT | 圆形 | 480×480 | 能 |
| Balance 3 | 圆形 | 480×480 | 能 |
| Balance 3 Ti | 圆形 | 480×480 | 能 |
| Balance Ultra | 圆形 | 480×480 | 能 |
| Bip 6 | 方形 | 390×450 | 能 |
| Bip Max | 方形 | 面板 432×514，应用看到的是 390×450 | 能 |
| Cheetah 2 Pro | 圆形 | 466×466 | 能 |
| Cheetah 2 Ultra | 圆形 | 480×480 | 能 |
| Cheetah Pro | 圆形 | 480×480 | 能 |
| Cheetah Round | 圆形 | 454×454 | 能 |
| Cheetah Square | 方形 | 390×450 | 能 |
| Falcon | 圆形 | 416×416 | 能 |
| GTR 4（以及 GTR 4 LE） | 圆形 | 466×466 | 能 |
| GTS 4 | 方形 | 390×450 | 能 |
| T-Rex 3 | 圆形 | 480×480 | 能 |
| T-Rex 3 Pro | 圆形 | 466×466（44 mm）、480×480（48 mm） | 能 |
| T-Rex Ultra | 圆形 | 454×454 | 能 |
| T-Rex Ultra 2 | 圆形 | 480×480 | 能 |
衍生版本算作同一款手表
这份列表背后的清单（manifest）所列的条目远不止 25 个，因为 Amazfit 会以多个固件身份销售同一款手表。它们全都在支持范围内：
- 地区版本，也就是应用清单中标注为 (W)、(WN) 或 (W64) 的那些，与它们所属的型号是同一款手表。
- NFC 版本：Active 2 NFC（方形和圆形）就是 Active 2。
- GTR 4 LE 与 GTR 4 列在一起，Cheetah Pro KK 与 Cheetah Pro 列在一起。
- 表壳尺寸：T-Rex 3 Pro 有 44 mm 和 48 mm 两种，屏幕不同，两者都受支持。
同样的列表也在主页的支持的手表部分。每次构建网站时，它都直接读取自应用自己的清单，所以两者不可能不一致。
这份列表从何而来
这份列表包括 Zepp 开发者工具中登记的、API 级别为 3.0 或更高的所有 Amazfit 手表，再减去三款有意排除的型号（下文详述）。AmazHA 声明的最低要求是 API 级别 3.0，这就是较早的手表根本不在列表上的原因。
Amazfit 以后发布的手表不会自动获得支持。必须先把它加入列表，并发布新版本的 AmazHA；在此之前，Zepp App Store 不会在这款手表上提供这个应用。
逐个系列
每个系列的答案，以及不同型号之间存在差异的细节。只要你的型号在这里，AmazHA 就能在上面运行。
Active
除了 Active Edge，所有 Zepp OS 版的 Active 手表都受支持。
- Amazfit Active： 能。方形，390×450。
- Amazfit Active 2： 能，两种形状都可以。方形 Active 2 和 Active 2 NFC Square 使用 390×450 布局；圆形 Active 2 使用 466×466 布局。
- Amazfit Active 2 Golf： 能。圆形，466×466。
- Amazfit Active 3 Premium： 能。圆形，466×466。
- Amazfit Active Max： 能。圆形，480×480。
- Amazfit Active Edge： 不能。它 360×360 的屏幕太小（见不支持的手表及原因）。
Active 2 是列表中唯一同时有方形版和圆形版的型号。两者运行的是同一个应用，各自按自己的屏幕绘制，所以你看到的差别只在布局上，而不在功能上。
Balance
每一款 Balance 都受支持，而且全都属于 480×480 圆形组。
- Amazfit Balance： 能。
- Amazfit Balance 2： 能。
- Amazfit Balance 2 XT： 能。
- Amazfit Balance 3： 能。
- Amazfit Balance 3 Ti： 能。
- Amazfit Balance Ultra： 能。
由于屏幕尺寸相同，每款 Balance 得到的都是同一个应用版本。Balance 3、Balance 3 Ti 和 Balance Ultra 比其他几款更新，收到的内容与 Balance 2 完全相同。
关于初代 Balance 有一点说明，而且只在你于后台使用手表传感器时才相关：在 Balance 固件 2.0.0 上，手表重启后后台更新会停止，直到下一次重启。这是该固件服务计时器的缺陷，不是应用能修复的，较新的 Balance 固件已经没有这个问题。只要让手表保持最新，就不受影响。无论如何，在应用打开时做的所有操作都正常。
Bip
有两款 Bip 受支持：Bip 6 和 Bip Max。Bip 5 不受支持。
- Amazfit Bip 6： 能。方形，390×450，与 AmazHA 布局的设计尺寸相同。
- Amazfit Bip Max： 能。方形，面板为 432×514。
- Amazfit Bip 5： 不能。它 320×380 的屏幕太小。
Bip Max 值得多说几句。它在一块虚拟的 390×450 画布上运行为 API 级别 3 编写的应用：在它 432×514 的面板上，手表告诉应用屏幕是 390×450。AmazHA 在一块真实的 Bip Max 上测量证实了这一点。实际上，Bip Max 显示的布局与 GTS 4 或 Bip 6 相同。
这块画布曾经导致过一个真实的 bug：图标集是按物理面板的尺寸准备的，应用却按虚拟画布的尺寸绘制，结果有些图标显示为空白。现在，AmazHA 为 Bip Max 提供一套同时覆盖两种尺寸的图标集，并在绘制前检查要用的文件是否存在，不存在时退回到一个确定存在的尺寸。
Cheetah
每一款 Zepp OS 版的 Cheetah 都受支持，共有三种屏幕尺寸。
- Amazfit Cheetah Square： 能。方形，390×450。
- Amazfit Cheetah Round： 能。圆形，454×454。
- Amazfit Cheetah Pro： 能。圆形，480×480（Cheetah Pro KK 也一样）。
- Amazfit Cheetah 2 Pro： 能。圆形，466×466。
- Amazfit Cheetah 2 Ultra： 能。圆形，480×480。
Cheetah 2 Ultra 与 Balance 2 和 T-Rex 3 同属 480×480 组；Cheetah 2 Pro 与 GTR 4 和圆形 Active 2 同属 466×466 组。
Falcon
Falcon 受支持。它是 AmazHA 的 416×416 圆形组中唯一的型号。
- Amazfit Falcon： 能。圆形，416×416。
- Falcon 2： AmazHA 的列表上没有这个名字的手表。列表只列出了 Falcon。如果你的手表以其他 Falcon 名称销售，请用下面的两分钟检查方法：App Store 说了算。
Falcon 的 416×416 是列表上最小的圆形屏幕。所有内容都能放下；如果你想要更大的文字，请参阅方形还是圆形中关于字体大小和卡片大小偏好设置的介绍。
GTR 4 和 GTS 4
GTR 4 和 GTS 4 都受支持，而 GTS 4 是整个应用的基准手表。
- Amazfit GTS 4： 能。方形，390×450。
- Amazfit GTR 4： 能。圆形，466×466。GTR 4 LE 与它列在一起。
- Amazfit GTS 4 Mini： 不在列表上。
AmazHA 正是从 GTS 4 起步的。它 390×450 的屏幕是所有布局的设计画布，在此基础上再缩放到其他屏幕；主页上的交互式演示就是一块 GTS 4；它也是开发者自己戴的手表：当前版本在发布前就在它上面逐项检查过。
较早的 GT 系列型号，例如 GTS 2、GTR 2、GTS 3 或 GTR 3，都不在列表上。如果 AmazHA 没有出现在你手表的 App Store 里，就说明你的手表不受支持。
T-Rex
T-Rex 3、T-Rex 3 Pro、T-Rex Ultra 和 T-Rex Ultra 2 受支持。T-Rex 2 不受支持。
- Amazfit T-Rex 3： 能。圆形，480×480。
- Amazfit T-Rex 3 Pro： 能，两种尺寸都可以。44 mm 型号使用 466×466 布局，48 mm 型号使用 480×480 布局。
- Amazfit T-Rex Ultra： 能。圆形，454×454。
- Amazfit T-Rex Ultra 2： 能。圆形，480×480。
- Amazfit T-Rex 2： 不能，原因是内存（见下文）。
如果你只搜索“T-Rex”：当前的型号都能用，T-Rex 2 不能；更早的型号，请用下面的 App Store 检查方法来确认。
每款受支持的手表都能得到什么
每一款受支持的型号运行的都是同一个应用：同样的界面、同样的小组件、同样的手表传感器。六个屏幕组之间的差别只在布局和图标尺寸上，从不在功能上。
这源于 AmazHA 的构建方式。手表本身从不直接与 Home Assistant 通信：它通过 Bluetooth 与你手机上的 Zepp 应用通信，所有联网工作都由手机完成。所以连接的任何方面都不取决于手表型号，手表也不需要 Wi-Fi。
在这 25 款中的任何一款上，你都能得到：
- 按房间展示你的家，或者以收藏列表展示，每种设备都有控制界面：灯、开关、空调、窗帘、扫地机器人、安防面板、传感器、媒体播放器、风扇、门锁、场景、脚本、按钮、自动化、摄像头、追踪器以及下拉选择辅助元素（
select和input_select）。共 17 种设备类型。 - 表盘上的小组件：在手表的快捷卡片上放最多四个设备，一点即用。六个屏幕组都声明了这个小组件。
- Home Assistant 中的手表传感器：步数、心率、睡眠、电量等，通过 Home Assistant 的 Mobile App 集成发送。某款手表无法提供的读数会被直接跳过，不会出任何问题。手表传感器一文介绍了全部 18 个。
- 同样的限制：手机必须在附近，设备列表上限为 100 个。在每一款型号上，几十个设备都能保持流畅；少选一些是对所有型号的建议，而不仅仅是对小屏幕（见故障排除教程）。
是如何检查的
在当前版本发布之前，我们在 Zepp 的模拟器中、在 19 款 Amazfit 手表的真实固件上，把每一类界面都走了一遍；模拟器运行的是每款手表自己的固件，而不是仿制品。19 款全部通过。在 GTS 4、Cheetah Square、T-Rex Ultra、Cheetah Pro、Falcon、GTR 4、Balance 2 和 Active 2 Square 上还进行了更长时间的运行，一次会话约 130 个界面，没有出现黑屏。那些没有自己的模拟器镜像的型号，例如最新的 Balance 型号，得到的安装包与它们所在屏幕组中的型号相同。
方形还是圆形：屏幕上有什么不同
AmazHA 只有一套设计，绘制在 390×450 的画布上，再缩放到每块屏幕。在方形手表上，它铺满屏幕；在圆形手表上，标题居中，列表铺满整个表面。
具体来说是这样的。
| 方形手表 | 圆形手表 | |
|---|---|---|
| 布局 | 390×450 的设计，缩放到适合屏幕 | 同一套设计，缩放进一条居中的区域，避开弯曲的边缘 |
| 界面标题栏 | 返回箭头在左，标题左对齐 | 返回箭头从弧边向内移，标题居中 |
| 较长的标题 | 在箭头之后左对齐 | 移到箭头之后靠左，利用直到表面边缘的空间，而不是滚动显示 |
| 设备磁贴和房间行 | 全宽，留有边距 | 向两侧加宽，距表面边缘约 30 像素 |
| 滑块、角标、固定控件 | 设计全宽 | 保持在居中区域内 |
| 列表末尾 | 在最后一行结束 | 最后一行之后留出一点额外空间 |
| 分节标签 | 左对齐 | 居中 |
| 表盘上的小组件 | 在手表给它的框架内绘制 | 保持在圆形表面之内，即使手表给的框架横跨整个宽度也是如此 |
返回手势和标题栏
在两种形状上，向右滑动都会返回。在控制界面上，点按标题栏的任何位置也会返回，而不只是点按那个小小的返回箭头。手表上的基本操作教程演示了这一点。这在圆形手表上更重要：圆的顶部很窄，而整条标题栏是比箭头大得多的点按目标。
为什么修改了圆形手表上的标题
在 480×480 的圆形屏幕上，返回箭头与另一侧对称位置之间的空间很窄。一个叫“Bedroom”的房间放不下，而 Zepp OS 会把放不下的文字以跑马灯的方式滚动显示。现在，居中放不下的标题会移到左侧，占用箭头之后的空间，就像在方形手表上一样。短标题仍然居中。同一次更新还让房间角标（例如温度读数）根据数值自动加宽，所以“19.8°C”会完整、静止地显示。
为每块屏幕绘制的图标
Zepp OS 按原生尺寸绘制图片，运行时不做缩放。所以 AmazHA 不会给所有人提供同一套图标：六个屏幕组各有自己的图标包，预先按该屏幕所用的精确像素尺寸绘制好。这让图标在 416×416 的 Falcon 和 480×480 的 Balance 上同样清晰。
在任何形状上都可以放大文字和卡片
如果觉得屏幕上的文字太小，有两项偏好设置在每一款型号上都能帮上忙，位于 AmazHA 设置的偏好设置下（教程）：
- 字体大小会放大手表上的所有文字：110%、120% 或 130%。
- 卡片大小会放大主屏幕上的区域卡片和设备磁贴：115%、130% 或 145%。
行高会随文字一起增加，所以字形变大后间距依然舒适。新的尺寸会在你下次于手表上打开 AmazHA 时生效。
不支持的手表及原因
有三款 Zepp OS 型号是有意排除的，所有 API 级别低于 3.0 的手表都不在支持范围内。原因如下。
| 手表 | AmazHA | 原因 |
|---|---|---|
| Active Edge | 不能 | 屏幕太小：360×360 |
| Bip 5 | 不能 | 屏幕太小：320×380 |
| T-Rex 2 | 不能 | 内存不足：32 MB RAM，而 GTS 4 有 128 MB |
| Zepp OS API 级别低于 3.0 的手表 | 不能 | AmazHA 需要 API 级别 3.0 或更高 |
| 不在上述列表中的任何型号 | 不能 | 不在应用的清单中，所以商店不会提供 |
屏幕太小：Active Edge 和 Bip 5
AmazHA 的布局按 390×450 设计，再保持比例缩放到每块屏幕。在 360×360 或 320×380 的屏幕上，它会缩小到房间名称、磁贴状态和按钮都难以舒适阅读的程度。我们的选择是不支持这两款，而不是推出一个看起来很糟糕的版本。
内存：T-Rex 2
T-Rex 2 有 32 MB RAM；AmazHA 的最低要求是 GTS 4 的 128 MB。这不是平台的限制，因为第三方应用确实能在 T-Rex 2 上运行。这是我们的选择：不推出体验打了折扣的版本。
为什么不给它做一个精简版？在 Zepp OS 手表上，系统、表盘和每个应用共享一块很小的内存空间来存放代码，在 AmazHA 检查过固件的手表上，这块空间只有几 MB。AmazHA 的负担不在控制界面上（精简版或许能削减这部分），而在于保持手表与 Home Assistant 同步以及后台那一层。削减界面并不能让它装得下，所以目前没有推出精简版的计划。
较早的手表
Zepp OS 低于 API 级别 3.0 的手表无法运行 AmazHA，因为应用声明的最低要求是 3.0。没有 Zepp OS 的型号根本无法运行 Zepp OS 应用。对于任何具体的较早型号，可靠的检验方法是商店：如果 AmazHA 没有出现在你手表的 App Store 里，你的手表就不受支持。
Wear OS
AmazHA 面向搭载 Zepp OS 的 Amazfit 手表。Wear OS 版本正在开发中，尚无发布日期。
两分钟检查你的手表
在手表已连接的情况下，在 Zepp 应用的 App Store 中搜索 AmazHA。如果搜得到，你的手表就受支持；安装它，在付费之前，免费演示就会让你看到它在你的屏幕上运行的样子。
具体步骤：
- 在手机上打开 Zepp 应用，手表已配对并连接。
- 打开 App Store，也就是 Zepp 应用里专为你的手表准备的应用商店。
- 点按搜索图标，输入 AmazHA。
- 如果出现 AmazHA — Home Assistant Companion App 这个结果，你的手表就受支持。
- 点按安装。它是免费的。
- 在手表上打开应用列表，点按 AmazHA。
应用一打开就是一个有房间、有设备的演示家庭。每个界面都使用示例数据运行：打开房间、拨动开关、试试灯的亮度或温控器。这就是真正的应用，运行在你真正的屏幕上，所以对于“它在我的手表上看起来怎么样？”这个问题，它比任何表格回答得都好。演示不需要 Home Assistant，也不需要付费。
如果演示看起来不错，下一步就是一次性解锁，无订阅：点按手表上橙色的演示模式 · 未授权横幅，然后按照解锁教程操作。网站的价格部分有详细信息。
如果商店里没有出现 AmazHA
| 你看到的 | 含义 | 怎么做 |
|---|---|---|
| 搜不到 AmazHA | 你的手表不在列表上 | 查看上面的表格；如果没有你的型号，它就不受支持 |
| 安装一直完成不了 | 应用是通过 Bluetooth 从手机传到手表的 | 让手机留在附近并开启 Bluetooth，然后重试 |
| AmazHA 打开后是示例房间 | 那是演示，本来就是这样 | 解锁它，然后连接你的 Home Assistant |
如何在 Amazfit 手表上安装应用
Zepp OS 手表的应用是从手机上安装的：打开 Zepp 应用，打开它的 App Store，找到应用，点按安装。应用会通过 Bluetooth 发送到手表，同时手机上显示进度。不需要电脑，也不需要数据线。
这对每个应用、每款 Zepp OS 手表都一样。对于 AmazHA：
- 开始之前： 你的手表已与手机上的 Zepp 应用配对，Bluetooth 已开启，手机就在附近。
- 打开 Zepp 应用，也就是你手表的配套应用（第 1 步）。
- 打开 App Store，它就在 Zepp 应用里（第 2 步）。
- 搜索 AmazHA：点按搜索图标，输入名称（第 3 步）。
- 打开搜索结果 AmazHA — Home Assistant Companion App（第 4 步）。
- 点按安装，等待传输完成（第 5 步）。
- 在手表上打开它：按一下按键打开应用列表，然后点按 AmazHA（第 6 步）。
应用自己的设置也在 Zepp 应用里。AmazHA 的设置位于我的 › 你的手表 › 应用 › AmazHA › 设置：你在那里连接 Home Assistant、选择手表显示的设备，以及调整偏好设置。
更新也通过同一个商店推送。更新之后，请重启一次手表。
安装之后：从演示到你自己的家
应用装到手表上之后，无论哪款型号，把它连接到你的 Home Assistant 都只需三个教程：
- 解锁完整版：手表上显示一个 5 位代码，在 kzl.io/code 一次性付款。
- 连接 Home Assistant：在 AmazHA 设置中点按 Home Assistant，填写你的本地 URL (LAN)；如果离家时也想用，再填写远程 URL；粘贴长期访问令牌，然后点按连接。
- 选择你的设备：所有设备默认隐藏，所以请开启你想在手表上看到的那些。
在连接这一步，有两件事常让人卡住，而且都与手表无关：
- 令牌必须来自管理员。 AmazHA 通过 Home Assistant 的模板 API 读取你的区域，而 Home Assistant 只允许管理员使用它。用普通用户的令牌，连接测试可以通过，但手表加载不到任何设备，并显示需要管理员令牌。长期访问令牌一文对此有详细解释。
- 在家时，本地地址就足够了。 手机连在家庭网络上时，AmazHA 使用你的本地地址。只有想在离家时使用手表，才需要远程地址；远程访问一文比较了各种方案。
为 Home Assistant 挑选手表
如果你挑选手表时有一部分是为了 Home Assistant，那么这 25 款中的任何一款都能胜任，因为应用及其功能在所有型号上都一样。不同的是屏幕，而这归根结底是个人喜好的问题。
从列表本身可以看出几点：
- 方形还是圆形。 方形手表（390×450，以及 Bip Max）以 AmazHA 的设计尺寸显示它。圆形手表显示同样的界面，标题居中，列表延伸到表面边缘。两种形状都不会少任何功能。
- 屏幕尺寸。 列表上的圆形屏幕从 416×416（Falcon）到 480×480（Balance、Cheetah Pro、T-Rex 3 等）不等。每块屏幕都显示同样的布局，按自身尺寸缩放；字体大小和卡片大小能让其中任何一块都更易阅读。
- 新旧两代。 列表既包括 GTS 4 和 GTR 4 这样较早的手表，也包括最新的 Balance 3 和 Balance Ultra。AmazHA 在两代固件上都能运行；最低要求是 Zepp OS API 级别 3.0。
- 如果 Home Assistant 对你很重要，请避开这三款被排除的型号：Active Edge、Bip 5 和 T-Rex 2。
本页只从 AmazHA 的角度比较手表。续航、传感器、按键和材质应由 Amazfit 来介绍，这里不做讨论。