View a markdown version of this page

Mulai sesi streaming dengan Amazon GameLift Streams - Aliran GameLift Amazon
Tentang sesi streamingMenguji aliran di konsolSiklus hidup sesi streamingNilai batas waktu yang memengaruhi sesi streamingMengakhiri sesi streamingMenghubungkan kembali ke sesi streaming

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

Mulai sesi streaming dengan Amazon GameLift Streams

Bagian ini mencakup sesi streaming, contoh aktual dari aliran di mana pengguna akhir atau pemain dapat berinteraksi dengan aplikasi Anda atau memainkan game Anda. Anda akan belajar tentang cara menguji sesi streaming Anda sendiri dan memahami siklus hidup sesi streaming.

Untuk meluncurkan sesi streaming ke pengguna akhir, Anda dapat mengintegrasikan Amazon GameLift Streams ke layanan dan aplikasi klien Anda sendiri; untuk informasi selengkapnya, lihatLayanan back GameLift end dan klien web Amazon Streams. Anda juga dapat membuat URL aliran, yang memulai sesi streaming di browser web yang didukung tanpa mengharuskan pengguna akhir untuk memiliki AWS kredentif atau integrasi klien; untuk informasi selengkapnya, lihatBagikan sesi streaming dengan URL streaming.

Tentang sesi streaming

Prasyarat untuk memulai sesi streaming adalah aplikasi dalam status Siap, grup aliran yang memiliki kapasitas tersedia di lokasi tempat Anda ingin melakukan streaming, dan aplikasi yang direplikasi ke lokasi tempat Anda ingin melakukan streaming. Sesi aliran berjalan pada salah satu sumber daya komputasi yang telah dialokasikan oleh grup aliran. Saat memulai streaming, Anda harus menentukan grup aliran dan aplikasi untuk melakukan streaming menggunakan nilai ARN atau ID-nya.

Ketika Anda berhasil memulai sesi streaming, Anda menerima pengenal unik untuk sesi streaming tersebut. Kemudian, Anda menggunakan ID itu untuk menghubungkan sesi streaming ke pengguna akhir. Untuk informasi selengkapnya, lihat StartStreamSession Referensi API Amazon GameLift Streams.

Secara opsional, Anda dapat memberikan peran IAM ARN saat memulai sesi streaming. Jika disediakan, Amazon GameLift Streams mengambil peran tersebut dan aplikasi Anda secara otomatis menerima kredenSIAL AWS. Anda tidak perlu mengubah kode aplikasi Anda. Untuk informasi selengkapnya, lihat Berikan kredensial AWS ke aplikasi streaming Anda.

Menguji aliran di konsol

Cara paling langsung bagi Anda untuk menguji cara streaming aplikasi Anda adalah melalui konsol Amazon GameLift Streams. Saat memulai streaming, Amazon Stre GameLift ams menggunakan salah satu sumber daya komputasi yang dialokasikan grup streaming Anda. Jadi, Anda harus memiliki kapasitas yang tersedia di grup streaming Anda.

Untuk menguji streaming Anda di konsol Amazon GameLift Streams

  1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon GameLift Streams.

  2. Anda dapat menguji aliran dengan beberapa cara. Mulai dari halaman grup Stream atau halaman Uji aliran dan ikuti langkah-langkah berikut:

    1. Pilih grup streaming yang ingin Anda gunakan untuk melakukan streaming.

    2. Jika Anda memulai dari halaman grup Streaming, pilih U ji aliran. Jika Anda memulai dari halaman Stream uji, pilih Pilih. Ini membuka halaman konfigurasi aliran uji untuk grup aliran yang dipilih.

    3. Di Aplikasi ter taut, pilih aplikasi.

    4. Di Lokasi, pilih lokasi dengan kapasitas yang tersedia.

    5. (Opsional) Dalam Konfigurasi program, masukkan argumen baris perintah atau variabel lingkungan untuk diteruskan ke aplikasi saat diluncurkan.

    6. Konfirmasikan pilihan Anda, dan pilih Uji aliran.

  3. Setelah streaming dimuat, Anda dapat melakukan tindakan berikut di streaming Anda:

    1. Untuk menghubungkan input, seperti mouse, keyboard, dan gamepad (kecuali mikrofon, yang tidak didukung dalam aliran uji), pilih Lamp irkan input. Anda secara otomatis melampirkan mouse Anda ketika Anda memindahkan kursor ke jendela streaming.

    2. Agar file yang dibuat selama sesi streaming diekspor ke bucket Amazon S3 di akhir sesi, pilih Ekspor file dan tentukan detail bucket. File yang diekspor dapat ditemukan di halaman Sesi.

    3. Untuk melihat streaming dalam layar penuh, pilih Layar Penuh. Tekan Escape untuk membalikkan tindakan ini.

  4. Untuk mengakhiri streaming, pilih Hentikan sesi. Ketika aliran terputus, kapasitas aliran menjadi tersedia untuk memulai aliran lain.

catatan

Fitur U ji aliran di konsol Amazon GameLift Streams tidak mendukung mikrofon.

Siklus hidup sesi streaming

