AppStream 2.0 스트리밍 세션 임베드 - 아마존 AppStream 2.0
필수 조건권장 사항 및 사용 고려 사항1단계: 임베디드 AppStream 2.0 스트리밍 세션에 대한 호스트 도메인 지정2단계: 사용자 인증을 위한 스트리밍 URL 생성3단계: 임베디드 AppStream 2.0 파일 다운로드4단계. AppStream 2.0 통합을 위한 웹 사이트 구성임베디드 AppStream 2.0 스트리밍 세션의 상수, 함수 및 이벤트

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AppStream 2.0 스트리밍 세션 임베드

웹 사이트 내에 AppStream 2.0 스트리밍 세션을 임베드하여 사용자에게 동적인 대화형 사용자 지정 환경을 제공할 수 있습니다. 임베디드 AppStream 2.0 스트리밍 세션을 통해 사용자는 웹 사이트에서 직접 3D 모델, 맵 및 데이터 세트와 상호 작용할 수 있습니다. 예를 들어 사용자는 AppStream 2.0 스트리밍 세션과 함께 교육 지침이나 교육 자료를 볼 수 있습니다.

필수 조건

웹 사이트에 AppStream 2.0 스트리밍 세션을 임베드하려면

  • AppStream 2.0 이미지, 플릿 및 스택을 포함하여 구성된 AppStream 2.0 환경이 필요합니다. 이러한 리소스를 만드는 방법에 대한 자세한 내용은 AppStream 2.0 관리자 안내서의 다음 항목을 참조하세요.

  • 사용자 인증을 위한 스트리밍 URL. 현재 임베디드 AppStream 2.0 스트리밍 세션에 대한 인증 방법으로 SAML 2.0 및 AppStream 2.0 사용자 풀은 지원되지 않습니다.

  • 선택적으로, 임베디드 AppStream 2.0 스트리밍 세션에 사용자 지정 도메인을 사용할 수 있습니다. 사용자 지정 도메인을 사용하면 AppStream 2.0 URL 대신 회사 URL이 사용자에게 표시되도록 할 수 있습니다. 사용자가 타사 쿠키를 차단하는 웹 브라우저를 사용하는 경우, 사용자 지정 도메인이 필요합니다.

    참고

    Amazon CloudFront를 사용하여 사용자 지정 도메인을 구성할 수 있습니다. 자세한 내용은 Using Custom Domains with AppStream 2.0을 참조하세요.

    사용자 지정 도메인을 사용하는 경우 다음을 수행해야 합니다.

    • 동일한 도메인을 사용하는 스트리밍 URL을 만듭니다.

    • 임베디드 AppStream 2.0 스트리밍 세션을 호스팅할 웹페이지의 헤더에 appstream-custom-url-domain을 추가합니다. 헤더 값의 경우, 역방향 프록시가 사용자에게 표시하는 도메인을 사용합니다. 자세한 내용은 사용자 지정 도메인 사용을 위한 구성 요구 사항 섹션을 참조하세요.

권장 사항 및 사용 고려 사항

임베디드 AppStream 2.0 스트리밍 세션에 대한 다음 권장 사항 및 사용 시 주의사항을 고려하세요.

  • 사용자의 임베디드 AppStream 2.0 스트리밍 환경을 최대한 제어하려면 약 5초 동안 지속되는 수명이 짧은 스트리밍 URL을 구성하는 것이 좋습니다. 모든 사용자는 웹 페이지의 내용을 검사하고 소스를 볼 수 있습니다. 여기에는 문서 객체 모델(DOM)과 iframe의 src(소스) URL이 포함됩니다. 사용자가 URL을 복사할 때 URL이 여전히 유효한 경우, 해당 사용자는 URL을 별도의 브라우저 탭에 붙여넣고, 임베드 옵션 없이 표준 AppStream 2.0 포털 사용자 인터페이스로 세션을 스트리밍할 수 있습니다.

  • 사용자 지정 도메인이 임베디드 AppStream 2.0 스트리밍 세션에 사용되는 경우 동시 세션이 지원되지 않습니다. 동시 세션은 사용자가 동일한 웹페이지 또는 두 개의 서로 다른 브라우저 탭에서 두 개의 임베디드 AppStream 2.0 스트리밍 세션을 시작할 때 발생합니다. 동시 세션에서 사용자가 한 명일 수는 없지만 여러 명일 수는 있습니다. 예를 들어, 사용자가 앱에 로그인하면 앱이 고객에게 제공할 스트리밍 URL(청구 시 고유 사용자로 계산)을 생성하고, 고객이 스트리밍 URL을 로드하고, 고객이 지정된 풀 내의 appstream 인스턴스에 할당됩니다.

