1. HAIOTS - 상업용 IoT 솔루션 플랫폼Home
  2. 기술 문서

Skyworth TV는 주로 Android TV 시스템을 사용하기 때문에 Home Assistant에 연동하는 가장 권장되고 안정적이며 초보자에게 적합한 방법은 공식 Android TV Remote 통합을 사용하는 것입니다. 복잡한 코드 설정이 필요 없고 화면에서 조작만 하면 됩니다.

📺 연동 전 준비 작업

시작하기 전에 다음 조건을 충족하는지 확인하세요.

  • 네트워크 요구사항: Home Assistant (HA)와 Skyworth TV가 같은 로컬 네트워크(같은 공유기 아래)에 연결되어 있어야 합니다.
  • 고정 IP(강력 권장): 공유기 관리 화면에서 TV의 IP 주소를 고정 IP(예: 192.168.1.100)로 설정하는 것을 권장합니다. TV 재부팅 후 IP가 바뀌어 연결이 끊기는 문제를 피할 수 있습니다.

1단계: TV에서 개발자 모드 켜기

가장 중요한 단계입니다. Skyworth TV는 디버깅 권한을 기본적으로 숨겨 두었기 때문에 직접 켜야 합니다.

  • 설정 메뉴 열기: 리모컨으로 TV의 설정 (Settings) -> 기기 환경설정 (Device Preferences)으로 들어갑니다. 참고: 모델마다 화면이 조금씩 다르지만, 정보 항목을 찾는 것이 핵심입니다.
  • 개발자 모드 켜기: 정보 (About)로 들어가 아래로 스크롤하여 빌드 번호 (Build) 또는 컴파일 버전을 찾습니다. 이 항목에서 리모컨의 확인/OK 버튼을 7번 연속 누릅니다. 그러면 화면에 You are now a developer(개발자가 되었습니다)라는 메시지가 표시됩니다.
  • USB 디버깅 켜기: 뒤로 가기를 눌러 기기 환경설정 메뉴로 돌아오면 개발자 옵션 (Developer options)이 새로 생긴 것을 볼 수 있습니다. 그곳에 들어가 USB 디버깅 (USB Debugging)을 찾아 켭니다. 네트워크 디버깅 항목이 있다면 함께 켜 주세요.

2단계: Home Assistant에서 통합 추가하기

이제 Home Assistant 웹 화면으로 돌아와서 작업합니다.

  • 통합 추가하기:
  • 왼쪽 메뉴에서 설정 -> 기기 및 서비스를 클릭합니다.
  • 오른쪽 아래의 + 통합 추가를 클릭합니다.
  • 검색창에 Android TV Remote를 입력합니다.
  • 나타난 Android TV Remote 아이콘을 클릭합니다.

자동 검색 또는 수동 입력:

  • 네트워크가 정상이라면 HA가 TV를 자동으로 검색했을 수 있습니다. 이 경우 바로 구성 버튼을 클릭하면 됩니다.
  • 자동 검색되지 않으면 수동 입력을 선택하고 Host 항목에 TV의 IP 주소(예: 192.168.1.100)를 입력한 뒤 제출을 클릭합니다.

페어링 진행:

  • 제출을 클릭하면 Skyworth TV 화면에 페어링 요청이 뜨거나 4자리 또는 6자리 PIN 코드가 표시됩니다.
  • 동시에 Home Assistant 화면에서도 이 PIN 코드를 입력하라는 안내가 나옵니다.
  • TV에 표시된 숫자를 HA에 입력하고 제출을 클릭합니다.

설정 완료:

  • 성공 메시지가 나오면 기기를 영역(예: 거실)에 지정할 수 있습니다.
  • 이제 media_player 엔티티를 얻게 됩니다. 예: media_player.android_tv_192_168_1_100.

3단계: 기능 확인 및 사용

  • 기본 제어:
  • HA의 개요 (Dashboard)로 가서 방금 생성된 미디어 플레이어 카드를 찾습니다.
  • 카드의 점 세 개를 클릭하면 볼륨 조절, 일시정지/재생, 상하좌우 이동, 뒤로/홈 등의 조작이 가능합니다.

