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

Mengatur notifikasi di Kinesis Video Streams

Saat fragmen media tersedia untuk dikonsumsi, Kinesis Video Streams akan memberi tahu pelanggan yang Amazon Simple Notification Service menggunakan notifikasi (Amazon). SNS

Topik berikut menjelaskan cara memulai dengan notifikasi.

Kelola konfigurasi notifikasi

Untuk mengelola konfigurasi notifikasi, gunakan UpdateNotificationConfiguration danDescribeNotificationConfiguration. Lihat di bawah untuk informasi lebih lanjut.

UpdateNotificationConfiguration

Gunakan API operasi ini untuk memperbarui informasi pemberitahuan untuk aliran. Untuk informasi selengkapnya tentang UpdateNotificationConfiguration fitur ini, lihat UpdateNotificationConfiguration di Panduan Pengembang Amazon Kinesis Video Streams.

DescribeNotificationConfiguration

Gunakan ini API untuk menjelaskan konfigurasi notifikasi yang dilampirkan ke aliran. Untuk informasi selengkapnya tentang DescribeNotificationConfiguration fitur ini, lihat DescribeNotificationConfigurationdi Panduan Pengembang Amazon Kinesis Video Streams.

Tentang MKV tag produser

Anda dapat menggunakan produser Kinesis Video SDK Streams untuk menandai fragmen tertentu yang menarik dengan API mengekspos operasi di file. SDK Lihat contoh cara kerjanya di bagian kode ini. Setelah memanggil iniAPI, SDK akan menambahkan satu set MKV tag yang telah ditentukan bersama dengan data fragmen. Kinesis Video Streams akan mengenali tag khusus MKV ini dan memulai pemberitahuan untuk fragmen yang ditandai.

Setiap metadata fragmen yang disediakan bersama dengan MKV tag Pemberitahuan akan dipublikasikan sebagai bagian dari payload topik AmazonSNS.

Sintaks untuk tag produser MKV

|+ Tags
| + Tag
|  // MANDATORY: Predefined MKV tag to trigger the notification for the fragment
|  + Simple
|   + Name: AWS_KINESISVIDEO_NOTIFICATION
|   + String
| // OPTIONAL: Key value pairs that will be sent as part of the Notification payload
|  + Simple
|   + Name: CUSTOM_KEY_1 // Max 128 bytes
|   + String:CUSTOM_VALUE_1 // Max 256 bytes
|  + Simple
|   + Name: CUSTOM_KEY_2 // Max 128 bytes
|   + String: CUSTOM_VALUE_2 // Max 256 bytes
           

MKVbatas tag

Tabel berikut mencantumkan batasan yang terkait dengan tag metadata. Jika batas tag metadata dapat disesuaikan, Anda dapat meminta peningkatan melalui manajer akun Anda.

SNSPesan Amazon

Topik ini berisi informasi lebih lanjut tentang SNS pesan Amazon dan muatan topik.

SNSPayload topik Amazon

Setiap pemberitahuan yang dimulai melalui alur kerja sebelumnya akan mengirimkan payload SNS topik Amazon, seperti yang ditunjukkan pada contoh berikut. Contoh ini adalah SNS pesan Amazon yang terjadi setelah mengkonsumsi data notifikasi dari antrian Amazon Simple Queue Service (AmazonSQS).

{
"Type" : "Notification",
"MessageId" : Message ID,
"TopicArn" : SNS ARN,
"Subject" : "Kinesis Video Streams Notification",
"Message" : "{\"StreamArn\":\Stream Arn,\"FragmentNumber\":\Fragment Number,\"FragmentStartProducerTimestamp\":FragmentStartProducerTimestamp,
                \"FragmentStartServerTimestamp\":FragmentStartServerTimestamp,\"NotificationType\":\"PERSISTED\",\"NotificationPayload\":{\ CUSTOM_KEY_1:\CUSTOM_VALUE_1,
                \CUSTOM_KEY_2:\CUSTOM_VALUE_2}}",
"Timestamp" : "2022-04-25T18:36:29.194Z",
"SignatureVersion" : Signature Version,
"Signature" : Signature,
"SigningCertURL" : Signing Cert URL,
"UnsubscribeURL" : Unsubscribe URL
}            

Subject: "Kinesis Video Streams Notification"
Message: 
{
    "StreamArn":Stream Arn,
    "FragmentNumber":Fragment Number,
    "FragmentStartProducerTimestamp":Fragment Start Producer Timestamp,
    "FragmentStartServerTimestamp":Fragment Start Server Timestamp,
    "NotificationType":"PERSISTED",
    "NotificationPayload":{
        CUSTOM_KEY_1:CUSTOM_VALUE_1,
        CUSTOM_KEY_2:CUSTOM_VALUE_2
    }
}

Lihat SNS pesan Amazon Anda

Anda tidak dapat membaca pesan langsung dari SNS topik Amazon karena tidak ada API gunanya melakukannya. Untuk melihat pesan, berlangganan SQS antrian ke SNS topik, atau pilih tujuan lain yang SNS didukung Amazon. Namun, opsi paling efisien untuk melihat pesan adalah menggunakan AmazonSQS.