1단계: 임베디드 AppStream 2.0 스트리밍 세션에 대한 호스트 도메인 지정

웹페이지에 AppStream 2.0 스트리밍 세션을 임베드하려면 먼저 스택을 업데이트하여 임베디드 스트리밍 세션을 호스팅할 도메인을 지정합니다. 이는 인증된 웹 사이트 도메인만 AppStream 2.0 스트리밍 세션을 임베드할 수 있도록 하기 위한 보안 조치입니다. AppStream 2.0은 지정한 하나 이상의 도메인을 Content-Security-Policy(CSP) 헤더에 추가합니다. 자세한 내용은 Mozilla MDN Web Docs 설명서의 Content Security Policy (CSP)를 참조하세요.

임베디드 스트리밍 세션을 호스팅할 도메인을 지정하도록 스택을 업데이트하려면 다음 방법 중 하나를 사용합니다.

  • AppStream 2.0 콘솔

  • EmbedHostDomains API 작업

  • embed-host-domains AWS Command Line Interface(AWS CLI) 명령

AppStream 2.0 콘솔을 사용하여 호스트 도메인을 지정하려면 다음 단계를 수행하세요.

  1. https://console.aws.amazon.com/appstream2에서 AppStream 2.0 콘솔을 엽니다.

  2. 왼쪽 탐색 창에서 스택을 선택하고, 원하는 스택을 선택합니다.

  3. 편집(Edit)을 선택합니다.

  4. AppStream 2.0 임베드(선택 사항)을 확장합니다.

  5. 호스트 도메인에 유효한 도메인을 지정합니다. 예: training.example.com.

    참고

    임베디드 스트리밍 세션은 HTTPS[TCP 포트 443]를 통해서만 지원됩니다.

  6. 업데이트를 선택합니다.

2단계: 사용자 인증을 위한 스트리밍 URL 생성

임베디드 AppStream 2.0 스트리밍 세션에 대해 사용자를 인증하려면 스트리밍 URL을 만들어야 합니다. 현재 임베디드 스트리밍 세션에 대해 SAML 2.0 및 사용자 풀은 지원되지 않습니다. 스트리밍 URL을 만들려면 다음 방법 중 하나를 사용합니다.

사용자 지정 도메인 사용을 위한 구성 요구 사항

사용자 지정 도메인을 사용하여 회사 브랜딩을 적용하려는 경우든, 임베디드 AppStream 2.0 스트리밍 세션이 서드 파티 쿠키를 차단하는 브라우저에서 제대로 작동하는지 확인하려는 경우든 구성 요구 사항은 동일합니다.

서드 파티 쿠키를 차단하는 웹 브라우저의 경우, 사용자 지정 도메인이 필요합니다. AppStream 2.0은 브라우저 쿠키를 사용하여 스트리밍 세션을 인증하므로 매번 로그인 보안 인증 정보를 입력하라는 메시지가 표시되지 않고 사용자가 활성 세션에 다시 연결할 수 있습니다. 기본적으로 AppStream 2.0 스트리밍 URL은 도메인으로 appstream.com을 포함합니다. 웹사이트 내에 스트리밍 세션을 임베드하면 appstream.com은 타사 도메인으로 취급됩니다. 따라서 기본적으로 타사 쿠키를 차단하는 최신 브라우저를 사용할 경우 스트리밍 세션이 차단될 수 있습니다.

