등록

스타일 미디어 수신기를 사용하거나 맞춤 수신기를 빌드하고 있다면 애플리케이션을 등록해야 합니다. 애플리케이션을 등록하면 애플리케이션 ID를 받게 됩니다. 이 ID는 전송자 애플리케이션에서 웹 수신기 애플리케이션 실행과 같은 API 호출을 수행하는 데 사용됩니다.

기본 미디어 수신기를 사용하는 경우 애플리케이션을 등록할 필요가 없습니다. 기본 미디어 수신기를 사용하면 미디어 플레이어 UI에 스타일을 지정할 수 없으며 제공된 상수를 애플리케이션 ID로 사용합니다.

또한 게시하기 전에 웹 수신기 애플리케이션에 액세스할 수 있도록 Google Cast 기기를 등록해야 합니다. 수신기 애플리케이션을 게시하면 모든 Google Cast 기기에서 사용할 수 있습니다.

참고: 앱이나 기기를 등록하기 전에 시작하기의 단계를 따르세요.

애플리케이션

애플리케이션을 등록하면 애플리케이션을 게시하기 전에 등록된 Cast 기기를 대상으로 테스트할 수 있습니다. 애플리케이션을 게시하면 모든 Cast 기기에서 사용할 수 있습니다.

애플리케이션 등록

발신기 애플리케이션의 API 호출에 사용되는 애플리케이션 ID를 수신하려면 스타일 미디어 수신기 또는 맞춤 수신기를 등록해야 합니다.

Cast 애플리케이션을 등록하려면 다음 단계를 따르세요.

1. Google Cast SDK 개발자 콘솔에 로그인합니다.
   조직에서 일하는 경우 개인 또는 개별 이메일 주소가 아닌 일반적인 팀 이메일 주소를 사용하여 등록하세요. Google Cast 개발자 계정의 이메일 주소는 계정을 만든 후에는 변경할 수 없습니다. 계속하기 전에 올바른 이메일 주소로 로그인했는지 확인하세요.
2. 개요 페이지 또는 애플리케이션 페이지에서 새 애플리케이션 추가를 클릭합니다.

3. 사용할 웹 수신기 앱 유형을 선택하세요.

   • 맞춤 수신기

     스타일 미디어 수신기에서 제공하지 않는 사용자 인터페이스 구성요소 또는 상호작용 패턴이 앱에 필요한 경우 이 옵션을 선택합니다. 콘텐츠 유형이 스타일 미디어 수신기의 지원되는 미디어 유형 중 하나로 나열되지 않은 경우에도 맞춤 수신기를 선택해야 할 수 있습니다.

     이 옵션을 사용하려면 웹 수신기 앱을 위한 완전한 웹 앱을 빌드해야 합니다.

     자세한 내용은 맞춤 수신기 애플리케이션을 참고하세요.

   • 스타일 미디어 수신기

     앱이 지원되는 미디어 유형 중 하나를 사용하여 동영상 또는 오디오 콘텐츠를 스트리밍하고 TV에 기본 미디어 플레이어 UI 또는 기본 미디어 플레이어 UI 위에 있는 맞춤 스타일 집합을 사용하는 사용자 인터페이스를 제공하려는 경우 이 옵션을 선택합니다.

     개발자가 제공하는 맞춤 스타일을 사용하면 CSS 파일을 제공하여 플레이어 UI의 다양한 요소 (예: 스플래시 화면 및 진행률 표시줄)의 스타일을 정의할 수 있습니다. 수신기 앱을 빌드할 필요가 없습니다.

     자세한 내용은 스타일 미디어 수신기를 참고하세요.

