Lokalisasi

Kartu Vacuum Dreame secara bawaan mendukung beberapa bahasa. Kartu ini secara dinamis menggunakan berkas bahasa yang disediakan oleh integrasi backend dreame_vacuum daripada mempertahankan berkas lokalisasi terpisah.

Kartu mengambil nilai teks lokal dari bagian entity_component dalam dreame_vacuum berkas terjemahan integrasi.

Kunci Terjemahan

Dalam berkas bahasa, kartu ini terutama menggunakan beberapa kategori kunci yang dimulai dengan frontend_ untuk menampilkan antarmukanya:

• frontend_action: Bagian ini berisi semua teks yang digunakan di dalam tombol aksi pada panel kontrol utama kartu, seperti Mulai, Jeda, atau Dock.

• frontend_config: Bagian ini berisi semua label teks, deskripsi, dan pengaturan yang digunakan di dalam UI konfigurator kartu visual.

• frontend_message: Berisi pesan status, peringatan, laporan kesalahan, dan peringatan yang ditampilkan di kartu.

• frontend_title: Meliputi judul dan tajuk bagian yang digunakan dalam menu kartu, seperti Manajemen Peta atau Pengaturan Pembersihan.

• entity: Blok ini mencakup domain entitas Home Assistant seperti select, sensor, switch, number, time, dan input. Kartu ini secara dinamis mengambil nama dan status entitas-entitas ini, seperti Level Hisap atau Senyi, langsung dari integrasi untuk memastikan konsistensi.

  • Status Khusus Kartu: Menyediakan terjemahan untuk status internal yang digunakan secara eksklusif oleh UI kartu, bukan entitas Home Assistant. Ini mencakup nama ruangan (diperoleh dari entitas segment_name), beserta pengenal spesifik seperti task_type, edit_type, map_type, object_type, furniture_type, obstacle_type, obstacle_reason, task_end_type, task_interrupt_reason, startup_method, cleanup_method, dan recovery_map_type.

Format Tanggal, Waktu, dan Unit

Selain terjemahan teks, kartu ini secara otomatis menyesuaikan dengan preferensi format lokal tanpa memerlukan konfigurasi manual:

• Bahasa & Lokal: Kartu ini memprioritaskan bahasa yang dipilih dalam profil Home Assistant. Jika tidak ada bahasa yang ditetapkan secara eksplisit di sana, kartu ini secara otomatis menggunakan bahasa default dari browser web.
• Format Waktu 12/24 Jam: Kartu ini menghormati format waktu yang dikonfigurasi dalam profil Home Assistant. Jika tidak ditentukan, secara otomatis mengadopsi format waktu standar dari wilayah perangkat.
• Hari Pertama Minggu: Kartu ini membaca pengaturan hari pertama minggu langsung dari Home Assistant. Jika tidak didefinisikan, kartu ini secara dinamis menentukan apakah kalender harus dimulai pada hari Minggu atau Senin berdasarkan wilayah lokal.
• Sistem Satuan: Kartu terus memeriksa konfigurasi global Home Assistant. Jika sistem menggunakan sistem satuan Imperial, kartu secara otomatis menghitung ulang area dan jarak, menampilkan secara native dalam kaki, kaki persegi, atau yard.
• Terjemahan Unit Asli: Sufiks dan singkatan unit umum, seperti meter, kilometer, kaki, yard, menit dan jam, tidak memerlukan terjemahan manual. Kartu ini menerjemahkannya secara langsung menggunakan fitur bawaan browser yang khusus disesuaikan dengan bahasa aktif.

Perbaiki atau Tingkatkan Terjemahan

Jika ditemukan kesalahan ketik atau terjemahan yang salah, atau diperlukan dukungan untuk bahasa baru, kontribusi dapat dikirim ke repositori integrasi utama dreame_vacuum.

Generalisasi Terjemahan

Aplikasi resmi sering menggunakan terminologi yang berbeda untuk parameter yang sama di berbagai generasi perangkat. Terjemahan harus menggunakan nama yang logis dan digeneralisasi daripada menyalin kata-kata persis dari APLIKASI. Hal ini mencegah konflik terjemahan di mana koreksi yang disesuaikan untuk satu generasi spesifik kemudian ditimpa oleh pengguna dengan generasi perangkat berbeda.

Proses pembaruan melibatkan langkah-langkah berikut:

1. Fork Repository: Membuat fork repositori integrasi Dreame Vacuum Home Assistant di GitHub.
2. Temukan File Terjemahan: Menavigasi ke direktori custom_components/dreame_vacuum/translations/ di repositori yang di-fork untuk menemukan file terjemahan yang sesuai dengan kode bahasa, seperti de.json atau it.json.
3. Lakukan Perubahan: Memperbarui teks yang salah. Blok frontend_action, frontend_config, frontend_message, dan frontend_title mengelola teks terkait UI. Blok entity mengelola nama sensor, opsi yang dapat dipilih, dan statusnya.
4. Kirim Pull Request: Membuka Pull Request ke repositori utama. Setelah Pull Request ditinjau dan digabungkan ke dalam rilis baru dari integrasi, Dreame Vacuum Card secara otomatis mengambil terjemahan yang diperbarui.