Alur kerja untuk merekam panggilan - Amazon Chime SDK

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

Alur kerja untuk merekam panggilan

Topik di bagian ini mencantumkan dan menjelaskan alur kerja untuk merekam panggilan dan Kinesis Video Streams.

Gunakan alur kerja ini saat:

  • Anda sudah menggunakan, atau berencana untuk menggunakan, Konektor Suara untuk membawa media SIP ke dalam analitik panggilan.

    catatan

    Konektor Suara mendukung SIP dan SIPREC. Untuk informasi selengkapnya, lihat Mengelola Konektor Suara Amazon Chime SDK, di Panduan Administrator Amazon Chime SDK.

  • Anda ingin merekam panggilan SIP atau SIPREC secara otomatis dengan latensi rendah ke tujuan Amazon Simple Storage Service pilihan Anda.

  • Anda ingin menggunakan konsol Amazon Chime SDK untuk membuat konfigurasi dan mengaitkannya dengan Konektor Suara.

  • Anda ingin menerapkan konfigurasi perekaman yang sama ke setiap panggilan Konektor Suara. Jika Anda ingin menerapkan beberapa konfigurasi ke satu atau beberapa Konektor Suara, lihat bagian berikutnya.

Untuk mengaktifkan pemanggilan secara terprogram, gunakan Amazon Chime SDK API berikut.

Untuk informasi selengkapnya, lihat Mengonfigurasi Konektor Suara untuk menggunakan analitik panggilan di Panduan Administrator Amazon Chime SDK.

Diagram berikut menunjukkan aliran data saat Konektor Suara memulai sesi perekaman panggilan. Angka dalam diagram sesuai dengan teks bernomor di bawah ini.

Gambar yang menunjukkan aliran data saat Konektor Suara mulai merekam panggilan.

Dalam diagram:

  1. Gunakan konsol Amazon Chime SDK atau CreateMediaInsightsPipelineConfigurationAPI untuk membuat konfigurasi analitik panggilan. Selama proses pembuatan konfigurasi, Anda cukup mengaktifkan perekaman panggilan, memilih format file perekaman yang diinginkan, dan menentukan tujuan Amazon S3 untuk menyimpan file rekaman. Untuk informasi selengkapnya, lihat Membuat konfigurasi analitik panggilan, di Panduan Administrator Amazon Chime SDK.

  2. Anda menggunakan konsol Amazon Chime SDK atau PutVoiceConnectorStreamingConfigurationAPI untuk mengaitkan konfigurasi dengan Konektor Suara. Untuk menggunakan konsol, lihat Mengonfigurasi Konektor Suara untuk menggunakan analitik panggilan.

  3. Selama panggilan keluar, Konektor Suara menerima audio setiap peserta panggilan.

  4. Jika konfigurasi perekaman analitik panggilan dilampirkan ke Konektor Suara, layanan Konektor Suara menggunakan layanan saluran media untuk memulai sesi perekaman analitik panggilan.

  5. Layanan pipa media memulai prosesor perekaman panggilan yang memantau panggilan yang sedang berlangsung.

  6. Saat panggilan berakhir, layanan saluran media mengirimkan file perekaman panggilan ke bucket Amazon S3 yang ditunjuk dan menyediakan metadata perekaman melalui Amazon Kinesis Data Stream. Jika gudang data diaktifkan, metadata panggilan juga masuk ke gudang data Amazon Simple Storage Service. Dalam kasus di mana SIPREC digunakan untuk memasukkan audio SIP ke dalam analitik panggilan, metadata panggilan menyertakan metadata SIPREC dalam format tabel. Untuk informasi lebih lanjut tentang tabel rekaman, lihatGlue tabel katalog data, nanti di bagian ini.

  7. Layanan pipa media mengirimkan peristiwa status pipeline ke Amazon default EventBridge. Untuk informasi selengkapnya lihat, Menggunakan EventBridge notifikasi dalam panduan ini.

catatan

Harap dicatat, Anda harus mengaktifkan streaming Konektor Suara untuk mengaktifkan perekaman dengan Konektor Suara. Fitur ini memungkinkan streaming data panggilan ke Kinesis Video Streams yang dikelola Konektor Suara di akun Anda. Untuk informasi selengkapnya, lihat Streaming media Konektor Suara Amazon Chime SDK ke Kinesis Video Streams di Panduan Administrator Amazon Chime SDK.

