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

Bagikan sesi streaming dengan URL streaming

Streaming URL memungkinkan Anda berbagi sesi streaming dengan cepat dengan siapa pun. Penerima mengakses sesi streaming Anda di browser web yang didukung, tanpa perlu integrasi klien Akun AWS atau klien, dan Anda mengontrol kedaluwarsa, penggunaan, dan pencabutan. Setelah membuat URL streaming, siapa pun yang mengaksesnya memulai sesi streaming mereka sendiri tanpa memerlukan kredentif apa pun. URL Stream ideal untuk menyiapkan demo, playtest, ulasan pemangku kepentingan, dan akses tamu dengan cepat dan mudah.

Cara kerja URL streaming

URL aliran menghubungkan grup aliran (kapasitas yang menjalankan aliran) dan satu aplikasi dalam grup aliran tersebut (konten yang akan dijalankan). Saat Anda membuat URL streaming, Amazon Stre GameLift ams mengembalikan URL aliran dari formulir berikut:

https://gameliftstreams.aws.com/su-1AB2C3De4/stream?token=EXAMPLETOKEN

Alur kerja memiliki empat langkah:

Karena URL streaming tidak diautentikasi, pengguna akhir tidak pernah melihat atau membutuhkan kredensibilitas Anda AWS . Layanan mengarahkan setiap pengguna akhir ke lokasi terdekat berdasarkan preferensi lokasi streaming yang Anda tetapkan pada waktu pembuatan. Amazon GameLift Streams menyusun ulang lokasi streaming pilihan Anda berdasarkan kedekatan tetapi tidak pernah menambahkan lokasi yang tidak Anda sertakan.

Pengalaman pengguna akhir

Pengguna yang Anda bagikan URL streaming tidak memerlukan Akun AWS instalasi perangkat lunak apa pun. Mereka membuka URL di browser web yang didukung dan melakukan streaming dari halaman web yang dihosting Amazon Stre GameLift ams untuk Anda. Streaming menggunakan WebRTC dan memiliki persyaratan browser dan perangkat yang sama dengan klien Amazon GameLift Streams Web SDK. Untuk browser yang didukung dan versi minimum, lihatPerangkat dan browser yang kompatibel dengan Amazon GameLift Streams. Jika grup aliran tidak memiliki kapasitas yang tersedia saat pengguna akhir membuka URL, halaman akan menampilkan pesan bahwa aliran sementara memenuhi kapasitas, dan pengguna akhir dapat mencoba lagi. Jika pengguna akhir mencoba menutup atau memuat ulang tab, halaman meminta mereka untuk mengonfirmasi, karena meninggalkan halaman mengakhiri sesi.

Prasyarat

Sebelum membuat URL streaming, Anda memerlukan yang berikut ini:

Membuat URL Streaming

AWS CLI Contoh berikut membuat URL aliran untuk aplikasi dalam grup aliran. URL streaming valid selama dua jam dan dapat digunakan hingga lima kali, dan lebih menyukai us-east-1 lokasi us-west-2 dan.

aws gameliftstreams create-stream-url \
    --identifier sg-1AB2C3De4 \
    --application-identifier a-9ZY8X7Wv6 \
    --protocol WebRTC \
    --url-expires-after-minutes 120 \
    --usage-limit 5 \
    --locations us-west-2 us-east-1 \
    --description "Preview build - reviewer invites"

Panggilan yang berhasil mengembalikan sumber daya URL aliran, termasuk StreamUrlId (awalansu-), ARN-nya, yang dapat dibagikan penuh, waktu kedalu StreamUrl warsa yang dihitung, dan penggunaan awal yang tersisa.

{
    "StreamUrlId": "su-1AB2C3De4",
    "Arn": "arn:aws:gameliftstreams:us-west-2:111122223333:streamurl/sg-1AB2C3De4/su-1AB2C3De4",
    "StreamUrl": "https://gameliftstreams.aws.com/su-1AB2C3De4/stream?token=EXAMPLETOKEN",
    "Status": "ACTIVE",
    "UsageLimit": 5,
    "RemainingUses": 5,
    "ExpiresAt": "2026-07-31T20:00:00+00:00"
}

Parameter-parameter berikut diperlukan:

