지원
CasaRay 지원
Home Assistant 설정, 실험적인 어시스턴트, 기기 제어, 알림, 구독, 개인정보 보호와 문제 해결에 관한 도움을 받으세요.
통합 호환성
직접 테스트한 항목, 표준 Home Assistant 제어로 작동할 것으로 예상되는 항목, 지원이 달라질 수 있는 부분을 확인하세요.
호환성 보기공개 지원과 피드백
신고 내용을 검색하고, 공개 질문을 남기거나 문제와 개선 사항을 제안하세요. 이 저장소는 지원과 피드백을 위한 곳이며 앱 소스 코드를 제공하는 곳이 아닙니다.
GitHub 지원 열기로그를 공유하기 전에
스크린샷과 진단 텍스트에서 Home Assistant 및 ChatGPT 토큰, 비밀번호, 내부 URL, 공개 IP 주소, 사적인 카메라나 방 정보를 제거하세요.
커뮤니티 대화
설정이나 릴리스에 대해 편하게 이야기하려면 Evotec Discord에 참여하고 플랫폼, CasaRay 버전과 Home Assistant 버전을 알려 주세요.
Discord 열기지원에 연락하기 전에
- CasaRay를 실행하는 Apple 기기가 Home Assistant URL에 접근할 수 있는지 확인하세요.
- 문제가 있는 엔터티가 사용 가능하며 Home Assistant에서 같은 동작에 응답하는지 확인하세요.
- CasaRay를 다시 열고 실시간 상태가 재연결될 때까지 잠시 기다리세요.
- 잠금 해제나 대문 열기 같은 위험한 동작에서는 승인 요청이 표시되고 엔터티가 예상한 서비스를 제공하는지 확인하세요.
도움이 되는 정보
- CasaRay 버전과 Apple 운영체제 버전.
- 기기 모델: iPhone, iPad, Apple Watch 또는 Mac. CarPlay는 iPhone 모델, 차량 또는 헤드 유닛 모델과 문제가 음성, 수동 제어 또는 둘 다에 영향을 주는지도 알려 주세요.
- Home Assistant 버전과 연결 유형: 로컬 URL, 원격 URL 또는 Home Assistant Cloud.
- 기기나 통합 문제라면 Home Assistant 통합 이름, 제조사와 모델, 엔터티 도메인, 같은 동작이 Home Assistant에서 작동하는지 알려 주세요.
- 방, 기기 범주, 예상한 동작과 실제로 일어난 일.
- 사적인 정보를 제거한 스크린샷이나 짧은 진단 발췌문.
어시스턴트 지원 보고서
어시스턴트 문제가 발생한 후 다음 항목을 여세요: 어시스턴트 설정 → 어시스턴트 지원 진단. 문제를 재현한 뒤에만 보고서를 준비하고 공유 전에 파일을 검토하세요. 보고서는 음성 연결, 발화 감지, 받아쓰기, 모델 응답, 도구 선택, 확인, Home Assistant 실행과 상태 대조, 오디오 재생 시간을 구분합니다. 스크린샷만 있을 때보다 긴 지연이나 잘못된 동작을 훨씬 쉽게 조사할 수 있습니다.
보고서는 녹음된 오디오, 이미지 바이트, 저장된 Home Assistant 자격 증명, 저장된 ChatGPT 토큰, 인증 헤더나 전체 비공개 URL을 의도적으로 추가하지 않습니다. 다만 정확한 대화 내용과 정규화된 도구 인수, 모델 및 음성 설정, 집·방·기기·엔터티 이름은 포함합니다. 따라서 말하거나 입력한 내용과 텍스트 제어 값에는 사용자가 언급한 비밀번호, 토큰이나 다른 비밀이 들어갈 수 있습니다. CasaRay는 활성 ChatGPT 계정과 집에 기록된 진단만 포함하며, 범위가 지정되지 않은 이전 기록은 제외합니다. 아무것도 자동으로 업로드하지 않습니다. 공유 전에 검토하고 민감한 텍스트를 제거하세요.
어시스턴트 사용 가능 여부
CasaRay 어시스턴트는 실험적인 기능이며 CasaRay Plus와 별도로 자격 요건을 충족하는 ChatGPT 계정이 필요합니다. Apple Watch와 CarPlay의 어시스턴트 음성은 페어링된 iPhone의 실행 환경과 계정을 사용하며, 어느 쪽도 별도의 ChatGPT 자격 증명을 저장하지 않습니다. OpenAI는 사용 가능한 모델, 음성, 계정 한도, 워크스페이스 권한과 서비스 제공 여부를 관리합니다. 어시스턴트가 작동하지 않으면 페어링된 iPhone의 어시스턴트 설정에서 계정과 사용량을 확인하고, 요청받으면 다시 인증하며, CasaRay 수동 제어가 여전히 Home Assistant에 도달하는지 확인하세요.
공개 웹 검색은 어시스턴트의 별도 실험 설정입니다. 날씨와 Home Assistant에 설정된 다른 출처를 넘어 최신 정보가 필요할 때만 켜세요. CasaRay는 마지막 요청을 받은 그대로 검색하며 집 위치나 상태를 몰래 추가하지 않습니다. 정확성이 중요하면 반환된 출처 링크를 여세요.
실시간 현황, 백그라운드 작업 업데이트와 위젯
CasaRay가 열려 있을 때 실시간 상태는 Home Assistant에서 직접 옵니다. CasaRay를 닫은 후에도 잔디깎이, 청소기나 관수 활동을 이어 가려면 별도의 백그라운드 전달 경로가 필요합니다: Home Assistant → CasaRay 릴레이 → Apple Push → 이 Apple 기기.
- 홈에서 연결 점을 누른 뒤 다음 항목을 여세요: 백그라운드 및 위젯 → 점검 및 복구.
- 알림을 허용하고 다음 설정을 완료하세요: 알림 전달. 전달 테스트를 보내면 CasaRay가 설정이 존재한다는 사실뿐 아니라 이 기기에서 실제 수신한 증거를 보여 줄 수 있습니다.
- 다음 항목을 완료하세요: 백그라운드 작업 업데이트. 그런 다음 Home Assistant에서 CasaRay가 관리하는 자동화를 승인하세요. 각 CasaRay 설치는 자체 자동화를 사용하므로 한 iPhone이나 iPad가 다른 기기의 수신자를 대체하지 않습니다.
- 같은 상태 패널에서 마지막 작업 업데이트, 실시간 현황 권한과 최근 검증된 위젯 스냅샷을 확인하세요.
초기 설정에서 건너뛰었다면 다음 항목을 여세요: 더 보기 → 설정 가이드 또는 설정 → 설정 가이드. 가이드를 다시 확인해도 Home Assistant 연결이나 레이아웃은 지워지지 않습니다.
위젯은 플랫폼별로 독립적입니다. iPhone, iPad, Mac 앱은 각각 자체 스냅샷과 경로를 게시하고 엽니다. 한 플랫폼에서 오래된 상태를 표시하면 해당 플랫폼에서 CasaRay를 열고 연결 점을 확인하세요. iPhone 위젯이 정상이어도 Mac 확장이 최신 상태라는 증거는 아닙니다.
구매와 환불
Apple은 CasaRay Plus의 결제, 갱신, 해지, 환불과 구매 기록을 처리합니다. Plus가 활성 상태로 표시되지 않으면 CasaRay에서 구매 복원을 사용하고, 그래도 앱이 구매를 인식하지 못하면 지원에 문의하세요.
미리보기 모드
미리보기 모드는 제공자 연결이 필요하지 않습니다. 실시간 제어를 위해서는 Home Assistant를 연결하거나 iPhone, iPad, Mac에서 선택한 Apple Home 액세서리를 승인하세요.
요구 사항
CasaRay는 iOS 또는 iPadOS 17 이상, 페어링된 iPhone이 있는 watchOS 10 이상, 또는 macOS 14 이상이 필요합니다. 실시간 제어에는 설정된 제공자가 필요합니다. Home Assistant, iPhone·iPad·Mac의 선택된 Apple Home 액세서리 또는 둘 다 사용할 수 있습니다. CarPlay는 호환되는 차량이나 헤드 유닛과 페어링된 iPhone이 필요하며, 전체 앱이나 카메라 탐색 대신 음성과 제한된 수동 제어를 제공합니다. 기능은 각 기기와 제공자가 노출하는 능력에 따라 달라집니다. 어시스턴트에는 CasaRay Plus, 자격을 충족하는 ChatGPT 계정과 지원되는 App Store 지역도 필요합니다.