2022.2：让我们开始化繁为简！

    现在说这个也许有点晚了，毕竟已经 2 月了……但既然这是今年的第一篇发布，我还是要说一句：

    新年快乐 🥂

    而且，因为我们跳过了 1 月发布，这次更新也就变成了一个大版本。超过 2500 次贡献，让这次发布成为我们至今推出过规模最大的一次！其中还包含 15 个全新集成，以及 13 个现有集成现在已经可以直接通过用户界面进行设置。

    看到“向后不兼容变更”那一节时先别被吓到。内容确实很多，但大多数只是清理旧弃用项，或者是因为功能迁移到了 UI。用一次大扫除来开启新的一年，没有比这更合适的方式了 🧹

    对了，如果你错过了，@balloob 上周发布了一篇关于 Home Assistant 2022 年重点方向的博客：Streamlining Experiences。我对此非常兴奋，也很期待这一年会把 Home Assistant 带向哪里！冲吧，2022！

    你今年为自己的智能家居立下了什么新年计划？

    祝你享受这次发布！

    ../Frenck

    Nabu Casa 近况更新

    在深入介绍这次发布之前，我们想先和你分享一些来自 Nabu Casa 的新闻与更新。

    美国现已支持年付订阅

    Home Assistant Cloud 的年付订阅能力， 自 Nabu Casa 成立以来一直是呼声最高的功能之一，并已在 12 月的 开放家庭现状 活动中宣布。

    从今天起，美国用户已经可以订阅 Home Assistant Cloud 年付方案了。🎉

    Read more about the announcement on the Nabu Casa website

    基础设施改进

    Nabu Casa 的新支付系统，是其正在逐步上线的全新云平台的一部分， 这也将为 Home Assistant Cloud 服务带来更多改进。

    他们已经改进了远程访问基础设施，确保请求会尽可能路由到离你更近的位置。 上周他们还上线了更多基础设施优化，显著提升了 Google Assistant 和 Amazon Alexa 集成的速度。

    Zack Barett 和 Mike Degatano 加入 Nabu Casa

    我们也很高兴宣布，Zack Barett 和 Mike Degatano 将加入 Nabu Casa， 共同参与 Home Assistant 的开发。

    Zack 将参与 Home Assistant 的多个方向， 包括 Home Assistant YouTube 频道 以及 Home Assistant 前端。

    Mike 则会专注于扩展和改进 Home Assistant Supervisor 及其周边生态（例如内部插件和附加组件）。

    欢迎加入！很高兴你们来到团队中！🎉

    媒体体验改进

    媒体浏览器现在被重命名为“媒体”。简单、直接，也更清爽。

    此外，它现在在底部加入了一个漂亮的媒体控制栏，用于控制当前正在播放的内容：

    Screenshot showing media with the new media bar

    媒体浏览体验也得到了改进，并扩展了新的能力。浏览媒体时，浏览器地址栏中的 URL 会随之变化， 因此你现在可以把这些页面加入书签。某个集成也可以浏览由其他集成提供、且受支持的媒体来源。

    例如，如果你已经设置了 Spotify 和 Sonos 集成， 现在就可以浏览你的 Spotify 内容并直接在 Sonos 设备上播放； Cast 现在也支持直接从浏览器播放 Plex 媒体。

    Sonos、VLC（通过 Telnet）和 Roku 也新增了本地媒体播放支持！ 如果再结合 VLC 附加组件使用，你甚至可以把 Home Assistant 设备变成一个本地媒体播放器。 下面的视频里，Zack 会演示这是如何实现的：

    检查更新

    在 Home Assistant Core、Operating System 或附加组件发布公告之后， 我们经常会看到一个问题：“为什么我还看不到更新？我要怎么更新？”

    系统会每隔几小时自动检查一次更新。 不过，有时你可能不想等它自动完成，而是希望立刻手动检查。

    这也让我们意识到，过去不同部分的更新检查入口分散在各处，不太容易找到。 因此，我们在主配置页面中加入了一个简单直观的“检查更新”按钮。

    Screenshot showing the new Check for Updates button in the 配置 screen Checking for any 更新 is now just a single click.

    该功能目前适用于 Home Assistant OS 和 Home Assistant 受监管模式安装方式。

    集成与设备的诊断功能

    To make debugging and reporting issues with 集成 or 设备 easier, both in terms of reporting it, and for 开发者 to fix them, we introduce: Diagnostics.

    Diagnostics can be provided by 集成 and allow you to download diagnostic information about an 集成 or 设备 you have set up.

    Screenshot showing the Download Diagnostics button on a Sonos 设备 page Screenshot of the Download Diagnostics button on the 设备 page

    The downloadable diagnostics file can be viewed as a text file, and can be shared when reporting an issue in our issue tracker.

    Diagnostics data can be extremely helpful in finding the root causes of an issue and getting them fixed. As a Matter of fact, it helped us pinpointing and fixing issues during the beta of this 发布.

    The good news is that 61! 集成 already added support for this new diagnostics feature, including Z-Wave JS, ESPHome, Sonos, Shelly, WLED, Unifi, Nest, deCONZ, KNX, Tuya, Roku, Samsung TV, and many more!

    查找已知问题以及报告新问题的位置

    Are you experiencing an issue with an 集成? Want to know if your issue is already known and reported? Or, maybe you are not sure where our issue tracker can be found?

    We added a small menu option to each 集成, helping with that.

    Screenshot showing the 已知问题 menu item an 集成 卡片 Clicking the "已知问题" item will open up our issue tracker for 此integrations.

    This button will bring you to our issue tracker, showing all currently known and open issues for 此integrations.

    Is your issue not listed? Well, if 此integrations提供 diagnostics, download those. Next, go back to issue tracker, using the new 已知问题 link, and click the "New issue" button in the top right corner to report your issue. Fill out the form and attach the diagnostics file by dragging and dropping it into the form.

    改进设备追踪器实体的处理方式

    If you run an 集成 that provides 设备 trackers from your router or something like the UniFi Network 集成, you are probably aware those can create many 实体!

    This has been improved now. As of today, by default, only 设备 tracker 实体 that match up with an existing - known by Home Assistant - 设备 will be enabled by default. This keeps Home Assistant nice and tidy.

    If Home Assistant does not know the 设备, but you still would like to track a specific one, that is still possible. In that case, you can enable the particular 设备 tracker 实体 you’d like to have.

    场景现在也有状态了

    场景 never had a 状态, well that is not entirely true, it would always say: "scening".

    To make the 状态 of a 场景 more valuable, it will now have the last timestamp of when the 场景 was activated. This has a couple of advantages:

    • You can see when a 场景 was last activated.
    • History of when a 场景 was activated in the logbook, and who did that.
    • You can now automate on a 场景 being activated.

    The last one is pretty useful as a 场景 can now be used to 触发器 even more 动作 via 自动化. For example, you could start playing media or send a TTS announcement when a 场景 activated.

    Screenshot of the logbook of a 场景 Now the 场景 has a 状态; it also got logbook entries.

    在配置面板中搜索

    There is now a search in the top right of the 配置 仪表盘, which opens the Quick Bar. This also works on mobile 设备.

    It allows you to access and search forst about anything within Home Assistant. From accessing add-ons, 配置 面板, and even 实体 and 设备.

    Screenshot showing the new search in the 配置 screen

    Tip: Did you know you can press c (for command) and e (for 实体) on you keyboard from anywhere in Home Assistant to bring up that same Quick Bar?

    按钮辅助器与模板

    In the previous 发布, we introduced the button 实体. One of the most asked questions about the button has been: "How can I create my own button 实体?"

    This 发布 introduces the button helper, and those can be 创建 via the UI and using YAML ( as the input_button).

    These button helpers can be used to 触发器 自动化 and we have ensured they work with Alexa, Google Assistant, and HomeKit.

    Additionally, there is now a template 实体 for buttons available as well. Here is an example:

    # Example configuration.yaml
