Home Assistant(줄여서 HA)의 스크립트(Script)에 대해 최대한 쉬운 말로 설명하고, 실용적인 영화 감상 모드 스크립트를 만드는 방법을 하나하나 알려 드리겠습니다.
1. 쉬운 말로: 스크립트란 무엇인가?
Home Assistant를 똑똑한 집사라고 생각해 보세요.
- 장치(Device/Entity): 집사가 가진 도구로, 조명, TV, 커튼 등입니다.
- 자동화(Automation): 집사에게 내리는 절대 명령으로, 만약 ……라면 ……하라 형식입니다. 예를 들어 집에 도착하면 조명을 켜라. 수동적으로 발동됩니다.
- 스크립트(Script): 집사에게 가르치는 일련의 연속 동작, 또는 기술 묶음입니다.
쉬운 비유:스크립트는 매크로, 즉 원터치 매크로입니다.
스크립트와 자동화의 가장 큰 차이:
- 자동화: 스스로 움직입니다. 조건에 의한 발동이 필요합니다(몇 시인지, 사람이 왔는지).
- 스크립트: 당신의 지시를 따릅니다. 평소에는 대기하다가 당신(또는 자동화)이 한 번 호출하면 한 번 실행됩니다.
2. 2025.12.2 버전 스크립트 생성 완전 초보자 가이드
고전적인 영화 감상 모드 스크립트를 만들어 봅시다.목표: 한 번 누르면 거실 메인 조명이 꺼지고, 테이프 조명 밝기가 30%가 되며, TV가 켜집니다.
1단계: 생성 화면 열기
- Home Assistant 웹 페이지나 앱을 엽니다.
- 왼쪽 메뉴에서 설정(Settings)을 클릭합니다.
- 자동화 및 장면(Automations & Scenes)을 선택합니다.
- 상단 탭에서 스크립트(Scripts)를 클릭합니다.
- 오른쪽 아래의 스크립트 만들기(Create Script) 버튼을 클릭합니다.
- 새 스크립트 만들기(Create new script)를 선택합니다.
2단계: 스크립트 기본 정보 설정
상단 편집기에서:
- 이름(Name): 영화 감상 모드 를 입력합니다.
- 아이콘(Icon): TV 아이콘을 고를 수 있습니다. 예를 들어 mdi:movie-open 입니다.
- 모드(Mode): 기본값인 단일(Single)을 유지하면 됩니다. 스크립트가 실행 중일 때 다시 눌러도 반응하지 않아 중복 실행 충돌을 막습니다.
3단계: 동작(Action) 추가하기 (핵심입니다)
스크립트는 일련의 동작(Actions)입니다. 2025.12 버전에서는 인터페이스가 더 직관적입니다.
동작 1: 거실 메인 조명 끄기
- 동작 추가(Add Action) 버튼을 클릭합니다.
- 검색 상자에 끄기 또는 turn off 를 입력합니다.
- 참고: HA 2025 버전에서 서비스 호출은 동작 실행으로 이름이 바뀌었고, 또는 장치를 바로 선택할 수 있습니다.
- 가장 간단한 방법: 장치(Device)를 바로 클릭한 뒤 장치 드롭다운에서 거실 메인 조명 을 찾습니다.
- 동작 영역에서 끄기(Turn off)를 선택합니다.
동작 2: 테이프 조명 켜고 어둡게 하기 (선택)
- 다시 동작 추가(Add Action)를 클릭합니다.
- 이번에는 동작으로 검색합니다: light.turn_on 을 검색합니다.
- 조명: 켜기(Light: Turn on)를 클릭합니다.
- 대상 선택(Choose entity)을 클릭하고 거실 테이프 조명 에 체크합니다.
- 아래에 상세 파라미터가 나타납니다. 밝기(Brightness)를 체크하고 슬라이더를 30%로 옮깁니다.
- 선택: 색상(Color)을 체크하고 따뜻한 노랑이나 빨강을 고릅니다.
동작 3: TV 켜기
- 다시 동작 추가(Add Action)를 클릭합니다.
- 장치(Device)를 선택하고 거실 TV 를 찾습니다.
- 동작으로 켜기(Turn on)를 선택합니다.
4단계: 저장과 테스트
- 오른쪽 아래의 스크립트 저장(Save Script) 버튼을 클릭합니다.
- 저장 후 오른쪽 위의 점 세 개 아이콘을 클릭하고 실행(Run)을 선택합니다.
- 확인: 집의 조명이 꺼지고 TV가 켜졌나요? 그렇다면 축하합니다, 스크립트가 성공했습니다.
3. 이 스크립트는 어떻게 사용하나요?
스크립트를 만들었으니 어떻게 호출할까요? 보통 두 가지 방법이 있습니다.
사용법 A: 대시보드에 두고 직접 누르기
- HA 홈 화면(개요)으로 돌아갑니다.
- 오른쪽 위의 연필 아이콘을 클릭해 대시보드를 편집합니다.
- 오른쪽 아래의 카드 추가 를 클릭합니다.
- 버튼(Button) 카드를 선택합니다.
- 엔티티(Entity)에서 script.guan_ying_mo_shi 를 검색합니다. 방금 만든 스크립트이며 보통 script. 뒤에 지정한 이름의 병음이 붙습니다.
- 저장을 클릭합니다. 이제 대시보드에 스위치가 생겼습니다. 한 번 누르면 집이 영화 감상 모드로 들어갑니다.
사용법 B: 자동화와 함께 사용하기 (자동 실행)자동화를 만들 수 있습니다:
- 발동 조건: 스마트 플러그가 TV 소비 전력이 50W 이상임을 감지할 때(TV가 켜진 증거).
- 실행 동작: 동작(Action)을 선택하고 script.turn_on 을 검색한 뒤 영화 감상 모드 를 선택합니다. 이렇게 하면 리모컨으로 TV를 켤 때마다 HA가 자동으로 조명을 맞춰 줍니다.
4. 고급 팁 (2025.12 이후 버전 대상)
- YAML 문법 변화: 코드를 즐겨 보는 고급 사용자라면 주목하세요. 2025 버전에서는 스크립트의 기반 YAML 키 이름으로 복수형 actions: 가 권장됩니다. 예전 action: 도 아직 작동하지만 새 표준은 복수형입니다.
- 대기(Wait): TV가 느리게 켜진다면 TV 켜기 동작 뒤에 시간 대기(Wait for time to pass) 동작을 추가해 5초로 설정하고, 이어서 커튼 닫기 동작을 추가하세요. 그러면 스크립트 실행에 리듬감이 생깁니다.
- 대규모 모델 지원: 2025.12 버전은 AI 통합이 더 좋아졌습니다. 이 스크립트를 Assist(음성 비서)에 노출한 뒤 스마트폰에 대고 이봐, 영화 감상 모드 시작해 라고 말하면 실행됩니다.
이 튜토리얼이 Home Assistant 스크립트를 쉽게 익히는 데 도움이 되길 바랍니다. 오류가 나오면 장치 엔티티 이름을 올바르게 선택했는지 확인하세요.