이 시나리오에서 임베디드 AppStream 2.0 스트리밍 세션이 차단되지 않도록 하려면 다음 단계를 수행하세요.

  1. 임베디드 AppStream 2.0 스트리밍 세션을 호스팅할 사용자 지정 도메인을 지정합니다.

    사용자 지정 도메인을 구성할 때 도메인이 AppStream 2.0을 임베드할 웹 페이지의 하위 도메인인지 확인합니다. 예를 들어 training.example.com을 호스트 도메인으로 지정하도록 스택을 업데이트하면, 임베디드 스트리밍 세션에 대해 content.training.example.com라는 하위 도메인을 생성할 수 있습니다.

  2. 동일한 사용자 지정 하위 도메인을 사용하는 임베디드 AppStream 2.0 스트리밍 세션에 대한 스트리밍 URL을 생성합니다. 스트리밍 URL을 생성하려면 CreateStreamingURL API 작업 또는 create-streaming-url AWS CLI 명령을 사용합니다. 이 시나리오에서는 AppStream 2.0 콘솔을 사용하여 스트리밍 URL을 생성할 수 없습니다.

    임베디드 AppStream 2.0 스트리밍 세션에 대한 스트리밍 URL을 생성하려면 URL에서 appstream2.region.aws.amazon.com을 자체 도메인으로 바꿉니다.

    기본적으로 AppStream 2.0 스트리밍 URL의 형식은 다음과 같습니다.

    https://appstream2.region.aws.amazon.com/authenticate?parameters=authenticationcode

    하위 도메인이 content.training.example.com인 경우 새 스트리밍 URL은 다음 형식을 따릅니다.

    https://content.training.example.com/authenticate?parameters=authenticationcode
    참고

    사용자 지정 도메인을 생성할 때 도메인이 구성되었던 AWS 리전에서만 임베디드 AppStream 2.0 스트리밍 세션에 해당 도메인을 사용할 수 있습니다. 여러 리전에서 사용자 지정 도메인을 지원하려는 경우, 해당하는 각각의 리전에 대해 사용자 지정 도메인을 만듭니다. 또한 임베디드 스트리밍 세션은 HTTPS[TCP 포트 443]를 통해서만 지원됩니다.

  3. 임베디드 스트리밍 세션을 호스팅할 웹페이지의 헤더에 appstream-custom-url-domain을 추가합니다. 헤더 값의 경우, 역방향 프록시가 사용자에게 표시하는 도메인을 사용합니다. 예:

    Header name: appstream-custom-url-domain
Header value: training.example.com

    사용자 지정 도메인을 설정하고 동일한 도메인을 지정하는 스트리밍 URL을 생성하면 쿠키가 자사 쿠키로 저장될 수 있습니다. Amazon CloudFront를 사용하여 사용자 지정 도메인을 구성하는 방법에 대한 자세한 내용은 Using Custom Domains with AppStream 2.0을 참조하세요.

임베디드 AppStream 2.0 스트리밍 세션에 사용자 지정 도메인을 설정한 후 스트리밍 URL이 사용자 지정 도메인으로 리디렉션되지 않거나 사용자 지정 도메인이 사용자에게 제대로 표시되지 않는 경우 다음 문제 해결 항목을 참조하세요.

3단계: 임베디드 AppStream 2.0 파일 다운로드

임베디드 AppStream 2.0 스트리밍 세션을 호스팅하려면 제공된 AppStream 2.0 API JavaScript 파일을 다운로드하고 구성해야 합니다.

  1. 웹 사이트에 AppStream 2.0 임베드 웹 페이지에서 1단계의 링크를 선택하여 AppStream 2.0 Embed Kit .zip 파일인 appstream_embed_<version>.zip을 다운로드합니다.

  2. .zip 파일을 다운로드한 위치로 이동하여 파일의 압축을 풉니다.

  3. 파일의 압축을 풀면 appstream-embed라는 하나의 폴더로 구성되어 있습니다. 이 폴더에는 COPYRIGHT.txt, THIRD_PARTY_NOTICES.txt 외에 다음 두 개의 파일이 포함되어 있습니다.

    • appstream-embed.js - 임베디드 AppStream 2.0 API를 제공합니다. 이 JavaScript 파일에는 임베디드 AppStream 2.0 스트리밍 세션을 구성하고 제어하기 위한 함수와 API 작업이 포함되어 있습니다.

    • embed-sample.html - 임베디드 AppStream 2.0 API를 사용하여 스트리밍 세션을 초기화하고, 함수를 호출하고, 이벤트를 수신하는 방법에 대해 설명합니다. 이 샘플 파일은 개발자를 위한 예제 사용 사례를 제공하기 위해 이 주제어ㅔ 대한 자세한 정보를 제공합니다.