template:
  button:
    - name: "Send message"
      press:
        - service: notify.frenck
          data:
            message: "My button has been pressed!"

    模板增强

    There are a couple of nice enhancements to this 发布 for the more advanced use cases that stand out.

    Shorthand 条件 notations in 动作

    Shorthand 条件 notations are pretty helpful and are now supported in 条件 动作; For use in 自动化 and 脚本.

    For example:

    sequence:
  - condition: ""

    Immediate if (iif)

    We now have an immediate if (iif) template function and filter that can be used as a short alternative 版本 to an if/else statement.

    These can help shortening a lot of if/else constructs that for example, return a "Yes" or "No" (or similar) value in templates. Some examples:

    其他值得注意的变化

    There is much more juice in this 发布; here are some of the other noteworthy changes this 发布:

    • When an 集成 has a single 设备, clicking on the "1 设备" link will now navigate to that 设备 directly and skip the addition page with a table showing 1 item. This makes navigating those cases quicker, thanks @balloob!

    • There is now a tiny menu on discovered 设备 and 服务, which allows you to visit the 设备/服务 and find the 文档 that belongs to this discovered item.

      Screenshot showing the new menu on a discovered item

    • Editing 触发器 IDs in 自动化 has moved into the 触发器 menu, making the 自动化 editor a little more compact.

      Screenshot showing the moved 触发器 ID feature

    • When viewing backups, it will now display the size of each 备份 in the table. Thanks, @ludeeus!

    • Thanks to @bramkragten, you can now select the period in the options of the statistics 卡片.

    • The Apple TV 集成 has been updated to support tvOS 15 and can now launch apps too! Thanks, @postlund!

    • Thanks to @bdraco, a 设备 can now also display its hardware 版本 in Home Assistant. The HomeKit, Xiaomi Miio, Bond, Roku, and WLED 集成 have already adopted this.

    • The Google Assistant 集成 can now be set up to use local fulfillment, thanks to @LoekSangers! Please note that this only applies to manual setups. This is already handled automatically when using the Home Assistant Cloud.

    • ZHA 设备 now have identify buttons, so you know which 灯光 you are dealing with, thanks @dmulcahey! (Tip: also nice for visual 通知)

    • We now enable Low Latency HLS (LL-HLS) by default to lower stream latency. Also, stream can now generate still images from a video feed. Generic 摄像头 can now use this and can be set up without the still_image_url option. FFmpeg 摄像头 users can consider using this as an alternative as it does not require multiple simultaneous 摄像头 connections. Thanks @uvjustin and @allenporter!

    • Magic Home (also known as FluxLED) had lots of improvements of love from @bdraco!

    • @Danielhiversen added support for local access to Adax and Mill heaters. Nice!

    • Tuya now supports Pet Feeders (thanks @vauriga), Circuit Breakers (thanks @slydiman), and 报警 (thanks @leeyuentuen). Additionally, support for 风扇 has been improved.

    • The generic thermostat 集成 now supports presets, thanks @brianegge!

    • Home Connect added support for refrigerators and cook processors, thanks @BraveChicken1 and @noxhirsch

    • @Shutgun added support for sirens to devolo Home Control.

    • Tibber added 传感器 for estimated hourly and monthly consumption, costs, and more! Thanks, @Danielhiversen!

    • We now have a slugify template filter, thanks to @ZephireNZ!

    • @Petro31 make is_number available as tests in templates.

    • Volumio has now repeat, repeat, repeat, ... support. Thanks, @m4rkireland!

    • @marcelveldt added a 服务 to the Hue 集成 for setting more advanced 场景 options. Thanks!

    • Sonos now has a 二元sensor that can tell you if the microphone is on or off. Helpful for a 通知 in case it shouldn't be on or off. Thanks, @jjlawren!

    • @sebfortier2288 add support for tilt 设备 to Soma. Nice!

    • Google Assistant now supports the curtain 设备 classes, thanks @emontnemery!

    • If you are using Synology DSM connected 摄像头, you can now select the quality of the snapshots taken. Thanks, @mib1185!

    • A whole bunch of 实体 have been added to 配置 Yamaha MusicCast, really nice @micha91!

    • Environment Canada now has an AQHI 传感器. Thanks, @gwww!

    And honestly, this list is far from complete! There is so much this 发布. Feel free to check and search the "All Changes" section to find more!

    This 发布 adds support for long-term statistics to the following 集成:

    And the following 集成 now have 实体 categories:

    新集成

    We welcome the following new 集成 this 发布:

    现在可通过 UI 设置的集成

    The following 集成 are now available via the Home Assistant UI:

    发布 2022.2.1 - February 3

    发布 2022.2.2 - February 4

    发布 2022.2.3 - February 6

    发布 2022.2.4 - February 8

    发布 2022.2.5 - February 9

    发布 2022.2.6 - February 11

    发布 2022.2.7 - February 15

    发布 2022.2.8 - February 16

    发布 2022.2.9 - February 18

    需要帮助？

    ...欢迎随时使用我们非常活跃的论坛，或加入我们的 chat 聊聊。

    如果你遇到了这个发布引入的问题，请在我们的 issue tracker 中反馈。请务必填写问题模板中的所有字段。

    不向后兼容的变更

    以下是这个发布中的破坏性变更清单，按主题或集成分类。 选择其中任意一项，即可阅读该项目的详细破坏性变更说明。

    Energy 仪表盘的配置位置已调整。

    它之前位于配置页面中的一个菜单项， 现在已经移动到“仪表盘”菜单项下。

    这样一来，所有仪表盘的配置都集中在一个位置。

    (@zsarnett - #11386)

    此前已弃用的 Python 3.8 支持现已移除。 Home Assistant 现在要求使用 Python 3.9 运行。

    如果你使用的是 Home Assistant OS、Home Assistant 容器，或 Home Assistant 受监管模式安装方式，则无需执行任何操作。在这些场景下， 我们已为你处理好一切。你的系统其实已经使用 Python 3.9 有一段时间了。

    (@frenck - #63883)

    从这个发布开始，所有直接与 GPIO 交互的集成都已被弃用。

    原因有很多，其中之一是这些集成整体使用率较低。 对于大多数 Home Assistant 安装来说，GPIO 并不容易使用， 而且这类集成往往缺乏维护。

    更多信息请参阅 架构决策记录 0019。

    此外，当前也有许多项目比 Home Assistant 更适合处理 GPIO 相关场景。例如我们的姊妹项目 ESPHome， 以及 MQTT IO 项目等。

    我们并不是禁止使用 GPIO，而是仅弃用并移除核心内置的 GPIO 功能集成。 我们欢迎自定义集成（现有的或新的）来提供替代方案。 不过在大多数场景下，我们更推荐使用专用硬件，比如 ESP 设备。

    以下集成已被弃用，并将在 Home Assistant 核心 2022.4 中移除：

    • BeagleBone Black GPIO
    • BH1750
    • Blinkt!
    • Bosch BME280 Environmental 传感器
    • Bosch BME680 Environmental 传感器
    • Bosch BMP280 Environmental 传感器
    • DHT 传感器
    • Enviro pHAT
    • HTU21D(F) 传感器
    • mcp23017
    • MH-Z19 CO2 传感器
    • Orange Pi GPIO
    • pcal9535a
    • pi4ioe5v9xxxx
    • PiFace Digital I/O (PFIO)
    • Piglow
    • pigpio Daemon PWM LED
    • 树莓派 RF
    • Rasphihats
    • Sense HAT
    • Sensirion SHT31
    • Time of Flight

    以下集成已被弃用，并将在 Home Assistant 核心 2022.6 中移除：

    • 1-Wire (SysBus only!)
    • 树莓派 GPIO

    注意：1-Wire 是一个特殊情况，它同时支持 SysBus 和连接远程 owfs 服务器。 其中 SysBus 用法已弃用，但连接远程 owfs 服务器不受影响。

    更新：有开发者告知我们，树莓派 GPIO 集成将通过 HACS 提供。

    此前，binary_sensor 实体可拥有 on、off 状态， 在设备不可达时为 unavailable。

    不过，与其他实体相比，它原本不支持 unknown 状态， 而这个发布已添加该状态。

    因此，binary_sensor 实体现在可以拥有 on、off、unavailable 或 unknown 状态。

    你可能需要调整自动化或脚本，以处理这个新的 unknown 状态。

    (@frenck - #60193) (binary_sensor docs)

    分组门锁的行为已反转：unlocked 现在映射为 on，locked 映射为 off。

    这意味着：

    • 如果一个跨域分组中包含门锁，只要其中任意门锁处于解锁状态，该组就会被视为 on。
    • 如果一个纯门锁分组中任意门锁处于解锁状态，该组就会被视为“unlocked”。

    (@emontnemery - #62580) (门锁 docs) (group docs)

    此前，基于切换的实体（如 fan、light、switch、remote、siren、vacuum、humidifier）可拥有 on 或 off 状态，在设备不可达时为 unavailable。 但与其他实体相比，切换实体原本不支持 unknown 状态，现在这一点已改变。

    目前，基于切换的实体可以拥有 on、off、unavailable 或 unknown 状态。

    你可能需要调整自动化或脚本，以处理这个新的 unknown 状态。

    (@frenck - #64621)

    Home Assistant 不再支持管理 PID 文件或创建守护进程。 使用自定义核心或容器安装的用户，可能需要更新启动脚本。

    hass 命令不再支持 --runner 选项。 现在从 UI 请求重启时，程序始终会以退出码 100 退出。 你需要更新启动脚本来处理重启，例如我们的 Systemd 服务示例。

    根据 ADR-0016，如果不是在受支持的操作系统上启动， Home Assistant 会立即退出。受支持系统为 Linux（含 WSL）或 OSX。 我们新增了命令行参数 --ignore-os-check，用于覆盖此检查。

    (@emontnemery - #64345) #64347) #64352)

    advantage_air.set_myzone 服务已弃用， 并将在未来版本的 Home Assistant 中移除。

    在受支持系统上，请改为在 MyZone 的 select 实体上使用 select.select_option 服务来修改该值。

    (@Bre77 - #58777) (advantage_air docs)

    Android TV 集成已迁移到通过 UI 进行配置。 通过 YAML 配置 Android TV 现已弃用， 并将在未来的 Home Assistant 发布中移除。

    升级到此发布时，你现有的 YAML 配置会被自动导入； 因此升级后可以安全地从 YAML 配置中移除。

    /api/discovery_info 端点已在 2021.10 弃用， 此后它只会返回空值。从这个版本开始， /api/discovery_info 端点已被完全移除。

    (@ludeeus - #64534) (api docs)

    Apple iCloud 集成在更早前的发布中已迁移为通过 UI 配置。 现在，通过 YAML 配置 Apple iCloud 也已弃用， 并将在未来的 Home Assistant 发布中移除。

    你现有的 YAML 配置已经自动导入； 因此可以安全地从 YAML 配置中移除。

    (@epenet - #63875) (icloud docs)

    Apple Push 通知服务（APNS）集成已弃用， 并将在 Home Assistant 2022.4 中移除。 请注意，这不会影响我们的移动端 Companion App， 因为它们的通知并不依赖此集成。

    (@frenck - #64629) (apns docs)

    此前已弃用的 Aurora ABB PowerOne Solar PV 集成 YAML 配置 现已移除。

    Aurora ABB PowerOne Solar PV 现在通过 UI 配置。 任何现有 YAML 配置都已在之前的版本中导入， 现在可以安全地从 YAML 配置文件中移除。

    (@tkdrob - #62317) (aurora_abb_powerone docs)

    此前已弃用的 AVM FRITZ!Box Tools 集成 YAML 配置 现已移除。

    AVM FRITZ!Box Tools 现在通过 UI 配置。 任何现有 YAML 配置都已在之前的版本中导入， 现在可以安全地从 YAML 配置文件中移除。

    @epenet - #63857) (fritz docs)

    reboot 与 reconnect 服务已弃用，并将在未来发布中移除。 请改用新提供的 button 实体。

    (@chemelli74 - #61483) (fritz docs)

    lock 和 devicelock 属性已从所有实体中移除， 现在会以独立传感器形式提供。

    (@mib1185 - #60426) (fritzbox docs)

    Azure Event Hub 集成已迁移到通过 UI 进行配置。 通过 YAML 配置 Azure Event Hub 现已弃用， 并将在未来的 Home Assistant 发布中移除。

    升级到此发布时，你现有的 YAML 配置会被自动导入； 因此升级后可以安全地从 YAML 配置中移除。

    (@eavanvalkenburg - #61155) (azure_event_hub docs)

    charging_time_remaining（小时）已被 charging_end_time（时间戳）替代， 以减少 Home Assistant 状态机中的冗余。

    你可能需要根据此变更调整自动化或脚本。

    (@rikroe - #60942) (bmw_connected_drive docs)

    所有 bmw_connected_drive.* 服务都已弃用。 请改用新的 button 实体，并通过 button.press 服务调用。

    (@rikroe - #63136) (bmw_connected_drive docs)

    自定义服务 start_increasing_brightness、start_decreasing_brightness 和 stop 现已弃用，并将在未来发布中移除。

    请改用用于替代它们的新 button 实体。

    (@bdraco - #64725) (bond docs)

    此前已弃用的 Broadlink 集成 YAML 配置 现已移除。

    Broadlink 现在通过 UI 配置。 任何现有 YAML 配置都已在之前的版本中导入， 现在可以安全地从 YAML 配置文件中移除。

    (@tkdrob - #62341) (broadlink docs)

    此前已弃用的 CO2 Signal 集成 YAML 配置 现已移除。

    CO2 Signal 现在通过 UI 配置。 任何现有 YAML 配置都已在之前的版本中导入， 现在可以安全地从 YAML 配置文件中移除。

    (@tkdrob - #62343) (co2signal docs)

    CPU Speed 集成已迁移到通过 UI 进行配置。 通过 YAML 配置 CPU Speed 现已弃用， 并将在未来的 Home Assistant 发布中移除。

    升级到此发布时，你现有的 YAML 配置会被自动导入； 因此升级后可以安全地从 YAML 配置中移除。

    (@frenck - #62929) (cpuspeed docs)

    此前已弃用的 DLNA Digital Media Renderer 集成 YAML 配置 现已移除。

    DLNA Digital Media Renderer 现在通过 UI 配置。 任何现有 YAML 配置都已在之前的版本中导入， 现在可以安全地从 YAML 配置文件中移除。

    (@tkdrob - #62344) (dlna_dmr docs)

    DNS IP 集成已迁移到通过 UI 进行配置。 通过 YAML 配置 DNS IP 现已弃用， 并将在未来的 Home Assistant 发布中移除。

    升级到此发布时，你现有的 YAML 配置会被自动导入； 因此升级后可以安全地从 YAML 配置中移除。

    (@gjohansson-ST - #62843) (dnsip docs)

    继电器和红外灯光开关已移除，并替换为对应的 button 实体。 任何通过这些开关来“打开”它们的脚本或自动化， 都应改为按下对应的按钮实体。

    (@flacjacket - #63995) (doorbird docs)

    适用于 DSMR 2.2 和 4 版本的 sensor.energy_consumption_total 传感器 已被移除。这些版本的电表本身不提供该数据， 因此可以安全删除该传感器。 你可能还需要清理设置中遗留的孤立实体。

    (@rhpijnacker - #63436) (dsmr docs)

    此前已弃用的 Efergy 集成 YAML 配置 现已移除。

    Efergy 现在通过 UI 配置。任何现有的 YAML 配置 都已在此前版本中自动导入， 现在可以安全地从 YAML 配置文件中删除。

    (@tkdrob - #61520) (efergy docs)

    此前已弃用的 Enphase Envoy 集成 YAML 配置 现已移除。

    Enphase Envoy 现在通过 UI 配置。任何现有的 YAML 配置 都已在此前版本中自动导入， 现在可以安全地从 YAML 配置文件中删除。

    (@tkdrob - #61840) (enphase_envoy docs)

    此前已弃用的 Environment Canada 集成 YAML 配置 现已移除。

    Environment Canada 现在通过 UI 配置。任何现有的 YAML 配置 都已在此前版本中自动导入， 现在可以安全地从 YAML 配置文件中删除。

    (@tkdrob - #61839) (environment_canada docs)

    这些传感器不再提供额外状态属性 Timestamp， 请改用新的 timestamp 传感器， 可用于跟踪状态变化的自动化。

    告警传感器（advisories、endings、statements、warnings 和 watches） 的状态现在表示该类型当前活跃告警数量， 额外状态属性则包含告警文本和告警时间戳。

    这些属性命名为 alert_<x> 和 alert_time_<x>， 其中 <x> 表示告警序号，如 1、2 等。

    (@gwww - #58615) (environment_canada docs)

    这项变更主要影响自定义集成开发者。

    由于所有核心风扇都已使用新的风扇实体模型，兼容层现已移除。 尚未迁移到新风扇模型的自定义集成可能会受到影响。更多信息见：

    https://开发者.home-assistant.io/docs/core/entities/风扇/#deprecated-properties

    为给用户留出更多时间更新自动化， 预设模式和百分比值在 2022.3 前仍会继续回译为旧版速度。

    (@bdraco - #59781) (风扇 docs)

    能耗数值现已作为独立传感器实体提供， 因此其他实体中的状态属性 current_energy_kwh 已被移除。

    如果你依赖状态属性 current_energy_kwh， 需要改为使用新的能耗传感器。

    (@rappenze - #63697) (fibaro docs)

    此前已弃用的 Flume 集成 YAML 配置已被移除。

    Flume 现在通过 UI 配置。任何现有 YAML 配置都已在此前版本中导入， 现在可以安全地从 YAML 配置文件中删除。

    (@tkdrob - #61517) (flume docs)

    该集成现在要求 FortiOS 6.4.3 或更高版本。

    (@kimfrellsen - #61970) (fortios docs)

    此前已弃用的 Foscam 集成 YAML 配置 现已移除。

    Foscam 现在通过 UI 配置。任何现有 YAML 配置 都已在此前版本中自动导入， 现在可以安全地从 YAML 配置文件中删除。

    (@tkdrob - #61761) (foscam docs)

    foursquare.checkin 事件关联的数据， 现在可通过键为 text 的字典项获取。

    如果你在自动化或脚本中使用该事件， 需要相应调整以适配此变更。

    (@epenet - #63982) (foursquare docs)

    github 传感器平台的 YAML 配置已被移除。

    该配置无法自动迁移， 因此你需要手动从配置文件中删除， 并在集成面板中重新设置。

    此前该集成会为每个仓库创建 1 个传感器， 现在已拆分为多个实体，且大多默认禁用 （你可以按需启用该集成提供的实体）。

    GitHub Enterprise 支持也已移除。

    (@ludeeus - #64190) (github docs)

    此前已弃用的 Google Maps Travel Time 集成 YAML 配置 现已移除。

    Google Maps Travel Time 现在通过 UI 配置。任何现有 YAML 配置都已在此前版本中自动导入， 现在可以安全地从 YAML 配置文件中删除。

    (@tkdrob - #62468) (google_travel_time docs)

    HomeKit 现在会自动排除带有实体类别的实体（例如配置类或诊断类实体）， 除非你明确将其包含在内。

    如需明确包含某个实体：

    • YAML：将实体添加到 include_entities 或 include_entity_globs 过滤字段。
    • UI：在 UI 的包含模式中选择该实体。如果你当前使用排除模式，可额外创建一个使用包含模式的桥接器。

    (@bdraco - #64492) (homekit docs)

    此前已弃用的 Honeywell Total Connect Comfort 集成 YAML 配置 现已移除。

    Honeywell Total Connect Comfort 现在通过 UI 配置。任何现有 YAML 配置都已在此前版本中自动导入， 现在可以安全地从 YAML 配置文件中删除。

    (@tkdrob - #62469) (honeywell docs)

    Home Assistant iOS/macOS 应用支持在通知本身中定义通知动作； iOS 集成中旧的推送分类定义方式现已弃用，并将在 2022.4 移除。

    (@zacwest - #61078) (ios docs)

    此前已弃用的 Keenetic NDMS2 Router 集成 YAML 配置 现已移除。

    Keenetic NDMS2 Router 现在通过 UI 配置。任何现有 YAML 配置都已在此前版本中自动导入， 现在可以安全地从 YAML 配置文件中删除。

    (@epenet - #63860) (keenetic_ndms2 docs)

    Launch Library 集成已迁移为通过 UI 配置。 通过 YAML 配置 Launch Library 现已弃用， 并将在未来的 Home Assistant 发布中移除。

    升级到此版本时，现有 YAML 配置会自动导入， 因此升级后可安全地从 YAML 配置中删除。

    (@DurgNomis-drol - #62416) (launch_library docs)

    当前传感器上的属性已调整。 这些属性名称已更新，以更准确描述所提供的信息 （例如 agency 更名为 provider，该术语更准确）。 同时新增了一些属性，用于提供更多事件发生地点信息。

    stream 属性已迁移到新传感器中， 并更名为 stream_live，因为它表示流是否“正在直播”， 而不是流是否“可用”。

    最后，launch_time 属性也已迁移为独立传感器。 这使我们能够为该新传感器添加发射窗口起止时间等信息作为属性。 该传感器也会包含 stream_live 属性。

    (@DurgNomis-drol - #64203) (launch_library docs)

    LG webOS Smart TV 集成已迁移为通过 UI 配置。 通过 YAML 配置 LG webOS Smart TV 现已弃用， 并将在未来的 Home Assistant 发布中移除。

    升级到此版本时，现有 YAML 配置会自动导入， 因此升级后可以安全地从 YAML 配置中删除。

    打开动作（通过 WakeOnLan 或 HDMI-CEC 打开电视） 此前使用 YAML 服务调用， 现已改为使用自定义自动化触发器 webostv.turn_on， 或在 UI 中配置的设备触发器自动化。

    触发器自动化示例：

    automation:
  trigger:
    - platform: webostv.turn_on
      entity_id: media_player.lg_webos_smart_tv
  action:
    - service: wake_on_lan.send_magic_packet
      data:
        mac: AA-BB-CC-DD-EE-FF

    (@thecode - #64117) (webostv docs)

    此前已弃用的 Logitech Squeezebox 集成 YAML 配置 现已移除。

    Logitech Squeezebox 现在通过 UI 配置。任何现有 YAML 配置都已在此前版本中自动导入， 现在可以安全地从 YAML 配置文件中删除。

    (@tkdrob - #62537) (squeezebox docs)

    此前已弃用的 Magic Home 集成 YAML 配置 现已移除。

    Magic Home 现在通过 UI 配置。任何现有 YAML 配置 都已在此前版本中自动导入， 现在可以安全地从 YAML 配置文件中删除。

    (@tkdrob - #61844) (flux_led docs)

    Media Player Classic Home Cinema（MPC-HC）集成已弃用， 并将在 Home Assistant 核心 2022.4 中移除。

    该集成依据架构决策记录 0004移除。

    (@frenck - #63598) (mpchc docs)

    MQTT 灯光不再支持此前已弃用的 value_template； 请改用 state_value_template。

    (@emontnemery - #62682) (MQTT docs)

    此前 MQTT 温控仅在新模式与当前状态不同时， 才会发布到 hold_command_topic 或 away_mode_command_topic。

    从这个发布开始，MQTT 会始终向两个命令主题发布 （hold_command_topic 与 away_mode_command_topic，若已定义）， 从而让 MQTT 设备接收到的更新更可预测。

    (@jbouwh - #63463) (MQTT docs)

    温控平台的 send_if_off 配置参数已弃用。 该参数用于在当前运行模式为 HVAC_MODE_OFF 时限制发布。

    依赖此功能的应用可能会受到影响。

    (@jbouwh - #63814) (MQTT docs)

    Nanoleaf 集成已在此前发布中迁移为通过 UI 配置。 通过 YAML 配置 Nanoleaf 现已弃用， 并将在未来的 Home Assistant 发布中移除。

    你现有的 YAML 配置已自动导入， 因此可以安全地从 YAML 配置中删除。

    (@milanmeu - #63404) (nanoleaf docs)

    旧版 “Works With Nest API” 已弃用， 并将在 Home Assistant 核心 2022.5 中移除支持； 请改用我们的Smart Device Management API 文档。

    了解原因及可选替代方案。

    (@allenporter - #63027) (nest docs)

    此前已弃用的 NETGEAR 集成 YAML 配置 现已移除。

    NETGEAR 现在通过 UI 配置。任何现有 YAML 配置都已在此前版本中自动导入， 现在可以安全地从 YAML 配置文件中删除。

    (@epenet - #63862) (netgear docs)

    启动充电的服务已弃用， 并由 button 实体替代。

    请将现有自动化中的 nissan_leaf.start_charge 服务， 改为对新的 button.start_NICKNAME_charging 实体调用 button.press。

    nissan_leaf.start_charge 服务现已弃用， 并将在未来发布中移除。

    (@filcole - #62948) (nissan_leaf docs)

    此前已弃用的 Nmap Tracker 集成 YAML 配置 现已移除。

    Nmap Tracker 现在通过 UI 配置。任何现有 YAML 配置都已在此前版本中自动导入， 现在可以安全地从 YAML 配置文件中删除。

    (@epenet - #63863) (nmap_tracker docs)

    此前已弃用的 Nuki 集成 YAML 配置 现已移除。

    Nuki 现在通过 UI 配置。任何现有 YAML 配置都已在此前版本中自动导入， 现在可以安全地从 YAML 配置文件中删除。

    (@tkdrob - #62470) (nuki docs)

    此前已弃用的 OpenGarage 集成 YAML 配置 现已移除。

    OpenGarage 现在通过 UI 配置。任何现有 YAML 配置 都已在此前版本中自动导入， 现在可以安全地从 YAML 配置文件中删除。

    此前已弃用的 Philips TV 集成 YAML 配置 现已移除。

    Philips TV 现在通过 UI 配置。任何现有 YAML 配置都已在此前版本中自动导入， 现在可以安全地从 YAML 配置文件中删除。

    (@tkdrob - #62471) (philips_js docs)

    PVOutput 集成已迁移为通过 UI 配置。 通过 YAML 配置 PVOutput 现已弃用， 并将在未来的 Home Assistant 发布中移除。

    升级到此版本时，现有 YAML 配置会自动导入， 因此升级后可以安全地从 YAML 配置中删除。

    此外，PVOutput 传感器上的所有传感器属性， 都已拆分为各自独立的专用传感器。

    此变更适用于以下 PVOutput 属性：

    • energy_generation
    • power_generation
    • energy_consumption
    • power_consumption
    • efficiency
    • temperature
    • voltage

    如果你的自动化或脚本依赖这些属性， 需要改为使用新的独立传感器。 这些属性目前仍可用，但已弃用，并将在 Home Assistant 核心 2022.4 中移除。

    (@frenck - #62667 #62894) (pvoutput docs)

    ReCollect Waste 不再将“next pickup”信息存储为“current pickup”传感器的属性； 现在两次收运信息都各自拥有独立传感器。

    (@bachya - #62558) (recollect_waste docs)

    此前已弃用的 Stookalert 集成 YAML 配置 现已移除。

    Stookalert 现在通过 UI 配置。任何现有 YAML 配置都已在此前版本中自动导入， 现在可以安全地从 YAML 配置文件中删除。

    (@frenck - #61007) (stookalert docs)

    此前已弃用的 Samsung SyncThru Printer 集成 YAML 配置 现已移除。

    Samsung SyncThru Printer 现在通过 UI 配置。任何现有 YAML 配置都已在此前版本中自动导入， 现在可以安全地从 YAML 配置文件中删除。

    (@tkdrob - #62541) (syncthru docs)

    Sensibo 集成已迁移为通过 UI 配置。 通过 YAML 配置 Sensibo 现已弃用， 并将在未来 Home Assistant 发布中移除。

    升级到此版本时，现有 YAML 配置会自动导入， 因此升级后可以安全地从 YAML 配置中删除。

    (@gjohansson-ST - #60900) (sensibo docs)

    Luftdaten 集成已更名为 传感器.Community； 这也是 Luftdaten 项目的新名称。

    此前已弃用的该集成 YAML 配置 现已移除。

    传感器.Community 现在通过 UI 配置。任何现有 YAML 配置 都已在此前版本中自动导入， 现在可以安全地从 YAML 配置文件中删除。

    (@frenck - #61748 #62865) (luftdaten docs)

    此前已弃用的 SMA Solar 集成 YAML 配置 现已移除。

    SMA Solar 现在通过 UI 配置。任何现有 YAML 配置都已在此前版本中自动导入， 现在可以安全地从 YAML 配置文件中删除。

    (@tkdrob - #62472) (sma docs)

    SolaX Power 集成已迁移为通过 UI 配置。 通过 YAML 配置 SolaX Power 现已弃用， 并将在未来 Home Assistant 发布中移除。

    升级到此版本时，现有 YAML 配置会自动导入， 因此升级后可以安全地从 YAML 配置中删除。

    (@tokenize47 - #56620) (solax docs)

    SwitchBot 集成已在此前发布中迁移为通过 UI 配置。 通过 YAML 配置 SwitchBot 现已弃用， 并将在未来 Home Assistant 发布中移除。

    你现有的 YAML 配置已自动导入， 因此可以安全地从 YAML 配置中删除。

    (@tkdrob - #62583) (switchbot docs)

    reboot 和 shutdown 服务已弃用，并将在未来发布中移除。 请改用新的 button 实体。

    (@mib1185 - #57352) (synology_dsm docs) (breaking-change)

    模板触发的二元传感器应以 unknown 状态启动， 而不是始终以 false/off 启动。 这与其他模板传感器的行为保持一致。

    (@amosyuen - #62769) (template docs)

    此前已弃用的 TP-Link Kasa Smart 集成 YAML 配置 现已移除。

    TP-Link Kasa Smart 现在通过 UI 配置。任何现有 YAML 配置都已在此前版本中自动导入， 现在可以安全地从 YAML 配置文件中删除。

    (@bdraco - #62457) (tplink docs)

    计划时间、预计时间和实际时间这些传感器属性 已修正为 UTC ISO 格式字符串，这也是 Home Assistant 的标准格式。

    此前显示为 2021-12-23T09:07:00， 现在会正确显示为 2021-12-23T09:07:00+00:00。

    这可能影响基于这些属性的模板或自动化。

    (@gjohansson-ST - #62636) (trafikverket_train docs)

    键 host 已从灯光实体的（额外）状态属性中移除。

    (@RobBie1221 - #64139) (twinkly docs)

    Vallox 集成已迁移为通过 UI 配置。 通过 YAML 配置 Vallox 现已弃用， 并将在未来 Home Assistant 发布中移除。

    升级到此版本时，现有 YAML 配置会自动导入， 因此升级后可以安全地从 YAML 配置中删除。

    (@slovdahl - #62780) (vallox docs)

    版本集成已迁移为通过 UI 配置。 通过 YAML 配置版本集成现已弃用， 并将在未来 Home Assistant 发布中移除。

    升级到此版本时，现有 YAML 配置会自动导入， 因此升级后可以安全地从 YAML 配置中删除。

    此外，本地源的版本传感器已移除 source 和 channel 属性。

    (@ludeeus - #54642 #64827) (版本 docs)

    此前版本中，该集成会把 VeSync 插座的功率和能耗使用情况 作为 switch 实体上的状态属性暴露， 使用的是已弃用属性：current_power_w 和 today_energy_kwh。

    在这个版本中，这两个属性已从 switch 实体中移除， 并拆分为两个新的诊断传感器实体， 它们都附属于同一设备。

    基于状态属性机制的自动化和模板实体 应相应更新。

    (@decompil3d - #61837) (vesync docs)

    扫描间隔选项已移除， 因为默认值在几乎所有情况下都足够使用。

    如果你确实需要更细粒度控制， 可在 Viessmann ViCare 集成的系统设置中禁用自动更新， 并通过 homeassistant.update_entity 服务自动轮询相关实体。

    (@oischinger - #63343) (vicare docs)

    如果已集成的 vizio 电视支持应用，且当前输入源为非应用输入 （如 HDMI-1），媒体播放器实体状态中将不再包含 app_id 和 app_name 属性。

    当电视正在使用应用时，app_name 仍会始终显示， app_id 则仍仅在应用无法识别时显示。

    (@raman325 - #64025) (vizio docs)

    此前已弃用的 VLC media player Telnet 集成 YAML 配置 现已移除。

    VLC media player Telnet 现在通过 UI 配置。任何现有 YAML 配置都已在此前版本中自动导入， 现在可以安全地从 YAML 配置文件中删除。

    (@tkdrob - #62542) (vlc_telnet docs)

    此前已弃用的 Waze Travel Time 集成 YAML 配置 现已移除。

    Waze Travel Time 现在通过 UI 配置。任何现有 YAML 配置都已在此前版本中自动导入， 现在可以安全地从 YAML 配置文件中删除。

    (@tkdrob - #62543) (waze_travel_time docs)

    此项仅与自定义集成开发者相关。

    async_sign_path 的参数已变更。刷新令牌现在是关键字参数。 如果作为 HTTP 或 WebSocket 请求的一部分调用， 将自动使用用户的刷新令牌。

    (@balloob - #64337)

    Whois 集成已迁移为通过 UI 配置。 通过 YAML 配置 Whois 现已弃用， 并将在未来 Home Assistant 发布中移除。

    升级到此版本时，现有 YAML 配置会自动导入， 因此升级后可以安全地从 YAML 配置中删除。

    (@frenck - #63069) (whois docs)

    由于架构变更，要求 zwave-js-server 版本为 1.14.0 或更高。 请确保你使用的是最新版本的 zwave-js-server （或提供它的相关附加组件）。

    (@raman325 - #64407) (zwave_js docs)

    这项变更仅影响自定义集成开发者。

    目前 zeroconf 匹配仅支持 macaddress、model、manufacturer 这几个属性，以及 ZeroconfServiceInfo 中的 name。

    由于属性由 zeroconf 服务自由定义， 可命名属性列表会随着时间不断增长。

    现在匹配支持任意自定义属性。 所有属性匹配都必须使用小写，并支持通配符。

    顶层键 model、manufacturer 和 macaddress 在 manifest.json 中现已弃用， 应迁移到 properties 字典中。

    例如：

    -    {"type":"_airplay._tcp.local.","model":"appletv*"}
+    {"type":"_airplay._tcp.local.","properties":{"model":"appletv*"}}

    (@bdraco - #62133) (zeroconf docs)

    告别以下集成

    以下集成从这个发布开始不再可用：

    • TaHoma 已移除。该集成已失效， 现由 Overkiz 集成替代。 (@iMicknl - #62607)
    • Arduino 这个已长期弃用的集成现已移除。 (@frenck - #63406)
    • EE Bright Box 已损坏并停用超过一年， 现已移除。(@epenet - #63839)

    All changes