4. Web Receiver 앱에 관한 세부정보를 입력합니다.

   1. Name 필드에 앱 이름을 입력합니다.

      이 이름은 웹 수신기가 로드 중일 때 또는 스타일이 지정된 미디어 수신기를 사용하는 경우 유휴 상태에 표시되는 애플리케이션 이름입니다. 맞춤 수신기를 사용 중인 경우 이 필드의 값은 setApplicationState 메서드를 사용하여 설정되지 않은 경우 애플리케이션 상태의 기본값입니다.

   2. 웹 수신기 앱의 모양을 지정합니다.

      • 맞춤 수신기의 경우 URL 필드에 앱 URL을 지정합니다.

        웹 수신기 앱을 로드할 때 Google Cast 기기에서 요청해야 하는 URL을 입력합니다. 개발 중에는 URL에서 HTTP를 사용할 수 있지만 앱을 게시할 때는 HTTPS를 사용해야 합니다. 이 URL은 HTML 페이지 또는 웹브라우저에서 액세스할 수 있는 기타 파일 형식의 URL일 수 있습니다. 웹 수신기가 내부 (NAT 등록) IP 주소에 있어도 괜찮지만 최상위 도메인이 아니기 때문에 localhost에 있지 않아도 됩니다. 웹 수신기 앱은 게시될 때 SSL (HTTPS)을 통해 제공되어야 하지만, 웹 수신기 앱에 로드된 콘텐츠는 HTTP를 통해 제공될 수도 있습니다.

      • 스타일 미디어 수신기의 경우 스킨 URL 필드에 스타일 시트의 URL을 지정합니다.

        웹사이트에 있는 CSS 파일을 가리키는 HTTPS URL을 제공합니다. 기본 스타일을 사용하려면 입력란을 비워둡니다. 맞춤 스타일을 제공하거나 업데이트하려면 나중에 언제든지 수정할 수 있습니다.

      • 릴레이 전송 지원 체크박스를 선택하거나 선택 해제된 상태로 둡니다.

        릴레이 전송을 사용하면 웹 수신기가 수신기와 동일한 Wi-Fi 네트워크에 연결되지 않은 발신자로부터의 전송을 지원할 수 있습니다. 수신기의 릴레이 전송을 사용 중지하려면 이 체크박스를 선택 해제하세요.

      • 오디오 전용 기기로의 전송 지원 체크박스를 선택 또는 선택 해제 상태로 둡니다.

        앱이 오디오 기기용 Google Cast 기기를 검색하도록 허용하려면 이 체크박스를 선택하세요. 오디오 전용 기기 지원을 사용 중지하려면 이 체크박스를 선택 해제합니다. 자세한 내용은 오디오 기기를 참고하세요.

5. 저장을 클릭합니다.

   애플리케이션 ID, 이름, 유형, 상태를 포함한 등록 세부정보가 표시됩니다. 애플리케이션의 Cast API 호출과 함께 제공되므로 애플리케이션 ID를 기록해 둡니다.

6. 완료를 클릭하여 애플리케이션 페이지로 돌아갑니다.

애플리케이션 정보 수정

애플리케이션을 게시하기 전에 몇 가지 추가 정보를 제공해야 합니다. 등록 중에 신청에 관해 제공한 정보를 업데이트할 수도 있습니다.

애플리케이션 정보를 수정하려면 다음 단계를 따르세요.

1. Google Cast SDK 개발자 콘솔의 개요 페이지 또는 애플리케이션 페이지에서 애플리케이션 ID 또는 수정하려는 애플리케이션에서 수정을 클릭합니다.
2. 이름 필드에서 애플리케이션을 등록할 때 제공한 이름을 업데이트합니다.
3. 맞춤 수신기 애플리케이션의 경우 URL 필드에서 등록한 웹 수신기 애플리케이션의 위치를 업데이트합니다.
4. 스타일이 지정된 수신기 애플리케이션의 경우 스킨 URL 필드에서 애플리케이션의 스타일 시트 위치를 업데이트합니다.

5. 릴레이 전송 지원 체크박스를 선택하거나 선택 해제된 상태로 둡니다.

   릴레이 전송을 사용하면 웹 수신기가 수신기와 동일한 Wi-Fi 네트워크에 연결되지 않은 발신자로부터의 전송을 지원할 수 있습니다. 수신자의 릴레이 전송을 사용 중지하려면 이 체크박스를 선택 해제하세요.

6. 오디오 전용 기기로 전송 지원 체크박스를 선택하거나 선택 해제된 상태로 둡니다.

   앱이 오디오 기기용 Google Cast 기기를 검색하도록 허용하려면 이 체크박스를 선택합니다. 오디오 전용 기기에 대한 지원을 사용 중지하려면 이 체크박스를 선택 해제합니다. 자세한 내용은 오디오 기기를 참고하세요.

7. 발신자 세부정보 섹션에서 앱이 지원하는 각 플랫폼에 대해 다음을 제공합니다.

   • Android:

     • 애플리케이션 패키지의 정규화된 이름입니다.

   • iOS:

     • Apple에서 요구하는 iTunes ID 및 Bundle ID입니다.
     • 앱 실행 URI: Google Home 앱에서 앱을 실행하는 데 사용하는 URI를 사용합니다. 필수 URI 형식에 관한 자세한 내용은 URL 스키마를 사용하여 앱과 통신을 참고하세요.

   • 웹:

     • 애플리케이션의 웹사이트 URL을 입력합니다.

8. 목록 세부정보 섹션에서 chromecast.com/apps.와 같은 Google 서비스에 애플리케이션을 표시할지 선택합니다.

