Sematkan Sesi Streaming AppStream 2.0 - Amazon AppStream 2.0
PrasyaratRekomendasi dan Pertimbangan PenggunaanLangkah 1: Tentukan Domain Host untuk Sesi Streaming AppStream 2.0 TertanamLangkah 2: Membuat URL Streaming URL Streaming untuk Otentikasi PenggunaLangkah 3: Unduh file 2.0 Tertanam 2.0 file tertanam AppStream 2.0 file tertanamLangkah 4. Konfigurasikan Situs Web Anda untuk Integrasi dengan AppStream 2.0Konstanta, Fungsi, dan Acara untuk Sesi Streaming AppStream 2.0 Tertanam

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Sematkan Sesi Streaming AppStream 2.0

Anda dapat membuat pengalaman dinamis, interaktif, dan disesuaikan untuk pengguna Anda dengan menyematkan sesi streaming AppStream 2.0 di situs web Anda. Sesi streaming AppStream 2.0 yang disematkan memungkinkan pengguna berinteraksi dengan model 3D, peta, dan kumpulan data langsung dari situs web Anda. Misalnya, pengguna dapat melihat instruksi pelatihan atau materi pendidikan di samping sesi streaming AppStream 2.0 mereka.

Prasyarat

Untuk menyematkan sesi streaming AppStream 2.0 di situs web, Anda harus memiliki hal-hal berikut:

  • Lingkungan AppStream 2.0 yang dikonfigurasi yang mencakup gambar AppStream 2.0, armada, dan tumpukan. Untuk informasi tentang cara membuat topik berikut di Panduan AdministrasiAppStream 2.0:

  • URL streaming untuk otentikasi pengguna. Kumpulan pengguna SALL 2.0 dan AppStream 2.0 saat ini tidak didukung sebagai metode otentikasi untuk sesi streaming AppStream 2.0 yang disematkan.

  • Secara opsional, Anda dapat menggunakan domain khusus untuk sesi streaming AppStream 2.0 yang disematkan. Anda dapat menggunakan domain kustom sehingga URL perusahaan Anda sendiri ditampilkan untuk pengguna daripada URL AppStream 2.0. Domain khusus diperlukan jika pengguna Anda memiliki browser web yang memblokir cookie pihak ketiga.

    catatan

    Anda dapat mengonfigurasi domain khusus dengan menggunakan Amazon CloudFront. Untuk selengkapnya, lihat Menggunakan Domain Kustom dengan AppStream 2.0.

    Saat Anda menggunakan domain kustom, Anda harus:

    • Buat URL streaming yang menggunakan domain yang sama.

    • Tambahkanappstream-custom-url-domain ke header halaman web yang akan menjadi tuan rumah sesi streaming AppStream 2.0 yang disematkan. Untuk nilai header, gunakan domain yang ditampilkan proxy terbalik Anda kepada pengguna. Untuk informasi selengkapnya, lihat Persyaratan Konfigurasi untuk Menggunakan Domain Kustom.

Rekomendasi dan Pertimbangan Penggunaan

Pertimbangkan rekomendasi berikut dan catatan penggunaan untuk sesi streaming AppStream 2.0 yang disematkan.

  • Untuk mempertahankan kontrol maksimum atas pengalaman streaming AppStream 2.0 yang disematkan bagi pengguna Anda, kami sarankan Anda mengonfigurasi URL streaming berumur pendek yang bertahan sekitar 5 detik. Setiap pengguna dapat memeriksa isi halaman web dan melihat sumbernya. Ini termasuk model objek dokumen (DOM) dan src (sumber) URL dari iframe. Jika URL masih valid saat pengguna menyalinnya, pengguna tersebut dapat menempelkan URL di tab browser terpisah dan melakukan streaming sesi dengan antarmuka pengguna portal AppStream 2.0 standar, tanpa opsi penyematan.

  • Sesi serentak tidak didukung saat domain kustom digunakan untuk sesi streaming AppStream 2.0 yang disematkan. Sesi bersamaan terjadi ketika pengguna memulai dua sesi streaming AppStream 2.0 yang disematkan baik di halaman web yang sama atau di dua tab browser yang berbeda. Anda tidak dapat memiliki satu pengguna dengan sesi bersamaan, tetapi Anda dapat memiliki beberapa pengguna. Misalnya, pengguna masuk ke aplikasi Anda, aplikasi Anda menghasilkan URL streaming untuk diberikan kepada pelanggan (yang dihitung sebagai pengguna unik untuk penagihan), pelanggan memuat URL streaming, dan pelanggan ditugaskan ke instance appstream dalam pool yang ditentukan.