4단계. AppStream 2.0 통합을 위한 웹 사이트 구성

다음 섹션에서는 임베디드 AppStream 2.0 스트리밍 세션을 호스트하도록 웹 페이지를 구성하는 방법에 대해 설명합니다.

appstream-embed JavaScript 파일 가져오기

  1. AppStream 2.0 스트리밍 세션을 임베드할 웹 페이지에 다음 코드를 추가하여 appstream-emb.js 파일을 웹 페이지로 가져옵니다.

    <script type="text/javascript" src="./appstream_embed.js"> </script>

  2. 그런 다음 빈 컨테이너 div를 만듭니다. 설정한 div의 ID는 AppStream 2.0 임베드 생성자에게 전달됩니다. 그런 다음 스트리밍 세션용 iframe을 주입하는 데 사용됩니다. div를 만들려면 다음 코드를 추가하십시오.

    <div id="appstream-container"> </div>

AppStream.Embed 인터페이스 객체 초기화 및 구성

JavaScript에서 AppStream.Embed 인터페이스 객체를 초기화하려면 스트리밍 URL 및 사용자 인터페이스 구성에 대한 옵션을 사용하여 AppStream.Embed 객체를 생성하는 코드를 추가해야 합니다. 이러한 옵션과 직접 생성한 div ID는 appstreamOptions라는 객체에 저장됩니다.

다음 예제 코드는 AppStream.Embed 인터페이스 객체를 초기화하는 방법을 보여줍니다.

var appstreamOptions = {
     sessionURL: 'https://appstream2.region.aws.amazon.com/authenticate?parameters=authenticationcode...',
     userInterfaceConfig:{[AppStream.Embed.Options.HIDDEN_ELEMENTS]:[AppStream.Embed.Elements.TOOLBAR]}
 };
 appstreamEmbed = new AppStream.Embed("appstream-container", appstreamOptions);

코드에서 sessionURL 및 userInterfaceConfig를 고유한 값으로 바꿉니다.

참고

userInterfaceConfig에 지정된 값은 전체 AppStream 2.0 도구 모음을 숨깁니다. 예제로 포함되는 이 값은 선택 사항입니다.

sessionUrl

AppStream 2.0 콘솔, CreateStreamingURL API 작업 또는 create-streaming-url AWS CLI 명령을 사용하여 생성한 스트리밍 URL입니다. 이 파라미터는 대소문자를 구분합니다.

유형: 문자열

필수 항목 여부: 예

userInterfaceConfig

사용자 인터페이스 요소의 초기 상태를 생성하는 구성입니다. 구성은 키-값 페어입니다.

이 키(AppStream.Embed.Options.HIDDEN_ELEMENTS)는 처음에 임베디드 AppStream 2.0 스트리밍 세션이 초기화될 때 숨겨지는 사용자 인터페이스 객체를 지정합니다. 나중에 getInterfaceState 파라미터를 사용하여 숨겨진 객체와 보이는 객체를 모두 반환할 수 있습니다.

이 값은 상수의 배열(도구 모음 버튼)입니다. 사용할 수 있는 상수 목록은 HIDDEN_ELEMENTS로 작업하기 단원을 참조하십시오.

유형: 맵(키:값)

필수 항목 여부: 아니요

AppStream 2.0 사용자 인터페이스에서 항목 숨기기 예시

이 섹션의 예시에서는 임베디드 AppStream 2.0 스트리밍 세션 동안 사용자로부터 AppStream 2.0 사용자 인터페이스의 항목을 숨기는 방법을 보여줍니다.

예 1: 전체 AppStream 2.0 도구 모음 숨기기

