홈 › 사용 설명서 › 홈 오토메이션
Home Assistant · Hubitat · 웹훅

Home Assistant와 Hubitat: 휴대폰 없이 실행되는 내 장면

AVR Maestro를 Home Assistant 또는 Hubitat에 연결하면 만들어 둔 모든 장면이 허브의 네이티브 스크립트가 됩니다. 그 이후에는 허브가 내 네트워크에서 리시버와 직접 통신하므로, 휴대폰이 꺼져 있거나 잠자기 상태이거나 다른 나라에 있어도 "알렉사, 무비 나이트"가 작동합니다.

앱 없이도 실행되는 이유

대부분의 통합은 휴대폰을 중간 다리로 삼습니다. 휴대폰이 명령을 듣고, 휴대폰이 명령을 보내므로, 휴대폰이 깨어 있고 네트워크에 연결된 동안에만 자동화가 작동합니다.

AVR Maestro는 그렇게 하지 않습니다. 내 장면을 허브에 있는 스크립트로 컴파일하고, 허브가 리시버의 로컬 IP로 명령을 보냅니다. 앱의 역할은 동기화가 끝나면 끝납니다.

Home Assistant, 처음부터 끝까지

동기화가 끝나면

보기 좋은 대시보드 만들기

이제 Home Assistant에는 리시버에 시킬 수 있는 모든 일에 대한 제어 항목이 있지만, 그것들을 어떻게 배치할지에 대한 의견은 전혀 없습니다. 대시보드 예제는 전체 YAML이 포함된 하나의 배치 방안입니다. 선택된 항목에 불이 들어오는 소스와 서라운드 타일, 실제 dB로 표시되는 볼륨, 자기 이름을 그대로 읽어 오는 장면, 그리고 Home Assistant가 볼 수 있는 것과 볼 수 없는 것에 대한 솔직한 지도가 담겨 있습니다.

AVR Maestro가 동기화한 제어 항목으로 만든 Home Assistant 대시보드
장면만이 아닙니다

Speaker Preset, Dirac, Audyssey도 가능합니다

고급 제어 동기화를 켜면 앱이 장면뿐 아니라 훨씬 더 많은 스크립트를 게시합니다. 모든 Speaker Preset, 모든 Dirac Live 필터 슬롯, 각 Audyssey 곡선이 대상입니다. Cinema 30에서 전체 동기화를 하면 스크립트가 일흔 개 넘게 생기므로, 대시보드 버튼이나 음성 명령으로 장면을 불러오듯 Dirac 필터를 불러오거나 룸 곡선을 전환할 수 있습니다.

고급 제어 동기화가 켜진 AVR Maestro의 Home Assistant 화면
쓰기만 하는 것이 아니라 읽기도 합니다

Home Assistant가 활성 항목을 알 수 있습니다

스크립트는 실행할 수는 있어도 읽을 수는 없으므로, 초기의 대시보드는 Audyssey 곡선이나 Dirac 슬롯을 전환할 수는 있어도 어느 것이 켜져 있는지는 보여 줄 수 없었습니다. 이제 앱이 이미 가지고 있는 값(실시간 서라운드 모드, 활성 Dirac 필터, 스피커 프리셋, 디머 등 수십 가지)이 리시버의 상태 센서에 속성으로 공개되므로, 타일이 실제로 실행 중인 설정에 맞춰 불이 들어올 수 있습니다.

AVR Maestro가 Speaker Preset, Dirac Live, Audyssey 제어 스크립트를 Home Assistant에 게시하는 모습
모든 방

다른 존도 같은 대시보드에서

존 2와 존 3의 전원, 볼륨, 음소거는 각각 별도의 스크립트로 게시되므로, 테라스나 두 번째 방도 메인 존처럼 대시보드나 음성 어시스턴트에 반응합니다. 리시버가 실제로 보고하는 존에만 버튼이 생기므로, 2존 리시버에 존 3이 생기는 일은 없습니다.

예전 빌드로 동기화했다면

스크립트 ID가 한 번 바뀝니다

예전에는 스크립트 이름이 장면 과 리시버를 따라 지어졌기 때문에, 둘 중 하나의 이름을 바꾸면 예전 스크립트가 남고 조용히 두 번째 스크립트가 만들어졌습니다. 이제는 장면과 리시버의 MAC 주소를 따라 이름을 짓기 때문에, 이름을 바꿔도 스크립트가 갈라지지 않고 같은 스크립트가 업데이트됩니다.

이 변경 후 처음 동기화하면 예전 스크립트가 새 스크립트로 교체됩니다. 예전 ID를 기반으로 만든 것은 한 번 다시 연결해야 합니다. 대시보드 버튼, 자동화, 음성 별칭 등이 해당됩니다. Home Assistant에서 스크립트를 열면 새 엔티티 ID를 확인할 수 있습니다.

