TV가 대기 상태로 전환되거나 대기 상태에서 나갈 때 cast.framework.CastReceiverContext에 의해 전달되는 이벤트이므로 애플리케이션은 항상 isStandby 속성을 확인해야 합니다. 실제 상태를 알 수 없는 경우 애플리케이션에서 cast.framework.CastReceiverContext#getStandbyState 메서드를 호출할 수 있습니다.

SystemVolumeChangedEvent

시스템 볼륨이 변경될 때 cast.framework.CastReceiverContext에 의해 전달되는 이벤트입니다.

SystemVolumeData

이는 시스템 볼륨 데이터를 나타냅니다.

VisibilityChangedEvent

애플리케이션의 가시성이 변경될 때(예: HDMI 입력이 변경되거나 TV가 꺼질 때) cast.framework.CastReceiverContext에 의해 전달되는 이벤트입니다.

열거형

DeviceCapabilities

정적

string

Cast 지원 기기 및 연결된 디스플레이 기기(해당하는 경우)로 구성된 현재 설정의 기능을 설명합니다.

값
AUDIO_ASSISTANT	string 오디오 어시스턴트 지원 오디오 어시스턴트를 지원하는 Cast 지원 기기의 예로는 Google Home과 Google Home Mini가 있습니다.
BLUETOOTH_SUPPORTED	string 블루투스 지원
DISPLAY_SUPPORTED	string 디스플레이 출력을 지원합니다. 디스플레이를 지원하는 Cast 지원 기기의 예로는 Chromecast와 Cast TV가 있습니다. 디스플레이를 지원하지 않는 Cast 지원 기기의 예로는 Chromecast Audio와 Google Home이 있습니다.
HI_RES_AUDIO_SUPPORTED	string 고해상도 오디오 (최대 24비트 / 96KHz) 지원
IS_DV_SUPPORTED	string Dolby Vision 지원
IS_HDR_SUPPORTED	string HDR 동영상 지원
TOUCH_INPUT_SUPPORTED	string 터치 입력 지원 터치 입력을 지원하는 Cast 지원 기기의 예로는 Google Nest Hub 및 Google Nest Hub Max가 있습니다.
IS_GROUP	string 기기가 가상 기기이고 실제 기기가 아닌 그룹 타겟을 나타내는 경우
IS_DEVICE_REGISTERED	string `true`로 설정된 경우 이 플래그는 Cast 기기가 Cast Play Console에 등록되었음을 나타냅니다.
IS_CBCS_SUPPORTED	string `true`로 설정하면 이 플래그는 CBCS 스키마 (SAMPLE-AES)가 지원됨을 나타냅니다.
IS_DOLBY_ATMOS_SUPPORTED	string `true`로 설정하면 이 플래그는 오디오 패스 스루를 통해 Dolby Atmos가 지원된다는 것을 나타냅니다.

DisconnectReason

정적

string

연결 해제 이유를 나타냅니다.

값
REQUESTED_BY_SENDER	string 발신자 애플리케이션에서 연결 닫기를 적극적으로 요청했습니다 (일반적으로 사용자가 트리거함).
오류	string 프로토콜 오류가 발생했습니다.
UNKNOWN	string 발신자가 `close()`를 호출하여 적절한 연결 해제를 요청했는지 알 수 없습니다. 연결이 해제되지 않았을 가능성이 높지만 '닫기' 메시지가 손실되었을 수 있습니다. 이 문제는 일반적으로 네트워크 시간 초과가 있거나, 발신자 애플리케이션이 비정상 종료되거나, 발신자 OS가 소켓을 닫을 때 발생합니다.

값

REQUESTED_BY_SENDER

string

발신자 애플리케이션에서 연결 닫기를 적극적으로 요청했습니다 (일반적으로 사용자가 트리거함).

오류

string

프로토콜 오류가 발생했습니다.

UNKNOWN

string