임베디드 스트리밍 세션 중에 사용자가 AppStream 2.0 도구 모음의 버튼에 액세스하지 못하도록 하려면 AppStream.Embed.Elements.TOOLBAR 상수를 사용합니다. 이 상수를 사용하면 모든 AppStream 2.0 도구 모음 버튼을 숨길 수 있습니다.

var appstreamOptions = {
     sessionURL: 'https://appstream2.region.aws.amazon.com/authenticate?parameters=authenticationcode...',
     userInterfaceConfig:{[AppStream.Embed.Options.HIDDEN_ELEMENTS]:[AppStream.Embed.Elements.TOOLBAR]}
 };

예 2: AppStream 2.0 도구 모음에서 특정 버튼 숨기기

임베디드 스트리밍 세션 중에 사용자가 특정 도구 모음 버튼에 액세스하지 못하도록 AppStream 2.0 도구 모음을 표시할 수 있습니다. 이렇게 하려면 숨기려는 버튼에 상수를 지정합니다. 다음 코드는 AppStream.Embed.Elements.FILES_BUTTON 상수를 사용하여 내 파일 버튼을 숨깁니다. 이렇게 하면 사용자가 임베디드 스트리밍 세션 중에 영구 스토리지 옵션에 액세스할 수 없습니다.

var appstreamOptions = {
     sessionURL: 'https://appstream2.region.aws.amazon.com/authenticate?parameters=authenticationcode...',
     userInterfaceConfig:{[AppStream.Embed.Options.HIDDEN_ELEMENTS]:[AppStream.Embed.Elements.FILES_BUTTON]}
 };

예 3: AppStream 2.0 도구 모음에서 여러 버튼 숨기기

임베디드 스트리밍 세션 중에 사용자가 둘 이상의 도구 모음 버튼에 액세스하지 못하도록 AppStream 2.0 도구 모음을 표시할 수 있습니다. 이렇게 하려면 숨기려는 버튼에 상수를 지정합니다. 다음 코드는 AppStream.Embed.Elements.END_SESSION_BUTTON 및 AppStream.Embed.Elements.FULLSCREEN_BUTTON 상수를 사용하여 End Session(세션 종료) 및 Fullscreen(전체 화면) 버튼을 숨깁니다.

참고

앞이나 뒤에 공백 없이 각 상수를 쉼표로 구분합니다.

var appstreamOptions = {
     sessionURL: 'https://appstream2.region.aws.amazon.com/authenticate?parameters=authenticationcode... (https://appstream2.region.aws.amazon.com/#/)',
     userInterfaceConfig:{[AppStream.Embed.Options.HIDDEN_ELEMENTS]:[AppStream.Embed.Elements.END_SESSION_BUTTON,AppStream.Embed.Elements.FULLSCREEN_BUTTON]}
 };

임베디드 AppStream 2.0 스트리밍 세션의 상수, 함수 및 이벤트

다음 항목에서는 임베디드 AppStream 2.0 스트리밍 세션을 구성하는 데 사용할 수 있는 상수, 함수 및 이벤트에 대한 참조 정보를 제공합니다.

임베디드 AppStream 2.0 스트리밍 세션이 초기화될 때 다음 AppStream 2.0 사용자 인터페이스 요소를 HIDDEN_ELEMENTS 구성 옵션으로 전달할 수 있습니다.

HIDDEN_ELEMENTS로 작업하기

임베디드 AppStream 2.0 스트리밍 세션이 초기화될 때 다음 AppStream 2.0 사용자 인터페이스 요소를 상수로 HIDDEN_ELEMENTS 구성 옵션으로 전달할 수 있습니다.

