Định vị ngôn ngữ

Thẻ Dreame Vacuum hỗ trợ nhiều ngôn ngữ một cách nguyên bản. Nó sử dụng động các tệp ngôn ngữ được cung cấp bởi tích hợp backend dreame_vacuum thay vì duy trì các tệp localization riêng biệt.

Thẻ lấy các giá trị văn bản được định vị từ phần entity_component trong dreame_vacuum các tệp dịch tích hợp.

Khóa Dịch

Trong các tệp ngôn ngữ, thẻ chủ yếu sử dụng một số loại khóa bắt đầu bằng frontend_ để hiển thị giao diện của nó:

• frontend_action: Phần này chứa tất cả văn bản được sử dụng bên trong các nút hành động trên bảng điều khiển chính của thẻ, chẳng hạn như Bắt đầu, Tạm dừng, hoặc Về dock.

• frontend_config: Phần này chứa tất cả nhãn văn bản, mô tả và cài đặt được sử dụng bên trong giao diện cấu hình thẻ trực quan.

• frontend_message: Chứa các thông điệp trạng thái, cảnh báo, báo cáo lỗi và cảnh báo được hiển thị trên thẻ.

• frontend_title: Bao gồm các tiêu đề và tiêu đề phần được sử dụng trong menu của thẻ, chẳng hạn như Quản lý bản đồ hoặc Cài đặt làm sạch.

• entity: Khối này bao gồm các miền thực thể Home Assistant như select, sensor, switch, number, time và input. Thẻ tự động lấy tên và trạng thái của các thực thể này, chẳng hạn như Mức Hút hoặc Yên Tĩnh, trực tiếp từ tích hợp để đảm bảo tính nhất quán.

  • Trạng Thái Riêng Cho Thẻ: Cung cấp bản dịch cho các trạng thái nội bộ chỉ được sử dụng trong giao diện thẻ, thay vì các thực thể Home Assistant. Điều này bao gồm tên phòng (lấy từ thực thể segment_name), cùng với các định danh cụ thể như task_type, edit_type, map_type, object_type, furniture_type, obstacle_type, obstacle_reason, task_end_type, task_interrupt_reason, startup_method, cleanup_method và recovery_map_type.

Định Dạng Ngày, Giờ và Đơn Vị

Ngoài bản dịch văn bản, thẻ còn tự động thích ứng với các tùy chọn định dạng địa phương mà không cần cấu hình thủ công:

• Ngôn Ngữ & Khu Vực: Thẻ ưu tiên ngôn ngữ được chọn trong hồ sơ Home Assistant. Nếu không có ngôn ngữ nào được thiết lập rõ ràng ở đó, nó sẽ tự động quay về ngôn ngữ mặc định của trình duyệt web.
• Định dạng giờ 12/24: Thẻ tuân thủ định dạng giờ được cấu hình trong hồ sơ Home Assistant. Nếu không được xác định, nó sẽ tự động áp dụng định dạng giờ tiêu chuẩn của khu vực thiết bị.
• Ngày đầu tuần: Thẻ đọc một cách trực tiếp cài đặt ngày đầu tuần từ Home Assistant. Nếu không được xác định, nó sẽ tự động xác định xem lịch nên bắt đầu vào Chủ nhật hay Thứ Hai dựa trên khu vực địa phương.
• Hệ đơn vị: Thẻ liên tục kiểm tra cấu hình toàn cục của Home Assistant. Nếu hệ thống sử dụng hệ đơn vị Imperial, thẻ sẽ tự động tính toán lại diện tích và khoảng cách, hiển thị chúng một cách tự nhiên bằng feet, feet vuông hoặc yard.
• Dịch Đơn Vị Gốc: Các hậu tố và viết tắt đơn vị phổ biến, chẳng hạn như mét, kilômét, foot, yard, phút và giờ, không yêu cầu dịch thủ công. Thẻ sẽ dịch chúng ngay lập tức bằng các tính năng tích hợp sẵn trong trình duyệt được thiết kế đặc biệt cho ngôn ngữ đang hoạt động.

Sửa hoặc Cải thiện Bản dịch

Nếu phát hiện lỗi đánh máy hoặc dịch sai, hoặc cần hỗ trợ cho ngôn ngữ mới, các đóng góp sẽ được gửi đến kho dreame_vacuum tích hợp chính.

Tổng quát hóa Dịch thuật

Ứng dụng chính thức thường sử dụng các thuật ngữ khác nhau cho các tham số giống hệt nhau trên các thế hệ thiết bị khác nhau. Các bản dịch phải sử dụng tên hợp lý, tổng quát thay vì sao chép chính xác ngôn từ từ ỨNG DỤNG. Điều này ngăn ngừa xung đột dịch thuật khi một bản chỉnh sửa dành cho một thế hệ cụ thể bị ghi đè bởi người dùng có các thế hệ thiết bị khác.

Quy trình cập nhật bao gồm các bước sau:

1. Tạo Fork cho Repository: Tạo fork cho repository Dreame Vacuum Home Assistant integration trên GitHub.
2. Tìm Tệp Dịch: Điều hướng đến thư mục custom_components/dreame_vacuum/translations/ trong repository đã fork để tìm tệp dịch phù hợp với mã ngôn ngữ, chẳng hạn như de.json hoặc it.json.
3. Thực Hiện Các Thay Đổi: Cập nhật văn bản sai. Các khối frontend_action, frontend_config, frontend_message và frontend_title quản lý văn bản liên quan đến giao diện người dùng. Khối entity quản lý tên cảm biến, các tùy chọn chọn và trạng thái của chúng.
4. Gửi Pull Request: Mở Pull Request đến repository chính. Sau khi Pull Request được xem xét và hợp nhất vào phiên bản mới của integration, Dreame Vacuum Card sẽ tự động tiếp nhận các bản dịch đã cập nhật.