Konstanta, Fungsi, dan Acara untuk Sesi Streaming WorkSpaces Aplikasi Amazon Tertanam - WorkSpaces Aplikasi Amazon
Bekerja dengan HIDDEN_ELEMENTSFungsi untuk AppStream.Embed ObjekAcara untuk Sesi Streaming WorkSpaces Aplikasi TertanamContoh untuk Menambahkan Pendengar Acara dan Mengakhiri Sesi Streaming WorkSpaces Aplikasi Tertanam

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

Konstanta, Fungsi, dan Acara untuk Sesi Streaming WorkSpaces Aplikasi Amazon Tertanam

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

Elemen antarmuka pengguna WorkSpaces Aplikasi berikut dapat diteruskan ke opsi HIDDEN_ELEMENTS konfigurasi saat sesi streaming WorkSpaces Aplikasi tertanam diinisialisasi.

Bekerja dengan HIDDEN_ELEMENTS

Elemen antarmuka pengguna WorkSpaces Aplikasi berikut dapat diteruskan sebagai konstanta ke dalam opsi HIDDEN_ELEMENTS konfigurasi saat sesi streaming WorkSpaces Aplikasi 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 diteruskan sebagai string ke HIDDEN_ELEMENTS, bukan sebagai konstanta.

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

Fungsi untuk AppStream.Embed Objek

Tabel berikut mencantumkan fungsi yang dapat dilakukan pada AppStream.Embed objek.

Fungsi Deskripsi
AppStream.Embed(containerId:string, options:object) Konstruktor AppStream.Embed objek. Konstruktor ini menginisialisasi dan berkomunikasi dengan AppStream.Embed objek, dan menggunakan ID kontainer div. ID digunakan untuk menyuntikkan iframe. Ini juga menyuntikkan objek yang mencakup opsi konfigurasi untuk appstreamOptions (sessionURLdanHIDDEN_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 mengirimkan AppSwitcher perintah ke portal WorkSpaces Aplikasi. Ini memicu AppSwitcher perintah pada instance.
getSessionState() Fungsi ini mengembalikan sebuah objek untuksessionStatus. Untuk informasi selengkapnya, lihat Acara untuk Sesi Streaming WorkSpaces Aplikasi 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 WorkSpaces Aplikasi Tertanam.
addEventListener(name, callback) Fungsi ini menambahkan fungsi callback untuk memanggil ketika peristiwa tertentu dipicu. Untuk daftar peristiwa yang dapat dipicu, lihatAcara untuk Sesi Streaming WorkSpaces Aplikasi 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 WorkSpaces Aplikasi Tertanam

Tabel berikut mencantumkan peristiwa yang dapat dipicu selama sesi streaming WorkSpaces Aplikasi tertanam.

Peristiwa Data Deskripsi
AppStream.Embed.Events.SESSION_STATE_CHANGE

sessionStatus: State enumeration

sessionTerminationReason: String

sessionDisconnectionReason: String

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

Berikut ini adalah status sesi:

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

AppStream.Embed.SessionStatus.Reserved— Sesi 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

hiddenElements: Array string

isFullscreen: Boolean

isSoftKeyboardVisible: Boolean

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

errorCode: Angka

errorMessage: String

 Peristiwa ini dipicu ketika ada kesalahan yang terjadi selama sesi.

Contoh untuk Menambahkan Pendengar Acara dan Mengakhiri Sesi Streaming WorkSpaces Aplikasi Tertanam

Contoh di bagian ini menunjukkan cara melakukan hal berikut:

  • Tambahkan pendengar acara untuk sesi streaming WorkSpaces Aplikasi yang disematkan.

  • Akhiri sesi streaming WorkSpaces Aplikasi yang disematkan secara terprogram.

Contoh 1: Tambahkan pendengar acara untuk sesi streaming WorkSpaces Aplikasi yang disematkan

Untuk menambahkan pendengar acara untuk perubahan status sesi, perubahan status antarmuka sesi, dan kesalahan sesi selama sesi streaming tertanam, 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, dan AppStream.Embed.Events.SESSION_ERROR merupakan nama acara.

Fungsi updateSessionStateCallbackupdateUserInterfaceStateCallback, dan errorCallback fungsi adalah yang Anda terapkan. Fungsi-fungsi ini diteruskan ke addEventListener fungsi dan dipanggil ketika suatu peristiwa dipicu.

Contoh 2: Akhiri sesi streaming WorkSpaces Aplikasi yang disematkan secara terprogram

Untuk mengakhiri sesi streaming WorkSpaces Aplikasi yang disematkan, gunakan fungsi berikut:

appstreamEmbed.endSession();