엔티티도 이제 32자의 기계 식별자 대신 리시버에서 읽은 cinema30으로 표시되므로, 목록을 알아보기 쉽고 자동 완성에서도 찾을 수 있습니다. 이전 버전의 ID도 계속 작동합니다.

Hubitat

Hubitat은 Maker API를 통해 지원되며, 앱에서 BETA로 표시되는 이유는 미완성이어서가 아니라 Home Assistant 방식보다 더 새롭기 때문입니다.

  • 허브 IP - LAN에서 Hubitat의 주소입니다.
  • Maker API 앱 ID - Maker API 앱 자체 URL에 들어 있는 숫자입니다.
  • 액세스 토큰 - Maker API를 켤 때 발급됩니다.

먼저 허브에서 Maker API를 켜면(Apps › Add Built-In App › Maker API) 세 가지를 모두 알려 줍니다. 이를 붙여 넣으면 AVR Maestro가 리시버를 찾고, 장면을 명령 시퀀스로 게시하며, 실시간 상태를 다시 보내 주므로 Hubitat 대시보드에는 마지막으로 전달된 명령이 아니라 리시버가 실제로 하고 있는 일이 반영됩니다.

허브 IP, Maker API 앱 ID, 액세스 토큰이 있는 Hubitat 설정 화면

웹훅

Home Assistant와 Hubitat은 리시버로 명령을 보냅니다. 웹훅은 반대 방향입니다. 리시버가 무언가를 하면 다른 모든 곳에 그 사실을 알립니다. 리시버를 켜면 AVR Maestro가 지정한 주소로 작은 메시지를 보내는데, 그 메시지가 바로 웹훅입니다.

이 부분만은 휴대폰과 무관하지 않습니다. 동기화된 장면은 허브의 스크립트가 되어 앱이 근처에 있든 없든 실행됩니다. 웹훅은 다릅니다. 리시버를 지켜보는 것이 AVR Maestro이므로, 트리거는 리시버를 볼 수 있는 기기에서 앱이 열려 있는 동안 작동합니다. 아무것도 실행하지 않은 상태에서 무언가가 작동하길 원한다면 허브에서 리시버 엔티티를 기준으로 만드세요.

네 가지 트리거

트리거 이벤트작동 시점좁힐 수 있는 범위
리시버 전원 켜짐리시버가 대기 모드에서 깨어날 때-
리시버 전원 꺼짐리시버가 대기 모드로 들어갈 때-
활성 입력 변경됨선택된 소스가 바뀔 때이 입력일 때만 트리거에서 입력 하나
장면 불러옴장면이 적용될 때장면 선택에서 장면 하나

범위를 좁혀야 시끄럽지 않고 쓸모가 생깁니다. 모든 입력에 "활성 입력 변경됨"을 걸면 쏟아지는 소방 호스지만, 같은 트리거를 프로젝터가 연결된 입력 하나에만 걸면 조명 스위치가 됩니다.

입력 목록은 내 리시버가 보고하는 목록이므로, 이름을 바꾸거나 숨긴 소스가 이미 반영되어 있습니다. 장면 목록은 내가 만든 장면입니다.

단계별 설정 방법

대부분의 사람들이 원하는 Home Assistant 방식입니다. 앱이 가리킬 대상이 필요하므로 Home Assistant 쪽을 먼저 하세요.

Home Assistant에서

AVR Maestro에서는

Home Assistant 방식에서는 URL을 직접 입력할 필요가 없습니다. 앱이 연결된 Home Assistant를 바탕으로 주소를 만들고, 트리거가 작동할 때마다 그 주소를 다시 조회합니다. Home Assistant의 포트, 호스트 이름, Nabu Casa 주소를 바꿔도 이미 만든 모든 웹훅이 그대로 따라갑니다. 다시 동기화할 것도, 누를 버튼도 없습니다.
시트에 Home Assistant가 아직 연결되지 않았습니다라고 나오면, 먼저 이 페이지 위쪽의 Home Assistant 카드를 진행하세요. 웹훅 방식에는 기준이 될 주소가 필요합니다.

Home Assistant가 아닌 곳으로 보내기

전송할 위치를 기타로 바꾸고 웹훅 URL에 전체 URL을 붙여 넣으세요. POST를 받을 수 있는 것이라면 무엇이든 됩니다. Node-RED 플로, IFTTT 애플릿, NAS의 스크립트, Hubitat Maker API 엔드포인트 등이 그 예입니다. 이 방식은 입력한 그대로 주소를 저장하므로, 대상이 옮겨지면 트리거를 수정해야 합니다.

