Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Siapkan streaming media langsung audio pelanggan di Amazon Connect
Di Amazon Connect, Anda dapat merekam audio pelanggan selama interaksi dengan pusat kontak dengan mengirimkan audio ke aliran video Kinesis. Bergantung pada pengaturan Anda, audio dapat ditangkap untuk seluruh interaksi—hingga interaksi dengan agen selesai—atau hanya satu arah:
+ Apa yang didengar pelanggan, termasuk apa yang dikatakan agen dan perintah sistem.
+ Apa yang dikatakan pelanggan, termasuk ketika mereka ditahan.
Streaming audio pelanggan juga menyertakan interaksi dengan bot Amazon Lex, jika Anda menggunakannya di alur Anda.
**Topics**
+ [Rencanakan streaming media langsung](plan-live-media-streams.md)
+ [Aktifkan streaming media langsung](enable-live-media-streams.md)
+ [Akses Data Kinesis Video Streams](access-media-stream-data.md)
+ [Uji streaming media langsung](use-media-streams-blocks.md)
+ [Atribut kontak untuk streaming media langsung](media-streaming-attributes.md)
# Rencanakan streaming media langsung dari Amazon Connect ke Kinesis Video Streams
**penting**
Jika Anda ingin menggunakan fitur streaming audio, Anda perlu mempertahankan aliran yang dibuat oleh Amazon Connect. Jangan menghapusnya, kecuali Anda akan berhenti menggunakan fitur streaming.
Anda dapat mengirim semua audio ke dan dari pelanggan ke Kinesis Video Streams. Streaming media memanfaatkan dukungan multi-track Kinesis Video Streams sehingga apa yang dikatakan pelanggan berada di jalur terpisah dari apa yang didengar pelanggan.
Audio yang dikirim ke Kinesis menggunakan sampling rate 8 kHz.
## Apakah Anda perlu meningkatkan kuota layanan Anda?
Saat Anda mengaktifkan streaming media di Amazon Connect, satu aliran video Kinesis digunakan per panggilan aktif. Kami membuat aliran KVS baru sesuai kebutuhan untuk menangani permintaan streaming bersamaan. Kami secara otomatis membuat stream tambahan sesuai kebutuhan untuk mengimbangi panggilan aktif, kecuali akun Anda mencapai kuota layanan [Kinesis Video](https://docs.aws.amazon.com/streams/latest/dev/service-sizes-and-limits.html) Streams.
Kontak Dukungan untuk meminta peningkatan **Jumlah Streaming**.
Untuk meminta peningkatan kuota layanan Anda, di AWS Support Center, pilih **Buat Kasus** lalu pilih Peningkatan **Kuota Layanan**.
**Tip**
Kami memastikan bahwa **PutMedia**permintaan selalu berada dalam kuota 5 TPS. Anda tidak perlu meminta kenaikan.
## Berapa lama Anda perlu menyimpan audio?
Audio pelanggan disimpan dalam Kinesis untuk waktu yang ditentukan oleh setelan retensi Anda dalam instans Amazon Connect. Untuk petunjuk pengaturan nilai ini, lihat[Aktifkan streaming media langsung di instans Amazon Connect](enable-live-media-streams.md).
## Apakah Anda perlu mengubah aliran audio?
Kami menyarankan Anda menahan diri untuk tidak memodifikasi aliran. Melakukannya dapat menyebabkan perilaku yang tidak terduga.
## Siapa yang memerlukan izin IAM untuk mengambil data?
Jika bisnis Anda menggunakan izin IAM, AWS admin Anda harus memberikan izin untuk peran IAM yang perlu mengambil data dari Kinesis Video Streams. Mereka harus memberi mereka izin akses penuh untuk Kinesis Video Streams dan. AWS Key Management Service
# Aktifkan streaming media langsung di instans Amazon Connect
Streaming media langsung (streaming audio pelanggan) tidak diaktifkan secara default. Anda dapat mengaktifkan aliran audio pelanggan dari halaman pengaturan untuk instans Anda.
**Untuk mengaktifkan streaming media langsung**
1. Buka konsol Amazon Connect di [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. Pada halaman instance, pilih alias instance. Alias instance juga merupakan **nama instans** Anda, yang muncul di URL Amazon Connect Anda. Gambar berikut menunjukkan halaman **instance pusat kontak virtual Amazon Connect**, dengan kotak di sekitar alias instance.
1. Di panel navigasi, pilih **Penyimpanan data**.
1. Di bawah **Streaming media langsung**, pilih **Edit**. Pilih **Aktifkan streaming media langsung**.
1. Masukkan awalan untuk Kinesis Video Streams yang dibuat untuk audio pelanggan Anda. Awalan ini memudahkan Anda mengidentifikasi aliran dengan data.
1. Data dienkripsi sebelum ditulis ke lapisan penyimpanan aliran Kinesis Video Streams, dan didekripsi setelah diambil dari penyimpanan. Akibatnya, data Anda selalu dienkripsi saat diam dalam layanan Kinesis Video Streams. Pilih tombol KMS yang digunakan untuk mengenkripsi data dalam Kinesis Video Streams seperti yang ditunjukkan pada gambar berikut.
![\[Bagian Enkripsi tempat Anda memilih kunci KMS.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/streaming-encryption.png)
Saat Anda memilih untuk memasukkan kunci Anda sendiri, catat batasan berikut:
1. Kunci KMS harus berada di Region yang sama dengan instance.
1. Kunci KMS harus berupa:
+ Kunci yang dikelola pelanggan
ATAU
+ Kunci AWS terkelola untuk Kinesis Video Streams (aws/kinesisvideo).
Seharusnya tidak ada kunci AWS terkelola yang dibuat secara otomatis untuk layanan lain (misalnya,aws/connect, aws/lambda, aws/kinesis).
1. Hibah yang disediakan untuk kunci oleh Amazon Connect tidak boleh dicabut. Hibah ini akan memiliki `GranteePrincipal` format:
```
arn:aws:iam::customer-account-id:role/aws-service-role/connect.amazonaws.com/AWSServiceRoleForAmazonConnect_hash_suffix
```
1. Tentukan nomor dan unit untuk **periode retensi data**.
**penting**
Jika Anda memilih **Tidak ada retensi data**, data tidak disimpan dan tersedia untuk dikonsumsi hanya selama 5 menit. Ini adalah waktu minimum default Kinesis menyimpan data.
Karena Amazon Connect menggunakan Kinesis untuk streaming, kuota [Kinesis Video Streams berlaku](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html).
1. Pilih **Simpan** di bawah **Streaming media langsung**, lalu pilih **Simpan** di bagian bawah halaman.
Setelah Anda mengaktifkan streaming media langsung, tambahkan **Mulai streaming media** dan **Hentikan blok streaming media** ke aliran Anda. Konfigurasikan blok-blok tersebut untuk menentukan audio apa yang ingin Anda tangkap. Untuk instruksi dan contoh, lihat[Contoh aliran untuk menguji streaming media langsung di Amazon Connect](use-media-streams-blocks.md).
# Kembangkan streaming media langsung di Amazon Connect
Untuk membantu Anda memulai pengembangan menggunakan streaming media langsung, Amazon Connect menyertakan repositori Kinesis Video Streams berikut yang berisi contoh dasar cara mengonsumsi data audio dari Kinesis Video Streams Anda: [https://github.com/amazon-connect/connect-kvs-consumer-demo](https://github.com/amazon-connect/connect-kvs-consumer-demo)
Demo ini dibangun di atas abstraksi tingkat tinggi yang disediakan oleh Kinesis Video Streams Parser Library untuk membaca dan `AUDIO_TO_CUSTOMER` trek `AUDIO_FROM_CUSTOMER` yang diterbitkan oleh Amazon Connect. Ini menyimpan data ini sebagai file PCM mentah. File ini dapat diubah, ditranskode, atau diputar ulang.
# Contoh aliran untuk menguji streaming media langsung di Amazon Connect
Berikut cara mengatur alur untuk menguji streaming media langsung:
1. Tambahkan blok **streaming media Mulai** pada titik di mana Anda ingin mengaktifkan streaming audio pelanggan.
1. Hubungkan cabang **Sukses** ke seluruh alur Anda.
1. Tambahkan blok **Stop media streaming** ke tempat Anda ingin menghentikan streaming.
1. Konfigurasikan kedua blok untuk menentukan apa yang ingin Anda streaming: **Dari pelanggan and/or ** **Ke pelanggan**.
![\[Blok streaming media Mulai.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/start-media-streaming.png)
Audio pelanggan ditangkap hingga blok **Stop media streaming** dipanggil, bahkan jika kontak diteruskan ke aliran lain.
Gunakan atribut kontak untuk streaming media dalam alur Anda sehingga catatan kontak menyertakan atribut. Anda kemudian dapat melihat catatan kontak untuk menentukan data streaming media yang terkait dengan kontak tertentu. Anda juga dapat meneruskan atribut ke AWS Lambda fungsi.
Alur contoh berikut menunjukkan bagaimana Anda dapat menggunakan streaming media dengan atribut untuk tujuan pengujian. Aliran ini mencakup blok **streaming media Mulai** tetapi tidak ada blok **streaming media Stop**.
![\[Aliran sampel dengan blok streaming media awal.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/media-streaming-flow.png)
**Setelah audio berhasil dialirkan ke Kinesis Video Streams, atribut kontak diisi dari blok fungsi Invoke Lambda. AWS ** Anda dapat menggunakan atribut untuk mengidentifikasi lokasi di aliran tempat audio pelanggan dimulai. Untuk petunjuk, lihat [Atribut kontak untuk streaming media langsung di Kinesis Video Streams](media-streaming-attributes.md).
# Atribut kontak untuk streaming media langsung di Kinesis Video Streams
Atribut ditampilkan saat Anda memilih **Aliran media** untuk **Jenis** di blok aliran yang mendukung atribut, seperti blok **Mulai streaming media**. Mereka termasuk yang berikut:
Arn streaming audio pelanggan
ARN dari aliran video Kinesis yang mencakup data pelanggan untuk referensi.
**JSONPath format:** \$1. MediaStreams.customer.audio.streamarn
Stempel waktu mulai audio pelanggan
Waktu di mana aliran audio pelanggan dimulai.
**JSONPath format:** \$1. MediaStreams.Customer.Audio. StartTimestamp
Stempel waktu berhenti audio pelanggan
Waktu di mana aliran audio pelanggan berhenti.
**JSONPath format:** \$1. MediaStreams.Customer.Audio. StopTimestamp
Nomor fragmen mulai audio pelanggan
Nomor yang mengidentifikasi fragmen Kinesis Video Streams di mana streaming audio pelanggan dimulai.
**JSONPath format:** \$1. MediaStreams.Customer.Audio. StartFragmentNumber
Untuk informasi selengkapnya tentang fragmen Amazon Kinesis Video Streams[,](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_reader_Fragment.html) lihat Fragmen *di Panduan Pengembang Amazon Kinesis Video Streams*.