

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

# Memenuhi Syarat Perangkat USB untuk Digunakan dengan Aplikasi Streaming
<a name="qualify-usb-devices"></a>

Ada dua metode untuk menentukan perangkat USB mana yang dapat dialihkan pengguna Anda ke instance streaming WorkSpaces Aplikasi mereka:

**catatan**  
Pengalihan USB saat ini hanya didukung pada instance streaming WorkSpaces Aplikasi Windows. Itu tidak didukung pada klien macOS. 
+ Anda dapat membuat string filter perangkat USB dalam file konfigurasi yang disimpan pada gambar. Metode ini hanya dapat digunakan dengan armada Always-On dan On-Demand.
+ Anda dapat menentukan string filter perangkat USB saat membuat armada, baik dengan AWS Management Console atau dengan `CreateFleet` API. Untuk informasi rinci tentang string ini, lihat bagian di bawah ini. Metode ini hanya dapat digunakan dengan armada elastis.

Anda dapat membuat file pada gambar WorkSpaces Aplikasi Anda yang menentukan perangkat USB mana yang dapat disediakan pengguna untuk aplikasi streaming mereka. Untuk memenuhi syarat perangkat USB pengguna Anda sehingga perangkat dapat digunakan dengan aplikasi streaming, lakukan langkah-langkah ini. 

**catatan**  
Untuk alasan keamanan, hanya memenuhi syarat perangkat USB dari sumber tepercaya yang disetujui. Memenuhi syarat semua perangkat generik atau kelas perangkat mungkin memungkinkan perangkat yang tidak disetujui untuk digunakan dengan aplikasi streaming Anda.

1. Jika Anda belum melakukannya, instal klien WorkSpaces Aplikasi. Untuk informasi, lihat [Instal dan Konfigurasikan Klien WorkSpaces Aplikasi](install-configure-client.md).

1. Hubungkan perangkat USB yang ingin Anda kualifikasikan ke komputer Anda.

1. Arahkan ke **C:\$1Users\$1 < logged-in-user >\$1AppData\$1 Local\$1 AppStreamClient**, dan klik dua kali **dcvusblist.exe**.

1. Di kotak dialog **DCV - Perangkat USB**, daftar perangkat USB yang terhubung ke komputer lokal Anda ditampilkan. Kolom **Filter** menampilkan string filter untuk setiap perangkat USB. Klik kanan entri daftar untuk perangkat USB yang ingin Anda aktifkan, dan pilih **Salin string filter**. 

1. Di desktop Anda, pilih tombol **Start** Windows, dan cari Notepad. Klik dua kali **Notepad** untuk membuka file baru, salin string filter ke file, dan simpan. Nanti, Anda akan menggunakan string filter untuk memenuhi syarat perangkat USB.

1. Luncurkan pembuat gambar baru. Untuk informasi selengkapnya, lihat [Luncurkan Image Builder untuk Menginstal dan Mengkonfigurasi Aplikasi Streaming](tutorial-image-builder-create.md).

1. Setelah pembuat gambar Anda dalam status **Running**, lakukan langkah-langkah berikut untuk membuat URL streaming dan sambungkan ke pembuat gambar dengan menggunakan klien WorkSpaces Aplikasi.

   1. Dengan pembuat gambar Anda dipilih dalam daftar, pilih **Tindakan**, **Buat URL streaming**.

   1. Dalam kotak dialog **Buat URL streaming**, pilih **Salin tautan**, dan salin dan tempel alamat web ke file terpisah untuk digunakan nanti. Anda akan menggunakan URL ini untuk menyambung kembali ke pembuat gambar di langkah 12.

   1. Pilih **Luncurkan di Klien**.

   1. Jika kotak dialog **Luncurkan Aplikasi** terbuka dan meminta Anda untuk memilih aplikasi yang akan digunakan saat membuka tautan, pilih **Amazon AppStream**, **Buka tautan**. Untuk mencegah kotak dialog ini ditampilkan saat berikutnya Anda melakukan langkah ini untuk terhubung ke pembuat gambar, pilih kotak centang **Remember my choice for amazonappstream links**.

   1. Jika klien WorkSpaces Aplikasi menampilkan tautan ke Perjanjian AWS Pelanggan, Ketentuan AWS Layanan, dan Pemberitahuan AWS Privasi, dan pemberitahuan pihak ketiga, tinjau informasi ini, lalu pilih **Selesai**. 

   1. Jika halaman login klien ditampilkan, bidang alamat web diisi sebelumnya dengan URL streaming. Pilih **Hubungkan**. 

   1. Jika diminta, masuk ke pembuat gambar sebagai Administrator. 

1. Setelah Anda terhubung ke pembuat gambar, jika perangkat USB Anda mengharuskan Anda menginstal driver sebelum menggunakannya, unduh dan instal driver pada pembuat gambar. Misalnya, jika Anda menggunakan mouse Connexion 3D, Anda harus mengunduh dan menginstal driver Connexion yang diperlukan pada pembuat gambar. 

1. Di desktop pembuat gambar Anda, pilih tombol **Start** Windows, dan cari Notepad. Klik kanan **Notepad**, dan pilih **Jalankan** sebagai Administrator.

1. Pilih **File**, **Buka**, dan buka file berikut:`C:\ProgramData\Amazon\Photon\DCV\usb_device_allowlist.txt`. Anda juga dapat mengizinkan seluruh kategori perangkat atau semua perangkat dari produsen tertentu dengan menggunakan ekspresi wildcard dalam `usb_device_allowlist.txt` file. 