AppStream.Embed.Elements.TOOLBAR
AppStream.Embed.Elements.FULLSCREEN_BUTTON
AppStream.Embed.Elements.END_SESSION_BUTTON
AppStream.Embed.Elements.TOOLBAR
AppStream.Embed.Elements.CATALOG_BUTTON
AppStream.Embed.Elements.WINDOW_SWITCHER_BUTTON
AppStream.Embed.Elements.FILES_BUTTON
AppStream.Embed.Elements.CLIPBOARD_BUTTON
AppStream.Embed.Elements.COPY_LOCAL_BUTTON
AppStream.Embed.Elements.PASTE_REMOTE_BUTTON
AppStream.Embed.Elements.SETTINGS_BUTTON
AppStream.Embed.Elements.STREAMING_MODE_BUTTON
AppStream.Embed.Elements.SCREEN_RESOLUTION_BUTTON
AppStream.Embed.Elements.REGIONAL_SETTINGS_BUTTON
AppStream.Embed.Elements.FULLSCREEN_BUTTON
AppStream.Embed.Elements.END_SESSION_BUTTON

다음 세 요소는 상수가 아닌 문자열로 HIDDEN_ELEMENTS에 전달할 수 있습니다.

문자열 설명
'adminCommandsButton' AppStream 2.0 이미지 빌더에 연결하면 AppStream 2.0 도구 모음의 오른쪽 위 모서리에 관리 명령 버튼이 표시됩니다. 이 문자열을 HIDDEN_ELEMENTS에 전달하면 Admin Commands(관리 명령) 버튼이 숨겨집니다.
'softKeyboardButton' 터치 지원 디바이스에서 AppStream 2.0 스트리밍 세션 동안 AppStream 2.0 도구 모음의 키보드 아이콘을 눌러 화상 키보드를 표시할 수 있습니다. 이 문자열을 HIDDEN_ELEMENTS에 전달하면 키보드 아이콘이 숨겨집니다.
'keyboardShortcutsButton' 터치 지원 디바이스에서 AppStream 2.0 스트리밍 세션 동안 AppStream 2.0 도구 모음의 Fn 아이콘을 눌러 키보드 단축키를 표시할 수 있습니다. 이 문자열을 HIDDEN_ELEMENTS에 전달하면 Fn 아이콘이 숨겨집니다.

AppStream.Embed 객체에 대한 함수

다음 표에는 AppStream.Embed 객체에 대해 수행할 수 있는 함수가 나열되어 있습니다.

함수 설명
AppStream.Embed(containerId:string, options:object) AppStream.Embed 객체 생성자입니다. 이 생성자는 AppStream.Embed 객체를 초기화하고 통신을 수행하며 div 컨테이너 ID를 사용합니다. ID는 iframe을 주입하는 데 사용됩니다. 또한 appstreamOptions(sessionURL 및 HIDDEN_ELEMENTS)의 구성 옵션을 포함하는 객체를 주입합니다.
endSession() 이 함수는 스트리밍 세션을 종료하지만 iframe을 파괴하지는 않습니다. 리디렉션 URL을 지정하면 iframe이 URL을 로드하려고 시도합니다. 페이지의 CORS 헤더에 따라 URL이 로드되지 않을 수 있습니다.
launchApp(appId:string) 이 함수는 이미지 생성 중에 지정된 애플리케이션 ID로 애플리케이션을 프로그래밍 방식으로 시작합니다.
launchAppSwitcher() 이 함수는 AppSwitcher 명령을 AppStream 2.0 포털에 보냅니다. 그러면 인스턴스에서 AppSwitcher 명령이 트리거됩니다.
getSessionState() 이 함수는 sessionStatus에 대한 객체를 반환합니다. 자세한 내용은 임베디드 AppStream 2.0 스트리밍 세션에 대한 이벤트 섹션을 참조하세요.
getUserInterfaceState()

이 함수는 UserInterfaceState에 대한 객체를 반환합니다. 객체에는 다음에 대한 키-값 페어가 포함되어 있습니다.

sessionStatus: 상태 열거

sessionTerminationReason: 문자열 목록

sessionDisconnectionReason: 문자열 목록

자세한 내용은 임베디드 AppStream 2.0 스트리밍 세션에 대한 이벤트 섹션을 참조하세요.
addEventListener(name, callback) 이 함수는 지정된 이벤트가 트리거될 때 호출할 콜백 함수를 추가합니다. 트리거할 수 있는 이벤트 목록은 임베디드 AppStream 2.0 스트리밍 세션에 대한 이벤트 단원을 참조하십시오.
removeEventListener(name, callback) 이 함수는 지정된 이벤트에 대한 콜백을 제거합니다.
destroy() 이 함수는 iframe을 삭제하고 리소스를 정리합니다. 이 함수는 진행 중인 스트리밍 세션에는 영향을 주지 않습니다.

