스타일 미디어 수신기를 사용하거나 맞춤 수신기를 빌드하는 경우 애플리케이션을 등록해야 합니다. 애플리케이션을 등록하면 애플리케이션 ID가 수신됩니다. 이 ID는 발신기 애플리케이션이 API 호출을 실행하는 데(예: Web Receiver 애플리케이션 실행) 사용합니다.
기본 미디어 수신기를 사용하면 애플리케이션을 등록하지 않아도 됩니다. 기본 미디어 수신기를 사용하면 미디어 플레이어 UI에 스타일을 지정할 수 없으며 제공된 상수를 애플리케이션 ID로 사용합니다.
또한 게시하기 전에 웹 수신기 애플리케이션에 액세스할 수 있도록 Google Cast 기기를 등록해야 합니다. 수신기 애플리케이션을 게시하면 모든 Google Cast 기기에서 사용할 수 있습니다.
애플리케이션
애플리케이션을 등록하면 애플리케이션을 게시하기 전에 등록된 Cast 기기를 대상으로 테스트할 수 있습니다. 애플리케이션을 게시하면 모든 Cast 기기에서 사용할 수 있습니다.
애플리케이션 등록
발신기 애플리케이션의 API 호출에 사용되는 애플리케이션 ID를 수신하려면 스타일 미디어 수신기 또는 맞춤 수신기를 등록해야 합니다.
Cast 애플리케이션을 등록하려면 다음 단계를 따르세요.
- Google Cast SDK 개발자 콘솔에 로그인합니다.
- 개요 페이지 또는 애플리케이션 페이지에서 새 애플리케이션 추가를 클릭합니다.
사용할 웹 수신기 앱 유형을 선택하세요.
맞춤 수신기
앱에 스타일 미디어 수신기에서 제공하지 않는 사용자 인터페이스 구성요소 또는 상호작용 패턴이 필요한 경우 이 옵션을 선택합니다. 콘텐츠 유형이 스타일 미디어 수신기의 지원되는 미디어 유형 중 하나로 나열되지 않은 경우 맞춤 수신기를 선택해야 할 수도 있습니다.
이 옵션을 사용하려면 웹 수신기 앱을 위한 완전한 웹 앱을 빌드해야 합니다.
자세한 내용은 맞춤 수신기 애플리케이션을 참고하세요.
스타일 미디어 수신기
앱에서 지원되는 미디어 유형 중 하나를 사용하여 동영상 또는 오디오 콘텐츠를 스트리밍하고 기본 미디어 플레이어 UI 또는 기본 미디어 플레이어 UI를 기반으로 한 맞춤 스타일 모음을 사용하는 사용자 인터페이스를 TV에 제공하려는 경우 이 옵션을 선택합니다.
제공할 수 있는 맞춤 스타일을 사용하면 간단하게 CSS 파일을 제공하여 플레이어 UI의 다양한 요소 (예: 스플래시 화면, 진행률 표시줄)의 디자인을 정의할 수 있습니다. 수신기 앱을 빌드하지 않아도 됩니다.
자세한 내용은 스타일 미디어 수신기를 참고하세요.
Web Receiver 앱의 세부정보를 입력합니다.
Name 필드에 앱 이름을 입력합니다.
이는 웹 수신기가 로드 중일 때 또는 스타일 미디어 수신기를 사용하는 경우 유휴 상태일 때 표시되는 애플리케이션 이름입니다. 맞춤 수신기를 사용하고 있다면 이 필드의 값은 애플리케이션 상태의 기본값입니다(
setApplicationState메서드를 사용하여 설정되지 않은 경우).웹 수신기 앱의 모양을 지정합니다.
맞춤 수신기의 경우 URL 필드에서 앱 URL을 지정합니다.
웹 수신기 앱을 로드할 때 Google Cast 기기에서 요청해야 하는 URL을 입력합니다. 개발 중에는 URL이 HTTP를 사용할 수 있지만 앱이 게시되면 HTTPS를 사용해야 합니다. URL은 HTML 페이지 또는 웹브라우저에서 액세스할 수 있는 다른 파일 형식일 수 있습니다. Web Receiver는 최상위 도메인이 아니므로 localhost가 아닌 내부 (NAT 등록) IP 주소에 있어도 괜찮습니다. 웹 수신기 앱은 게시 시 SSL (HTTPS)을 통해 제공되어야 하지만 웹 수신기 앱에 로드된 콘텐츠는 HTTP를 통해 제공될 수 있습니다.
스타일 미디어 수신기의 경우 스킨 URL 필드에서 스타일 시트의 URL을 지정합니다.
자체 웹사이트에 있는 CSS 파일을 가리키는 HTTPS URL을 제공합니다. 기본 스타일을 사용하려면 입력란을 비워둡니다. 맞춤 스타일을 제공하거나 업데이트하려는 경우 나중에 언제든지 이를 수정할 수 있습니다.
릴레이 전송 지원 체크박스를 선택하거나 선택 해제한 상태로 둡니다.
릴레이 전송을 사용하면 웹 수신기가 수신자와 동일한 Wi-Fi 네트워크에 연결되지 않은 발신자의 전송을 지원할 수 있습니다. 수신기의 릴레이 전송을 사용 중지하려면 이 체크박스를 선택 해제하세요.
오디오 전용 기기로 전송 지원 체크박스를 선택하거나 선택 해제한 상태로 둡니다.
앱에서 오디오 기기용 Google Cast를 검색할 수 있도록 허용하려면 이 체크박스를 선택합니다. 오디오 전용 기기 지원을 사용 중지하려면 이 체크박스를 선택 해제합니다. 자세한 내용은 오디오 기기를 참고하세요.
저장을 클릭합니다.
애플리케이션 ID, 이름, 유형, 상태를 포함한 등록 세부정보가 표시됩니다. 애플리케이션의 Cast API 호출을 함께 제공하므로 애플리케이션 ID를 기록해 둡니다.
완료를 클릭하여 애플리케이션 페이지로 돌아갑니다.
애플리케이션 정보 수정
애플리케이션을 게시하기 전에 몇 가지 추가 정보를 제공해야 합니다. 등록 중에 애플리케이션에 관해 제공한 정보를 업데이트할 수도 있습니다.
애플리케이션 정보를 수정하려면 다음 단계를 따르세요.
- Google Cast SDK 개발자 콘솔의 개요 페이지 또는 애플리케이션 페이지에서 애플리케이션 ID를 클릭하거나 수정하려는 애플리케이션의 수정을 클릭합니다.
- 이름 필드에서 애플리케이션을 등록할 때 제공한 이름을 업데이트합니다.
- 맞춤 수신기 애플리케이션의 경우 URL 필드에서 등록한 웹 수신기 애플리케이션의 위치를 업데이트합니다.
- 스타일 수신기 애플리케이션의 경우 스킨 URL 필드에서 애플리케이션의 스타일 시트 위치를 업데이트합니다.
릴레이 전송 지원 체크박스를 선택하거나 선택 해제한 상태로 둡니다.
릴레이 전송을 사용하면 웹 수신기가 수신자와 동일한 Wi-Fi 네트워크에 연결되지 않은 발신자의 전송을 지원할 수 있습니다. 수신기에서 릴레이 전송을 사용 중지하려면 이 체크박스를 선택 해제합니다.
오디오 전용 기기로 전송 지원 체크박스를 선택하거나 선택 해제한 상태로 둡니다.
앱이 오디오 기기용 Google Cast를 검색할 수 있도록 허용하려면 이 체크박스를 선택합니다. 오디오 전용 기기 지원을 사용 중지하려면 이 체크박스를 선택 해제합니다. 자세한 내용은 오디오 기기를 참고하세요.
발신자 세부정보 섹션에서 앱이 지원하는 플랫폼별로 다음을 제공합니다.
Android:
- 애플리케이션 패키지의 정규화된 이름입니다.
iOS:
- Apple에 필요한 iTunes ID 및 Bundle ID를 확인해야 합니다.
- 앱 실행 URI: Google Home 앱이 앱을 실행하는 데 사용하는 URI를 사용합니다. 필수 URI 형식에 관한 자세한 내용은 앱과 통신하기 위해 URL 스킴 사용을 참고하세요.
웹:
- 애플리케이션의 웹사이트 URL입니다.
등록정보 세부정보 섹션에서 chromecast.com/apps.와 같은 Google 서비스에 애플리케이션을 표시할지 여부를 선택합니다.
Category 드롭다운 메뉴에서 애플리케이션을 가장 잘 설명하는 카테고리를 선택합니다.
참고: 앱은 여기에 설명된 미디어 유형뿐만 아니라 다른 설정에 암시된 미디어 유형을 지원해야 합니다. 예를 들어 앱에서 오디오용 Google Cast를 지원하고 여기에서 TV 및 영화를 선택하면 앱은 오디오 기기에 설명된 오디오 전용 기기와 동영상 재생 조항을 지원해야 합니다.
앱을 사용할 수 있는 국가를 설명하려면 모든 국가 또는 선택한 국가에서만 라디오 버튼을 선택합니다. 국가를 지정하는 경우 표시되는 목록에서 해당 국가의 체크박스를 선택합니다.
제목 입력란에 애플리케이션을 설명하는 제목을 입력합니다.
50자(영문 기준) 이하여야 합니다. 예: 'YouTube'
설명 필드에 애플리케이션에 대한 설명을 입력합니다.
80자(영문 기준) 이하여야 합니다. 예: '좋아하는 YouTube 채널을 집에서 최상의 화면으로 즐기세요.'
그래픽 섹션에서 더하기 기호를 클릭하여 애플리케이션의 아이콘 이미지를 업로드합니다.
이미지는 512X512픽셀이어야 하며 투명한 배경을 사용할 수 있습니다.
Add Your Own Translations(자체 번역 추가)에서 제목 및 설명 필드에 번역을 제공하려면 드롭다운 메뉴에서 언어를 선택하고 추가를 클릭한 후 표시되는 대화상자에 번역된 텍스트를 입력합니다. 해당 번역과 관련된 아이콘의 이미지를 업로드할 수도 있습니다.
애플리케이션 정보 업데이트가 완료되면 저장을 클릭합니다.
애플리케이션 게시
애플리케이션을 게시하면 전 세계의 모든 Cast 기기에서 애플리케이션을 사용할 수 있습니다. 또한 사용자가 앱을 검색하고 다운로드할 수 있는 chromecast.com/apps 목록 사이트와 같은 Google 서비스에 표시되는 애플리케이션 목록도 만듭니다. 위 6단계에서 애플리케이션 정보를 수정할 때 앱을 나열하도록 선택한 경우 앱이 게시되면 chromecast.com/apps에 표시됩니다.
애플리케이션을 게시하는 방법은 다음과 같습니다.
Google Cast SDK 개발자 콘솔의 개요 페이지 또는 애플리케이션 페이지에서 게시하려는 애플리케이션의 게시를 클릭합니다.
애플리케이션 정보가 완성되면 애플리케이션 정보 수정에서 입력한 애플리케이션 정보가 표시된 미리보기 화면이 나타납니다. 그렇지 않은 경우 제공해야 하는 정보가 포함된 메시지가 표시됩니다.
수정을 클릭하면 뒤로 돌아가 정보를 업데이트할 수 있습니다.
애플리케이션을 게시할 준비가 되면 게시를 클릭합니다.
통계
Google Cast SDK 개발자 콘솔은 애플리케이션의 성능을 추적합니다. 애플리케이션 또는 개요 페이지에 게시된 각 애플리케이션의 통계 열에서 보기를 클릭하여 성능 데이터를 볼 수 있습니다.
다음 정보가 표시됩니다.
- 애플리케이션을 실행한 Cast 수신기 수
- 시작된 세션 수
- 세션당 평균 미디어 재생 시간 (분)
통계에 기타 플랫폼이 표시되면 발신자가 플랫폼을 표시하지 않았음을 의미합니다. 예를 들어 이전 iOS 발신자가 업데이트되지 않은 경우입니다.
기기
기본적으로 Google Cast 기기 (예: Chromecast 또는 Android TV 기기)는 개발 및 테스트에 사용 설정되어 있지 않습니다. 기기를 개발 기기로 전환하고 개발 중에 게시되지 않은 Web Receiver 앱에 액세스하려면 앱을 앱에 등록해야 합니다. 또한 등록하면 디버깅을 위해 원격 브라우저 창에서 수신기에 액세스할 수 있습니다 (디버깅 참고).
Google Cast 기기를 등록하려면 다음 단계를 따르세요.
Google Cast 기기를 설정하고 컴퓨터와 동일한 Wi-Fi 네트워크에 연결합니다.
자세한 내용은 Cast 기기 설정 안내를 참고하세요.
컴퓨터에서 Cast 지원 웹브라우저를 엽니다.
Google Cast SDK 개발자 콘솔에 로그인합니다.
등록하려는 기기의 일련번호를 찾습니다.
개요 페이지 또는 기기 페이지에서 새 기기 추가를 클릭합니다.
기기의 일련번호를 입력합니다.
설명을 입력하고 확인을 클릭합니다.
기기의 친숙한 이름일 뿐입니다 (사용자 설정 중에 기기에 지정한 이름과 일치하지 않아도 됨).
15분 후에 계속 진행합니다.
등록이 완료되면 기기 상태가 '테스트 준비 완료'로 표시됩니다.
전원 또는 USB 케이블을 기기에서 분리하여 Cast 기기를 다시 시작한 후 다시 연결합니다.
기기 일련번호 찾기
기기의 일련번호를 찾으려면 Cast Developer Console 페이지를 기기로 전송하세요.
이 페이지를 전송하는 것처럼 전송 버튼을 클릭합니다.
프롬프트에 전송 탭이 표시되고 사용 가능한 기기가 나열됩니다.
드롭다운 메뉴에서 일련번호를 가져올 기기를 선택합니다.
- 디스플레이 기기의 경우 일련번호가 TV 화면에 표시되고 TV 스피커에서 소리 내어 읽습니다 (0과 O를 구별하는 데 도움이 됨).
- 오디오 기기의 경우 전송 대상 스피커에서 일련번호를 소리 내어 읽습니다.
Android TV 소프트웨어 일련번호
Android TV (ATV) 기기에는 여러 개의 일련번호가 연결되어 있습니다. 소프트웨어 (Cast) 일련번호는 위에서 설명한 대로 Cast 개발자 콘솔 페이지를 ATV 기기로 전송하거나, ATV 기기를 개발자 모드로 설정하고 Cast 설정에서 소프트웨어 일련번호를 찾아 얻을 수 있습니다.
ATV 기기를 개발자 모드로 전환하려면 Settings > System > About > Android TV OS build로 이동하여 기기에 개발자 모드 상태라고 알릴 때까지 빌드를 여러 번 클릭합니다. 개발자 모드에서 일련번호를 찾으려면 ATV 모델에 따라 설정 > 기기 환경설정 > Chromecast 내장 기기 또는 설정 > 시스템 > 전송으로 이동합니다. 그러면 소프트웨어 일련번호가 표시됩니다.
ATV 기기가 초기화되면 소프트웨어 일련번호가 변경됩니다. 초기화 후 위의 단계에 따라 소프트웨어 일련번호를 찾아 Cast Developer Console에서 기기의 새 소프트웨어 일련번호를 다시 등록합니다.
계정 문제
Google Cast 개발자 콘솔 등록을 취소하고 싶습니다.
개발자 계정 등록 수수료 5달러는 환불되지 않습니다.
Google Cast 개발자 콘솔에 더 이상 액세스할 수 없습니다.
이전에 Google에서 서비스 약관 또는 콘텐츠 정책을 여러 번 위반하여 개발자 계정이 정지되었음을 알리는 이메일을 받은 경우, 추가 설명이 필요하면 이메일에 답장해 주시기 바랍니다.
앱이 Google Cast에서 삭제됨
삭제된 애플리케이션은 개발자 계정에 부정적인 영향을 미칩니다. 정책을 여러 번 또는 심각하게 위반하면 개발자 계정이 해지될 수 있습니다.
삭제란 사용자가 삭제된 애플리케이션을 보거나 액세스할 수 없음을 의미합니다. Google Cast 개발자 인증 정보가 아직 양호한 상태이고 애플리케이션 특성상 가능하다면, 애플리케이션을 수정하여 정책을 준수하는 새로운 애플리케이션을 게시할 수 있습니다.
정책 위반을 수정할 때까지 삭제된 애플리케이션을 다시 게시하지 마세요.
계정과 연결된 이메일 주소를 변경하고 싶습니다.
Google Cast 개발자 계정에 연결된 이메일 주소는 변경할 수 없습니다. 조직에서 일하는 경우 향후 액세스 문제가 발생하지 않도록 팀 이메일 주소를 사용하는 것이 좋습니다.
다른 문제가 있습니다.
Cast SDK 지원 페이지를 참조하세요.