9. 카테고리 드롭다운 메뉴에서 애플리케이션을 가장 잘 설명하는 카테고리를 선택합니다.

   참고: 앱은 여기에 설명된 미디어 유형뿐만 아니라 다른 설정에 암시된 미디어 유형도 지원해야 합니다. 예를 들어 Google Cast 오디오를 지원하는 앱에서 여기에서 TV 및 영화를 선택하면 오디오 기기에 설명된 대로 오디오 전용 기기와 동영상 재생 조항도 지원해야 합니다.

10. 앱이 제공되는 국가를 설명하려면 모든 국가 또는 선택한 국가에만 라디오 버튼을 선택합니다. 국가를 지정하는 경우 표시되는 목록에서 해당 국가의 체크박스를 선택합니다.

11. 제목 필드에 애플리케이션을 설명하는 제목을 입력합니다.

    50자(영문 기준) 이하여야 합니다. 예: 'YouTube'

12. 설명 필드에 애플리케이션에 대한 설명을 입력합니다.

    80자(영문 기준) 이하여야 합니다. 예: '좋아하는 YouTube 채널을 집 안에서 가장 좋은 화면으로 즐기세요.'

13. 그래픽 섹션에서 더하기 기호를 클릭하여 애플리케이션의 아이콘 이미지를 업로드합니다.

    이미지는 512X512픽셀이어야 하며 투명한 배경을 사용할 수 있습니다.

14. Add Your Own Translations(자체 번역 추가) 아래의 Title(제목) 및 Description(설명) 필드에 번역을 제공하려면 드롭다운 메뉴에서 언어를 선택하고 Add(추가)를 클릭한 후 표시되는 대화상자에 번역된 텍스트를 입력합니다. 해당 번역과 관련된 아이콘의 이미지도 업로드할 수 있습니다.

15. 애플리케이션 정보 업데이트를 완료하면 저장을 클릭합니다.

참고: 이러한 수정사항을 적용하려면 앱을 게시 (또는 다시 게시)해야 합니다.

애플리케이션 게시

애플리케이션을 게시하면 전 세계 모든 Cast 기기에서 애플리케이션을 사용할 수 있습니다. 또한 사용자가 앱을 검색하고 다운로드할 수 있는 chromecast.com/apps 등록정보 사이트와 같은 Google 서비스에 애플리케이션 등록정보를 만듭니다. 위의 6단계에서 애플리케이션 정보를 수정할 때 앱을 표시하도록 선택한 경우 앱이 게시된 후 chromecast.com/apps에 표시됩니다.

참고: 애플리케이션 정보 수정에 설명된 모든 정보를 제공해야 애플리케이션을 게시할 수 있습니다.

애플리케이션을 게시하려면 다음 단계를 따르세요.

1. Google Cast SDK 개발자 콘솔의 개요 페이지 또는 애플리케이션 페이지에서 게시할 애플리케이션에 대해 게시를 클릭합니다.

   애플리케이션 정보가 완성되면 애플리케이션 정보 수정에 입력한 애플리케이션 정보와 함께 미리보기 화면이 표시됩니다. 그렇지 않은 경우 제공해야 하는 정보가 포함된 메시지가 표시됩니다.

2. 수정을 클릭하면 돌아가서 정보를 업데이트할 수 있습니다.

3. 애플리케이션을 게시할 준비가 되면 게시를 클릭합니다.

통계

Google Cast SDK 개발자 콘솔은 애플리케이션의 성능을 추적합니다. 애플리케이션 또는 개요 페이지에 게시된 각 애플리케이션의 통계 열에서 보기를 클릭하면 성능 데이터를 볼 수 있습니다.

다음 정보가 표시됩니다.

• 애플리케이션을 실행한 Cast 수신기 수
• 실행된 세션 수
• 세션당 평균 미디어 재생 시간 (분)

통계에 기타 플랫폼이 표시되면 발신자가 플랫폼을 지정하지 않았음을 의미합니다(예: 이전 iOS 발신자가 업데이트되지 않음).

기기

기본적으로 Google Cast 기기 (예: Chromecast 또는 Android TV 기기)는 개발 및 테스트에 사용 설정되지 않습니다. 기기를 개발 기기로 전환하고 개발 중에 게시되지 않은 웹 수신기 앱에 액세스하려면 기기를 앱에 등록해야 합니다. 등록하면 디버깅을 위해 원격 브라우저 창에서 수신기에 액세스할 수도 있습니다 (디버깅 참고).

Google Cast 기기를 등록하려면 다음 단계를 따르세요.

1. Google Cast 기기를 설정하고 컴퓨터와 동일한 Wi-Fi 네트워크에 연결합니다.

   자세한 내용은 Cast 기기 설정 안내를 참고하세요.

2. 컴퓨터에서 Cast 지원 웹브라우저를 엽니다.