Anda juga dapat menyimpan data panggilan yang dibuat Konektor Suara di Kinesis Video Streams untuk berbagai durasi, mulai dari jam hingga hari atau bahkan bertahun-tahun. Memilih untuk tidak ada retensi data membatasi kegunaan data panggilan untuk konsumsi segera. Biaya Kinesis Video Streams ditentukan berdasarkan bandwidth dan total penyimpanan yang digunakan. Anda dapat menyesuaikan periode penyimpanan data kapan saja dalam konfigurasi streaming Konektor Suara. Untuk mengaktifkan perekaman analitik panggilan, Anda harus memastikan bahwa Kinesis Video Stream menyimpan data cukup lama untuk melakukan analisis panggilan. Anda melakukannya dengan menentukan periode retensi data yang sesuai.

Anda dapat mengaitkan konfigurasi pipeline wawasan panggilan dengan Konektor Suara sebanyak yang Anda inginkan. Anda juga dapat membuat konfigurasi yang berbeda untuk setiap Konektor Suara. Konektor Suara menggunakan AWSServiceRoleForAmazonChimeVoiceConnector file untuk memanggil CreateMediaInsightsPipelineAPI atas nama Anda satu kali per ID transaksi. Untuk informasi tentang peran tersebut, lihat Menggunakan peran terkait layanan Amazon Chime SDK untuk Konektor Suara Amazon Chime SDK di Panduan Administrator SDK Amazon Chime.

Anda merekam streaming Video Amazon Kinesis saat:

  • Anda perlu menerapkan konfigurasi yang berbeda ke panggilan alih-alih menggunakan konfigurasi yang sama untuk setiap panggilan Konektor Suara.

  • Anda ingin merekam audio SIP atau non-SIP yang tidak diproses oleh Konektor Suara.

Untuk menggunakan opsi perekaman panggilan ini, Anda perlu mempublikasikan audio ke Kinesis Video Streams (KVS) dan kemudian CreateMediaInsightsPipelinememanggil API dengan informasi saluran aliran KVS dan ARN konfigurasi analitik panggilan.

catatan

API analitik panggilan mendukung maksimal dua saluran audio. Anda juga dapat mengaktifkan streaming Konektor Suara, lalu menggunakan informasi KVS yang dipublikasikan di EventBridge notifikasi Konektor Suara untuk memulai perekaman panggilan.

Saat memanggil CreateMediaInsightsPipelineAPI, Anda dapat memilih apakah akan menentukan nomor fragmen untuk setiap definisi saluran aliran KVS atau tidak. Jika Anda memberikan nomor fragmen, analitik panggilan akan mulai memproses aliran di fragmen tersebut. Jika Anda tidak menentukan ID fragmen, analitik panggilan akan mulai memproses aliran dari fragmen terbaru yang tersedia.

Diagram berikut menunjukkan aliran data saat Konektor Suara memulai sesi perekaman panggilan. Angka dalam diagram sesuai dengan teks bernomor di bawah ini.

Gambar yang menunjukkan aliran data saat Konektor Suara mulai merekam panggilan.