Langkah 1: Tentukan Domain Host untuk Sesi Streaming AppStream 2.0 Tertanam

Untuk menyematkan sesi streaming AppStream 2.0 di halaman web, pertama-tama perbarui tumpukan Anda untuk menentukan domain yang akan menjadi tuan rumah sesi streaming yang disematkan. Ini merupakan langkah keamanan untuk memastikan bahwa hanya domain situs web resmi yang dapat menyematkan sesi streaming AppStream 2.0. AppStream 2.0 menambahkan domain atau domain yang Anda tentukan ke headerContent-Security-Policy (CSP). Untuk informasi selengkapnya, lihat Kebijakan Keamanan Konten (CSP) di dokumentasi Mozilla MDN Web Docs.

Untuk memperbarui tumpukan untuk menentukan domain yang akan menjadi tuan rumah sesi streaming tertanam, gunakan salah satu metode berikut:

  • Konsol AppStream 2.0

  • AksiEmbedHostDomains API

  • embed-host-domainsAWSPerintah antarmuka baris perintah (AWSCLI)

Untuk menentukan domain host dengan menggunakan konsol AppStream 2.0, lakukan langkah-langkah berikut.

  1. Buka konsol AppStream 2.0 di https://console.aws.amazon.com/appstream2.

  2. Di panel navigasi kiri, pilih Stacks, dan pilih tumpukan yang Anda inginkan.

  3. Pilih Edit.

  4. Perluas Embed AppStream 2.0 (Opsional).

  5. Di Domain Host, tentukan domain yang valid. Misalnya: training.example.com.

    catatan

    Sesi streaming tertanam hanya didukung melalui HTTPS [port TCP 443].

  6. Pilih Update (Perbarui).

Langkah 2: Membuat URL Streaming URL Streaming untuk Otentikasi Pengguna

Anda harus membuat URL streaming untuk mengotentikasi pengguna untuk sesi streaming 2.0 yang disematkan oleh pengguna untuk sesi streaming AppStream 2.0 yang disematkan. SALL 2.0 dan kumpulan pengguna saat ini tidak didukung untuk sesi streaming yang disematkan. Untuk membuat URL streaming, gunakan salah satu metode berikut:

Persyaratan Konfigurasi untuk Menggunakan Domain Kustom

Baik Anda menggunakan domain khusus untuk menerapkan merek perusahaan Anda atau untuk memastikan bahwa sesi streaming AppStream 2.0 yang disematkan berfungsi dengan browser yang memblokir cookie pihak ketiga, persyaratan konfigurasinya sama.

Untuk browser web yang memblokir cookie pihak ketiga, domain khusus diperlukan. AppStream 2.0 menggunakan cookie browser untuk mengautentikasi sesi streaming dan memungkinkan pengguna menyambung kembali ke sesi aktif tanpa diminta untuk memberikan kredensi login mereka setiap saat. Secara default, URL streaming AppStream 2.0 termasukappstream.com sebagai domain. Ketika Anda menyematkan sesi streaming dalam situs web Anda,appstream.com diperlakukan sebagai domain pihak ketiga. Akibatnya, sesi streaming dapat diblokir ketika browser modern digunakan yang memblokir cookie pihak ketiga secara default.

