Home Assistant 2025.12.2+ 버전의 Sonos 제품 추가 상세 튜토리얼입니다. 내용은 최신 버전 로직으로 검증되었으며, 초보 사용자도 설정을 원활하게 완료할 수 있습니다.
🟢 준비 작업 (필독)
시작하기 전에 다음 3가지 핵심 조건을 충족하는지 확인하세요. 그렇지 않으면 Home Assistant (HA)가 Sonos 스피커를 찾지 못할 수 있습니다:
- 동일한 로컬 네트워크: Home Assistant 호스트(라즈베리파이, 소프트 라우터 등)가 Sonos 스피커와 같은 공유기/같은 대역에 연결되어 있어야 합니다.
- 주의: HA가 Docker나 가상 머신에서 실행 중이라면 네트워크 모드가 다음인지 확인하세요
Sonos 장치 네트워크 연결: Sonos 스피커가 공식 앱에서 설정을 마쳤고 정상적으로 음악을 재생할 수 있는지 확인합니다.
UPnP 켜기 (핵심 단계):
- 휴대폰의 Sonos 앱을 엽니다.
- 설정 (Settings) -> 관리 (Manage) -> 시스템 설정 (System Settings)으로 들어갑니다(앱 버전에 따라 경로가 조금 다를 수 있지만, 계정/개인정보 또는 네트워크 설정에 있습니다).
- UPnP 옵션을 찾아 켭니다. 이렇게 하면 HA가 스피커를 자동으로 검색할 수 있습니다.
🚀 튜토리얼: Home Assistant에 Sonos 추가하기
방법 1: 자동 검색 (가장 간단, 권장)
Home Assistant 2025.12는 자동 검색 기능이 잘 최적화되어 있어, 보통 백엔드에 로그인하면 안내가 표시됩니다.
- HA 백엔드에 로그인합니다.
- 왼쪽 메뉴의 설정 (Settings)을 확인하고, 파란색 배지가 나타나면 새 장치가 검색된 것입니다.
- 설정 (Settings) -> 장치 및 서비스 (Devices & Services)를 클릭합니다.
- 상단에 “검색됨 (Discovered)” 영역이 보이고 Sonos가 표시될 것입니다.
- 파란색 구성 (Configure) 버튼을 클릭합니다.
- 제출 (Submit)을 클릭합니다.
- 시스템이 모든 스피커를 자동으로 구성하고, 완료 후 특정 방(거실, 침실 등)에 할당하라는 안내가 나옵니다. 할당 후 완료 (Finish)를 클릭합니다.
방법 2: 수동 추가 (자동으로 뜨지 않을 경우)
“검색됨”에 Sonos가 없다면 다음 단계로 수동 추가하세요:
- HA 왼쪽 메뉴에서 설정 (Settings)을 클릭합니다.
- 장치 및 서비스 (Devices & Services)를 선택합니다.
- 오른쪽 아래의 파란색 버튼 + 통합 추가 (+ ADD INTEGRATION)를 클릭합니다.
- 검색창에 Sonos를 입력합니다.
- 검색 결과의 Sonos 아이콘을 클릭합니다.
- 시스템이 로컬 네트워크의 장치를 자동으로 검색합니다:
- 경우 A: 검색되면 제출을 클릭하면 됩니다(방법 1 단계 참조).
- 경우 B: Host(호스트/IP) 입력을 요청하면 Sonos 스피커 중 하나의 IP 주소를 입력해야 합니다.
- IP 확인 방법: 공유기 관리 화면이나 Sonos 앱의 “내 시스템 정보”에서 찾을 수 있습니다(예: 192.168.1.100).
IP를 입력하고 제출을 클릭하면 HA가 이 장치를 통해 나머지 모든 Sonos 장치를 찾습니다.
✅ 검증 및 사용
추가에 성공하면 장치가 정상 동작하는지 검증하고 대시보드에 추가해야 합니다.
- 장치 상태 확인:
- 설정 -> 장치 및 서비스로 돌아가 Sonos 카드를 찾습니다.
- 장치 (Devices)를 클릭하면 집 안의 모든 Sonos 스피커 목록이 보입니다.
대시보드 (Dashboard)에 추가:
- 왼쪽 메뉴에서 개요 (Overview)(또는 사용자 지정 대시보드)를 클릭합니다.
- 오른쪽 위의 연필 아이콘 (Edit Dashboard)을 클릭해 편집 모드로 들어갑니다.
- 오른쪽 아래의 + 카드 추가 (+ ADD CARD)를 클릭합니다.
- 미디어 컨트롤 (Media Control)을 검색하거나 미디어 플레이어를 직접 찾습니다.
- 엔터티 (Entity) 드롭다운에서 Sonos 스피커를 선택합니다(예: media_player.living_room).
- 저장 (Save)을 클릭합니다.
이제 HA 홈 화면에서 바로 Sonos의 재생, 일시정지, 볼륨 조절, 다중 스피커 그룹화 (Group) 기능을 제어할 수 있습니다.
💡 고급 팁 (2025.12 신규 기능 기반)
Home Assistant 2025.12에서는 자동화 (Automation) 구성이 더 직관적으로 바뀌었습니다. 다음과 같은 간단한 자동화를 시도해 보세요:
시나리오: 귀가 시 자동으로 음악 재생
- 설정 -> 자동화 및 장면 -> + 자동화 만들기로 들어갑니다.
- 트리거 조건 (When): “상태”를 선택하고, 엔터티에서 휴대폰 위치(예: person.본인이름)를 고른 뒤 상태가 “외출”에서 “재실”로 바뀌도록 설정합니다.
- 실행 동작 (Then):
- 미디어 플레이어 (Media Player)를 검색해 선택합니다.
- 동작 미디어 재생 (Play Media)을 선택합니다.
- 사용자의 Sonos 스피커를 선택합니다.
- 콘텐츠 ID에 듣고 싶은 라디오 방송국 URL 또는 간단한 재생 명령을 입력합니다.
- (더 간단한 방법): 동작 미디어 플레이어: 켜기 (Turn on)를 선택하면 Sonos가 보통 마지막 콘텐츠를 이어서 재생합니다.
❓ 자주 발생하는 문제 해결
- Q: 장치를 찾을 수 없으면 어떻게 하나요?
- A: 90%는 네트워크 문제입니다. 공유기, Sonos 스피커, Home Assistant 호스트를 재시작하세요. HA가 방화벽에서 UDP 1900 포트(검색 프로토콜)를 차단하지 않았는지 확인하세요.
Q: 엔터티가 “사용 불가 (Unavailable)”로 표시되나요?
- A: Sonos의 전원이 꺼졌거나 오프라인인지 확인하세요. Docker 버전 HA라면 컨테이너 네트워크 모드가 host인지 다시 확인하세요.
Q: TTS(텍스트 음성 변환)를 사용할 수 있나요?
- A: 가능합니다. Sonos는 HA의 TTS를 완벽하게 지원합니다. “개발자 도구” -> “동작”에서 tts.speak 또는 tts.google_translate_say(설정한 TTS 서비스에 따라 다름)를 검색하고 Sonos 엔터티를 선택하면 말하게 할 수 있습니다. 예: “세탁이 끝났습니다”.
