ローカリゼーション
この統合では、生成されたすべてのエンティティ名と状態の翻訳を、Home Assistantの標準翻訳システムを通じて提供しており、custom_components/dreame_vacuum/translations/*.json に保存されます。これらのファイルは、下流のUIが独自のインターフェーステキストに使用する基本辞書としても機能します。
翻訳の修正または改善
タイプミスや誤った翻訳が見つかった場合、または新しい言語のサポートが必要な場合は、このリポジトリに貢献してください。
翻訳の一般化
公式アプリは、異なるデバイス世代間で同じパラメータに対して異なる用語を頻繁に使用します。翻訳では、アプリの正確な表現をそのままコピーするのではなく、論理的で一般化された名前を使用する必要があります。これにより、特定の世代向けに修正した翻訳が、他のデバイス世代のユーザーによって上書きされてしまうという翻訳の競合を防ぐことができます。
更新手順は次のステップで行います：
- リポジトリをフォークする：GitHubでDreame Vacuum Home Assistant 統合リポジトリをフォークします。
- 翻訳ファイルを見つける：フォークしたリポジトリ内の
custom_components/dreame_vacuum/translations/ディレクトリに移動し、de.jsonやit.jsonなどの言語コードに対応する翻訳ファイルを探します。 - 変更を加える：誤ったテキストを更新します。
configブロックは構成フローおよびオプションフローのテキストを管理します。entityブロックはエンティティ名、選択オプションおよびその状態を管理します。 - プルリクエストを提出：
devブランチへのプルリクエストを開きます。プルリクエストがレビューされ、新しいリリースにマージされると、Home Assistantは自動的に更新された翻訳を取得します。
フロントエンド翻訳
フロントエンド固有の翻訳キーおよび共通のアクションラベルは、言語ファイルのentity_componentブロック内で管理されます。フロントエンド翻訳の構造や、下流のUIコンポーネントによる利用方法の詳細については、Dreame Vacuum Card 翻訳ドキュメントを参照してください。