Agar sesi streaming AppStream 2.0 tertanam tidak diblokir dalam skenario ini, ikuti langkah-langkah berikut:

  1. Tentukan domain kustom untuk host sesi streaming 2.0 Anda yang disematkan sesi streaming AppStream 2.0 yang disematkan.

    Ketika Anda mengkonfigurasi domain kustom Anda, pastikan bahwa domain adalah subdomain dari halaman web di mana Anda berencana untuk menyematkan AppStream 2.0. Misalnya, jika Anda memperbarui tumpukan untuk menentukantraining.example.com sebagai domain host, Anda dapat membuat subdomain yang dipanggilcontent.training.example.com untuk sesi streaming tersemat.

  2. Buat URL streaming untuk sesi streaming AppStream 2.0 tertanam yang menggunakan subdomain kustom yang sama. Untuk membuat URL streaming, gunakan tindakan CreateStreamingURL API atau perintah create-streaming-urlAWSCLI. Anda tidak dapat menggunakan konsol AppStream 2.0 untuk membuat URL streaming dalam skenario ini.

    Untuk membuat URL streaming untuk sesi streaming AppStream 2.0 yang disematkan, di URL, gantiappstream2. wilayah.aws.amazon.com dengan domain Anda sendiri.

    Secara default, URL streaming AppStream 2.0 diformat sebagai berikut:

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

    Jika subdomain Andacontent.training.example.com, URL streaming baru Anda mengikuti format ini:

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

    Saat membuat domain khusus, Anda dapat menggunakan domain untuk sesi streaming AppStream 2.0 yang disematkan hanya diAWS Wilayah yang dikonfigurasinya. Jika Anda berencana untuk mendukung domain kustom di beberapa Wilayah, buat domain khusus untuk setiap Wilayah yang berlaku. Selain itu, sesi streaming tertanam hanya didukung melalui HTTPS [port TCP 443].

  3. Tambahkanappstream-custom-url-domain ke header halaman web yang akan menjadi tuan rumah sesi streaming yang disematkan. Untuk nilai header, gunakan domain yang ditampilkan proxy terbalik Anda kepada pengguna. Misalnya:

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

    Menyetel domain kustom dan membuat URL streaming yang menentukan domain yang sama memungkinkan cookie disimpan sebagai cookie pihak pertama. Untuk informasi tentang cara mengonfigurasi domain kustom dengan menggunakan Amazon CloudFront, lihat Menggunakan Domain Kustom dengan AppStream 2.0.

Setelah menyiapkan domain kustom untuk sesi streaming AppStream 2.0 yang disematkan, jika URL streaming tidak dialihkan ke domain kustom, atau jika domain kustom Anda tidak ditampilkan dengan benar untuk pengguna, lihat topik pemecahan masalah berikut:

Langkah 3: Unduh file 2.0 Tertanam 2.0 file tertanam AppStream 2.0 file tertanam

Untuk meng-host sesi streaming AppStream 2.0 yang disematkan, Anda harus mengunduh dan mengonfigurasi JavaScript file API AppStream 2.0 yang disediakan.

  1. Pada Embedding AppStream 2.0 di halaman web Situs Web Anda, pilih tautan di langkah 1 untuk mengunduh file AppStream 2.0 Embed Kit .zip, appstream_embed_ .zip<version>.

  2. Arahkan ke lokasi tempat Anda mengunduh file.zip, dan ekstrak konten file.

  3. Isi yang diekstrak dari file terdiri dari satu folder, appstream-embed. Selain file COPYRIGHT.txt dan THIRD_PARTY_NOTICES.txt, folder ini berisi dua file berikut:

    • appstream-embed.js - Menyediakan tertanam AppStream 2.0 API. JavaScript File ini mencakup fungsi dan tindakan API untuk mengonfigurasi dan mengendalikan sesi streaming AppStream 2.0 tertanam Anda.

    • embed-sample.html - Menjelaskan cara menggunakan API AppStream 2.0 tertanam untuk menginisialisasi sesi streaming, fungsi panggilan, dan mendengarkan acara. File sampel ini memperluas informasi dalam topik ini, untuk memberikan contoh kasus penggunaan bagi pengembang.

Langkah 4. Konfigurasikan Situs Web Anda untuk Integrasi dengan AppStream 2.0

Bagian berikut memberikan informasi tentang cara mengonfigurasi halaman web Anda untuk menghosting sesi streaming AppStream 2.0 yang disematkan.

