네임스페이스: system

cast.framework.system

namespace   static

cast.framework.system 네임스페이스입니다.

클래스

열거

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

문자열

true로 설정하면 이 플래그는 Cast 기기가 Cast 개발자 콘솔에 등록되어 있음을 나타냅니다.

IS_CBCS_SUPPORTED

문자열

true로 설정하면 이 플래그는 CBCS 스키마 (SAMPLE-AES)가 지원됨을 나타냅니다.

IS_DOLBY_ATMOS_SUPPORTED

문자열

true로 설정하면 이 플래그는 오디오 패스 스루를 통해 Dolby Atmos가 지원됨을 나타냅니다.

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 등)(알려진 경우) 알 수 없는 경우 빈 문자열입니다.

환경

문자열

기기가 있는 환경 유형(예: 집, 자동차, 비행기, 호텔 등)(알려진 경우)입니다. 일반적으로 대부분의 기기에서 'home'입니다.

DEVICE_ID

문자열

수신자 기기의 고유 ID입니다(알려진 경우). thought 발신기 SDK에서 노출하는 전송 수신기 ID와 동일한 값입니다. 알 수 없는 경우 빈 문자열입니다.

METADATA_FROM_FIRMWARE

문자열

펌웨어에서 기기 정보를 제공했는지 여부입니다.

DisconnectReason

정적

문자열

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

값

REQUESTED_BY_SENDER

문자열

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

오류

문자열

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

알 수 없음

문자열

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

APPLICATION_STOP

문자열

수신기 애플리케이션이 자체적으로 중지되었습니다.

ABRUPT_SHUTDOWN

문자열

발신자가 아직 연결되어 있는 동안 플랫폼에서 애플리케이션을 종료했습니다.

NO_SENDERS

문자열

연결된 발신자가 없어 애플리케이션이 종료되었습니다.

TRANSPORT_CLOSED

문자열

정상적인 가상 연결 종료 없이 발신자가 기본 SSL 소켓을 닫았습니다.

TRANSPORT_ABORTED

문자열

피어에서 기본 SSL 소켓을 중단했습니다.

TRANSPORT_TOO_LONG_INACTIVE

문자열

하트비트 실패로 인해 기본 SSL 소켓이 닫혔습니다.

CLOSED_BY_SELF

문자열

Cast 수신자가 연결을 단계적으로 종료했습니다.

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가 대기 모드인 경우 공개 상태가 false이기 때문입니다.

공개 상태는 대기 상태보다 더 세분화되어 있지만 (공개 상태에는 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

문자열

true로 설정하면 이 플래그는 Cast 기기가 Cast 개발자 콘솔에 등록되어 있음을 나타냅니다.

IS_CBCS_SUPPORTED

문자열

true로 설정하면 이 플래그는 CBCS 스키마 (SAMPLE-AES)가 지원됨을 나타냅니다.

IS_DOLBY_ATMOS_SUPPORTED

문자열

true로 설정하면 이 플래그는 오디오 패스 스루를 통해 Dolby Atmos가 지원됨을 나타냅니다.

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 등)(알려진 경우) 알 수 없는 경우 빈 문자열입니다.

환경

문자열

기기가 있는 환경 유형(예: 집, 자동차, 비행기, 호텔 등)(알려진 경우)입니다. 일반적으로 대부분의 기기에서 'home'입니다.

DEVICE_ID

문자열

수신자 기기의 고유 ID입니다(알려진 경우). thought 발신기 SDK에서 노출하는 전송 수신기 ID와 동일한 값입니다. 알 수 없는 경우 빈 문자열입니다.

METADATA_FROM_FIRMWARE

문자열

펌웨어에서 기기 정보를 제공했는지 여부입니다.

DisconnectReason

정적

문자열

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

값

REQUESTED_BY_SENDER

문자열

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

오류

문자열

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

알 수 없음

문자열

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

APPLICATION_STOP

문자열

수신기 애플리케이션이 자체적으로 중지되었습니다.

ABRUPT_SHUTDOWN

문자열

발신자가 아직 연결되어 있는 동안 플랫폼에서 애플리케이션을 종료했습니다.

NO_SENDERS

문자열

연결된 발신자가 없어 애플리케이션이 종료되었습니다.

TRANSPORT_CLOSED

문자열

정상적인 가상 연결 종료 없이 발신자가 기본 SSL 소켓을 닫았습니다.

TRANSPORT_ABORTED

문자열

피어에서 기본 SSL 소켓을 중단했습니다.

TRANSPORT_TOO_LONG_INACTIVE

문자열

하트비트 실패로 인해 기본 SSL 소켓이 닫혔습니다.

CLOSED_BY_SELF

문자열

Cast 수신자가 연결을 단계적으로 종료했습니다.

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가 대기 모드인 경우 공개 상태가 false이기 때문입니다.

공개 상태는 대기 상태보다 더 세분화되어 있지만 (공개 상태에는 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에서 반환된 객체를 설명합니다.

참고 항목
cast.framework.system.DeviceCapabilities

DeviceInformationObj

정적

{model-name: string, brand-name: string, os-name: string, os-version: string, environment: string, device-id: string, metadata-from-firmware: boolean}

getDeviceInformation에서 반환된 객체를 설명합니다.

참고 항목
cast.framework.system.DeviceInformation