View a markdown version of this page

Memulai dengan Komposisi IVS Server-Side - Amazon IVS
PrasyaratInstruksi APIInstruksi CLI

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

Memulai dengan Komposisi IVS Server-Side

Dokumen ini membawa Anda melalui langkah-langkah yang terlibat dalam memulai komposisi sisi server IVS.

Prasyarat

Untuk menggunakan komposisi sisi server, Anda harus memiliki stage dengan penerbit aktif dan menggunakan saluran IVS bucket S3 and/or sebagai tujuan komposisi.

Untuk membuat bucket S3, lihat dokumentasi S3 tentang cara membuat bucket. Bucket S3 harus dibuat di wilayah AWS yang sama dengan tahap IVS.

Penting: Jika Anda menggunakan bucket S3 yang ada:

  • Setelan Kepemilikan Objek harus diberlakukan pemilik Buc ket atau lebih disukai pemilik Bucket.

  • Set elan Enkripsi Default harus berupa Server-side enkripsi dengan kunci terkelola Amazon S3 (SSE-S3).

Untuk detailnya, lihat dokumentasi S3 tentang mengendalikan kepemilikan objek dan melindungi data dengan enkripsi.

Instruksi API

Di bawah ini, kami menjelaskan satu alur kerja yang mungkin menggunakan EventBridge acara untuk memulai komposisi yang menyiarkan panggung ke saluran IVS ketika peserta menerbitkan. Atau, Anda dapat memulai dan menghentikan komposisi berdasarkan logika aplikasi Anda sendiri. Lihat Perekaman Komposit untuk contoh lain yang menampilkan penggunaan komposisi sisi server untuk merekam panggung langsung ke bucket S3.

  1. Buat saluran IVS. Lihat Memulai dengan Amazon IVS Low-Latency Streaming.

  2. Buat panggung IVS dan token peserta untuk setiap penerbit.

  3. Buat EncoderConfiguration.

  4. Bergabunglah dengan panggung dan terbitkan ke sana. (Lihat bagian “Penerbitan dan Berlangganan” dari panduan SDK siaran streaming real-time: Web, Android, dan iOS.)

  5. Saat Anda menerima EventBridge acara yang Dipublikasikan Peserta, hubungi StartComposition dengan konfigurasi tata letak yang Anda inginkan.

  6. Tunggu beberapa detik dan lihat tampilan komposit dalam pemutaran saluran.

Server-side alur kerja komposisi yang menggunakan EventBridge peristiwa untuk memulai komposisi ketika peserta menerbitkan.

Catatan: Komposisi melakukan shutdown otomatis setelah 60 detik tidak aktif dari peserta penerbit di atas panggung. Pada titik itu, Komposisi dihentikan dan transisi ke suatu STOPPED keadaan. Komposisi secara otomatis dihapus setelah beberapa menit di STOPPED negara bagian.

Instruksi CLI

Menggunakan AWS CLI adalah opsi lanjutan dan mengharuskan Anda mengunduh dan mengonfigurasi CLI terlebih dahulu di mesin Anda. Untuk detail, lihat Panduan Pengguna AWS Command Line Interface.

Sekarang Anda dapat menggunakan CLI untuk membuat dan mengelola sumber daya. Operasi Komposisi berada di bawah ivs-realtime namespace.

Buat Sumber EncoderConfiguration Daya

An EncoderConfiguration adalah objek yang memungkinkan Anda untuk menyesuaikan format video yang dihasilkan (tinggi, lebar, bitrate, dan parameter streaming lainnya). Anda dapat menggunakan kembali EncoderConfiguration setiap kali Anda memanggil operasi Komposisi, seperti yang dijelaskan pada langkah berikutnya.

Perintah di bawah ini membuat EncoderConfiguration sumber daya yang mengonfigurasi parameter komposisi video sisi server seperti bitrate video, kecepatan bingkai, dan resolusi:

aws ivs-realtime create-encoder-configuration --name "MyEncoderConfig" --video "bitrate=2500000,height=720,width=1280,framerate=30"

Tanggapannya adalah:

{
"encoderConfiguration": {
  "arn": "arn:aws:ivs:us-east-1:927810967299:encoder-configuration/9W59OBY2M8s4",
  "name": "MyEncoderConfig",
  "tags": {},
  "video": {
	 "bitrate": 2500000,
	 "framerate": 30,
	 "height": 720,
	 "width": 1280
    }
  }
}

Memulai Komposisi

Menggunakan EncoderConfiguration ARN yang disediakan dalam tanggapan di atas, buat sumber daya Komposisi Anda:

Contoh Tata Letak Grid 

aws ivs-realtime start-composition --stage-arn "arn:aws:ivs:us-east-1:927810967299:stage/8faHz1SQp0ik" --destinations '[{"channel": {"channelArn": "arn:aws:ivs:us-east-1:927810967299:channel/DOlMW4dfMR8r", "encoderConfigurationArn": "arn:aws:ivs:us-east-1:927810967299:encoder-configuration/9W59OBY2M8s4"}}]' --layout '{"grid":{"participantOrderAttribute":"order","featuredParticipantAttribute":"isFeatured","videoFillMode":"COVER","gridGap":0}}'

Contoh Tata Letak PiP 

aws ivs-realtime start-composition --stage-arn "arn:aws:ivs:us-east-1:927810967299:stage/8faHz1SQp0ik" --destinations '[{"channel": {"channelArn": "arn:aws:ivs:us-east-1:927810967299:channel/DOlMW4dfMR8r", "encoderConfigurationArn": "arn:aws:ivs:us-east-1:927810967299:encoder-configuration/DEkQHWPVaOwO"}}]' --layout '{"pip":{"participantOrderAttribute":"priority","pipParticipantAttribute":"isPip","pipOffset":10,"pipPosition":"TOP_RIGHT"}}'

Catatan: Anda dapat menggunakan alat ini untuk lebih mudah menghasilkan --layout konfigurasi berdasarkan pilihan tata letak Anda.

Respons akan menunjukkan bahwa Komposisi dibuat dengan STARTING status. Setelah Komposisi mulai menerbitkan komposisi, status beralih keACTIVE. (Anda dapat melihat status dengan memanggil GetComposition operasi ListCompositions atau.)

Setelah KomposisiACTIVE, tampilan komposit tahap IVS terlihat pada saluran IVS, menggunakan: ListCompositions

aws ivs-realtime list-compositions

Tanggapannya adalah:

{
"compositions": [
  {
	 "arn": "arn:aws:ivs:us-east-1:927810967299:composition/YVoaXkKdEdRP",
	 "destinations": [
		{
		   "id": "bD9rRoN91fHU",
		   "startTime": "2023-09-21T15:38:39+00:00",
		   "state": "ACTIVE"
		}
	 ],
	 "stageArn": "arn:aws:ivs:us-east-1:927810967299:stage/8faHz1SQp0ik",
	 "startTime": "2023-09-21T15:38:37+00:00",
	 "state": "ACTIVE",
	 "tags": {}
    }
  ]
}

Catatan: Anda harus memiliki peserta penerbit yang aktif menerbitkan ke panggung agar komposisi tetap hidup. Untuk informasi selengkapnya, lihat bagian “Penerbitan dan Berlangganan” dari panduan SDK siaran streaming real-time: Web, Android, dan iOS. Anda harus membuat token panggung yang berbeda untuk setiap peserta.