Home Assistant(HA)에서 HomePod Mini를 음성 재생기로 사용한다는 것은 본질적으로 DLNA/AirPlay 미디어 플레이어로 취급한다는 뜻입니다.
일부 네트워크 환경에서는 기본 제공 Google TTS나 인터넷 연결이 필요한 클라우드 서비스가 자주 작동하지 않습니다. 그래서 현재 가장 안정적이고 음질이 좋은 Microsoft Edge TTS를 추천합니다. 특별한 네트워크 설정이 필요 없고 음성이 자연스러우며 완전히 무료입니다.
아래는 Home Assistant 2025.12.2 버전에 기반한 자세한 사용 튜토리얼입니다.
1단계: HomePod Mini를 Home Assistant에 연결하기
Home Assistant는 Apple 프로토콜을 기본 지원하므로 보통 장치를 자동으로 검색합니다.
- 자동 검색: HomePod Mini와 HA가 같은 LAN에 있는지 확인합니다. HA 화면에서 설정 -> 장치 및 서비스 를 클릭합니다.
- 통합 추가: 발견된 카드에 Apple TV 또는 HomeKit Accessory Protocol이 보이면 설정 을 클릭합니다.
- 수동 추가: 자동 검색되지 않으면 오른쪽 아래의 통합 추가 를 클릭하고 Apple 을 검색한 뒤 Apple TV(Apple 장치의 통합 구성 요소)를 선택합니다.
- 페어링: HA가 HomePod에서 확인 코드를 입력하라고 요청합니다. 이때 스마트폰이나 iPad(홈 허브)에 코드가 뜨므로 HA에 입력하면 됩니다.
- 확인: 성공하면 장치 에 media_player 유형의 엔티티가 보입니다. 예를 들어 media_player.homepod_mini 입니다.
2단계: Edge TTS 설치하기 (국내에 가장 적합한 음성 솔루션)
HomePod가 중국어를 말하게 하려면 발성 엔진이 필요합니다.
- 설정 -> 장치 및 서비스 -> 통합 추가 로 들어갑니다.
- Microsoft Edge TTS 를 검색합니다.
- 참고: 공식 스토어에 없으면 먼저 HACS가 설치되어 있는지 확인하고 HACS에서 검색하세요.
설치하면 tts.microsoft_edge_tts_cloud 서비스를 제공합니다.
중국어 설정: 통합 옵션에서 기본 음성을 zh-CN-XiaoxiaoNeural(샤오샤오, 가장 자연스러운 중국어 여성 음성)로 설정하는 것을 권장합니다.
3단계: 기본 TTS 옵션 설정하기
HA 최신 버전에서는 음성 안내를 매끄럽게 하기 위해 configuration.yaml 에서 간단히 확인해야 합니다(또는 UI 화면에서 바로 설정합니다).
왼쪽의 개발자 도구 -> 서비스 를 클릭합니다.
tts.speak 를 입력해 작동하는지 테스트합니다.
주의 사항
: HomePod가 오디오 파일을 받으려면 HA의 내부 주소가 올바르게 설정되어 있어야 합니다.
- 설정 -> 시스템 -> 네트워크 로 들어갑니다.
- Home Assistant URL 이 LAN IP(예: http://192.168.1.100:8123)로 설정되어 있는지 확인하고, 공인 주소로 설정하지 마세요.
4단계: 초보자 자동화 튜토리얼 – 환영 인사 방송
이제 가장 간단한 자동화를 만들어 봅시다: 누군가 집에 도착하면 HomePod가 자동으로 환영합니다.
- 설정 -> 자동화 및 장면 -> 자동화 만들기 로 들어갑니다.
- 발동 조건 추가: 상태 를 선택합니다.
- 엔티티: person.your_name (당신의 사용자).
- From: not_home, To: home.
동작 추가: 서비스 호출 을 선택합니다.
- 서비스: tts.speak (참고: 2025 버전에서는 예전 say 대신 speak 사용을 권장합니다).
- 미디어 플레이어: media_player.homepod_mini 를 선택합니다.
- TTS 엔진: Edge TTS 를 선택합니다.
- 메시지: 집에 오신 것을 환영합니다, 오늘도 수고하셨어요! 를 입력합니다.
저장 및 테스트: 동작 오른쪽 위의 점 세 개를 클릭하고 실행 을 선택해 HomePod가 소리를 내는지 확인합니다.
고급: 음성을 더 매끄럽게 하려면?
HomePod는 오디오를 재생하기 전에 약간의 지연이 있으므로 자동화 동작을 다음 순서로 설정하는 것을 권장합니다:
- 동작 1: media_player.volume_set (볼륨을 0.5로 설정해 너무 커서 놀라지 않게 합니다).
- 동작 2: tts.speak (음성을 전송합니다).
자주 발생하는 문제 해결(실패 방지 가이드):
- 소리가 안 나요?
- 홈 앱에서 HomePod의 AirPlay 권한이 비활성화되어 있지 않은지 확인하세요. 같은 네트워크의 모든 사람 으로 설정합니다.
- HA의 IP 주소가 고정되어 있는지 확인하세요. HA의 IP가 바뀌면 HomePod가 오디오 파일을 찾지 못합니다.
소리가 끊기나요?
- Microsoft Edge 서버 연결이 간헐적으로 불안정해지기 때문입니다. VPN은 필요 없지만 네트워크가 너무 나쁘면 HA에서 Media Source 캐시를 설정하세요.
남성 음성으로 바꾸려면?
- Edge TTS 통합 설정에서 zh-CN-YunxiNeural 을 기본으로 설정하면 됩니다. 매우 자연스러운 남성 음성입니다.
위 단계를 거치면 완전히 로컬화되고 네트워크 의존이 매우 낮으며 음질도 뛰어난 HomePod 음성 안내 시스템을 갖추게 됩니다.
no response to SETUP rtsp://… 오류가 나타난다면 핵심 의미는 핸드셰이크 실패입니다. 방화벽에서 UDP 포트 10000-65535를 허용하기만 하면 됩니다.
