Memahami alur kerja untuk merekam panggilan untuk Amazon Chime SDK

Gunakan alur kerja ini saat:

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

Untuk informasi selengkapnya, lihat Mengonfigurasi Konektor Suara untuk menggunakan analisis 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.

Dalam diagram:

Anda juga dapat menyimpan data panggilan yang dibuat Konektor Suara di Kinesis Video Streams untuk durasi yang bervariasi, mulai dari jam hingga hari atau bahkan tahun. Memilih tidak ada retensi data membatasi kegunaan data panggilan untuk konsumsi langsung. Biaya Kinesis Video Streams ditentukan berdasarkan bandwidth dan total penyimpanan yang digunakan. Anda dapat menyesuaikan periode retensi data kapan saja dalam konfigurasi streaming Konektor Suara. Untuk mengaktifkan perekaman analisis panggilan, Anda harus memastikan bahwa Stream Video Kinesis 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 untuk memang CreateMediaInsightsPipeline gil API atas nama Anda sekali 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 Amazon Chime SDK.

Anda merekam streaming Video Amazon Kinesis saat:

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

Saat memanggil CreateMediaInsightsPipeline API, 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 pada fragmen itu. Jika Anda tidak menentukan ID fragmen, analisis panggilan 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.

Dalam diagram:

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

Contoh-contoh di bagian ini menjelaskan cara melakukan hal berikut:

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
    }
}

Ini MediaInsightsPipelineConfigurationArn adalah konfigurasi ARN yang Anda terima setelah Anda membuat konfigurasi analisis panggilan.

Mengatur 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 digunakan 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