명령어 및 제어 (CaC) 도구

명령어 및 제어 (CaC) 도구는 개발자가 웹 수신기 애플리케이션을 테스트하고 디버그하는 데 사용할 수 있는 웹 발신자입니다.

개발자는 CaC 도구를 사용하여 다음을 수행할 수 있습니다.

  • Cast 지원 기기에서 웹 수신기 앱을 실행하고 로드 요청을 전송하여 미디어 재생을 시작합니다.
  • Google 어시스턴트가 웹 수신기로 전송한 음성 명령을 시뮬레이션합니다.
  • Cast 디버그 로거에서 로그를 캡처하고 웹 수신기 디버그 오버레이를 제어합니다.

웹 수신기 앱 실행

다음 두 가지 방법으로 CaC 도구를 사용하여 웹 수신기를 실행할 수 있습니다.

  1. 새 전송 세션을 시작하려면 다음 단계를 따르세요.

    1. CaC 도구를 열고 웹 수신기 앱 ID를 입력한 다음 앱 ID 설정 버튼을 클릭합니다.

    2. 전송 버튼을 클릭하고 기기를 선택하여 원격 Cast 지원 기기에서 웹 수신기를 실행합니다.

  2. 기존 Cast 세션에 참여하려면 다음 단계를 따르세요.

    1. 다음 코드를 사용하여 실행 중인 Cast 세션 ID를 가져옵니다.

      웹 수신기 측에서 다음 메서드를 사용하여 Chrome 원격 디버거 콘솔에서 세션 ID를 가져옵니다.

      cast.framework.CastReceiverContext.getInstance().getApplicationData().sessionId;

      또는 연결된 웹 발신자로부터 세션 ID를 가져오려면 다음 메서드를 사용합니다.

      cast.framework.CastContext.getInstance().getCurrentSession().getSessionId();

    2. CaC 도구에 세션 ID를 입력하고 재개 버튼을 클릭합니다.

CaC 도구를 웹 수신기 앱에 연결하면 전송 버튼이 채워진 프레임 모양으로 나타납니다. Web Receiver 앱 ID와 세션 ID도 도구 상단에 표시됩니다.

미디어 로드

발신기 앱이나 CaC 도구에서 미디어를 로드합니다.

발신기 앱

웹 수신기에서 미디어 재생을 시작하려면 발신기 앱을 동일한 Cast 지원 기기로 전송하고 발신기 앱에서 웹 수신기로 로드 요청을 보내세요.

CaC 도구

CaC 도구는 웹 수신자 앱에 로드 요청을 보내는 다양한 방법도 제공합니다.

항목별 로드 (음성 변환)

사용자가 Google 어시스턴트를 통해 미디어 재생을 시작하면 Google 어시스턴트는 명령어 및 제어 (CaC) 메시지를 사용하여 사용자 인증 정보와 항목을 웹 수신기에 전송합니다.

CaC 도구는 음성 전송을 시뮬레이션하고 credentials 및 entity를 사용하여 로드 요청을 보냅니다.

콘텐츠로 로드

CaC 도구는 Content ID 또는 Content Url를 사용하여 로드 요청을 보내는 앱을 시뮬레이션할 수도 있습니다.

미디어 재생이 시작되면 CaC 도구는 웹 수신기 앱에서 미디어 상태 메시지를 수신하여 미디어 상태 탭에 표시합니다.

맞춤 로드 요청

자체 Load Request 객체를 사용하여 수신기를 테스트하려면 로드 미디어 탭의 맞춤 로드 요청 필드를 사용합니다. 먼저 요청 유형 선택 라디오 버튼에서 요청 유형을 선택한 다음 복사하여 JSON 객체를 붙여넣거나 자체 객체를 빌드합니다.

음성 명령 테스트

또한 CaC 도구는 Google 어시스턴트가 웹 수신기 앱에 전송한 음성 명령을 시뮬레이션합니다. 앱에서 지원한 미디어 명령어가 제대로 작동하는지 테스트할 수 있습니다. 지원되지 않는 미디어 명령어는 적절한 오류 유형 및 오류 이유로 처리해야 합니다.

Cast 디버그 로거 검사 및 제어

웹 수신기 앱이 Cast 디버그 로거를 사용 설정하면 CaC 도구가 로그 메시지를 캡처하고 웹 수신기 디버그 오버레이를 제어합니다.

웹 수신기 및 로그 메시지를 관리하려면 다음 버튼을 사용합니다.

  • 웹 수신기 앱 ID
    • 캐시 지우기 및 웹 수신기 중지 - 웹 수신기 앱을 새로고침하고 전송을 중지합니다.
  • 웹 수신기 디버그 오버레이
    • 표시 - 웹 수신기에서 디버그 오버레이를 전환합니다.
    • 삭제 - 웹 수신기 디버그 오버레이의 로그 메시지를 지웁니다.
  • 로그 메시지 관리
    • 메시지 삽입 - 로그 영역에 댓글 또는 구분선 삽입
    • 로그 다운로드 - 로그 메시지를 저장합니다.
    • 로그 지우기 - 로그 영역의 로그 메시지를 삭제합니다.
  • 로그 메시지
    • 맞춤 태그 - 체크박스를 클릭하여 로그 메시지를 필터링합니다.

다음 태그는 맞춤 태그 아래에 표시될 수 있습니다. 디버깅 세션과 관련된 중요한 로그 또는 메시지를 표시하고 필터링하기 위해 CaC 도구가 추가합니다.

  • MEDIA - 미디어 네임스페이스를 통해 메시지가 전송되었습니다.
  • MEDIA-ERROR - 전송하는 동안 또는 미디어 네임스페이스를 통해 전송된 메시지에 대한 응답으로 오류가 발생했습니다.
  • CAC: CAC 네임스페이스를 통해 메시지를 전송했습니다.
  • CAC-ERROR - 전송 중에 또는 CAC 네임스페이스를 통해 전송된 메시지에 대한 응답으로 오류가 발생했습니다.
  • 재생 중 - CaC 도구에서 재생 중인 음악 버튼을 클릭하면 결과를 표시하는 로그입니다.
  • USER - CaC 도구에서 메시지 삽입 버튼으로 사용자가 입력한 커스텀 메시지를 표시하는 로그

Cast Connect 테스트

Cast Connect를 테스트하려면 세션을 설정하기 전에 다음 단계를 수행하세요.

  1. Cast Connect 지원 수신기와 연결된 수신기 앱 ID를 입력하고 앱 ID 설정을 클릭합니다.
  2. Android TV 옵션 표시 버튼을 클릭합니다.
  3. androidReceiver호환 가능 체크박스를 선택합니다. 수신기에 Launch Credentials 설정이 필요하지 않거나 설정되지 않은 경우 어떻게 되는지 테스트하려면 여기서 중지하고 5단계로 진행하세요.
  4. (선택사항) Cast Connect 세션의 실행 사용자 인증 정보를 설정하기 위해 Launch Credentials를 입력하고 Set Launch Credentials(실행 사용자 인증 정보 설정) 버튼을 클릭합니다.
  5. 헤더의 전송 아이콘을 클릭하거나 Chrome 브라우저에서 전송 메뉴를 클릭하여 전송 세션을 시작합니다.

이제 Android TV 애플리케이션이 기기에서 실행됩니다.

이전
Cast 디버그 로거
다음
Chrome 원격 디버거