cast. framework. system
cast.framework.system 네임스페이스입니다.
클래스
ApplicationData
실행된 애플리케이션의 데이터를 설명하는 메타데이터입니다.
이벤트
시스템 정보가 포함된 cast.framework.CastReceiverContext에서 디스패치된 이벤트입니다.
FeedbackStartedEvent
시스템에서 의견 보고서를 만들기 시작할 때 cast.framework.CastReceiverContext에 의해 디스패치되는 이벤트입니다.
MaxVideoResolutionChangedEvent
시스템에서 최대 동영상 해상도 제한을 업데이트해야 할 때 cast.framework.CastReceiverContext에 의해 디스패치되는 이벤트입니다.
메시지
발신자로부터 수신된 맞춤 메시지입니다. 맞춤 이벤트를 수신하려면 cast.framework.CastReceiverContext#addCustomMessageListener 메서드를 사용합니다.
ReadyEvent
시스템이 준비되면 cast.framework.CastReceiverContext에서 디스패치하는 이벤트입니다.
발신자
연결된 전송 기기의 데이터를 나타냅니다.
SenderConnectedEvent
발신자가 연결될 때 cast.framework.CastReceiverContext에서 디스패치하는 이벤트입니다.
SenderDisconnectedEvent
전송자가 연결 해제될 때 cast.framework.CastReceiverContext에 의해 디스패치되는 이벤트입니다.
ShutdownEvent
애플리케이션이 종료될 때 cast.framework.CastReceiverContext에 의해 디스패치되는 이벤트입니다.
StandbyChangedEvent
TV가 대기 상태로 전환되거나 대기 상태에서 벗어날 때 cast.framework.CastReceiverContext에 의해 디스패치되는 이벤트이므로 애플리케이션은 항상 isStandby 속성을 확인해야 합니다. 실제 상태를 알 수 없는지 확인하려면 애플리케이션에서 cast.framework.CastReceiverContext#getStandbyState 메서드를 호출하면 됩니다.
SystemVolumeChangedEvent
시스템 볼륨이 변경될 때 cast.framework.CastReceiverContext에 의해 디스패치되는 이벤트입니다.
SystemVolumeData
시스템 볼륨 데이터를 나타냅니다.
VisibilityChangedEvent
애플리케이션의 표시 상태가 변경될 때(예: HDMI 입력이 변경되거나 TV가 꺼질 때) cast.framework.CastReceiverContext에 의해 디스패치되는 이벤트입니다.
열거
DeviceCapabilities
문자열
Cast 지원 기기와 연결된 디스플레이 기기(해당하는 경우)로 구성된 현재 설정의 기능을 설명합니다.
값 |
|
|---|---|
|
AUDIO_ASSISTANT |
문자열 오디오 어시스턴트 지원 오디오 어시스턴트 지원 기능이 있는 Cast 지원 기기의 예로는 Google Home과 Google Home Mini가 있습니다. |
|
BLUETOOTH_SUPPORTED |
문자열 블루투스 지원 |
|
DISPLAY_SUPPORTED |
문자열 디스플레이 출력 지원 디스플레이 지원 기능이 있는 Cast 지원 기기의 예로는 Chromecast와 Cast TV가 있습니다. 디스플레이 지원이 없는 Cast 지원 기기의 예로는 Chromecast Audio와 Google Home이 있습니다. |
|
HI_RES_AUDIO_SUPPORTED |
문자열 고해상도 오디오 (최대 24비트 / 96KHz) 지원 |
|
IS_DV_SUPPORTED |
문자열 Dolby Vision 지원 |
|
IS_HDR_SUPPORTED |
문자열 HDR 동영상 지원 |
|
CAST_LITE_ONLY |
문자열 이 기기가 오디오 전용 플랫폼에서 실행되는지 여부입니다. 일부 API는 이러한 플랫폼에서 완전히 지원되지 않을 수 있습니다. |
|
DPAD_INPUT_SUPPORTED |
문자열 이 기기가 잠금 해제 DPAD와 같은 입력 메커니즘을 지원하는지 여부입니다. |
|
TOUCH_INPUT_SUPPORTED |
문자열 터치 입력 지원 터치 입력을 지원하는 Cast 지원 기기의 예로는 Google Nest Hub와 Google Nest Hub Max가 있습니다. |
|
IS_GROUP |
문자열 기기가 가상 기기이고 실제 기기가 아닌 그룹 타겟을 나타내는 경우 |
|
IS_DEVICE_REGISTERED |
문자열
|
|
IS_CBCS_SUPPORTED |
문자열
|
|
IS_DOLBY_ATMOS_SUPPORTED |
문자열
|
DeviceInformation
문자열
cast.framework.CastReceiverContext.DeviceInformationObj의 유효한 키 상수입니다.
값 |
|
|---|---|
|
MODEL_NAME |
문자열 알려진 경우 기기 모델의 이름 (예: Google TV Streamer, Nest Hub, Nest Mini 등)입니다. 알 수 없는 경우 'unknown'입니다. |
|
BRAND_NAME |
문자열 알려진 경우 기기 브랜드 이름 (예: Google, LG, Sony 등)입니다. 알 수 없는 경우 빈 문자열입니다. |
|
OS_NAME |
문자열 알려진 경우 기기 OS 이름 (예: Android, Fuchsia, Linux 등)입니다. 알 수 없는 경우 빈 문자열, Cast 기기가 아닌 경우 'not Cast' |
|
OS_VERSION |
문자열 알려진 경우 기기 OS 버전 (예: 14.0 등)입니다. 알 수 없는 경우 빈 문자열입니다. |
|
환경 |
문자열 기기가 내부에 있는 환경 유형입니다(예: 집, 자동차, 비행기, 호텔 등)(알려진 경우). 대부분의 기기에서 일반적으로 '홈'입니다. |
|
DEVICE_ID |
문자열 수신기 기기의 고유 ID입니다(알려진 경우). Sender SDK에서 노출하는 Cast Receiver ID와 동일한 값입니다. 알 수 없는 경우 빈 문자열입니다. |
|
METADATA_FROM_FIRMWARE |
문자열 기기 정보가 펌웨어에 의해 제공되었는지 여부입니다. |
DisconnectReason
문자열
연결 해제 이유를 나타냅니다.
값 |
|
|---|---|
|
REQUESTED_BY_SENDER |
문자열 연결 닫기가 발신자 애플리케이션에 의해 적극적으로 요청되었습니다 (일반적으로 사용자에 의해 트리거됨). |
|
오류 |
문자열 프로토콜 오류가 발생했습니다. |
|
알 수 없음 |
문자열 발신자가 |
EventType
문자열
cast.framework.CastReceiverContext에서 디스패치하는 시스템 이벤트입니다.
값 |
|
|---|---|
|
READY |
문자열 시스템이 준비되면 실행됩니다. |
|
종료 |
문자열 애플리케이션이 종료되면 발생합니다. |
|
SENDER_CONNECTED |
문자열 새 발신자가 연결되면 발생합니다. |
|
SENDER_DISCONNECTED |
문자열 발신자가 연결을 해제하면 발생합니다. |
|
오류 |
문자열 시스템 오류가 발생하면 발생합니다. |
|
SYSTEM_VOLUME_CHANGED |
문자열 시스템 볼륨이 변경되면 발생합니다. |
|
VISIBILITY_CHANGED |
문자열 애플리케이션의 표시 상태가 변경된 경우 (예: HDMI 입력이 변경된 후 또는 TV가 꺼졌다 켜지고 Cast 기기가 외부 전원을 사용하는 경우) 실행됩니다. 이 API는 브라우저에서 발생하는 'webkitvisibilitychange' 이벤트와 동일한 효과를 갖습니다. 이는 편의를 위해 그리고 webkit 접두사가 붙은 이벤트에 대한 종속 항목을 방지하기 위해 cast.framework.CastReceiverContext API로 제공됩니다. |
|
STANDBY_CHANGED |
문자열 TV의 대기 상태가 변경될 때 발생합니다. 이 이벤트는 cast.framework.system.EventType.VISIBILITY_CHANGED 이벤트와 관련이 있습니다. TV가 대기 모드에 있으면 가시성이 표시 상태는 대기 상태보다 세부적입니다 (표시에는 TV 채널 선택도 포함되기 때문). 하지만 모든 TV에서 안정적으로 감지되지는 않습니다. 대부분의 TV에서 대기 모드를 구현하므로 이러한 경우 대기 모드를 사용할 수 있습니다. |
|
MAX_VIDEO_RESOLUTION_CHANGED |
문자열 |
|
FEEDBACK_STARTED |
문자열 시스템에서 의견 보고서 생성을 시작할 때 발생합니다. |
LaunchedFrom
문자열
이는 리시버를 실행한 요청의 유형을 나타냅니다.
값 |
|
|---|---|
|
알 수 없음 |
문자열 출시 소유자를 확인할 수 없습니다. |
|
DIAL |
문자열 앱이 DIAL 요청에 의해 실행되었습니다. |
|
전송 |
문자열 앱이 Cast V2 요청에 의해 실행되었습니다. |
|
클라우드 |
문자열 앱이 어시스턴트 요청 (예: Google 어시스턴트 명령)에 의해 실행되었습니다. |
MessageType
문자열
맞춤 메시지 유형입니다.
값 |
|
|---|---|
|
문자열 |
문자열 메시지는 자유 형식 문자열입니다. 애플리케이션은 전송된 정보를 인코딩/디코딩해야 합니다. |
|
JSON |
문자열 메시지는 JSON으로 인코딩됩니다. 기본 전송은 JSON으로 인코딩된 문자열을 사용합니다. |
StandbyState
문자열
이는 플랫폼에서 보고한 현재 대기 상태를 나타냅니다. Cast 플랫폼에서 상태를 확인할 수 없는 경우 UNKNOWN일 수 있습니다.
값 |
|
|---|---|
|
STANDBY |
문자열 |
|
NOT_STANDBY |
문자열 |
|
알 수 없음 |
문자열 |
SystemState
문자열
이는 현재 시스템 상태를 나타냅니다.
값 |
|
|---|---|
|
NOT_STARTED |
문자열 아직 애플리케이션 시작이 요청되지 않았습니다. |
|
STARTING_IN_BACKGROUND |
문자열 애플리케이션이 시작되지만 사용자에게 표시되지 않습니다. |
|
시작 중 |
문자열 애플리케이션이 시작되고 있습니다. |
|
READY |
문자열 애플리케이션이 포그라운드에 있으며 메시지를 주고받을 준비가 되었습니다. |
|
STOPPING_IN_BACKGROUND |
문자열 애플리케이션이 백그라운드에서 중지됩니다. |
|
중지 중 |
문자열 애플리케이션이 중지되고 있습니다. |
VisibilityState
문자열
플랫폼에서 보고한 현재 표시 상태를 나타냅니다. Cast 플랫폼에서 공개 상태를 확인할 수 없는 경우 UNKNOWN일 수 있습니다.
값 |
|
|---|---|
|
VISIBLE |
문자열 |
|
NOT_VISIBLE |
문자열 |
|
알 수 없음 |
문자열 |
속성
DeviceCapabilities
문자열
Cast 지원 기기와 연결된 디스플레이 기기(해당하는 경우)로 구성된 현재 설정의 기능을 설명합니다.
값 |
|
|---|---|
|
AUDIO_ASSISTANT |
문자열 오디오 어시스턴트 지원 오디오 어시스턴트 지원 기능이 있는 Cast 지원 기기의 예로는 Google Home과 Google Home Mini가 있습니다. |
|
BLUETOOTH_SUPPORTED |
문자열 블루투스 지원 |
|
DISPLAY_SUPPORTED |
문자열 디스플레이 출력 지원 디스플레이 지원 기능이 있는 Cast 지원 기기의 예로는 Chromecast와 Cast TV가 있습니다. 디스플레이 지원이 없는 Cast 지원 기기의 예로는 Chromecast Audio와 Google Home이 있습니다. |
|
HI_RES_AUDIO_SUPPORTED |
문자열 고해상도 오디오 (최대 24비트 / 96KHz) 지원 |
|
IS_DV_SUPPORTED |
문자열 Dolby Vision 지원 |
|
IS_HDR_SUPPORTED |
문자열 HDR 동영상 지원 |
|
CAST_LITE_ONLY |
문자열 이 기기가 오디오 전용 플랫폼에서 실행되는지 여부입니다. 일부 API는 이러한 플랫폼에서 완전히 지원되지 않을 수 있습니다. |
|
DPAD_INPUT_SUPPORTED |
문자열 이 기기가 잠금 해제 DPAD와 같은 입력 메커니즘을 지원하는지 여부입니다. |
|
TOUCH_INPUT_SUPPORTED |
문자열 터치 입력 지원 터치 입력을 지원하는 Cast 지원 기기의 예로는 Google Nest Hub와 Google Nest Hub Max가 있습니다. |
|
IS_GROUP |
문자열 기기가 가상 기기이고 실제 기기가 아닌 그룹 타겟을 나타내는 경우 |
|
IS_DEVICE_REGISTERED |
문자열
|
|
IS_CBCS_SUPPORTED |
문자열
|
|
IS_DOLBY_ATMOS_SUPPORTED |
문자열
|
DeviceInformation
문자열
cast.framework.CastReceiverContext.DeviceInformationObj의 유효한 키 상수입니다.
값 |
|
|---|---|
|
MODEL_NAME |
문자열 알려진 경우 기기 모델의 이름 (예: Google TV Streamer, Nest Hub, Nest Mini 등)입니다. 알 수 없는 경우 'unknown'입니다. |
|
BRAND_NAME |
문자열 알려진 경우 기기 브랜드 이름 (예: Google, LG, Sony 등)입니다. 알 수 없는 경우 빈 문자열입니다. |
|
OS_NAME |
문자열 알려진 경우 기기 OS 이름 (예: Android, Fuchsia, Linux 등)입니다. 알 수 없는 경우 빈 문자열, Cast 기기가 아닌 경우 'not Cast' |
|
OS_VERSION |
문자열 알려진 경우 기기 OS 버전 (예: 14.0 등)입니다. 알 수 없는 경우 빈 문자열입니다. |
|
환경 |
문자열 기기가 내부에 있는 환경 유형입니다(예: 집, 자동차, 비행기, 호텔 등)(알려진 경우). 대부분의 기기에서 일반적으로 '홈'입니다. |
|
DEVICE_ID |
문자열 수신기 기기의 고유 ID입니다(알려진 경우). Sender SDK에서 노출하는 Cast Receiver ID와 동일한 값입니다. 알 수 없는 경우 빈 문자열입니다. |
|
METADATA_FROM_FIRMWARE |
문자열 기기 정보가 펌웨어에 의해 제공되었는지 여부입니다. |
DisconnectReason
문자열
연결 해제 이유를 나타냅니다.
값 |
|
|---|---|
|
REQUESTED_BY_SENDER |
문자열 연결 닫기가 발신자 애플리케이션에 의해 적극적으로 요청되었습니다 (일반적으로 사용자에 의해 트리거됨). |
|
오류 |
문자열 프로토콜 오류가 발생했습니다. |
|
알 수 없음 |
문자열 발신자가 |
EventType
문자열
cast.framework.CastReceiverContext에서 디스패치하는 시스템 이벤트입니다.
값 |
|
|---|---|
|
READY |
문자열 시스템이 준비되면 실행됩니다. |
|
종료 |
문자열 애플리케이션이 종료되면 발생합니다. |
|
SENDER_CONNECTED |
문자열 새 발신자가 연결되면 발생합니다. |
|
SENDER_DISCONNECTED |
문자열 발신자가 연결을 해제하면 발생합니다. |
|
오류 |
문자열 시스템 오류가 발생하면 발생합니다. |
|
SYSTEM_VOLUME_CHANGED |
문자열 시스템 볼륨이 변경되면 발생합니다. |
|
VISIBILITY_CHANGED |
문자열 애플리케이션의 표시 상태가 변경된 경우 (예: HDMI 입력이 변경된 후 또는 TV가 꺼졌다 켜지고 Cast 기기가 외부 전원을 사용하는 경우) 실행됩니다. 이 API는 브라우저에서 발생하는 'webkitvisibilitychange' 이벤트와 동일한 효과를 갖습니다. 이는 편의를 위해 그리고 webkit 접두사가 붙은 이벤트에 대한 종속 항목을 방지하기 위해 cast.framework.CastReceiverContext API로 제공됩니다. |
|
STANDBY_CHANGED |
문자열 TV의 대기 상태가 변경될 때 발생합니다. 이 이벤트는 cast.framework.system.EventType.VISIBILITY_CHANGED 이벤트와 관련이 있습니다. TV가 대기 모드에 있으면 가시성이 표시 상태는 대기 상태보다 세부적입니다 (표시에는 TV 채널 선택도 포함되기 때문). 하지만 모든 TV에서 안정적으로 감지되지는 않습니다. 대부분의 TV에서 대기 모드를 구현하므로 이러한 경우 대기 모드를 사용할 수 있습니다. |
|
MAX_VIDEO_RESOLUTION_CHANGED |
문자열 |
|
FEEDBACK_STARTED |
문자열 시스템에서 의견 보고서 생성을 시작할 때 발생합니다. |
LaunchedFrom
문자열
이는 리시버를 실행한 요청의 유형을 나타냅니다.
값 |
|
|---|---|
|
알 수 없음 |
문자열 출시 소유자를 확인할 수 없습니다. |
|
DIAL |
문자열 앱이 DIAL 요청에 의해 실행되었습니다. |
|
전송 |
문자열 앱이 Cast V2 요청에 의해 실행되었습니다. |
|
클라우드 |
문자열 앱이 어시스턴트 요청 (예: Google 어시스턴트 명령)에 의해 실행되었습니다. |
MessageType
문자열
맞춤 메시지 유형입니다.
값 |
|
|---|---|
|
문자열 |
문자열 메시지는 자유 형식 문자열입니다. 애플리케이션은 전송된 정보를 인코딩/디코딩해야 합니다. |
|
JSON |
문자열 메시지는 JSON으로 인코딩됩니다. 기본 전송은 JSON으로 인코딩된 문자열을 사용합니다. |
StandbyState
문자열
이는 플랫폼에서 보고한 현재 대기 상태를 나타냅니다. Cast 플랫폼에서 상태를 확인할 수 없는 경우 UNKNOWN일 수 있습니다.
값 |
|
|---|---|
|
STANDBY |
문자열 |
|
NOT_STANDBY |
문자열 |
|
알 수 없음 |
문자열 |
SystemState
문자열
이는 현재 시스템 상태를 나타냅니다.
값 |
|
|---|---|
|
NOT_STARTED |
문자열 아직 애플리케이션 시작이 요청되지 않았습니다. |
|
STARTING_IN_BACKGROUND |
문자열 애플리케이션이 시작되지만 사용자에게 표시되지 않습니다. |
|
시작 중 |
문자열 애플리케이션이 시작되고 있습니다. |
|
READY |
문자열 애플리케이션이 포그라운드에 있으며 메시지를 주고받을 준비가 되었습니다. |
|
STOPPING_IN_BACKGROUND |
문자열 애플리케이션이 백그라운드에서 중지됩니다. |
|
중지 중 |
문자열 애플리케이션이 중지되고 있습니다. |
VisibilityState
문자열
플랫폼에서 보고한 현재 표시 상태를 나타냅니다. Cast 플랫폼에서 공개 상태를 확인할 수 없는 경우 UNKNOWN일 수 있습니다.
값 |
|
|---|---|
|
VISIBLE |
문자열 |
|
NOT_VISIBLE |
문자열 |
|
알 수 없음 |
문자열 |
추상 유형
DeviceCapabilitiesObj
{audio_assistant: (boolean or undefined), bluetooth_supported: (boolean or undefined), display_supported: (boolean or undefined), hi_res_audio_supported: (boolean or undefined), is_dv_supported: (boolean or undefined), is_hdr_supported: (boolean or undefined), cast_lite_only: (boolean or undefined), dpad_input_supported: (boolean or undefined), touch_input_supported: (boolean or undefined), is_group: (boolean or undefined), remote_control_overlay_supported: (boolean or undefined), sleep_timer_overlay_supported: (boolean or undefined), app_foreground: (boolean or undefined), is_device_registered: (boolean or undefined), is_cbcs_supported: (boolean or undefined), is_dolby_atmos_supported: (boolean or undefined)}
getDeviceCapabilities에서 반환된 객체를 설명합니다.
DeviceInformationObj
{model-name: string, brand-name: string, os-name: string, os-version: string, environment: string, device-id: string, metadata-from-firmware: boolean}
getDeviceInformation에서 반환된 객체를 설명합니다.