Parameter-parameter berikut bersifat opsional. Setelan sesi apa pun yang Anda berikan dibekukan ke dalam URL streaming pada saat pembuatan dan diterapkan ke setiap sesi yang dimulai dari URL streaming.

Memantau URL streaming Anda

Gunakan GetStreamUrl untuk mengambil URL aliran tunggal. Tentukan grup aliran dengan --identifier dan URL aliran dengan --stream-url-identifier (ID URL aliran atau ARN). Selain konfigurasi URL streaming, saat ini, dan StatusRemainingUses, respons menyertakan StreamSessions daftar sesi yang dimulai darinya, sehingga Anda dapat melihat siapa yang aktif streaming.

aws gameliftstreams get-stream-url \
    --identifier sg-1AB2C3De4 \
    --stream-url-identifier su-1AB2C3De4

Gunakan ListStreamUrls untuk menghitung URL aliran di akun Anda. Anda dapat memfilter Status berdasarkan grup aliran, dan halaman melalui hasil dengan MaxResults (1—100, default 25) danNextToken.

aws gameliftstreams list-stream-urls \
    --status ACTIVE \
    --stream-group-identifier sg-1AB2C3De4

Anda juga dapat mengaudit aktivitas manajemen URL aliran di CloudTrail. CloudTrail merekam panggilan ke CreateStreamUrlGetStreamUrl,ListStreamUrls,, dan RevokeStreamUrl sebagai peristiwa data. Pengguna akhir yang membuka URL aliran dan memulai sesi bukan salah satu panggilan API Anda dan tidak direkam sebagai CloudTrail aktivitas pelanggan. Untuk informasi selengkapnya, lihat Mencatat panggilan API Amazon GameLift Streams menggunakan AWS CloudTrail.

Mencabut URL aliran

Cabut URL streaming saat Anda ingin menghentikannya memulai sesi lagi, misalnya saat periode pratinjau berakhir atau mungkin tidak sengaja dibagikan.

RevokeStreamUrlmembutuhkanRevocationMode:

aws gameliftstreams revoke-stream-url \
    --identifier sg-1AB2C3De4 \
    --stream-url-identifier su-1AB2C3De4 \
    --revocation-mode REVOKE_AND_TERMINATE_SESSIONS

URL aliran yang dicabut bertransisi ke REVOKED status dan tidak dapat diaktifkan kembali. Buat URL streaming baru jika Anda perlu melanjutkan berbagi.

Amazon GameLift Streams juga secara otomatis mencabut URL aliran ketika sumber daya yang bergantung padanya dihapus. Menghapus grup aliran akan mencabut semua URL aliran pada grup aliran tersebut, dan menghapus aplikasi akan mencabut semua URL aliran yang mereferensikan aplikasi tersebut. Dalam kedua kasus, URL aliran dipindahkan ke REVOKED dengan alasan status yang mengidentifikasi sumber daya yang dihapus.

Siklus hidup dan status URL Streaming

URL aliran adalah ACTIVE saat dibuat dan tetap seperti itu sampai kedaluwarsa, kehabisan penggunaan, atau dicabut. Itu tidak pernah kembali ACTIVE setelah meninggalkan negara itu.

Ketika URL streaming adaREVOKED, GetStreamUrl dan ListStreamUrls juga mengembalikan alasan status yang menjelaskan alasannya.

Perbedaan dari sesi yang Anda mulai StartStreamSession

Sesi dimulai dari URL streaming yang berjalan pada infrastruktur yang sama dengan sesi yang Anda mulai sendiri, tetapi sesi tersebut disetel untuk pemutaran singkat, langsung, dan single-viewer. Ingatlah perbedaan-perbedaan ini:

Pemecahan masalah

Amazon GameLift Streams sengaja menyembunyikan alasan spesifik aktivasi URL aliran yang gagal dari pengguna akhir. Pengguna akhir yang membuka URL aliran yang tidak dapat memulai aliran selalu melihat halaman umum “tidak ditemukan” atau pesan “pada kapasitas”, terlepas dari penyebab yang mendasarinya. Untuk mendiagnosis penyebab sebenarnya, periksa URL aliran dari sisi pembuat dengan GetStreamUrl danListStreamUrls, periksa alasan Status dan status, dan tinjau aktivitas API URL aliran di CloudTrail.