Impor JavaScript file appstream-embed

  1. Pada halaman web tempat Anda berencana untuk menyematkan sesi streaming AppStream 2.0, impor file appstream-embed.js ke halaman web dengan menambahkan kode berikut:

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

  2. Selanjutnya, buat div kontainer kosong. ID dari div yang Anda tetapkan diteruskan ke konstruktor AppStream 2.0 embed. Ini kemudian digunakan untuk menyuntikkan iframe untuk sesi streaming. Untuk membuat div, tambahkan kode berikut:

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

Inisialisasi dan Konfigurasi ObjekAppStream.Embed Antarmuka

Untuk menginisialisasi objekAppStream.Embed antarmuka JavaScript, Anda harus menambahkan kode yang membuatAppStream.Embed objek dengan opsi untuk URL streaming dan konfigurasi antarmuka pengguna. Pilihan ini, dan ID div yang Anda buat, disimpan dalam objek yang disebutappstreamOptions.

Contoh kode berikut menunjukkan bagaimana untuk menginisialisasi objek antarmuka berikut menunjukkan bagaimana cara menginisialisasi objekAppStream.Embed antarmuka.

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);

Dalam kode, ganti sessionURL dan userInterfaceConfigdengan nilai Anda sendiri.

catatan

Nilai yang ditentukan untuk userInterfaceConfigmenyembunyikan seluruh toolbar AppStream 2.0. Nilai ini, yang disertakan sebagai contoh, adalah opsional.

sessionUrl

URL streaming yang Anda buat menggunakan konsol AppStream 2.0, tindakan API CreateStreamingURL, atau perintah create-streaming-urlAWSCLI. Parameter ini peka huruf besar kecil dan kecil.

Tipe: String

Wajib: Ya

userInterfaceConfig

Konfigurasi yang menghasilkan keadaan awal elemen antarmuka pengguna. Konfigurasi adalah pasangan nilai kunci dan nilai kunci.

KuncinyaAppStream.Embed.Options.HIDDEN_ELEMENTS,, menentukan objek antarmuka pengguna yang awalnya tersembunyi saat sesi streaming AppStream 2.0 tertanam diinisialisasi. Kemudian, Anda dapat mengembalikan objek tersembunyi dan terlihat dengan menggunakangetInterfaceState parameter.

Nilai adalah array konstanta (tombol toolbar). Untuk daftar konstanta yang dapat Anda gunakan, lihatBekerja dengan HIDDEN_ELEMENTS.

Jenis: Peta (key: value)

Wajib: Tidak

Contoh untuk Menyembunyikan Item di Antarmuka Pengguna AppStream 2.0

Contoh di bagian ini menunjukkan cara menyembunyikan item di antarmuka pengguna AppStream 2.0 dari pengguna selama sesi streaming AppStream 2.0 yang disematkan.

Contoh 1: Sembunyikan seluruh toolbar AppStream 2.0

Untuk mencegah pengguna mengakses tombol apa pun pada toolbar AppStream 2.0 selama sesi streaming tertanam, gunakanAppStream.Embed.Elements.TOOLBAR konstanta. Konstanta ini memungkinkan Anda menyembunyikan semua tombol 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]}
 };

Contoh 2: Sembunyikan tombol tertentu pada toolbar AppStream 2.0

Anda dapat menampilkan toolbar AppStream 2.0, sekaligus mencegah pengguna mengakses tombol toolbar tertentu selama sesi streaming yang disematkan. Untuk melakukannya, tentukan konstanta untuk tombol yang ingin Anda sembunyikan. Kode berikut menggunakanAppStream.Embed.Elements.FILES_BUTTON konstanta untuk menyembunyikan tombol File Saya. Ini mencegah pengguna mengakses opsi penyimpanan persisten selama sesi streaming tertanam.

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

Contoh 3: Sembunyikan beberapa tombol pada toolbar AppStream 2.0