1. Salin string filter dari komputer lokal Anda ke pembuat gambar. **String filter untuk perangkat USB tertentu adalah string yang dipisahkan koma dari bidang berikut: **Nama**, **Kelas Dasar**,, **Protokol**, **ID Vendor **SubClass**, ID** **Product**, **Support Autoshare**, dan Lewati Reset.** Untuk informasi rinci tentang string ini, lihat[Bekerja dengan String Filter Perangkat USB](USB-device-filter-strings.md).

1. Putuskan sambungan dari pembuat gambar Anda, mulai ulang, dan sambungkan kembali dengan menggunakan klien WorkSpaces Aplikasi. Untuk melakukannya, buka klien WorkSpaces Aplikasi dan tempel URL streaming yang Anda buat di langkah 7 ke bidang alamat web masuk klien, dan pilih **Connect**.

1. Pada pembuat gambar, uji perangkat USB Anda untuk mengonfirmasi bahwa itu berfungsi seperti yang diharapkan.

1. Sebelum pengguna Anda dapat menggunakan perangkat USB dalam sesi WorkSpaces Aplikasi, mereka harus terlebih dahulu berbagi perangkat dengan sesi mereka. Untuk panduan yang dapat Anda berikan kepada pengguna Anda untuk membantu mereka melakukan tugas ini, lihat[Perangkat USB](client-application-windows-how-to-share-usb-devices-user.md).

1. Jika perangkat USB bekerja dengan pembuat gambar seperti yang diharapkan, buat gambar. Untuk informasi selengkapnya, lihat [Tutorial: Membuat Gambar WorkSpaces Aplikasi Kustom dengan Menggunakan Konsol WorkSpaces Aplikasi](tutorial-image-builder.md).

1. Setelah Anda selesai membuat gambar, perbarui armada WorkSpaces Aplikasi Anda untuk menggunakan gambar baru.

# Bekerja dengan String Filter Perangkat USB
<a name="USB-device-filter-strings"></a>

Bagian ini menjelaskan string filter yang tersedia untuk perangkat USB yang memenuhi syarat untuk sesi streaming WorkSpaces Aplikasi. Ini juga memberikan panduan untuk bekerja dengan string ini. String filter berikut tersedia:
+ `Name`— Secara default, nilai untuk string filter ini adalah nama perangkat, tetapi Anda dapat menentukan nilai Anda sendiri.
+ `Base Class,SubClass,Protocol`— Kode kelas USB untuk perangkat. Untuk informasi selengkapnya, lihat [Kode Kelas yang Ditetapkan](https://www.usb.org/defined-class-codes).
+ `ID Vendor (VID)`— Pengidentifikasi unik yang ditugaskan oleh organisasi USB ke produsen perangkat USB.
+ `ID Product (PID)`— Pengidentifikasi unik yang ditetapkan oleh pabrikan ke perangkat USB. 
+ `Support Autoshare`— Memungkinkan klien WorkSpaces Aplikasi secara otomatis berbagi perangkat saat sesi streaming dimulai. Tetapkan nilai ini `1` untuk memungkinkan berbagi perangkat otomatis. Tetapkan nilai ini `0` agar tidak mengizinkan berbagi perangkat otomatis.
+ `Skip Reset`— Secara default, ketika perangkat USB dibagikan oleh WorkSpaces Aplikasi dengan sesi streaming, perangkat diatur ulang untuk memastikan bahwa itu berfungsi dengan benar. Namun, beberapa perangkat USB tidak berfungsi dengan benar selama sesi streaming jika disetel ulang. Untuk mencegah masalah ini terjadi, tetapkan nilai untuk string filter ini `1` untuk menginstruksikan klien WorkSpaces Aplikasi agar tidak mengatur ulang perangkat saat dibagikan dengan sesi streaming. Untuk memastikan bahwa perangkat disetel ulang saat dibagikan dengan sesi streaming, setel nilai ini ke`0`. Saat Anda menetapkan nilai untuk`Skip Reset`, pastikan Anda menetapkan nilai `Support Autoshare` untuk `0` atau`1`.

 String filter yang disalin dari komputer lokal khusus untuk perangkat USB. Dalam beberapa kasus, Anda mungkin ingin mengizinkan seluruh kelas perangkat alih-alih mengizinkan setiap perangkat USB yang memungkinkan. Misalnya, Anda mungkin ingin mengizinkan pengguna Anda menggunakan segala jenis tablet desain Wacom atau menggunakan perangkat penyimpanan massal USB apa pun. Dalam skenario seperti itu, Anda dapat memberikan karakter wildcard untuk bidang string filter tertentu. Jika Anda tidak mengetahui VID dan PID untuk perangkat USB Anda, Anda dapat mencari informasi ini di [database ID USB](https://www.the-sz.com/products/usbid/index.php). 

Contoh berikut menunjukkan cara mengonfigurasi string filter untuk berbagi perangkat USB selama sesi streaming:
+ Izinkan semua perangkat penyimpanan massal secara otomatis saat memulai sesi streaming — “Penyimpanan massal, 8, \$1, \$1, \$1, \$1, \$1,1,0"
+ Izinkan semua perangkat Wacom secara otomatis memulai sesi streaming - “Tablet Wacom, 3, \$1, \$1, 1386, \$1,1,0"
+ Izinkan semua perangkat yang menyediakan antarmuka audio - “Audio, 1, \$1, \$1, \$1, \$1,1,0"
+ Izinkan perangkat X, tetapi jangan mengatur ulang saat perangkat dibagikan. Jangan bagikan perangkat secara otomatis saat memulai sesi streaming — “X, Y, \$1, \$1, \$1, 1386, \$1,0,1" 