앱 실행:

  • 이 통합은 HA에서 TV의 앱을 직접 실행하는 것을 지원합니다.
  • 개발자 도구 -> 서비스 (또는 동작)에서 테스트할 수 있습니다.
  • 동작: media_player.select_source
  • 대상: TV 엔티티를 선택
  • 소스: 앱 이름을 입력 (일부 앱은 ID가 필요할 수 있지만, 일반적인 앱은 보통 자동으로 인식됩니다).

4단계: 전원이 켜지지 않는 문제 해결 (고급, 필독)

대부분의 Android TV는 전원을 끈(대기) 상태로 일정 시간이 지나면 Wi-Fi가 끊겨 HA에 사용 불가로 표시되고 원격 전원 켜기가 되지 않습니다. 이 문제가 발생하면 Wake on LAN(네트워크 웨이크)을 함께 사용해야 합니다.

1. TV가 WOL을 지원하는지 확인

TV가 유선 랜카드(랜선)에 연결되어 있을 때 가장 효과적입니다. Wi-Fi라면 불안정할 수 있습니다.

2. TV MAC 주소 확인

TV의 설정 -> 네트워크 -> 상태에서 MAC 주소를 찾습니다(형식: AA:BB:CC:DD:EE:FF).

3. Home Assistant 설정

configuration.yaml 파일에 다음 내용을 추가합니다(파일 수정이 어렵다면 UI에서 helper 버튼을 추가할 수 있지만 YAML이 더 안정적입니다).

# 开启网络唤醒功能wake_on_lan:# 定义一个万能开关 (Switch)
switch:
 - platform: template
 switches:
 skyworth_tv_power:
 friendly_name: "创维电视电源"
 # 这里的 media_player 换成你第二步生成的实体ID
 value_template: "{{ is_state('media_player.android_tv_xxxx', 'on') }}"
 turn_on:
 service: wake_on_lan.send_magic_packet
 data:
 mac: "AA:BB:CC:DD:EE:FF"
# 换成你电视的MAC地址
 turn_off:
 service: media_player.turn_off
 target:
 entity_id: media_player.android_tv_xxxx

4. HA 재시작

재시작 후 switch.skyworth_tv_power 스위치가 하나 더 생깁니다. 이 스위치로 TV를 제어하면 끄기만 되고 켜지지 않던 문제가 해결됩니다.

자주 발생하는 문제 해결 (Troubleshooting)

  • HA가 연결 실패 또는 시간 초과라고 표시:
  • TV가 절전 상태인지 확인하고, 먼저 정품 리모컨으로 전원을 켜세요.
  • TV의 개발자 옵션에서 USB 디버깅이 시스템에 의해 자동으로 꺼졌는지 확인하세요(일부 Skyworth TV는 재부팅 후 이 옵션이 초기화됩니다).

제어 지연이 큼:

  • 보통 Wi-Fi 신호 문제입니다. 가능하면 5GHz Wi-Fi나 유선 연결을 사용하세요.

엔티티 상태가 계속 알 수 없음으로 표시:

  • HA의 통합 페이지에서 해당 통합을 다시 로드하거나 TV를 한 번 재부팅해 보세요(전원 키를 길게 눌러 재부팅, 대기가 아님).

정리

초보자에게 Android TV Remote는 현재 가장 경험이 좋고 화면이 친숙한 방법입니다. TV 쪽의 개발자 모드 스위치만 해결하면 나머지는 HA 화면에서 마우스로 몇 번 클릭하면 끝납니다.

—————————-그런데 문제가 있습니다. configuration.yaml 파일을 수정할 줄 모르면 어떻게 해야 할까요?——————————————————————-

코드 파일(YAML) 수정에 익숙하지 않더라도 Home Assistant의 순수 그래픽 화면(UI)만으로 비슷한 효과를 충분히 구현할 수 있습니다.

코드 대신 자동화 (Automation) + 보조 요소 (Helper) 방식으로 대체할 수 있습니다.

핵심 아이디어

코드를 직접 작성해 스위치를 정의하는 대신 다음과 같이 합니다.

  • 가상 버튼을 하나 만듭니다(그것을 클릭).
  • 자동화를 하나 만듭니다(버튼이 클릭되면 전원 켜기 명령을 보냄).

방법 1: 순수 UI로 전원 켜기 버튼 설정하기 (권장)

이 방법은 전부 웹 화면에서 조작하며 어떤 파일도 열 필요가 없습니다.

1단계: 네트워크 웨이크 기능 활성화 (핵심)