Anda dapat menampilkan toolbar AppStream 2.0, sekaligus mencegah pengguna mengakses lebih dari satu tombol toolbar selama sesi streaming yang disematkan. Untuk melakukannya, tentukan konstanta untuk tombol yang ingin Anda sembunyikan. Kode berikut menggunakanAppStream.Embed.Elements.END_SESSION_BUTTON danAppStream.Embed.Elements.FULLSCREEN_BUTTON konstanta untuk menyembunyikan Sesi Akhir dan tombol Fullscreen.

catatan

Pisahkan setiap konstanta dengan koma, tanpa ruang sebelumnya atau berikut.

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]}
 };

Konstanta, Fungsi, dan Acara untuk Sesi Streaming AppStream 2.0 Tertanam

Topik berikut memberikan informasi referensi untuk konstanta, fungsi, dan peristiwa yang dapat Anda gunakan untuk mengonfigurasi sesi streaming AppStream 2.0 yang disematkan.

Elemen antarmuka pengguna AppStream 2.0 berikut dapat diteruskan ke opsiHIDDEN_ELEMENTS konfigurasi ketika sesi streaming AppStream 2.0 tertanam diinisialisasi.

Bekerja dengan HIDDEN_ELEMENTS

Elemen antarmuka pengguna AppStream 2.0 berikut dapat diteruskan sebagai konstanta ke dalam opsiHIDDEN_ELEMENTS konfigurasi ketika sesi streaming AppStream 2.0 tertanam diinisialisasi. 

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

Tiga elemen berikut dapat dilewatkan sebagai string ke HIDDEN_ELEMENTS, bukan sebagai konstanta.

String Deskripsi
'adminCommandsButton' Saat Anda terhubung ke pembuat gambar AppStream 2.0, tombol Perintah Admin ditampilkan di sudut kanan atas toolbar AppStream 2.0. Melewati string ini keHIDDEN_ELEMENTS menyembunyikan tombol Admin Commands.
'softKeyboardButton' Selama sesi streaming AppStream 2.0 pada perangkat yang mendukung sentuhan, pengguna dapat mengetuk ikon keyboard pada toolbar AppStream 2.0 untuk menampilkan keyboard di layar. Melewati string ini keHIDDEN_ELEMENTS menyembunyikan ikon keyboard.
'keyboardShortcutsButton' Selama sesi streaming AppStream 2.0 pada perangkat yang mendukung sentuhan, pengguna dapat mengetuk ikon Fn pada toolbar AppStream 2.0 untuk menampilkan pintasan keyboard. Melewati string ini keHIDDEN_ELEMENTS menyembunyikan ikon Fn.

Fungsi untukAppStream.Embed Object

Tabel berikut berisi daftar fungsi yang dapat dilakukan padaAppStream.Embed objek.

Fungsi Deskripsi
AppStream.Embed(containerId:string, options:object) AppStream.EmbedObjek konstruktor. Konstruktor ini menginisialisasi dan berkomunikasi denganAppStream.Embed objek, dan menggunakan ID kontainer div. ID digunakan untuk menyuntikkan iframe. Hal ini juga menyuntikkan sebuah objek yang mencakup pilihan konfigurasi untukappstreamOptions (sessionURL danHIDDEN_ELEMENTS).
endSession() Fungsi ini mengakhiri sesi streaming, tetapi tidak merusak iframe. Jika Anda menentukan URL pengalihan, iframe mencoba memuat URL. Bergantung pada header CORS halaman, URL mungkin tidak dimuat.
launchApp(appId:string) Fungsi ini secara terprogram meluncurkan aplikasi dengan ID aplikasi yang ditentukan selama pembuatan gambar.
launchAppSwitcher() Fungsi ini mengirimkanAppSwitcher perintah ke portal AppStream 2.0. Ini memicuAppSwitcher perintah pada instance.
getSessionState() Fungsi ini mengembalikan sebuah objek untuksessionStatus. Untuk informasi selengkapnya, lihat Acara untuk Sesi Streaming AppStream 2.0 Tertanam.
getUserInterfaceState()

Fungsi ini mengembalikan sebuah objek untukUserInterfaceState. Objek berisi pasangan kunci-nilai untuk berikut:

