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

Menyematkan Metadata dalam Stream Video

Metadata waktu Amazon Interactive Video Service (IVS) menyediakan cara untuk menyematkan metadata dalam aliran Amazon IVS. Ini memastikan bahwa semua pemirsa Anda menerima metadata pada saat yang sama dalam aliran video, terlepas dari latensi streaming atau lokasi geografis.

Apa itu Metadata Waktu?

Metadata berwaktu adalah metadata dengan stempel waktu. Ini dapat dimasukkan ke dalam aliran terprogram, menggunakan IVS API atau IVS broadcast SDK. Saat Amazon IVS memproses streaming, metadata waktunya disinkronkan dengan bingkai audio dan video. Selama pemutaran, semua pemirsa aliran mendapatkan metadata pada saat yang sama relatif terhadap aliran. Kode waktu berfungsi sebagai titik isyarat, yang dapat digunakan untuk memicu tindakan berdasarkan data, seperti berikut ini:

Metadata waktu Amazon IVS menggunakan tag ID3 yang disematkan di segmen video. Akibatnya, mereka tersedia dalam video yang direkam.

Menyiapkan Izin IAM

Prasyarat: Sebelum melanjutkan, Anda harus melangkah melalui Memulai Streaming Latensi Rendah IVS (termasuk membuat pengguna IAM dan menyiapkan izin).

Selanjutnya, Anda harus memberikan izin kepada pengguna IAM Anda untuk menggunakan metadata berjangka waktu. Ikuti langkah-langkah ini:

Memasukkan Metadata Berjangka Waktu

Anda dapat menyisipkan metadata berwaktu hanya ke aliran aktif pada saluran tertentu.

Menggunakan AWS CLI

Untuk pengujian, cara termudah untuk menambahkan metadata berjangka waktu adalah dengan AWS CLI. Menggunakan AWS CLI mengharuskan Anda mengunduh dan mengonfigurasi CLI terlebih dahulu di mesin Anda. Anda mungkin sudah melakukannya ketika Anda melangkahMemulai Streaming Latensi Rendah IVS; jika tidak, lakukan sekarang. Untuk detailnya, lihat Panduan Pengguna Antarmuka Baris Perintah AWS.

Setelah Anda memiliki CLI:

Menggunakan Amazon IVS API

Untuk menyisipkan metadata berjangka waktu secara terprogram, gunakan titik akhir API. PutMetadata

Berikut adalah contoh permintaan HTTP:

POST /PutMetadata HTTP/1.1
{
    "channelArn": "my_channel",
    "metadata": "{\"question\": \"What does IVS stand for?\", \"correctIndex\": 0, \"answers\": [\"interactive video service\", \"interesting video service\", \"ingenious video service\"]}"
}

Menggunakan IVS Broadcast SDK

Anda dapat menyisipkan inband metadata berjangka waktu menggunakan SDK siaran IVS. Ini mungkin berguna untuk menyinkronkan metadata dengan konten audio dan video.

Mengkonsumsi Metadata Berjangka Waktu

Gunakan Amazon IVS Player untuk menggunakan metadata berjangka waktu yang disematkan dalam aliran video. Lihat SDK Pemutar Amazon IVS dan dokumentasi Pemain lainnya.

Di bawah ini adalah contoh cuplikan yang mencetak metadata apa pun yang diterima ke konsol menggunakan Amazon IVS Player SDK. Peristiwa dipicu setiap kali pemutaran mencapai segmen dengan metadata tertanam. (Acara ini TEXT_METADATA_CUE untuk Web, onCue() untuk Android, dan player(_:didOutputCue:) untuk iOS.) Anda dapat menggunakan acara ini untuk memulai fungsionalitas dalam aplikasi klien Anda, seperti memperbarui widget interaktif. Acara ini dipicu untuk konten langsung dan rekaman.

Amazon IVS Player SDK untuk Web:

const player = IVSPlayer.create();
player.addEventListener(IVSPlayer.PlayerEventType.TEXT_METADATA_CUE,
    function (cue) {
  console.log('Timed metadata: ', cue.text);
});

Amazon IVS Player SDK for Android:

@Override
public void onCue(@NonNull Cue cue) {
  if(cue instanceof TextMetadataCue) {
    Log.i("Timed Metadata: ", ((TextMetadataCue)cue).text);
  }
}

Amazon IVS Player SDK for iOS:

func player(_ player: IVSPlayer, didOutputCue cue: IVSCue) {
  if let textMetadataCue = cue as? IVSTextMetadataCue {
    print("Timed Metadata: \(textMetadataCue.text)")
  }
}

Catatan: Metadata berjangka waktu didukung untuk iOS Safari dan iOS Chrome di Player 1.3.0 dan versi lebih baru.

Contoh Demo: Aplikasi Kuis

Contoh kode aplikasi kuis interaktif tersedia di GitHub. Kami menggunakan JSON melalui metadata berjangka waktu untuk mengisi UI kuis untuk menampilkan pertanyaan dan jawaban. Jawabannya dapat dipilih dan mengungkapkan apakah pemilihannya benar.

Melihat Metadata Berjangka Waktu

Jika diinginkan, Anda dapat melihat metadata berjangka waktu yang disematkan di streaming langsung Anda, di konsol:

Untuk Informasi Selengkapnya

Lihat Menggunakan Metadata Waktu Layanan Video Interaktif Amazon, yang pertama dari seri blog dua bagian tentang penggunaan metadata waktu Amazon IVS.