현지화

드리미(Dreame) 진공 카드(Dreame Vacuum Card)는 기본적으로 다국어를 지원합니다. 별도의 현지화 파일을 유지하는 대신, 백엔드 dreame_vacuum 통합에서 제공되는 언어 파일을 동적으로 사용합니다.

카드는 dreame_vacuum 통합 번역 파일 내의 entity_component 섹션에서 현지화된 텍스트 값을 가져옵니다.

번역 키

언어 파일 내에서 카드는 주로 frontend_으로 시작하는 여러 키 카테고리를 사용하여 인터페이스를 표시합니다:

• frontend_action: 이 섹션에는 카드의 메인 제어판 액션 버튼 안에서 사용되는 모든 텍스트가 포함되어 있습니다. 예를 들어 시작, 일시정지, 또는 도킹 등이 있습니다.

• frontend_config: 이 섹션에는 시각적 카드 구성 UI 내에서 사용되는 모든 텍스트 라벨, 설명 및 설정이 포함됩니다.

• frontend_message: 카드에 표시되는 상태 메시지, 알림, 오류 보고서 및 경고가 포함됩니다.

• frontend_title: 카드 메뉴 내에서 사용되는 제목과 섹션 타이틀을 포함하며, 예를 들어 지도 관리 또는 청소 설정 등이 있습니다.

• entity: 이 블록은 select, sensor, switch, number, time 및 input과 같은 Home Assistant 엔티티 도메인을 다룹니다. 카드에서는 이러한 엔티티의 이름과 상태를 흡입 수준 또는 조용함과 같이 통합에서 직접 동적으로 가져와 일관성을 보장합니다.

  • 카드 전용 상태: Home Assistant 엔티티가 아닌 카드 UI에서만 사용되는 내부 상태의 번역을 제공합니다. 여기에는 ( 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 통합 저장소로 전달됩니다.

번역 일반화

공식 앱은 동일한 매개변수에 대해 다양한 기기 세대에서 서로 다른 용어를 자주 사용합니다. 번역은 앱의 정확한 문구를 단순히 복사하기보다는 논리적이고 일반화된 이름을 사용하는 것이 필요합니다. 이는 특정 세대에 맞춰진 수정이 다른 세대를 사용하는 사용자들에 의해 덮어써지는 번역 충돌을 방지합니다.

업데이트 과정은 다음 단계를 포함합니다:

1. 저장소 포크하기: GitHub에서 Dreame Vacuum Home Assistant 통합 저장소를 포크합니다.
2. 번역 파일 찾기: 포크된 저장소의 custom_components/dreame_vacuum/translations/ 디렉토리로 이동하여 de.json 또는 it.json와 같은 언어 코드에 맞는 번역 파일을 찾습니다.
3. 변경 사항 적용하기: 잘못된 텍스트를 업데이트합니다. frontend_action, frontend_config, frontend_message, frontend_title 블록은 UI 관련 텍스트를 관리합니다. entity 블록은 센서 이름, 선택 옵션 및 그 상태를 관리합니다.
4. 풀 리퀘스트 제출하기: 메인 저장소에 풀 리퀘스트를 엽니다. 풀 리퀘스트가 검토되고 통합의 새 릴리스에 병합된 후, Dreame Vacuum 카드가 자동으로 업데이트된 번역을 가져옵니다.