Tempatanisasi

Kad Vakum Dreame menyokong pelbagai bahasa secara asli. Ia menggunakan fail bahasa yang disediakan oleh integrasi backend dreame_vacuum secara dinamik tanpa mengekalkan fail penyetempatan yang berasingan.

Kad ini mendapatkan nilai teks yang disetempatkan dari bahagian entity_component dalam dreame_vacuum fail terjemahan integrasi.

Kekunci Terjemahan

Dalam fail bahasa, kad ini terutamanya menggunakan beberapa kategori kekunci yang bermula dengan frontend_ untuk memaparkan antara mukanya:

• frontend_action: Bahagian ini mengandungi semua teks yang digunakan di dalam butang tindakan pada panel kawalan utama kad, seperti Mula, Jeda, atau Pangkalan.

• frontend_config: Bahagian ini mengandungi semua label teks, penerangan dan tetapan yang digunakan dalam antara muka konfigurator kad visual.

• frontend_message: Mengandungi mesej status, amaran, laporan ralat dan amaran yang dipaparkan pada kad.

• frontend_title: Meliputi tajuk dan judul bahagian yang digunakan dalam menu kad, seperti Pengurusan Peta atau Tetapan Pembersihan.

• entity: Blok ini merangkumi domain entiti Home Assistant seperti select, sensor, switch, number, time dan input. Kad ini secara dinamik menarik nama dan status entiti ini, seperti Tahap Sedutan atau Senyi, terus dari integrasi untuk memastikan keseragaman.

  • Status Khusus Kad: Memberikan terjemahan untuk status dalaman yang digunakan secara eksklusif oleh UI kad dan bukannya entiti Home Assistant. Ini termasuk nama bilik (yang diperoleh daripada entiti segment_name), bersama dengan pengecam khusus 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.

Pemformatan Tarikh, Masa dan Unit

Selain terjemahan teks, kad ini secara automatik menyesuaikan dengan keutamaan pemformatan tempatan tanpa memerlukan sebarang konfigurasi manual:

• Bahasa & Lokasi: Kad ini mengutamakan bahasa yang dipilih dalam profil Home Assistant. Jika tiada bahasa ditetapkan secara jelas di situ, ia secara automatik menggunakan bahasa lalai pelayar web.
• Format Masa 12/24 Jam: Kad ini menghormati format masa yang dikonfigurasikan dalam profil Home Assistant. Jika tidak dinyatakan, ia secara automatik mengikut format masa standard bagi kawasan peranti.
• Hari Pertama Minggu: Kad ini membaca tetapan hari pertama minggu terus dari Home Assistant. Jika tidak ditakrifkan, ia secara dinamik menentukan sama ada kalendar harus bermula pada hari Ahad atau Isnin berdasarkan kawasan tempatan.
• Sistem Unit: Kad ini sentiasa memeriksa konfigurasi global Home Assistant. Jika sistem menggunakan sistem unit Imperial, kad ini secara automatik mengira semula kawasan dan jarak, memaparkannya secara asli dalam kaki, kaki persegi, atau yard.
• Terjemahan Unit Asli: Tanda akhiran unit dan singkatan yang biasa, seperti meter, kilometer, kaki, yard, minit dan jam, tidak memerlukan sebarang terjemahan manual. Kad ini menterjemahkannya secara automatik menggunakan ciri terbina dalam pelayar web yang direka khusus untuk bahasa yang aktif.

Betulkan atau Tingkatkan Terjemahan

Sekiranya terdapat kesalahan taip atau terjemahan yang tidak betul, atau sokongan untuk bahasa baru diperlukan, sumbangan dihantar ke repositori integrasi utama dreame_vacuum.

Penggeneralan Terjemahan

Aplikasi rasmi kerap menggunakan istilah yang berbeza untuk parameter yang sama merentas pelbagai generasi peranti. Terjemahan mesti menggunakan nama yang logik dan digeneralisasikan daripada menyalin secara tepat perkataan dari APLIKASI. Ini mengelakkan konflik terjemahan di mana pembetulan yang disesuaikan untuk satu generasi tertentu kemudiannya ditindih oleh pengguna dengan generasi peranti yang berbeza.

Proses kemas kini melibatkan langkah-langkah berikut:

1. Fork Repositori: Fork repositori integrasi Dreame Vacuum Home Assistant di GitHub.
2. Cari Fail Terjemahan: Navigasi ke direktori custom_components/dreame_vacuum/translations/ dalam repositori yang difork untuk mencari fail terjemahan yang sepadan dengan kod bahasa, seperti de.json atau it.json.
3. Lakukan Perubahan: Mengemas kini teks yang salah. Blok frontend_action, frontend_config, frontend_message, dan frontend_title menguruskan teks berkaitan UI. Blok entity menguruskan nama sensor, pilihan select, dan keadaan mereka.
4. Hantar Permintaan Tarik: Membuka Permintaan Tarik ke repositori utama. Selepas Permintaan Tarik disemak dan digabungkan ke dalam keluaran baharu integrasi, Kad Dreame Vacuum secara automatik mengambil terjemahan yang dikemas kini.