本地化

Dreame 真空吸尘器卡片原生支持多种语言。它动态使用后端 dreame_vacuum 集成提供的语言文件，而不是维护单独的本地化文件。

该卡片从 dreame_vacuum 集成翻译文件中的 entity_component 部分检索本地化文本值。

翻译键

在语言文件中，卡片主要使用几个以 frontend_ 开头的关键类别来显示其界面：

frontend_action：此部分包含卡片主控制面板上操作按钮中使用的所有文本，例如开始、暂停或回充。
frontend_config：此部分包含视觉卡片配置界面中使用的所有文本标签、描述和设置。
frontend_message：包含卡片上显示的状态消息、警报、错误报告和警告。
frontend_title：涵盖卡片菜单中使用的标题和章节标题，例如 地图管理 或 清扫设置。
entity：此模块涵盖 Home Assistant 实体域，例如 select、sensor、switch、number、time 和 input。该卡片会动态获取这些实体的名称和状态，例如 吸力等级 或静音，直接来自集成，以确保一致性。
- 卡片特定状态：提供仅由卡片界面使用的内部状态翻译，而非 Home Assistant 实体。这包括房间名称（来源于 segment_name 实体），以及特定标识符如 task_type、edit_type、map_type、object_type、furniture_type、obstacle_type、obstacle_reason、task_end_type、task_interrupt_reason、startup_method、cleanup_method 和 recovery_map_type。

除了文本翻译外，该卡片会自动适应本地格式偏好，无需任何手动配置：

语言与区域设置：卡片优先使用 Home Assistant 配置文件中选择的语言。如果未明确设置语言，则自动回退到网页浏览器的默认语言。
12/24 小时制：该卡片遵循 Home Assistant 配置的时间格式。如果未指定，则会自动采用设备所在区域的标准时间格式。
一周的第一天：该卡片直接读取 Home Assistant 的一周第一天设置。如果未定义，会根据本地区域动态决定日历应从星期日还是星期一开始。
单位系统：该卡片会持续检查 Home Assistant 全局配置。如果系统使用英制单位，卡片会自动重新计算区域和距离，并以英尺、平方英尺或码为单位显示。
本地单位翻译：常见的单位后缀和缩写，例如米、千米、英尺、码、分钟和小时，无需手动翻译。卡片使用内置浏览器功能根据当前语言即时翻译。

如果发现拼写错误或翻译不正确，或需要新增语言支持，可以向主 dreame_vacuum 集成仓库贡献。

翻译概括

官方应用在不同设备代中对相同参数经常使用不同术语。翻译必须使用合理、通用的名称，而不是严格复制应用中的原词。这样可以防止为特定代制作的修正被使用不同设备代的用户覆盖，从而造成翻译冲突。

更新流程包括以下步骤：

分叉仓库：在 GitHub 上分叉 Dreame Vacuum Home Assistant 集成仓库。
找到翻译文件：在分叉的仓库中导航到 custom_components/dreame_vacuum/translations/ 目录，查找与语言代码匹配的翻译文件，例如 de.json 或 it.json。
进行更改：更新错误文本。frontend_action、frontend_config、frontend_message 和 frontend_title 块管理与 UI 相关的文本。entity 块管理传感器名称、选择选项及其状态。
提交拉取请求：向主仓库提交拉取请求。拉取请求经过审核并合并到该集成的新版本后，Dreame Vacuum Card 会自动获取更新的翻译。