Pemesanan Peserta Kustom - Amazon IVS
Cara Kerja Pemesanan KustomMembuat Token dengan Atribut PemesananContoh Kasus PenggunaanKompatibilitas Ke Belakang

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

Pemesanan Peserta Kustom

Pemesanan peserta khusus memungkinkan Anda untuk mengontrol posisi peserta di tata letak kisi dan PiP berdasarkan nilai atribut khusus dalam token peserta, termasuk posisi peserta unggulan dan pemilihan peserta di jendela PiP. Ini memberikan penentuan posisi peserta deterministik dan memungkinkan tata letak berbasis peran.

Cara Kerja Pemesanan Kustom

Bila participantOrderAttribute ditentukan dalam konfigurasi tata letak Anda, peserta diurutkan sesuai dengan aturan berikut:

  • Peserta dengan atribut pemesanan yang ditentukan dalam token mereka diposisikan terlebih dahulu, diurutkan secara numerik berdasarkan nilai atribut mereka.

  • Peserta tanpa atribut pemesanan kembali ke pemesanan waktu kedatangan dan diposisikan setelah peserta yang dipesan.

  • Ketika beberapa peserta memiliki nilai urutan yang identik, mereka diurutkan berdasarkan waktu kedatangan mereka ke panggung.

  • Urutan menggunakan pengurutan numerik (bukan leksikografik), jadi “10" muncul setelah “9" (bukan setelah “1").

  • Nilai negatif didukung. Mereka diposisikan sebelum nilai-nilai positif.

  • Nilai non-numerik (misalnya, “abc”, “1.5") diperlakukan sebagai tidak valid, dan peserta tersebut kembali ke pemesanan waktu kedatangan.

Penting: Pemesanan peserta (baik berdasarkan waktu kedatangan atau kebiasaan) berlaku setelah komposisi dimulai. Urutan peserta yang benar tidak dijamin untuk peserta yang bergabung dengan panggung sebelum komposisi dimulai.

Membuat Token dengan Atribut Pemesanan

Untuk menggunakan pemesanan peserta khusus, sertakan atribut pemesanan dalam token peserta Anda saat membuatnya:

aws ivs-realtime create-participant-token --stage-arn "arn:aws:ivs:us-east-1:123456789012:stage/u9OiE29bT7Xp" --attributes order=1

aws ivs-realtime create-participant-token --stage-arn "arn:aws:ivs:us-east-1:123456789012:stage/u9OiE29bT7Xp" --attributes order=2

aws ivs-realtime create-participant-token --stage-arn "arn:aws:ivs:us-east-1:123456789012:stage/u9OiE29bT7Xp" --attributes order=3

Anda dapat menggabungkan custom-participant-order atribut dengan atribut untuk memilih peserta untuk slot unggulan dan jendela PiP:

aws ivs-realtime create-participant-token --stage-arn "arn:aws:ivs:us-east-1:123456789012:stage/u9OiE29bT7Xp" --attributes order=2,isFeatured=true

aws ivs-realtime create-participant-token --stage-arn "arn:aws:ivs:us-east-1:123456789012:stage/u9OiE29bT7Xp" --attributes order=3,isFeatured=true

aws ivs-realtime create-participant-token --stage-arn "arn:aws:ivs:us-east-1:123456789012:stage/u9OiE29bT7Xp" --attributes order=4,isPip=true

Contoh Kasus Penggunaan

Contoh kasus penggunaan meliputi:

  • Pemosisian yang konsisten — Peserta mempertahankan posisi mereka saat menyambung kembali dengan token yang sama.

  • Posisi berbasis peran — Misalnya, Anda dapat menentukan guru dengan order=1 dan siswa dengan order=2.

  • Tata letak berbasis prioritas - Peserta VIP dengan nilai urutan lebih rendah akan muncul terlebih dahulu.

  • Tata letak dinamis - Anda dapat menggabungkan pemesanan kustom dengan featuredParticipantAttribute dan pipParticipantAttribute untuk skenario yang kompleks.

  • Interaksi lintas tahap — Saat menggunakan replikasi peserta untuk skenario seperti kompetisi Mode VS di mana streamer dari berbagai tahap berinteraksi, Anda dapat mengganti atribut pengurutan untuk mengontrol pemosisian dalam komposisi tahap tujuan.

Catatan: Untuk kasus penggunaan replikasi peserta, Anda dapat mengganti atribut peserta (termasuk atribut urutan) sesuai kebutuhan saat memulai replikasi untuk mencapai tata letak yang diinginkan di tahap tujuan.

Kompatibilitas Ke Belakang

Pemesanan peserta khusus adalah fitur opsional dan sepenuhnya kompatibel ke belakang. Komposisi yang ada tanpa participantOrderAttribute terus bekerja tidak berubah, menggunakan pemesanan waktu kedatangan. Ketika participantOrderAttribute disetel ke string kosong, sistem mengabaikan pemesanan kustom sepenuhnya dan kembali ke perilaku default.