Dalam diagram:

  1. Anda dapat menggunakan konsol Amazon Chime SDK atau CreateMediaInsightsPipelineConfigurationAPI untuk membuat konfigurasi perekaman panggilan.

  2. Gunakan AWS SDK untuk membuat aplikasi yang mendorong audio eksternal ke KVS, atau aktifkan streaming Konektor Suara untuk mempublikasikan audio panggilan secara otomatis ke KVS. Untuk informasi selengkapnya, lihat Streaming media Konektor Suara Amazon Chime SDK ke Kinesis Video Streams di Panduan Administrator SDK Amazon Chime.

  3. Jika streaming Konektor Suara diaktifkan, layanan Konektor Suara akan mengirimkan notifikasi ke default EventBridge.

  4. Dalam kasus streaming Konektor Suara, aplikasi Anda dapat menggunakan STARTED acara streaming Amazon Chime Voice Connector dari EventBridge untuk mengumpulkan informasi aliran KVS tentang kaki panggilan.

  5. Setelah aplikasi Anda memiliki informasi audio dari peristiwa streaming Konektor Suara atau sumber eksternal, aplikasi Anda akan memanggil Amazon Chime CreateMediaInsightsPipelineSDK API.

  6. Layanan pipa media memulai prosesor perekaman panggilan yang memantau panggilan yang sedang berlangsung.

  7. Layanan pipa media mengirimkan peristiwa status pipeline ke Amazon default EventBridge. Untuk informasi selengkapnya, lihat Menggunakan EventBridge notifikasi.

  8. Setelah panggilan selesai, layanan pipa media akan mengirimkan file rekaman panggilan ke bucket Amazon S3 yang ditunjuk dan menyediakan metadata perekaman melalui Amazon Kinesis Data Stream. Jika gudang data diaktifkan, metadata panggilan juga akan dikirim ke gudang data Amazon S3. Dalam kasus di mana SIPREC digunakan untuk memasukkan audio SIP ke dalam analitik panggilan, metadata panggilan akan menyertakan metadata SIPREC dalam format tabel yang nyaman. Untuk informasi lebih lanjut tentang tabel rekaman, lihatGlue tabel katalog data, nanti di bagian ini.

  9. Aplikasi Anda dapat memantau pipeline, dan dalam kasus Konektor Suara, status panggilan menggunakan peristiwa yang dipublikasikan ke Amazon EventBridge. Untuk informasi selengkapnya lihat, Menggunakan EventBridge notifikasi dalam panduan ini.

  10. Untuk menghentikan perekaman, panggil DeleteMediaPipelineAPI untuk menghentikan perekaman panggilan.

Untuk perekaman dan contoh berbasis API lihat, perekaman Amazon S3 tenggelam dalam panduan ini.

Contoh di bagian ini menjelaskan cara melakukan hal berikut:

  • Gunakan CLI untuk menjalankan konfigurasi analitik panggilan dan memanggil. CreateMediaInsightsPipeline

  • Gunakan CLI untuk menentukan tujuan perekaman format file audio, dan nama file audio.

Menjalankan konfigurasi dan memulai pipeline

Gunakan perintah berikut untuk menjalankan konfigurasi dan memulai pipeline wawasan media. File pipeline.json berisi pengaturan konfigurasi.

aws chime-sdk-media-pipeline create-media-insights-pipeline --cli-input-json file://pipeline.json

Contoh berikut menunjukkan pipeline.json file tipikal.

{ "MediaInsightsPipelineConfigurationArn": arn:aws:chime:region;account_id:media-insights-pipeline-configuration/MyConfiguration, "KinesisVideoStreamRecordingSourceRuntimeConfiguration": { "Streams": [ { "StreamArn": kinesis_video_stream_arn_1 }, { "StreamArn": kinesis_video_stream_arn_2 } ], "FragmentSelector": { "FragmentSelectorType": "selector_type", // Specify "server_timestamp" or "producer_timestamp" as the fragment selector type "TimestampRange": { "StartTimestamp": epoch_time_seconds, "EndTimestamp": epoch_time_seconds } } }, "S3RecordingSinkRuntimeConfiguration": { "Destination": arn:aws:s3:::bucket_name/prefix/optional_file_name, "RecordingFileFormat": file_format // Specify "Opus" or "WAV" as the recording file format, if you want to override the configuration } }

MediaInsightsPipelineConfigurationArnIni adalah ARN konfigurasi yang Anda terima setelah Anda membuat konfigurasi analitik panggilan.

Menetapkan tujuan, nama, dan format

Contoh berikut menggunakan folder bernama MyRecordingBucket sebagai S3SinkConfiguration.Destination nilai, dan Opus sebagai RecordingFileFormat nilai.

arn:aws:s3:::MyRecordingBucket/voice-connector-id/transaction-id_year-month-date-hour-minute-second-millisecond.ogg

Contoh berikut menggunakan MyRecordingBucket sebagai S3SinkConfiguration.Destination nilai, dan Wav sebagai RecordingFileFormat nilai.

arn:aws:s3:::MyRecordingBucket/voice-connector-id/transaction-id_year-month-date-hour-minute-second-millisecond.wav