2022.12:这次真的很 Matter!
Home Assistant 核心 2022.12!🎄
这已经是今年最后一次发布了,而且来得正是时候,刚好能让你在即将到来的节日期间玩上这些酷炫的新功能!
2022 年对 Home Assistant 项目来说是极其精彩的一年。我们已经成为全球规模最大、增长最快的 GitHub 开源项目之一!❤️ 我们几乎每个月都有大量新功能,而且不仅如此,整个项目也成熟了许多:一切都变得更稳定、更快速,用户体验也有了飞跃式提升!
我们在 State of the Open Home 中回顾了 2022,也提前透露了一些 2023 的方向,包括一些很棒的全新 UI 概念,以及:语音之年! 🗣️ 如果你错过了,完整视频可在 YouTube 上观看。
不过!这一年还没结束!这次发布真的很 Matter!我们非常激动,能够成为全球首批向公众提供 Matter 支持的平台之一!🎉
还没有 Matter 设备?别担心!这次发布里依然有很多值得体验的内容。Tile 卡片加入了“功能区”!你现在还可以使用 Shelly 设备扩展蓝牙覆盖范围,而大家期待已久的功能也终于来了:本地日历。🤩
2022 年就到这里了!感谢你加入我们的社区,感谢你分享内容、帮助他人、参与贡献,制作 YouTube 视频、博客文章和播客。
感谢你使用 Home Assistant! ❤️
节日快乐,也请在 2022 年的最后一次,尽情享受这次发布吧!
../Frenck
- 这次真的很 Matter!
- Tile 卡片新增功能区
- 闪亮的新状态颜色!
- 本地日历
- 使用 Shelly 设备作为蓝牙代理
- 新实体:
text - 无需模板即可汇总实体
- 其他值得注意的变化
- 新的集成
- 现在可通过 UI 设置的集成
- 发布 2022.12.1 - 12 月 8 日
- 发布 2022.12.2 - 12 月 11 日
- 发布 2022.12.3 - 12 月 11 日
- 发布 2022.12.4 - 12 月 12 日
- 发布 2022.12.5 - 12 月 13 日
- 发布 2022.12.6 - 12 月 14 日
- 发布 2022.12.7 - 12 月 17 日
- 发布 2022.12.8 - 12 月 21 日
- 发布 2022.12.9 - 1 月 2 日
- 需要帮助吗?加入社区!
- 向后不兼容的变更
- 告别以下内容
- 所有变更
别忘了今天加入我们的 YouTube 发布派对直播!时间是 PDT 12:00 / CET 21:00。
这次真的很 Matter!
这次真的 Matter 吗?没错,Home Assistant 现在真的支持 Matter 了!
Matter 是一项新的智能家居互操作标准,也是一种开源协议,它定义了设备如何彼此通信和协同工作。想进一步了解 Matter,可以阅读 The Verge 的这篇完整解析。
今天,我们发布了 Home Assistant Matter 集成的第一个版本。这是一个重要而关键的基础,可能最适合被描述为“alpha”,甚至可以说是“开发者预览版”——它允许任何人参与进来,一起推动 Matter 的开发。对于首个版本来说,我们认为这已经是一个很棒的开始!
目前,支持 Matter 的产品还没有大规模上市。不过,如果你手上已经有通过 Matter 认证的产品,现在就可以把它接入进来!
接入 Home Assistant 的 Matter 设备。
添加 Matter 设备(配网)可以通过我们的 iOS 和 Android Home Assistant Companion 应用完成。相关支持正在持续开发中,并会在未来几周内逐步上线。目前,支持 Matter 的 Android Companion 应用已经开放 beta 测试。
感兴趣吗?我们已经在文档中提供了更多细节。
Tile 卡片新增功能区
在上一次发布中,我们介绍了 Tile 卡片。而今天,我们又进一步为 Tile 卡片加入了“功能区”支持。
对于 Tile 卡片来说,“功能区”指的是可以附加到卡片上的额外能力。比如,它们可以为 Tile 卡片所显示的实体提供额外控制项或更多信息。
我们已经加入了多个实用的 Tile 功能区:
- 吸尘器的命令按钮
- 灯光亮度滑块
- 用于打开、关闭和倾斜遮罩的控制项
但还不止这些!Tile 卡片现在也有颜色了!🎨
卡片会根据实体状态显示不同颜色。这些颜色会为实体当前的状态提供额外的视觉提示。
闪亮的新状态颜色!
上面展示的这些漂亮的新状态颜色,并不只应用在 Tile 卡片上。现在,同样的颜色逻辑也已经应用到了状态历史和日志簿中!
过去,这些颜色基本是随机的。现在它们变得可预测、易识别,而且最重要的是:看起来好看多了 🤩
当然,在独立的 Logbook 和 History 页面中,你也会看到同样的效果。
本地日历
这是 Home Assistant 长期以来悬而未决、呼声又特别高的大功能之一:本地日历!
做一个日历并不容易,但 Allen Porter 做到了!而且它可不只是一个能填写日期和描述的普通日历……不不不,Allen 这次可是火力全开!
我们现在拥有了一个完整的、本地的、内置日历,它支持全天事件,也支持按照你的需求设置重复事件。甚至还支持创建多个不同的本地日历!
使用 Shelly 设备作为蓝牙代理
在 9 月发布中,我们通过加入[蓝牙无处不在]的蓝牙代理支持,让你家里的任意 ESPHome 设备都可以在整个家中转发蓝牙流量。
而这次发布,则加入了把 Shelly 设备当作远程蓝牙适配器来使用的支持!
它适用于所有使用 12.0 或更高固件版本的第二代 Shelly 设备。这些设备能够将蓝牙广播数据转发给 Home Assistant 的蓝牙集成。不过,Home Assistant 还不能通过 Shelly 设备主动连接到蓝牙设备,而这通常是通过蓝牙控制设备所必需的。如果你需要这个能力,请使用我们的 蓝牙代理。
这会大大提升你家中蓝牙网络的覆盖范围,对于蓝牙温度传感器、植物传感器之类的设备尤其有帮助。
顺便一提,在蓝牙方面还有一个好消息:这次发布再次改进了蓝牙性能,而且内存占用也应该更低了。永远是好事!
新实体:text
来认识一个新实体:text!text 实体和 Text helper(也就是 input_text)非常相似。
不同之处在于,helper 由你自己配置和管理,而新的 text 实体则由集成提供。这意味着,集成现在可以在 UI 中提供需要文本输入的实体了。
在这次发布中,首批支持提供 text 实体的集成是 KNX 和 MQTT。
无需模板即可汇总实体
假设你有两个数值型传感器实体,并且想要一个新实体来显示它们的总和。以前你会怎么做?创建一个模板实体,对吧?现在不用了!😁
你现在可以直接创建一个新的 helper 实体,把两个或更多传感器实体的值汇总成一个全新的实体。
在创建新 helper 时,选择“合并多个传感器的状态”,再挑选你想求和的传感器,并将统计特性选择为“总和”,搞定!
你可能已经注意到,这看起来很像原来的 “Min/Max” helper。没错!随着它拥有了更多能力,我们已经把 “Min/Max” 重命名为“合并多个传感器的状态”,让它的用途表达得更清楚。
其他值得注意的变化
这次发布里还有很多值得一提的内容;以下是一些其他重要变化:
- 你现在可以在常规设置中设置你的国家和 Home Assistant 应使用的默认语言。这些新选项将帮助 Home Assistant 在未来功能中考虑这些偏好。
- 你在圣诞树上使用 Twinkly 吗?🎄 现在你可以控制灯效了!来得正是时候。感谢 @Olen!
- MQTT 已经达到了[集成质量等级]中的 gold 级别!干得漂亮,@jbouwh!而且还不止如此:它现在也支持 MQTT v5 和 WebSocket 连接了!
- NO2 和 VOC 传感器实体现在已经可以与 HomeKit 配合使用。感谢 @stackia!
- Shelly 现在已经是一个 platinum 集成 了!感谢 @thecode、@bieniu 和 @chemelli74 为这个集成付出的努力 🥇
- ZHA 现在支持新的 Aqara c1 pet feeder。感谢 @dmulcahey 添加支持,也感谢 @kirovilya 研究清楚了它的通信方式!
- 加湿器 卡片 现在拥有开关控制了。感谢 @Shulyaka!
- Amazon Alexa 现在支持加湿器了。感谢 @jbouwh!
- BTHome 第 2 版已经发布,Home Assistant 现在也支持它了!感谢 @Ernst79!
- Slack 现在提供了一个“请勿打扰”传感器,你可以基于它来做自动化。感谢 @tkdrob!
- KNX 现已加入对 IP-Secure routing 的支持。感谢 @farmio!
- 你在用 Picnic 购买日用品吗?现在你可以直接从 Home Assistant 把商品加入订单了。感谢 @corneyl!
新集成
我们欢迎以下新集成加入本次发布:
- air-Q,由 @Sibgatulin 添加
- Aranet,由 @aschmitz 添加
- LIVISI SmartHome,由 @StefanIacobLivisi 添加
- Local Calendar,由 @allenporter 添加
- Matter,由 @marcelveldt、@MartinHjelmare 和 @agners 添加
- RuuviTag BLE,由 @akx 添加
- Sensirion BLE,由 @akx 添加
- Text,由 @raman325 添加
现已可通过 UI 设置的集成
以下集成现在可以通过 Home Assistant UI 进行设置:
- Pushbullet,由 @engrbm87 完成
- Scrape,由 @gjohansson-ST 和 @epenet 完成
发布 2022.12.1 - 12 月 8 日
- 将 sensirion_ble 的 connectable 设为 false (@chkuendig - #83481) (sensirion_ble docs)
- 确保调用 super async_added_to_hass (@elupus - #83493) (philips_js docs)
- 将
simplisafe-python升级到 2022.12.0 (@bachya - #83497) (simplisafe docs) - 将 python-Matter-server 升级到 1.0.7 (@marcelveldt - #83507) (Matter docs)
- 将 pyhik 升级到 0.3.2 (@mezz64 - #83517) (hikvision docs)
- 将 ical 升级到 4.2.2 (@allenporter - #83520) (local_calendar docs)
- 修复 MQTT 在 Callable、Union 和 Python 3.9 下的问题 (@cdce8p - #83547) (MQTT docs)
- 更新 前端 to 20221208.0 (@bramkragten - #83551) (前端 docs)
- 改进本地日历输入校验错误处理 (@allenporter - #83563) (local_calendar docs)
- 将 pip_check 冲突计数 +1 (@frenck - #83536)
- 将 intellifire4py 升级到 2.2.2 (@jeeftor - #83589) (intellifire docs)
- 将 蓝牙-auto-recovery 升级到 0.5.5 (@bdraco - #83597) (蓝牙 docs)
- 禁用 multi-pan (@balloob - #83603) (homeassistant_yellow docs) (homeassistant_sky_connect docs) (homeassistant_hardware docs)
发布 2022.12.2 - 12 月 11 日
- 将 pyrisco 升级到 0.5.7 (@maartenweyns - #83548) (risco docs)
- 将 pychromecast 升级到 13.0.2 (@emontnemery - #83625) (cast docs)
- 修复 fibaro 温控单位问题 (@rappenze - #83659) (fibaro docs)
- 修复 UniFi Protect 的事件传感器问题 (@AngellusMortis - #83663) (unifiprotect docs)
- 为传感器 device_trigger SCHEMA 添加缺失的 CONF_SPEED (@SukramJ - #83679) (传感器 docs)
- 将 aioshelly 升级到 5.1.1 (@thecode - #83680) (shelly docs)
- 修复新 Yale Access 蓝牙条目设置延迟问题 (@bdraco - #83683) (yalexs_ble docs)
- 修复旧版 Fritz!Box 上 Fritz!Smarthome 的加载问题 (@mib1185 - #83688) (fritzbox docs)
- 升级 androitv 组件的 androidtv 依赖 (@chatziko - #83707) (androidtv docs)
- lifx:将 aiolifx_effects 依赖升级到 v0.3.1 (@Djelibeybi - #83730) (lifx docs)
- 修复仅在 Fritz!Box 为路由模式时加载 IPv6 传感器的问题 (@mib1185 - #83757) (fritz docs)
- 修复 Scrape 中的 scan_interval 问题 (@gjohansson-ST - #83758) (scrape docs)
发布 2022.12.3 - 12 月 11 日
发布 2022.12.4 - 12 月 12 日
- 将 蓝牙-auto-recovery 升级到 1.0.0 (@bdraco - #83800) (蓝牙 docs)
- 更新 前端 to 20221212.0 (@bramkragten - #83842) (前端 docs)
- 将 ZHA quirks 版本升级到 0.0.89 (@dmulcahey - #83848) (zha docs)
- 将 pychromecast 升级到 13.0.3 (@emontnemery - #83861) (cast docs)
- 将模板检查移动到 fritzbox 条目设置中 (@mib1185 - #83863) (fritzbox docs)
- 使用 async_migrate_paypal_agreement 函数获取迁移 URL (@ludeeus - #83469) (cloud docs)
- 修复 Overkiz Domestic Hot 热水器实体在离家模式下的问题 (@nyroDev - #83684) (overkiz docs)
- 将 pyoverkiz 升级到 1.7.2 (@nyroDev - #83866) (overkiz docs)
- 修复 HAOS 9.4 且仅使用代理时 bleak-retry-connector get_device 卡住的问题 (@bdraco - #83879) (蓝牙 docs)
- 修复实体存在重复来源时 HomeKit 媒体播放器的问题 (@bdraco - #83890) (homekit docs)
发布 2022.12.5 - 12 月 13 日
- 修复 Just Nimbus 错误码问题 (@kvanzuijlen - #83856) (justnimbus docs)
- 修复 BraviaTV 中忽略来源缺失时保存选项的问题 (@Drafteed - #83891) (braviatv docs)
- 将 pychromecast 升级到 13.0.4 (@emontnemery - #83896) (cast docs)
- 更新 前端 to 20221213.0 (@bramkragten - #83940) (前端 docs)
发布 2022.12.6 - 12 月 14 日
- 不再为 ingress 添加 Content-Type 头 (@zeehio - #83425) (hassio docs)
- 将 lupupy 依赖升级到 v0.2.3 (@majuss - #83765) (lupusec docs)
- 将 aioshelly 升级到 5.1.2,修复重连后状态更新不触发的问题 (@bdraco - #83950) (shelly docs)
- 将 aioesphomeapi 升级到 13.0.2,修复错误 protobuf 消息后的重连问题 (@bdraco - #83951) (esphome docs)
- 忽略某些设备触发器校验错误 (@emontnemery - #83972) (device_automation docs)
发布 2022.12.7 - 12 月 17 日
- 将 pySwitchbot 升级到 0.23.2 (@bdraco - #84002) (switchbot docs)
- 重新添加缺失的 Growatt TLX 数值 (@muppet3000 - #84040) (growatt_server docs)
- 更新 前端 to 20221213.1 (@bramkragten - #84058) (前端 docs)
- 将 govee-ble 升级到 0.19.3 (@bdraco - #84062) (govee_ble docs)
- 更新 Tibber 库,改进实时流 (@Danielhiversen - #84065) (tibber docs)
- 将 蓝牙-auto-recovery 升级到 1.0.3 (@bdraco - #84075) (蓝牙 docs)
- 确保 philips_hs 遥控实体调用已添加父级 (@elupus - #84082) (philips_js docs)
- 将 ical 升级到 4.2.3 (@allenporter - #84104) (local_calendar docs)
- 修复 Synology DSM 中检测 Surveillance Station 可用性的检查问题 (@mib1185 - #84140) (synology_dsm docs)
- 修复 KNX ConfigFlow 手动安全隧道密钥问题 (@farmio - #84155) (knx docs)
发布 2022.12.8 - 12 月 21 日
- 为 Overkiz Atlantic 电暖器添加缺失的预设 (@nyroDev - #84080) (overkiz docs)
- 修复 connectable 蓝牙设备在扫描器恢复后不可用的问题 (@bdraco - #84172) (蓝牙 docs)
- 将 ical 升级到 4.2.4 (@allenporter - #84248) (local_calendar docs)
- 将 蓝牙-data-tools 升级到 0.3.1 (@bdraco - #84258) (蓝牙 docs) (led_ble docs)
- 跳过值为 None 的客户端元数据 (@ludeeus - #84293) (cloud docs)
- 改进 Tibber rt Pulse 流式传输 (@Danielhiversen - #84313) (tibber docs)
- 修复 prometheus 导出器中的属性检查问题 (@mib1185 - #84321) (prometheus docs)
发布 2022.12.9 - 1 月 2 日
- 在 hassio 插件管理器中处理不可用插件 (@MartinHjelmare - #84943)
- 修复失败的 HomeKit Controller 诊断测试 (@bdraco - #84936)
需要帮助吗?加入社区!
Home Assistant 拥有一个非常棒的用户社区,大家都非常乐于互相帮助。 欢迎加入我们!
我们非常活跃的 Discord 聊天服务器是交流的绝佳去处, 也别忘了加入精彩的论坛。
发现 bug 或问题了吗?请到我们的 issue tracker 提交反馈,帮助我们修复它!你也可以查看帮助页面获取更多指导, 了解还能去哪些地方寻求帮助。
你更喜欢邮件吗?订阅我们的 Building the Open Home Newsletter, 把最新功能资讯、社区动态,以及更多关于构建开放家庭的新闻 直接发送到你的收件箱。
向后不兼容的变更
Cloudflare 集成不再依赖 ipify.org 来确定你的 IP, 而是改为使用 whoami 服务。
这意味着,如果你的网络此前只放行了对应流量, 你需要调整配置以适配新的情况。
此前已弃用的 guardian.disable_ap 和 guardian.enable_ap 服务,
以及对应的二元传感器现已移除。
Glances 配置中的扫描间隔(scan_interval)选项已移除,
更新间隔将使用默认值(60 秒)。
如果你已经配置过 Glances 集成,之前保存的间隔选项仍会继续使用。 若要恢复默认更新间隔,你需要重新添加该集成。
你可以在自动化中使用 homeassistant.update_entity 服务,
实现自定义更新间隔。
如果媒体播放器分组中包含提供无效媒体播放器实体状态的播放器, 该分组现在会报告为 “Unknown” 状态。
有效媒体播放器状态列表可在我们的 开发者文档中查看。
HERE Travel Time 集成现在使用 HERE API v8。
Travelmode publicTransportTimeTable 已合并为 publicTransport。
你的配置会自动迁移;
无需手动操作。
单位系统不再由 HERE Traveltime 集成的选项设置控制, 而是改为使用可按实体配置的内置自定义单位。
距离传感器现在默认使用千米, 如果你之前使用英制单位,需要手动重新配置。
videoloss 事件已从支持列表中移除。该事件一直被多数 Hikvision 设备 用作 keep-alive,库内部也会使用它。如果将它作为可选项保留启用, 一旦事件真的被处理就会导致整体异常,因此为避免混淆而将其移除。
你需要移除 YAML 配置中为 videoloss 事件设置的任何自定义选项, 并且该集成将不再生成 videoloss 实体。
如果你在自动化或脚本中使用了这些实体, 需要更新相关配置并移除这些实体的引用。
Home Assistant 与 HomeKit 之间的 HomeKit 空气质量 PM10 映射 已更新为最新的 US AQI standard。
select 实体的 PowerOff 状态将更改为 power_off。
如果你在自动化或脚本中依赖该状态值, 请务必据此调整。
移动应用扫描 Tag 时触发的事件此前包含错误的设备 ID; 该问题现已修复。
因此,这些事件现在会包含不同但正确的设备 ID。 如果你在自动化中依赖设备 ID,可能需要按新 ID 调整配置。
用于在 Modbus 温控集成(2022.11 引入)中定义 HVAC 模式的映射键名称
已发生变化。这是为了修复 off 键的问题,因为它在 YAML 中有不同含义。
不再使用:
现在你需要使用:
在 platform 键(如 light)下配置 MQTT 实体的 YAML 方式,
已在 Home Assistant 核心 2022.6 中弃用,现已不再受支持。
相关配置必须改为放在 mqtt 键下。
旧版 MQTT 设备追踪器已不再受支持。 请参阅文档了解受支持的 MQTT 设备追踪器配置方式。
从这个版本开始,你应当为所有手动配置的 MQTT 实体使用新版配置 schema。 请注意,这不会影响 MQTT discovery,例如 Zigbee2MQTT。
MQTT 摄像头中设为 b64 的 encoding 配置选项此前已弃用,
现在已成为无效配置。
现在应使用新的 image_encoding 配置选项来设置 Base64 编码。
请改用新的 image_encoding 参数(设置为 b64)。
此前已弃用的 openuv.update、openuv.update_uv_index 和
openuv.update_protection_data 服务现已移除。
此前已弃用的 Radarr 集成 YAML 配置方式已移除。
Radarr 现在通过 UI 配置,现有 YAML 配置已在此前版本完成导入, 你现在可以安全地从 YAML 配置文件中移除相关内容。
此前已弃用的 extra_water_on_hot_days 和 freeze_protection
二元传感器,以及 freeze_protection_temperature 传感器现已移除。
充电功率传感器的计量单位已修正。 由于单位发生变化,这会触发长期统计警告, 你需要在统计开发者工具中手动处理。
你需要通过调整之前的单位来解决分析警告。
Risco 区域中的 bypassed 属性已移除,并改为使用开关实体。
对应服务也已移除,你现在可以使用常规开关服务
(分别是 turn_on 和 turn_off)来旁路和取消旁路区域。
例如,如果你原本这样调用:
你可以替换为:
此前已弃用的 simplisafe.clear_notifications 服务现已移除。
statistics 传感器中的 quantiles 特性已移除,
并由更灵活的 percentile 特性替代。
如果你使用了 quantiles 特性,
需要调整传感器配置,改用 percentile 特性重建相同数值。
(@ThomDietrich - #81749) (文档)
statistics 传感器的配置已发生变化:
state_characteristic 配置项现在是必填项。
sampling_size 配置项现在是可选项,且不再默认使用固定值 20。
你现在可以根据使用场景定义 sampling_size、max_age,或同时定义两者。
现有传感器不会因这项变更而改变行为。不过,你可能需要检查当前定义的传感器
是否配置了有意义的 sampling_size,或是否希望彻底移除该设置。
(@ThomDietrich - #81749) (文档)
Subaru API 已变更,不再返回以下两个传感器所需的值:
- 外部温度
- 12V 电池电压
这些传感器已从 Subaru 集成中移除。
由于 2022.11 已引入新的 PoE 实体,本次发布中, 这些实体所替代的旧版且问题较多的 PoE 客户端实现已被移除。 升级后会自动删除旧实体。
请注意,新 PoE 实体默认是禁用的, 它们表示每个支持 PoE 的端口,而不会映射到具体客户端。
如果你是自定义集成或主题开发者,并希望了解与你的集成相关的 向后不兼容变更和新特性:请务必关注我们的开发者博客。 以下是本次发布中最值得关注的内容:
告别以下内容
以下集成也已在本次发布中下线:
- Google Chat 已移除。它依赖 Google Hangouts API, 而该 API 已关闭,导致该集成无法继续使用。
所有变更
当然,这次发布还有更多内容。你可以在这里查看完整变更列表: Home Assistant Core 2022.12 完整更新日志