발신자가 close()를 호출하여 적절한 연결 해제를 요청했는지 알 수 없습니다. 연결이 해제되지 않았을 가능성이 높지만 '닫기' 메시지가 손실되었을 수 있습니다. 이 문제는 일반적으로 네트워크 시간 초과가 있거나, 발신자 애플리케이션이 비정상 종료되거나, 발신자 OS가 소켓을 닫을 때 발생합니다.

EventType

정적

string

cast.framework.CastReceiverContext에 의해 전달되는 시스템 이벤트.

값
준비됨	string 시스템이 준비되면 실행됩니다.
SHUTDOWN	string 애플리케이션이 종료되면 실행됩니다.
SENDER_CONNECTED	string 새 발신자가 연결되면 실행됩니다.
SENDER_DISCONNECTED	string 발신자가 연결 해제되면 실행됩니다.
오류	string 시스템 오류가 있으면 실행됩니다.
SYSTEM_VOLUME_CHANGED	string 시스템 볼륨이 변경되면 실행됩니다.
VISIBILITY_CHANGED	string 애플리케이션의 공개 상태가 변경되면 (예: HDMI 입력이 변경된 후 또는 TV가 꺼지거나 켜지고 Cast 기기가 외부에서 전원을 공급받는 경우) 실행됩니다. 이 API는 브라우저에서 발생하는 'webkitVisibilitychange' 이벤트와 동일한 효과가 있습니다. 편의를 위해 그리고 webkit 접두사가 붙은 이벤트에 대한 의존성을 방지하기 위해 cast.framework.CastReceiverContext API로 제공됩니다.
STANDBY_CHANGED	string TV의 대기 상태가 변경되면 실행됩니다. 이 이벤트는 cast.framework.system.EventType.VISIBILITY_CHANGED 이벤트와 관련이 있습니다. TV가 대기 모드인 경우 가시성이 `false`이기 때문입니다. 공개 상태는 TV 채널 선택도 포함되기 때문에 대기 상태보다 더 상세하지만 모든 TV에서 안정적으로 감지되지는 않습니다. 이러한 경우 대부분의 TV에서 대기 모드를 구현하기 때문에 대기 모드를 사용할 수 있습니다.
MAX_VIDEO_RESOLUTION_CHANGED	string
FEEDBACK_STARTED	string 시스템에서 의견 보고서를 작성하기 시작하면 실행됩니다.

LaunchedFrom

정적

string

수신기를 실행한 요청의 유형을 나타냅니다.

값
UNKNOWN	string 출시 소유자를 확인할 수 없습니다.
DIAL	string 앱이 DIAL 요청으로 실행되었습니다.
CAST	string Cast V2 요청으로 앱이 실행되었습니다.
클라우드	string 앱이 어시스턴트 요청 (예: Google 어시스턴트 명령어)으로 실행되었습니다.

MessageType

정적

string

맞춤 메시지 유형

값
문자열	string 메시지는 자유 형식 문자열입니다. 애플리케이션은 전송된 정보를 인코딩/디코딩해야 합니다.
JSON	string 메시지는 JSON으로 인코딩됩니다. 기본 전송은 JSON으로 인코딩된 문자열을 사용합니다.

값

문자열

string

메시지는 자유 형식 문자열입니다. 애플리케이션은 전송된 정보를 인코딩/디코딩해야 합니다.

JSON

string

메시지는 JSON으로 인코딩됩니다. 기본 전송은 JSON으로 인코딩된 문자열을 사용합니다.

StandbyState

정적

string

이는 플랫폼에서 보고한 현재 대기 상태를 나타냅니다. Cast 플랫폼에서 상태를 확인할 수 없는 경우 UNKNOWN일 수 있습니다.

값
대기	string
NOT_STANDBY	string
UNKNOWN	string

SystemState

정적

string

현재 시스템 상태를 나타냅니다.