sessionStatus: Pencacahan negara

sessionTerminationReason: String

sessionDisconnectionReason: String

Untuk informasi selengkapnya, lihat Acara untuk Sesi Streaming AppStream 2.0 Tertanam.
addEventListener(name, callback) Fungsi ini menambahkan fungsi callback untuk memanggil ketika acara tertentu dipicu. Untuk daftar peristiwa yang dapat dipicu, lihatAcara untuk Sesi Streaming AppStream 2.0 Tertanam.
removeEventListener(name, callback) Fungsi ini menghapus callback untuk peristiwa tertentu.
destroy() Fungsi ini menghapus iframe dan membersihkan sumber daya. Fungsi ini tidak memengaruhi sesi streaming yang sedang berlangsung.

Acara untuk Sesi Streaming AppStream 2.0 Tertanam

Tabel berikut mencantumkan peristiwa yang dapat dipicu selama sesi streaming AppStream 2.0 tertanam.

Peristiwa Data Deskripsi
AppStream.Embed.Events.SESSION_STATE_CHANGE

sessionStatus: State enumeration

sessionTerminationReason: String

sessionDisconnectionReason: String

Acara ini dipicu ketika setiap perubahan negara sesi terjadi. Acara ini mencakup peta negara bagian yang berubah. Untuk mengambil status sesi penuh, gunakangetSessionState() fungsi.

Berikut ini adalah negara sesi:

AppStream.Embed.SessionStatus.Unknown— Sesi belum dimulai dan tidak dicadangkan

AppStream.Embed.SessionStatus.Reserved— Sesi ini dicadangkan tetapi belum dimulai.

AppStream.Embed.SessionStatus.Started- Pengguna terhubung ke sesi dan mulai streaming.

AppStream.Embed.SessionStatus Disconnected - Pengguna terputus dari sesi.

AppStream.Embed.SessionStatus.Ended— Sesi ditandai sebagai berakhir atau kedaluwarsa.
AppStream.Embed.Events.SESSION_INTERFACE_STATE_CHANGE

hiddenElementsArArArArArray string string Array string

isFullscreen: Boolean

isSoftKeyboardVisible: Boolean

 Acara ini dipicu ketika setiap perubahan negara sesi terjadi. Acara ini mencakup peta negara bagian yang berubah. Untuk mengambil status sesi penuh, gunakangetSessionState() fungsi.
AppStream.Embed.Events.SESSION_ERROR

errorCode: Nomor

errorMessage: String

 Acara ini dipicu ketika kesalahan terjadi selama sesi.

Contoh untuk Menambahkan Pendengar Acara dan Mengakhiri Sesi Streaming AppStream 2.0 Tertanam

Contoh di bagian ini menunjukkan cara melakukan hal berikut:

  • Tambahkan pendengar acara untuk sesi streaming AppStream 2.0 yang disematkan.

  • Akhiri sesi streaming AppStream 2.0 yang disematkan secara terprogram.

Contoh 1: Tambahkan pendengar acara untuk sesi streaming AppStream 2.0 yang disematkan

Untuk menambahkan pendengar peristiwa untuk perubahan status sesi, perubahan status antarmuka sesi, dan kesalahan sesi selama sesi streaming yang disematkan, gunakan kode berikut:

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);

Dalam contoh ini,AppStream.Embed.Events.SESSION_STATE_CHANGE,AppStream.Embed.Events.SESSION_INTERFACE_STATE_CHANGE, danAppStream.Embed.Events.SESSION_ERROR adalah nama acara.

TheupdateSessionStateCallback,updateUserInterfaceStateCallback, danerrorCallback fungsi adalah orang-orang yang Anda menerapkan. Fungsi-fungsi ini dilewatkan keaddEventListener fungsi dan dipanggil ketika suatu peristiwa dipicu.

Contoh 2: Akhiri sesi streaming AppStream 2.0 yang disematkan secara terprogram

Untuk mengakhiri sesi streaming AppStream 2.0 yang disematkan, gunakan fungsi berikut:

appstreamEmbed.endSession();