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

# Langkah 4. Konfigurasikan Situs Web Anda untuk Integrasi dengan WorkSpaces Aplikasi Amazon
<a name="configure-website-for-integration"></a>

Bagian berikut memberikan informasi tentang cara mengonfigurasi halaman web Anda untuk meng-host sesi streaming WorkSpaces Aplikasi yang disematkan.

**Topics**
+ [Impor File yang disematkan appstream JavaScript](#import-embed-javascript-file)
+ [Inisialisasi dan Konfigurasikan Objek `AppStream.Embed` Antarmuka](#initialize-configure-embed-interface-object)
+ [Contoh untuk Menyembunyikan Item di Antarmuka Pengguna WorkSpaces Aplikasi](#examples-hiding-user-interface-items)

## Impor File yang disematkan appstream JavaScript
<a name="import-embed-javascript-file"></a>

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

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

1. Selanjutnya, buat div kontainer kosong. ID div yang Anda atur diteruskan ke konstruktor embed WorkSpaces Applications. Ini kemudian digunakan untuk menyuntikkan iframe untuk sesi streaming. Untuk membuat div, tambahkan kode berikut:

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

## Inisialisasi dan Konfigurasikan Objek `AppStream.Embed` Antarmuka
<a name="initialize-configure-embed-interface-object"></a>

Untuk menginisialisasi objek `AppStream.Embed` antarmuka JavaScript, Anda harus menambahkan kode yang membuat `AppStream.Embed` objek dengan opsi untuk URL streaming dan konfigurasi antarmuka pengguna. Opsi ini, dan ID div yang Anda buat, disimpan dalam objek yang disebut`appstreamOptions`.

Kode contoh berikut menunjukkan bagaimana menginisialisasi objek `AppStream.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 *userInterfaceConfig* dengan nilai Anda sendiri. 

**catatan**  
Nilai yang ditentukan untuk *userInterfaceConfig* menyembunyikan seluruh toolbar WorkSpaces Aplikasi. Nilai ini, yang disertakan sebagai contoh, adalah opsional.

***sessionUrl***  
URL streaming yang Anda buat dengan menggunakan konsol WorkSpaces Aplikasi, tindakan API [CreateStreamingURL](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateStreamingURL.html), atau perintah [create-streaming-url](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-streaming-url.html) AWS CLI. Parameter ini peka huruf besar/kecil.  
**Tipe**: String  
**Wajib**: Ya

***userInterfaceConfig***  
Konfigurasi yang menghasilkan keadaan awal elemen antarmuka pengguna. Konfigurasi adalah pasangan kunci-nilai.   
Kuncinya`AppStream.Embed.Options.HIDDEN_ELEMENTS`,, menentukan objek antarmuka pengguna yang awalnya disembunyikan ketika sesi streaming WorkSpaces Aplikasi tertanam diinisialisasi. Kemudian, Anda dapat mengembalikan objek tersembunyi dan terlihat dengan menggunakan `getInterfaceState` parameter.  
Nilainya adalah array konstanta (tombol toolbar). Untuk daftar konstanta yang dapat Anda gunakan, lihat[Bekerja dengan `HIDDEN_ELEMENTS`](constants-functions-events-embedded-sessions.md#constants-hidden-elements).  
**Jenis**: Peta (*key*:*value*)  
**Wajib**: Tidak

## Contoh untuk Menyembunyikan Item di Antarmuka Pengguna WorkSpaces Aplikasi
<a name="examples-hiding-user-interface-items"></a>

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

**Topics**
+ [Contoh 1: Sembunyikan seluruh toolbar WorkSpaces Aplikasi](#example-hide-the-entire-tooolbar)
+ [Contoh 2: Sembunyikan tombol tertentu pada toolbar WorkSpaces Aplikasi](#example-hide-a-specific-toolbar-button)
+ [Contoh 3: Sembunyikan beberapa tombol pada toolbar WorkSpaces Aplikasi](#example-hide-multiple-toolbar-buttons)

### Contoh 1: Sembunyikan seluruh toolbar WorkSpaces Aplikasi
<a name="example-hide-the-entire-tooolbar"></a>

Untuk mencegah pengguna mengakses tombol apa pun pada bilah alat WorkSpaces Aplikasi selama sesi streaming tertanam, gunakan konstanta. `AppStream.Embed.Elements.TOOLBAR` Konstanta ini memungkinkan Anda menyembunyikan semua tombol toolbar WorkSpaces Aplikasi.

```
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 WorkSpaces Aplikasi
<a name="example-hide-a-specific-toolbar-button"></a>

Anda dapat menampilkan toolbar WorkSpaces Aplikasi, sekaligus mencegah pengguna mengakses tombol toolbar tertentu selama sesi streaming tertanam. Untuk melakukannya, tentukan konstanta untuk tombol yang ingin Anda sembunyikan. Kode berikut menggunakan `AppStream.Embed.Elements.FILES_BUTTON` konstanta untuk menyembunyikan tombol **My Files**. 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 WorkSpaces Aplikasi
<a name="example-hide-multiple-toolbar-buttons"></a>

Anda dapat menampilkan toolbar WorkSpaces Aplikasi, sekaligus mencegah pengguna mengakses lebih dari satu tombol toolbar selama sesi streaming tertanam. Untuk melakukannya, tentukan konstanta untuk tombol yang ingin Anda sembunyikan. Kode berikut menggunakan `AppStream.Embed.Elements.FULLSCREEN_BUTTON` konstanta `AppStream.Embed.Elements.END_SESSION_BUTTON` dan untuk menyembunyikan tombol **End Session** dan **Fullscreen**. 

**catatan**  
Pisahkan setiap konstanta dengan koma, tanpa spasi sebelumnya atau berikutnya.

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