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 menggunakan notifikasi ( Amazon Simple Notification Service Amazon SNS).

Topik berikut menjelaskan cara memulai notifikasi.

Kelola konfigurasi notifikasi

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

UpdateNotificationConfiguration

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

DescribeNotificationConfiguration

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

Tentang tag MKV produser

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

Setiap metadata fragmen yang disediakan bersama dengan tag Notification MKV akan dipublikasikan sebagai bagian dari payload topik Amazon SNS.

Sintaks untuk tag MKV produser

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

Batas tag MKV

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

Pesan Amazon SNS

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

Payload topik Amazon SNS

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

{
"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 pesan Amazon SNS Anda

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