실제로 전송되는 내용

작은 JSON 본문입니다. 같은 화면의 전송되는 내용 카드가 선택한 트리거에 맞춰 쉬운 말로 설명해 주므로 추측할 필요가 없습니다. 자동화가 읽는 필드 이름은 다음과 같습니다.

트리거메시지에 담기는 필드
리시버 전원 켜짐 / 꺼짐event, timestamp
활성 입력 변경됨...외에 source 포함
장면 불러옴...외에 sceneId 및 sceneName 포함

Home Assistant 자동화에서는 이 값들이 {{ trigger.json.event }}, {{ trigger.json.source }} 등으로 들어옵니다. 읽어서 쓸 수도 있고, 완전히 무시하고 작동했다는 사실만으로 동작하게 할 수도 있습니다. 대부분은 후자를 택합니다.

다른 형식이 필요하다면(자체 형식을 요구하는 서비스 등) 해당 카드 아래의 직접 JSON 보내기를 열어 그곳에 작성하세요. 이 항목은 접혀 있고 고급으로 표시되어 있는데, 권장하지 않아서가 아니라 거의 아무도 필요로 하지 않기 때문입니다.

이 화면의 이름이 웹훅인 것은 실제로 웹훅이기 때문입니다. 허브에서 실행되는 자동화를 찾고 있다면 위의 Home Assistant와 Hubitat 카드가 그것입니다. 동기화된 장면은 여기서 웹훅이 되는 것이 아니라 그곳에서 스크립트가 됩니다.

웹훅이 도착하지 않을 때

처음 두 가지가 거의 항상 원인이므로, 확인할 만한 순서대로 정리했습니다.

유료인 것과 아닌 것

홈 오토메이션이 유일한 잠금 해제 항목입니다. AI 어시스턴트는 무료입니다.

홈 오토메이션(Pro), 즉 Home Assistant, Hubitat, 아웃바운드 웹훅은 일회성 잠금 해제입니다. 기기 내 AI 어시스턴트를 포함한 AVR Maestro의 나머지 기능은 모두 앱에 포함되어 있습니다.

음성 제어는 허브를 거쳐 홈 오토메이션 을 통해 리시버에 도달합니다. AVR Maestro는 자체 음성 인식을 실행하지 않습니다.

자주 묻는 질문

홈 오토메이션 궁금증 풀이

음성 제어가 작동하려면 휴대폰이 켜져 있어야 하나요?
아니요. AVR Maestro는 내 장면을 네이티브 Home Assistant 스크립트로 컴파일합니다. Home Assistant가 로컬 네트워크에서 리시버와 직접 통신하므로 휴대폰이 꺼져 있거나, 잠자기 상태이거나, 다른 나라에 있어도 됩니다.
어떤 음성 어시스턴트로 리시버를 제어할 수 있나요?
이미 쓰고 계신 것이면 무엇이든 됩니다. AVR Maestro는 자체 음성 계층을 추가하지 않습니다. Home Assistant나 Hubitat에 스크립트를 공개하면, 이미 신뢰하는 허브가 이를 Alexa, Google Assistant 또는 Siri 단축어에 노출합니다.
AI 어시스턴트도 유료 잠금 해제에 포함되나요?
아니요. 기기 내 AI 어시스턴트는 무료입니다. 홈 오토메이션(Home Assistant, Hubitat, 아웃바운드 웹훅)이 AVR Maestro에서 유일한 유료 잠금 해제 항목입니다.
집 네트워크 밖으로 나가는 데이터가 있나요?
제어에는 없습니다. 앱은 내 네트워크 안에서 리시버 및 허브와 통신합니다. MiyaraHub 서버를 거치는 것은 없습니다. 웹훅은 지정한 곳으로 전송되며, 그 선택은 사용자의 몫입니다.
가이드 더 보기

다른 AVR Maestro 가이드

시작하기 · 홈 화면 · 장면 · 사용자 지정 아이콘 · 사운드 · 그래픽 EQ · 스피커 · 컨트롤이 잠겨 있는 이유 · 어시스턴트 · Home Assistant 대시보드 · 존 · 리모컨 · 라디오 (FM/AM) · 온스크린 디스플레이 · 설정 · 언어 · 볼륨 제어 · 백업 & 복원 · 지금 재생 중 & HEOS

휴대폰 없이 실행되는 내 장면

홈 오토메이션은 일회성 잠금 해제입니다. AI 어시스턴트를 포함한 앱의 나머지 기능은 모두 포함되어 있습니다.

Google Play에서 다운로드 App Store에서 다운로드 Mac App Store에서 다운로드 Microsoft Store에서 다운로드

전체 사용자 가이드로 돌아가기 →