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