최신 버전의 HA에서는 Wake on LAN이 핵심 기능이지만, 로드되었는지 수동으로 확인해야 할 때가 있습니다.

  • 시도할 것: 설정 -> 기기 및 서비스 -> 통합 추가 -> Wake on LAN을 검색합니다.
  • 있으면: 추가를 클릭하면 됩니다(기능이 활성화됩니다).
  • 없으면: 보통 HA는 기본적으로 명령 전송을 지원합니다. 이 단계를 건너뛰고 2단계로 바로 가도 됩니다. 3단계 테스트가 실패하면 글 끝의 대안을 확인하세요.

2단계: 가상 버튼 만들기

화면에 누르기 전용 전원 켜기 키를 만들어야 합니다.

  • 설정 (Settings) -> 기기 및 서비스 (Devices & Services)로 들어갑니다.
  • 상단의 보조 요소 (Helpers) 탭을 클릭합니다.
  • 오른쪽 아래의 + 보조 요소 만들기를 클릭합니다.
  • 버튼 (Button)을 선택합니다.
  • 이름: Skyworth TV 켜기라고 입력합니다.
  • 아이콘: mdi:television을 선택할 수 있습니다.
  • 만들기를 클릭합니다.

3단계: 클릭하면 켜지는 자동화 만들기

방금 만든 버튼과 전원 켜기 신호 전송을 연결합니다.

  • 설정 (Settings) -> 자동화 및 장면 (Automations & Scenes)으로 들어갑니다.
  • 오른쪽 아래의 + 자동화 만들기 -> 처음부터 만들기를 클릭합니다.
  • 트리거 (Trigger) 추가:
  • 상태 (State)를 선택합니다.
  • 엔티티: 방금 만든 input_button.da_kai_chuang_wei_dian_shi를 선택합니다(직접 지정한 이름으로 찾으세요).
  • 부터 / 까지: 둘 다 비워 둡니다(누르기만 하면 발동합니다).

동작 (Action) 추가:

  • 동작 수행 (Perform action)을 선택합니다(구버전에서는 서비스 호출).
  • 검색창에 Wake on LAN을 입력하고 Wake on LAN: Send magic packet을 선택합니다.
  • MAC 주소: TV 랜카드의 MAC 주소를 입력합니다(형식: AA:BB:CC:DD:EE:FF, 콜론에 주의).

저장:

  • 오른쪽 아래의 저장을 클릭하고 TV 네트워크 웨이크라고 이름을 지정합니다.

4단계: 버튼을 홈 화면에 배치하기

  • 개요 (Dashboard)로 돌아갑니다.
  • 오른쪽 위의 연필 아이콘(대시보드 편집)을 클릭합니다.
  • + 카드 추가를 클릭합니다.
  • 엔티티 (Entities) 또는 버튼 (Button)을 선택합니다.
  • 방금 만든 input_button.da_kai_chuang_wei_dian_shi를 선택합니다.
  • 저장을 클릭합니다.

이제 TV가 꺼져 연결할 수 없을 때 이 버튼을 클릭하면 TV가 깨어날 것입니다.

방법 2: 한 번에 끝내는 방법 (TV 설정 변경)

HA 설정을 건드리고 싶지 않다면 가장 간단한 방법은 TV가 완전히 네트워크에서 끊기지 않게 하는 것입니다. 이는 사용하는 Skyworth TV 모델이 지원하는지에 달려 있습니다.

  • 대기 안 함 옵션 켜기:
  • TV의 설정 -> 네트워크 또는 일반 설정에서 네트워크 대기, 빠른 부팅, 전원 끄면 네트워크 유지 같은 항목을 찾아 켭니다.

스크린리스 서비스 켜기 (일부 모델):

  • 일부 Skyworth TV는 설정 -> 기기 정보/정보 -> 기기 설정에 스크린리스 서비스 항목이 있으며, 이를 켭니다. 그러면 TV가 화면이 꺼진 상태에서도 백그라운드로 계속 동작해 언제든 HA의 일반 스위치로 켤 수 있습니다.

장점: 설정이 성공하면 네트워크 웨이크가 전혀 필요 없고, HA가 자동 생성한 미디어 플레이어 카드의 전원 키로 바로 켜고 끌 수 있습니다. 단점: TV 대기 전력 소모가 조금 더 높아집니다(보통 무시할 수준).

Previous:

Next:

相关新闻

cloud@haiots.com

QQ
微信