CaC 도구가 웹 수신기 앱에 연결되면 전송 버튼이 표시됩니다.
2개의 선으로 나뉩니다 웹 수신기 앱 ID와 세션 ID도
도구 상단에 표시됩니다.
미디어 로드
발신기 앱 또는 CaC 도구에서 미디어를 로드합니다.
발신자 앱
Web Receiver에서 미디어 재생을 시작하려면 발신기 앱을
전송 요청을 전송하여 발신기 앱에서
웹 수신기
CaC 도구
CaC 도구는 또한 로드 요청을 웹에 전송하는 다양한 방법을 제공합니다.
수신기 앱:
항목별 로드 (음성 전송)
사용자가 Google 어시스턴트를 통해 미디어 재생을 시작하면
커맨드 및 제어 (CaC) 메시지를 사용하여 사용자 인증 정보와 항목을
있습니다.
CaC 도구는 음성 전송을 시뮬레이션하고 credentials로 로드 요청을 전송합니다.
및 entity
콘텐츠별 로드
CaC 도구는 Content ID를 사용하여 로드 요청을 전송하는 앱을 시뮬레이션할 수도 있습니다.
또는 Content Url.
미디어 재생이 시작되면 CaC 도구는
웹 수신기 앱에 연결하여 미디어 상태 탭에 표시합니다.
커스텀 로드 요청
자체 Load Request 객체를 사용하여 broadcast receiver를 테스트하려면 다음을 사용합니다.
미디어 로드 탭 아래의 맞춤 로드 요청 필드. 먼저
요청 유형 선택 라디오 버튼의 요청 유형을 선택한 후 복사하여 붙여넣기
JSON 객체를 직접 빌드할 수 있습니다
음성 명령 테스트
또한 CaC 도구는
음성 명령
Google 어시스턴트를 웹 수신기 앱에 연결합니다. 미디어 명령어가
확인할 수 있습니다 지원되지 않는 미디어 명령어는
적절한 방식으로 처리하여
오류 유형 및 오류 이유를 자세히 알아보세요.
Cast 디버그 로거 검사 및 제어
웹 수신기 앱에서
CaC 도구인 Cast Debug Logger
로그 메시지를 캡처하고 웹 수신기 디버그 오버레이를 제어합니다.
다음 버튼을 사용하여 웹 수신기 및 로그 메시지를 제어합니다.
웹 수신기 앱 ID
<ph type="x-smartling-placeholder">
</ph>
캐시 지우기 및 웹 수신기 중지 - 웹 수신기 앱을 새로고침하고
전송 중지
웹 수신기 디버그 오버레이
<ph type="x-smartling-placeholder">
</ph>
표시 - 웹 수신기에서 디버그 오버레이를 전환합니다.
삭제 - 웹 수신기 디버그 오버레이의 로그 메시지를 삭제합니다.
로그 메시지 제어
<ph type="x-smartling-placeholder">
</ph>
Insert Message - 로그 영역에 댓글이나 구분선 삽입
로그 다운로드 - 로그 메시지를 저장합니다.
로그 지우기 - 로그 영역에서 로그 메시지를 지웁니다.
로그 메시지
<ph type="x-smartling-placeholder">
</ph>
맞춤 태그 - 체크박스를 클릭하여 로그 메시지를 필터링합니다.
다음 태그가 맞춤 태그 아래에 표시될 수 있습니다. 이러한 특성은
CaC 도구를 사용하면
디버깅 세션:
MEDIA - 미디어 네임스페이스를 통해 메시지가 전송되었습니다.
MEDIA-ERROR - 메시지를 보내는 중 또는 메시지에 대한 응답에서 오류가 발생함
미디어 네임스페이스를 통해 전송됨
CAC - CAC 네임스페이스를 통해 메시지가 전송됨
CAC-ERROR - 발신 중 또는 전송된 메시지에 대한 응답에서 오류 발생
CAC 네임스페이스에 대한
재생 중 - 재생 중인 음악 버튼을 누르면 결과를 표시하는 로그입니다.
CaC 도구에서 클릭된 횟수
USER - 사용자가 다음을 사용하여 입력한 맞춤 메시지를 표시하는 로그
CaC 도구의 Insert Message 버튼
Cast Connect 테스트
Cast Connect를 테스트하려면 세션을 설정하기 전에 다음 단계를 따르세요.
Cast Connect가 사용 설정된 수신기 앱 ID를 입력하세요.
앱 ID 설정을 클릭합니다.
Android TV 옵션 표시 버튼을 클릭합니다.
androidReceiverCompatible 체크박스를 선택합니다. 수신기가
Launch Credentials를 설정하거나
설정되어 있지 않으면 여기서 멈추고 5단계로 진행할 수 있습니다.
(선택사항) Launch Credentials를 입력하고 실행 설정
사용자 인증 정보 버튼: Cast의 실행 사용자 인증 정보를 설정합니다.
세션 연결
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eThe Command and Control (CaC) Tool is a web sender application for developers to test and debug their Web Receiver applications.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can use the CaC Tool to launch Web Receiver apps, simulate voice commands, load media, and inspect logs.\u003c/p\u003e\n"],["\u003cp\u003eThe CaC Tool provides features to simulate Google Assistant interactions, manage debug overlays, and control media playback.\u003c/p\u003e\n"],["\u003cp\u003eIt also enables developers to send custom load requests and test Cast Connect functionality for Android TV applications.\u003c/p\u003e\n"]]],[],null,["# Command and Control (CaC) Tool\n\nThe [Command and Control (CaC) Tool](https://casttool.appspot.com/cactool/) is\na functional web sender for developers to test and debug a Web Receiver application.\n\nDevelopers can use the CaC Tool to:\n\n- Launch a Web Receiver app on a Cast-enabled device and send a load request to start media playback.\n- Simulate [voice commands](/cast/docs/caf_receiver/core_features#voice_commands) sent by Google Assistant to the Web Receiver.\n- Capture logs from [Cast Debug Logger](/cast/docs/debugging/cast_debug_logger) and control the Web Receiver debug overlay.\n\nLaunch Web Receiver app\n-----------------------\n\nThere are two ways to launch your Web Receiver with the CaC Tool:\n\n1. To start a new Cast session:\n\n 1. Open the CaC Tool, enter your Web Receiver App ID and click the **SET APP ID** button.\n 2. Click on the Cast button and select a device to launch the Web Receiver\n on a remote Cast-enabled device.\n\n2. To join an existing Cast session:\n\n 1. Get the running Cast session ID by using the following codes:\n\n From the Web Receiver side, use the following method to get session ID in\n the [Chrome Remote Debugger](/cast/docs/debugging/remote_debugger) console: \n\n cast.framework.CastReceiverContext.getInstance().getApplicationData().sessionId;\n\n Or to get the session ID from a connected Web Sender, use the following\n method: \n\n cast.framework.CastContext.getInstance().getCurrentSession().getSessionId();\n\n 2. Enter the session ID in the CaC Tool and click the **RESUME** button.\n\nWhen the CaC Tool is connected to the Web Receiver app, the Cast button appears\nwith a filled frame shape. The Web Receiver app ID and session ID are also\ndisplayed at the top of the tool.\n\nLoad media\n----------\n\nLoad media from either your sender app or the CaC Tool.\n\n### Sender app\n\nTo start media playback on your Web Receiver, cast your sender app to the\nsame Cast-enabled device and send a load request from your sender app to the\nWeb Receiver.\n| **Note:** Make sure the sender app is using the same Web Receiver application ID as the one in the CaC Tool.\n\n### CaC Tool\n\nThe CaC Tool also provides multiple ways to send a load request to the Web\nReceiver app:\n\n#### Load by entity (voice casting)\n\nWhen users initiate media playback through Google Assistant, Google Assistant\nuses Command and Control (CaC) messages to send user credentials and entity to\nyour Web Receiver.\n\nThe CaC Tool simulates voice casting and sends a load request with `credentials`\nand `entity`.\n\n#### Load by content\n\nThe CaC Tool can also simulate your app sending a load request with `Content ID`\nor `Content Url`.\n| **Note:** We suggest you use `entity` in your implementation for both your sender and Web Receiver apps. For more information, see [Tip: Loading media using contentId, contentUrl and entity](/cast/docs/caf_receiver/core_features#tip_loading_media_using_contentid_contenturl_and_entity).\n\nWhen a media playback starts, the CaC Tool receives Media Status messages from\nyour Web Receiver app and displays them on the **MEDIA STATUS** tab.\n\n#### Custom Load Request\n\nIf you would like to test your receiver using your own `Load Request` objects, use\nthe **Custom Load Request** field under the **LOAD MEDIA** tab. First, select\nthe type of request from the **Select Request Type** radio buttons and then copy-paste\nor build your own JSON object.\n| **Note:** The editor supports the use of `Tab` key for indentation and formatting.\n\nTest voice commands\n-------------------\n\nThe CaC Tool also simulates\n[voice commands](/cast/docs/caf_receiver/core_features#voice_commands) sent by\nGoogle Assistant to your Web Receiver app. You can test if the media commands\nthat your app supported are working properly. Non-supported media commands must\nbe handled with appropriate\n[error type and error reasons](/cast/docs/caf_receiver/core_features#error_handling).\n\nInspect and control Cast Debug Logger\n-------------------------------------\n\nIf your Web Receiver app enables\n[Cast Debug Logger](/cast/docs/debugging/cast_debug_logger), the CaC Tool\ncaptures the log messages and controls the Web Receiver debug overlay.\n\nUse the following buttons to control the Web Receiver and log messages:\n\n- Web Receiver App ID\n - **Clear Cache and Stop Web Receiver** - Reload the Web Receiver app and stop casting\n- Web Receiver Debug Overlay\n - **Show** - Toggle the debug overlay on the Web Receiver\n - **Clear** - Clear log messages on the Web Receiver debug overlay\n- Log Message Controls\n - **Insert Message** - Insert comments or dividers to the log area\n - **Download Log** - Save log messages\n - **Clear Log** - Clear log messages on the log area\n- Log Messages\n - **Custom Tags** - Click the checkbox to filter log messages\n\nFollowing tags might appear under the **Custom Tags**. These are added by the\nCaC Tool to show and filter important logs or messages pertaining to the\ndebugging session:\n\n- **MEDIA** - Messages successfully sent over the Media namespace\n- **MEDIA-ERROR** - Error occurred while sending, or in response to messages sent over the Media namespace\n- **CAC** - Messages successfully sent over the CAC namespace\n- **CAC-ERROR** - Error occurred while sending, or in response to messages sent over the CAC namespace\n- **PLAYING** - Log displaying the result when the **What's Playing** button is clicked in the CaC Tool\n- **USER** - Log displaying custom message entered by User with **Insert Message** button in CaC Tool\n\nTest Cast Connect\n-----------------\n\nTo test Cast Connect, perform the following steps before establishing a session:\n\n1. Enter the Receiver App ID associated with your Cast Connect-enabled receiver and click **Set App ID**.\n2. Click on **Show Android TV Options** button.\n3. Check **androidReceiverCompatible** checkbox. If your receiver doesn't require `Launch Credentials` to be set, or you want to test what happens in case it is not set, you can stop here and continue to Step 5.\n4. (Optional) Enter the `Launch Credentials` and click on the **Set Launch\n Credentials** button in order to set the launch credentials for the Cast Connect session.\n5. Start a cast session by clicking on the Cast icon in the header or through the Cast menu in your Chrome browser.\n\nYour Android TV application should now launch on your device.\n| **Note:** CaC Tool is unable to fetch any logs from your Android TV device. In order to debug your Android TV app and see any relevant logs, use `adb` through your terminal or Android Studio, as you normally would in order to access the logs and debug your app."]]