임베디드 AppStream 2.0 스트리밍 세션에 대한 이벤트

다음 표에는 임베디드 AppStream 2.0 스트리밍 세션 중에 트리거될 수 있는 이벤트가 나열되어 있습니다.

이벤트 Data 설명
AppStream.Embed.Events.SESSION_STATE_CHANGE

sessionStatus: State enumeration

sessionTerminationReason: 문자열 목록

sessionDisconnectionReason: 문자열 목록

이 이벤트는 세션 상태 변경이 발생할 때 트리거됩니다. 이 이벤트에는 변경된 상태의 맵이 포함됩니다. 전체 세션 상태를 검색하려면 getSessionState() 함수를 사용합니다.

세션 상태는 다음과 같습니다.

AppStream.Embed.SessionStatus.Unknown - 세션이 시작되지 않았으며 예약되지 않았습니다.

AppStream.Embed.SessionStatus.Reserved - 세션이 예약되었지만 시작되지 않았습니다.

AppStream.Embed.SessionStatus.Started - 사용자가 세션에 연결했고 스트리밍을 시작했습니다.

AppStream.Embed.SessionStatus Disconnected - 사용자의 세션 연결이 끊겼습니다.

AppStream.Embed.SessionStatus.Ended - 세션이 종료됨 또는 만료됨으로 표시되었습니다.
AppStream.Embed.Events.SESSION_INTERFACE_STATE_CHANGE

hiddenElements: 문자열 배열

isFullscreen: 부울

isSoftKeyboardVisible: 부울

 이 이벤트는 세션 상태 변경이 발생할 때 트리거됩니다. 이 이벤트에는 변경된 상태의 맵이 포함됩니다. 전체 세션 상태를 검색하려면 getSessionState() 함수를 사용합니다.
AppStream.Embed.Events.SESSION_ERROR

errorCode: 숫자

errorMessage: 문자열 목록

 이 이벤트는 세션 중에 오류가 발생할 때 트리거됩니다.

이벤트 리스너 추가 및 임베디드 AppStream 2.0 스트리밍 세션 종료 예시

이 섹션의 예제에서는 다음을 수행하는 방법을 보여 줍니다.

  • 임베디드 AppStream 2.0 스트리밍 세션에 대한 이벤트 리스너를 추가합니다.

  • 프로그래밍 방식으로 임베디드 AppStream 2.0 스트리밍 세션을 종료합니다.

예 1: 임베디드 AppStream 2.0 스트리밍 세션에 대한 이벤트 리스너를 추가합니다.

임베디드 스트리밍 세션 중에 세션 상태 변경, 세션 인터페이스 상태 변경 및 세션 오류에 대한 이벤트 리스너를 추가하려면 다음 코드를 사용합니다.

appstreamEmbed.addEventListener(AppStream.Embed.Events.SESSION_STATE_CHANGE, updateSessionStateCallback);

appstreamEmbed.addEventListener(AppStream.Embed.Events.SESSION_INTERFACE_STATE_CHANGE, updateUserInterfaceStateCallback);

appstreamEmbed.addEventListener(AppStream.Embed.Events.SESSION_ERROR, errorCallback);

이 예에서 AppStream.Embed.Events.SESSION_STATE_CHANGE, AppStream.Embed.Events.SESSION_INTERFACE_STATE_CHANGE, 및 AppStream.Embed.Events.SESSION_ERROR는 이벤트 이름입니다.

updateSessionStateCallback, updateUserInterfaceStateCallback, 및 errorCallback 함수는 직접 구현하는 함수입니다. 이러한 함수는 addEventListener 함수에 전달되고, 이벤트가 트리거되면 호출됩니다.

예 2: 프로그래밍 방식으로 임베디드 AppStream 2.0 스트리밍 세션을 종료합니다.

임베디드 AppStream 2.0 스트리밍 세션을 종료하려면 다음 함수를 사용합니다.

appstreamEmbed.endSession();