값
NOT_STARTED	string 아직 시작 요청을 받지 않았습니다.
STARTING_IN_BACKGROUND	string 애플리케이션이 시작되지만 사용자에게 표시되지 않습니다.
시작 중	string 애플리케이션을 시작하는 중입니다.
준비됨	string 애플리케이션이 포그라운드 상태이며 메시지를 주고받을 준비가 되었습니다.
STOPPING_IN_BACKGROUND	string 백그라운드에서 애플리케이션이 중지되고 있습니다.
중지 중	string 애플리케이션을 중지하는 중입니다.

VisibilityState

정적

string

이는 플랫폼에서 보고한 현재 공개 상태 상태를 나타냅니다. Cast 플랫폼에서 공개 상태를 확인할 수 없는 경우에는 UNKNOWN일 수도 있습니다.

값
VISIBLE	string
NOT_VISIBLE	string
UNKNOWN	string

속성

DeviceCapabilities

정적

string

Cast 지원 기기 및 연결된 디스플레이 기기(해당하는 경우)로 구성된 현재 설정의 기능을 설명합니다.

값
AUDIO_ASSISTANT	string 오디오 어시스턴트 지원 오디오 어시스턴트를 지원하는 Cast 지원 기기의 예로는 Google Home과 Google Home Mini가 있습니다.
BLUETOOTH_SUPPORTED	string 블루투스 지원
DISPLAY_SUPPORTED	string 디스플레이 출력을 지원합니다. 디스플레이를 지원하는 Cast 지원 기기의 예로는 Chromecast와 Cast TV가 있습니다. 디스플레이를 지원하지 않는 Cast 지원 기기의 예로는 Chromecast Audio와 Google Home이 있습니다.
HI_RES_AUDIO_SUPPORTED	string 고해상도 오디오 (최대 24비트 / 96KHz) 지원
IS_DV_SUPPORTED	string Dolby Vision 지원
IS_HDR_SUPPORTED	string HDR 동영상 지원
TOUCH_INPUT_SUPPORTED	string 터치 입력 지원 터치 입력을 지원하는 Cast 지원 기기의 예로는 Google Nest Hub 및 Google Nest Hub Max가 있습니다.
IS_GROUP	string 기기가 가상 기기이고 실제 기기가 아닌 그룹 타겟을 나타내는 경우
IS_DEVICE_REGISTERED	string `true`로 설정된 경우 이 플래그는 Cast 기기가 Cast Play Console에 등록되었음을 나타냅니다.
IS_CBCS_SUPPORTED	string `true`로 설정하면 이 플래그는 CBCS 스키마 (SAMPLE-AES)가 지원됨을 나타냅니다.
IS_DOLBY_ATMOS_SUPPORTED	string `true`로 설정하면 이 플래그는 오디오 패스 스루를 통해 Dolby Atmos가 지원된다는 것을 나타냅니다.

DisconnectReason

정적

string

연결 해제 이유를 나타냅니다.

값
REQUESTED_BY_SENDER	string 발신자 애플리케이션에서 연결 닫기를 적극적으로 요청했습니다 (일반적으로 사용자가 트리거함).
오류	string 프로토콜 오류가 발생했습니다.
UNKNOWN	string 발신자가 `close()`를 호출하여 적절한 연결 해제를 요청했는지 알 수 없습니다. 연결이 해제되지 않았을 가능성이 높지만 '닫기' 메시지가 손실되었을 수 있습니다. 이 문제는 일반적으로 네트워크 시간 초과가 있거나, 발신자 애플리케이션이 비정상 종료되거나, 발신자 OS가 소켓을 닫을 때 발생합니다.

값

REQUESTED_BY_SENDER

string

발신자 애플리케이션에서 연결 닫기를 적극적으로 요청했습니다 (일반적으로 사용자가 트리거함).

오류

string

프로토콜 오류가 발생했습니다.

UNKNOWN

string

EventType

정적

string

cast.framework.CastReceiverContext에 의해 전달되는 시스템 이벤트.