3. Google Cast SDK 개발자 콘솔에 로그인합니다.

4. 등록하려는 기기의 일련번호를 찾습니다.

   참고: Android TV (ATV) 기기에는 여러 일련번호가 연결되어 있습니다. ATV 기기의 소프트웨어 (Cast) 일련번호를 사용해야 합니다. ATV 기기의 일련번호를 확인하는 방법에 관한 자세한 내용은 ATV 기기의 일련번호 확인을 참고하세요.

5. 개요 페이지 또는 기기 페이지에서 새 기기 추가를 클릭합니다.

6. 기기의 일련번호를 입력합니다.

7. 설명을 입력하고 확인을 클릭합니다.

   이 이름은 기기의 친숙한 이름일 뿐입니다 (사용자 설정 중에 기기에 지정한 이름과 일치하지 않아도 됨).

8. 15분 후에 계속하세요.

   등록이 완료되면 기기 상태에 '테스트 준비 완료'라고 표시됩니다.

9. Cast 기기를 다시 시작합니다. 기기에서 전원 또는 USB 케이블을 분리했다가 다시 연결합니다.

기기 일련번호 찾기

기기의 일련번호를 찾으려면 Cast 개발자 콘솔 페이지를 기기로 전송하면 됩니다.

1. 이 페이지를 전송하는 것처럼 전송 버튼을 클릭합니다.

   메시지에는 전송 탭이 표시되고 사용 가능한 기기가 나열됩니다.

2. 드롭다운 메뉴에서 일련번호를 가져올 기기를 선택합니다.

   • 디스플레이 기기의 경우 일련번호가 TV 화면에 표시되고 TV 스피커에서 소리 내어 읽습니다 (0과 O를 구별하는 데 유용함).
   • 오디오 기기의 경우 전송되는 스피커에서 일련번호를 소리 내어 읽습니다.

Android TV 소프트웨어 일련번호

Android TV (ATV) 기기에는 여러 일련번호가 연결되어 있습니다. 소프트웨어 (Cast) 일련번호는 위에 설명된 대로 Cast 개발자 콘솔 페이지를 ATV 기기로 전송하거나 ATV 기기를 개발자 모드로 설정하고 Cast 설정에서 소프트웨어 일련번호를 확인하여 얻을 수 있습니다.

ATV 기기를 개발자 모드로 전환하려면 설정 > 시스템 > 정보 > Android TV OS 빌드로 이동하여 기기에 개발자 모드라는 알림이 표시될 때까지 빌드를 여러 번 클릭합니다. 개발자 모드에서 일련번호를 한 번 찾으려면 ATV 모델에 따라 설정 > 기기 환경설정 > Chromecast 내장 또는 설정 > 시스템 > 전송으로 이동하면 소프트웨어 일련번호가 표시됩니다.

ATV 기기가 초기화되면 소프트웨어 일련번호가 변경됩니다. 초기화 후 위의 단계에 따라 소프트웨어 일련번호를 찾고 Cast 개발자 콘솔에 기기의 새 소프트웨어 일련번호를 다시 등록합니다.

계정 문제

Google Cast 개발자 콘솔 등록을 취소하고 싶습니다.

5달러의 개발자 계정 등록 수수료는 환불되지 않습니다.

Google Cast 개발자 콘솔에 더 이상 액세스할 수 없음

이전에 서비스 약관 또는 콘텐츠 정책을 여러 번 위반하여 개발자 계정이 정지되었다는 이메일을 받은 경우 자세한 설명이 필요하면 이메일에 답장해 주시기 바랍니다.

앱이 Google Cast에서 삭제됨

삭제된 애플리케이션은 개발자 계정의 양호한 상태에 부정적인 영향을 미칩니다. 정책을 여러 번 또는 심각하게 위반하면 개발자 계정이 해지될 수 있습니다.

삭제는 사용자가 삭제된 애플리케이션을 보거나 액세스할 수 없음을 의미합니다. Google Cast 개발자 인증 정보가 아직 양호한 상태이고 애플리케이션 특성상 가능하다면, 애플리케이션을 수정하여 정책을 준수하는 새로운 애플리케이션 인스턴스를 게시할 수 있습니다.

정책 위반이 수정될 때까지 삭제된 애플리케이션을 다시 게시하지 마세요.

내 계정에 연결된 이메일 주소를 변경하고 싶습니다.

Google Cast 개발자 계정에 연결된 이메일 주소는 변경할 수 없습니다. 조직에서 일하는 경우 향후 액세스 문제를 방지하려면 팀 이메일 주소를 사용하는 것이 좋습니다.

다른 문제가 있습니다.

Cast SDK 지원 페이지를 참조하세요.