등록

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

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

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

애플리케이션

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

애플리케이션 등록

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

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

  1. Google Cast SDK 개발자 콘솔에 로그인합니다.
  2. 개요 페이지 또는 애플리케이션 페이지에서 새 애플리케이션 추가를 클릭합니다.
  3. 사용할 웹 수신기 앱 유형을 선택합니다.

    • 맞춤 수신기

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

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

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

    • 스타일 미디어 수신기

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

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

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

  4. 웹 수신기 앱의 세부정보를 입력합니다.

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

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

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

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

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

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

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

      • Google Cast 게스트 모드 지원 체크박스를 선택 또는 선택 해제한 채로 둡니다.

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

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

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

  5. 저장을 클릭합니다.

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

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

애플리케이션 정보 수정

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

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

  1. Google Cast SDK 개발자 콘솔개요 페이지 또는 애플리케이션 페이지에서 애플리케이션 ID를 클릭하거나 수정하려는 애플리케이션의 수정을 클릭합니다.
  2. 이름 필드에서 애플리케이션을 등록할 때 입력한 이름을 업데이트합니다.
  3. 맞춤 수신기 애플리케이션의 경우 URL 필드에서 등록한 웹 수신기 애플리케이션의 위치를 업데이트합니다.
  4. 스타일 수신기 애플리케이션의 경우 스킨 URL 필드에서 애플리케이션의 스타일 시트 위치를 업데이트합니다.
  5. Google Cast 게스트 모드 지원 체크박스를 선택 또는 선택 해제한 상태로 둡니다.

    게스트 모드를 사용하면 웹 수신기가 수신기와 동일한 Wi-Fi 네트워크에 연결되지 않은 발신기에서 전송을 지원할 수 있습니다. 수신기에서 게스트 모드를 사용 중지하려면 이 체크박스를 선택 해제합니다. 자세한 내용은 게스트 모드를 참고하세요.

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

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

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

    • Android:

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

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

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

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

    참고: 앱은 여기에 설명된 미디어 유형뿐만 아니라 다른 설정에 의해 암시된 미디어 유형도 지원해야 합니다. 예를 들어 앱에서 오디오용 Google Cast를 지원하고 여기에서 TV 및 영화를 선택하는 경우 앱은 오디오 기기에 설명된 오디오 전용 기기는 물론 동영상 재생 프로비저닝도 지원해야 합니다.

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

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

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

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

    80자(영문 기준) 이하여야 합니다. 예: "좋아하는 YouTube 채널을 집에서 최상의 화면으로 즐길 수 있습니다."

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

    이미지는 512X512픽셀이어야 하며 배경이 투명한 것이 좋습니다.

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

  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. 등록하려는 기기의 일련번호를 찾습니다.

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

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

  7. 설명을 입력하고 OK를 클릭합니다.

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

  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 서비스 약관 또는 콘텐츠 정책을 여러 번 위반하여 개발자 계정이 정지되었다는 이메일을 받은 경우 추가 설명이 필요한 경우 이 이메일에 답장해 주시기 바랍니다.

앱이 Google Cast에서 삭제됨

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

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

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

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

Google Cast 개발자 계정에 연결된 이메일 주소는 변경할 수 없습니다. 조직에서 일하는 경우 앞으로 액세스 문제가 발생하지 않도록 팀 이메일 주소를 사용하는 것이 좋습니다.

다른 문제가 있습니다.

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