값
준비됨	string 시스템이 준비되면 실행됩니다.
SHUTDOWN	string 애플리케이션이 종료되면 실행됩니다.
SENDER_CONNECTED	string 새 발신자가 연결되면 실행됩니다.
SENDER_DISCONNECTED	string 발신자가 연결 해제되면 실행됩니다.
오류	string 시스템 오류가 있으면 실행됩니다.
SYSTEM_VOLUME_CHANGED	string 시스템 볼륨이 변경되면 실행됩니다.
VISIBILITY_CHANGED	string 애플리케이션의 공개 상태가 변경되면 (예: HDMI 입력이 변경된 후 또는 TV가 꺼지거나 켜지고 Cast 기기가 외부에서 전원을 공급받는 경우) 실행됩니다. 이 API는 브라우저에서 발생하는 'webkitVisibilitychange' 이벤트와 동일한 효과가 있습니다. 편의를 위해 그리고 webkit 접두사가 붙은 이벤트에 대한 의존성을 방지하기 위해 cast.framework.CastReceiverContext API로 제공됩니다.
STANDBY_CHANGED	string TV의 대기 상태가 변경되면 실행됩니다. 이 이벤트는 cast.framework.system.EventType.VISIBILITY_CHANGED 이벤트와 관련이 있습니다. TV가 대기 모드인 경우 가시성이 `false`이기 때문입니다. 공개 상태는 TV 채널 선택도 포함되기 때문에 대기 상태보다 더 상세하지만 모든 TV에서 안정적으로 감지되지는 않습니다. 이러한 경우 대부분의 TV에서 대기 모드를 구현하기 때문에 대기 모드를 사용할 수 있습니다.
MAX_VIDEO_RESOLUTION_CHANGED	string
FEEDBACK_STARTED	string 시스템에서 의견 보고서를 작성하기 시작하면 실행됩니다.

LaunchedFrom

정적

string

수신기를 실행한 요청의 유형을 나타냅니다.

값
UNKNOWN	string 출시 소유자를 확인할 수 없습니다.
DIAL	string 앱이 DIAL 요청으로 실행되었습니다.
CAST	string Cast V2 요청으로 앱이 실행되었습니다.
클라우드	string 앱이 어시스턴트 요청 (예: Google 어시스턴트 명령어)으로 실행되었습니다.

MessageType

정적

string

맞춤 메시지 유형

값
문자열	string 메시지는 자유 형식 문자열입니다. 애플리케이션은 전송된 정보를 인코딩/디코딩해야 합니다.
JSON	string 메시지는 JSON으로 인코딩됩니다. 기본 전송은 JSON으로 인코딩된 문자열을 사용합니다.

값

문자열

string

메시지는 자유 형식 문자열입니다. 애플리케이션은 전송된 정보를 인코딩/디코딩해야 합니다.

JSON

string

메시지는 JSON으로 인코딩됩니다. 기본 전송은 JSON으로 인코딩된 문자열을 사용합니다.

StandbyState

정적

string

이는 플랫폼에서 보고한 현재 대기 상태를 나타냅니다. Cast 플랫폼에서 상태를 확인할 수 없는 경우 UNKNOWN일 수 있습니다.

값
대기	string
NOT_STANDBY	string
UNKNOWN	string

SystemState

정적

string

현재 시스템 상태를 나타냅니다.

값
NOT_STARTED	string 아직 시작 요청을 받지 않았습니다.
STARTING_IN_BACKGROUND	string 애플리케이션이 시작되지만 사용자에게 표시되지 않습니다.
시작 중	string 애플리케이션을 시작하는 중입니다.
준비됨	string 애플리케이션이 포그라운드 상태이며 메시지를 주고받을 준비가 되었습니다.
STOPPING_IN_BACKGROUND	string 백그라운드에서 애플리케이션이 중지되고 있습니다.
중지 중	string 애플리케이션을 중지하는 중입니다.

VisibilityState

정적

string

이는 플랫폼에서 보고한 현재 공개 상태 상태를 나타냅니다. Cast 플랫폼에서 공개 상태를 확인할 수 없는 경우에는 UNKNOWN일 수도 있습니다.

값
VISIBLE	string
NOT_VISIBLE	string
UNKNOWN	string