Saat bekerja dengan sesi streaming di Amazon Stre GameLift ams, diagram ini dapat membantu Anda memahami berbagai status transisi sesi streaming sepanjang siklus hidupnya.

  • StartStreamSessionmembuat sesi streaming baru, yang dimulai dalam ACTIVATING status. Saat Amazon GameLift Streams menemukan sumber daya yang tersedia untuk meng-host streaming, sesi streaming beralih keACTIVE. Ketika klien terhubung ke aliran aktif, sesi aliran bertransisi keCONNECTED.

  • Ketika klien terputus dari aliran, sesi aliran beralih ke PENDING_CLIENT_RECONNECTION status. CreateStreamSessionConnectionmentransisi sesi streaming keRECONNECTING, dan akan memulai klien untuk menyambung kembali ke aliran atau membuat sesi aliran baru. Ketika sesi streaming siap untuk klien untuk disambungkan kembali, sesi tersebut beralih keACTIVE. Ketika klien terhubung kembali, ia beralih kembali keCONNECTED. Jika klien terputus lebih lama dariConnectionTimeoutSeconds, sesi streaming berakhir.

  • Ketika klien tidak terhubung ke sesi streaming dalam ACTIVE atau PENDING_CLIENT_RECONNECTION status dalam periode waktu yang ditentukan olehConnectionTimeoutSeconds, maka ia beralih keTERMINATED.

  • TerminateStreamSessionmemulai penghentian aliran, dan transisi sesi aliran ke TERMINATING status. Ketika sesi streaming berakhir dengan sukses, ia beralih keTERMINATED.

  • Sesi streaming dalam keadaan apa pun, kecualiTERMINATED, dapat beralih keERROR. Ketika panggilan API kembali ERROR sebagai nilai Status, periksa nilai StatusReason untuk deskripsi singkat tentang penyebab kesalahan. Anda juga dapat menelepon GetStreamSession untuk memeriksa nilai-nilai ini.

Diagram ini menunjukkan status berbeda yang menjadi transisi sesi aliran sepanjang siklus hidupnya.

Nilai batas waktu yang memengaruhi sesi streaming

Sesi streaming diatur oleh beberapa nilai batas waktu yang mengontrol berbagai aspek siklus hidup sesi. Dalam urutan kronologis kira-kira kapan Anda biasanya menemukannya selama siklus hidup sesi streaming, mereka termasuk yang berikut:

Waktu tunggu penempatan

Batas waktu Amazon GameLift Streams untuk menemukan sumber daya komputasi untuk menyelenggarakan sesi streaming menggunakan kapasitas yang tersedia. Waktu tunggu penempatan bervariasi berdasarkan jenis kapasitas yang digunakan untuk memenuhi permintaan streaming Anda:

  • Always-on kapasitas: 75 detik

  • On-demand kapasitas:

    • Linux/Proton runtime: 90 detik

    • Waktu proses Windows: 10 menit

  • Perilaku: Jika Amazon GameLift Streams tidak dapat mengidentifikasi sumber daya yang tersedia dalam waktu ini, sesi streaming Status ERROR berubah menjadi dengan StatusReason ofplacementTimeout.

Batas waktu koneksi

Lamanya waktu Amazon GameLift Streams menunggu klien untuk terhubung atau menyambung kembali ke sesi streaming.

  • Parameter: ConnectionTimeoutSeconds dalam StartStreamSession

  • Rentang: 1 - 3600 detik (1 jam)

  • Default: 120 detik (2 menit)

  • Perilaku: Timer dimulai saat sesi streaming mencapai ACTIVE atau PENDING_CLIENT_RECONNECTION status. Jika tidak ada klien yang terhubung sebelum batas waktu, sesi beralih Status keTERMINATED.

Waktu tunggu panjang sesi

Durasi maksimum Amazon Stre GameLift ams membuat sesi streaming tetap terbuka.

  • Parameter: SessionLengthSeconds dalam StartStreamSession

  • Rentang: 1 - 86400 detik (24 jam)

  • Standar: 43200 detik (12 jam)

  • Perilaku: Mengakhiri sesi streaming terlepas dari koneksi klien yang ada saat batas waktu tercapai.

Mengakhiri sesi streaming

Jika Anda perlu memaksa sesi streaming untuk diakhiri, Anda memiliki opsi berikut:

  • Gunakan TerminateStreamSession API: Untuk menggunakan TerminateStreamSession, Anda memerlukan ID grup aliran dan ID sesi aliran. Anda dapat menggunakan ListStreamSessions atau ListStreamSessionsByAccount dengan --status CONNECTED parameter untuk mendapatkan daftar sesi streaming yang memiliki klien yang terhubung.

  • Hapus lokasi sesi dari grup streamnya: Menghapus lokasi dari grup streaming tempat sesi streaming akan menghentikan semua sesi streaming aktif di lokasi tersebut. Anda dapat menghapus lokasi dalam grup aliran dari konsol atau dengan menggunakan RemoveStreamGroupLocations API.

  • Hapus grup aliran sesi: Menghapus grup aliran akan menghentikan semua sesi streaming aktif di semua lokasi grup streaming. Anda dapat menghapus grup streaming dari konsol atau dengan menggunakan DeleteStreamGroup API. Gunakan dengan hati-hati karena Anda akan tiba-tiba mengakhiri koneksi klien.

Menghubungkan kembali ke sesi streaming

Jika klien terputus dari sesi streaming tanpa mengakhiri sesi, klien dapat menyambung kembali ke sesi dalam waktu yang ditentukan ConnectionTimeoutSeconds saat sesi streaming dimulai. Untuk menyambung kembali ke sesi, Anda memerlukan ID sesi streaming. Untuk detailnya, lihat CreateStreamSessionConnection Referensi API Amazon GameLift Streams. Anda dapat melihat contoh menyambung kembali ke sesi stream di Sampel Pemula React.

Koneksi ulang tidak tersedia untuk sesi streaming yang dimulai dengan mengaktifkan URL aliran. Karena tidak ada koneksi ulang, membuka URL aliran lagi memulai sesi yang sama sekali baru dan menghabiskan penggunaan lain darinya. UsageLimit Lihat informasi yang lebih lengkap di Bagikan sesi streaming dengan URL streaming.