Siapkan aplikasi di Amazon GameLift Streams - GameLift Aliran Amazon

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

Siapkan aplikasi di Amazon GameLift Streams

Untuk mengatur streaming dengan Amazon GameLift Streams, pertama-tama Anda mengunggah game atau aplikasi lain yang ingin Anda streaming, lalu Anda mengonfigurasi sumber daya aplikasi dalam Amazon GameLift Streams untuk menentukan metadata tentang game Anda. Aplikasi Amazon GameLift Streams terdiri dari file yang Anda unggah (file yang dapat dieksekusi dan file pendukung apa pun) dan konfigurasi yang menginstruksikan Amazon GameLift Streams apa yang dapat dieksekusi untuk dijalankan saat streaming.

Setiap aplikasi Amazon GameLift Streams mewakili satu versi konten Anda. Jika Anda memiliki beberapa versi, Anda harus membuat aplikasi terpisah untuk setiap versi. Setelah Anda membuat aplikasi, Anda tidak dapat memperbarui file. Jika Anda perlu memperbarui file yang dapat dieksekusi atau file pendukung apa pun, Anda harus membuat aplikasi Amazon GameLift Streams baru.

Sebelum Anda meng-upload

Sebelum Anda membuat aplikasi Amazon GameLift Streams, verifikasi bahwa game Anda mematuhi batasan berikut.

Nama Default Dapat disesuaikan Deskripsi
File per aplikasi 30.000 file Ya* Jumlah maksimum file yang dapat Anda miliki dalam suatu aplikasi, di akun ini.
Ukuran file tunggal 80 GiB Tidak Ukuran maksimum satu file dalam aplikasi. Perhatikan bahwa gibibyte (GiB) sama dengan 1024*1024*1024 byte.
Ukuran aplikasi 100 GiB Ya* Ukuran total maksimum aplikasi Amazon GameLift Streams, di akun ini. Perhatikan bahwa gibibyte (GiB) sama dengan 1024*1024*1024 byte.

*Untuk meminta kenaikan, masuk ke AWS Management Console dan buka konsol Service Quotas ke GameLift Amazon Streams, di mana Anda dapat meninjau kuota saat ini di kolom Nilai kuota tingkat akun Terapan dan mengirimkan permintaan untuk meningkatkan nilai.

catatan

Untuk menghemat waktu dan tenaga Anda, verifikasi bahwa file yang siap Anda unggah adalah versi aplikasi Anda yang benar. Meskipun Anda dapat mengunggah versi baru nanti, Anda harus mengulangi Membuat aplikasi langkah untuk setiap versi.

Unggah aplikasi Anda ke bucket Amazon S3

Sekarang setelah Anda menyiapkan game untuk Amazon GameLift Streams, saatnya mengunggahnya ke bucket Amazon Simple Storage Service (Amazon S3) di akun Anda. AWS

catatan

Kelas penyimpanan Amazon S3 yang dibutuhkan Amazon GameLift Streams adalah Standar S3 default. Kelas penyimpanan lain seperti S3 Glacier atau objek yang dipindahkan ke Akses Jarang atau Akses Arsip oleh S3 Intelligent-Tiering tidak didukung oleh Amazon Streams. GameLift

Untuk mengoptimalkan biaya penyimpanan, Anda dapat menghapus aplikasi dari bucket S3 Anda setelah selesai Membuat aplikasi dan aplikasi dalam status Ready.

Untuk mengunggah aplikasi Anda ke Amazon S3
  1. Masuk ke AWS Management Console dan buka konsol Amazon S3 di. https://console.aws.amazon.com/s3/

  2. Buat bucket Amazon S3. Masukkan nama bucket dan pilih file Wilayah AWS. Wilayah ini harus sama dengan grup aplikasi dan streaming yang akan Anda buat nanti. Lihat Wilayah AWS dan lokasi terpencil yang didukung oleh Amazon GameLift Streams daftar Wilayah AWS tempat Amazon GameLift Streams tersedia. Untuk bidang yang tersisa, pertahankan pengaturan default.

    Untuk petunjuk selengkapnya, lihat Membuat bucket di Panduan Pengguna Layanan Penyimpanan Sederhana Amazon.

  3. Buka bucket baru dan unggah folder dengan file aplikasi Anda.

    Awas

    Anda harus mengunggah file aplikasi Anda sebagai folder yang tidak terkompresi. Jangan mengunggah .zip folder.

Membuat aplikasi

Aplikasi Amazon GameLift Streams adalah sumber daya yang berisi game atau perangkat lunak lain yang ingin Anda streaming dan pengaturan untuk menjalankannya. Saat membuat aplikasi, Anda memberikan jalur ke file aplikasi yang Anda unggah di bucket Amazon S3 Anda.

Amazon GameLift Streams tidak menyinkronkan file game Anda secara otomatis dari bucket Amazon S3 yang Anda buat. Jika Anda ingin memperbarui file game Anda, Anda harus membuat aplikasi Amazon GameLift Streams baru.

Console
Untuk membuat aplikasi Amazon GameLift Streams menggunakan konsol Amazon GameLift Streams
  1. Masuk ke AWS Management Console dan buka konsol Amazon GameLift Streams. Pilih yang Wilayah AWS sama dengan bucket Amazon S3 tempat Anda mengunggah kumpulan file Anda. Untuk informasi selengkapnya, lihat Memilih Wilayah di Panduan AWS Management Console Memulai.

  2. Di bilah navigasi, pilih Aplikasi dan kemudian pilih Buat aplikasi.

  3. Dalam pengaturan Runtime, masukkan yang berikut ini:

    1. Lingkungan runtime

      Ini adalah lingkungan runtime untuk menjalankan aplikasi Anda. Amazon GameLift Streams dapat berjalan di Windows, Ubuntu 22.04 LTS, atau Proton.

      Anda tidak dapat mengedit bidang ini setelah alur kerja pembuatan.

      Pilih dari salah satu lingkungan runtime berikut.

      • Untuk aplikasi Linux:

        • Ubuntu 22.04 () UBUNTU, 22_04_LTS

      • Untuk aplikasi Windows:

        • Basis Microsoft Windows Server 2022 (WINDOWS, 2022)

        • Proton 8.0-5 () PROTON, 20241007

        • Proton 8.0-2c () PROTON, 20230704

      Tinjau deskripsi dan gunakan daftar periksa perbandingan untuk membantu Anda memilih lingkungan runtime yang optimal untuk aplikasi Anda.

  4. Di Pengaturan umum, masukkan yang berikut ini:

    1. Deskripsi

      Ini adalah label yang dapat dibaca manusia untuk aplikasi Anda. Nilai ini tidak harus unik. Untuk praktik terbaik, gunakan deskripsi, nama, atau label yang bermakna untuk aplikasi. Anda dapat mengedit bidang ini kapan saja.

    2. Jalur dasar

      Ini adalah URI Amazon S3 ke folder root aplikasi Anda di bucket Amazon S3. Folder harus berisi file build yang dapat dieksekusi dan file pendukung apa pun.

      URI yang valid adalah awalan bucket yang berisi semua file yang diperlukan untuk menjalankan dan streaming aplikasi. Misalnya, bucket yang disebut mygamebuild berisi tiga versi lengkap dari file build game, masing-masing dalam folder terpisah. Anda ingin melakukan streaming build di foldermygamebuild-EN101. Dalam contoh ini, URI adalahs3://amzn-s3-demo-bucket/mygamebuild-EN101.

      Anda tidak dapat mengedit bidang ini setelah alur kerja pembuatan.

    3. Jalur peluncuran yang dapat dieksekusi

      Ini adalah URI Amazon S3 ke file yang dapat dieksekusi yang akan dialirkan Amazon GameLift Streams. File harus terkandung dalam folder root aplikasi.

      Anda tidak dapat mengedit bidang ini setelah alur kerja pembuatan.

  5. (Opsional) Di jalur log Aplikasi, masukkan yang berikut ini:

    1. Jalur log aplikasi

      Ini adalah path (atau path) ke folder aplikasi atau file yang berisi log yang ingin Anda simpan. Tentukan setiap jalur log relatif terhadap jalur dasar aplikasi Anda. Jika Anda menggunakan fitur ini, maka di akhir setiap sesi streaming, Amazon GameLift Streams akan menyalin file yang Anda tentukan ke bucket Amazon S3 yang Anda beri nama. Operasi penyalinan tidak dilakukan secara rekursif di subfolder folder aplikasi.

      Anda dapat mengedit bidang ini kapan saja.

    2. Keluaran log aplikasi

      Ini adalah URI ke bucket Amazon S3 tempat Amazon GameLift Streams akan menyalin file log aplikasi. Bidang ini diperlukan jika Anda menentukan jalur log aplikasi.

      Anda dapat mengedit bidang ini kapan saja.

      Untuk menyimpan file log atas nama Anda, Amazon GameLift Streams harus diberi izin ke bucket S3 Anda untuk disimpan. Jika Anda mengizinkan Amazon GameLift Streams membuat bucket untuk logging, kebijakan izin akan diterapkan secara otomatis setelah pembuatan. Jika Anda menyediakan ember Anda sendiri, Anda harus menerapkan kebijakan izin, sendiri.

      Templat kebijakan izin bucket

      Salin kode kebijakan berikut dan terapkan ke bucket yang ingin Anda gunakan untuk log aplikasi. Pastikan untuk mengganti amzn-s3-demo-bucket dengan nama bucket S3 Anda yang ada.

      { "Version": "2012-10-17", "Statement": [ { "Sid": "PutPolicy", "Effect": "Allow", "Principal": { "Service": [ "gameliftstreams.amazonaws.com" ] }, "Action": "s3:PutObject", "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*" } ] }
  6. (Opsional) Di Tag, tetapkan tag ke aplikasi ini.

    Tag adalah label yang dapat membantu Anda mengatur AWS sumber daya Anda. Untuk informasi selengkapnya, lihat Menandai sumber daya AWS Anda.

    Misalnya untuk melacak versi aplikasi, gunakan tag sepertiapplication-version : my-game-1121.

  7. Pilih Create application (Buat aplikasi).

CLI

Prasyarat

Anda harus mengkonfigurasi AWS CLI dengan kredensi pengguna Anda dan pilihan Anda. Wilayah AWS Untuk petunjuk penyiapan, lihatUnduh AWS CLI.

Untuk membuat aplikasi menggunakan AWS CLI

Saat Anda AWS CLI menggunakan CreateApplicationperintah, disesuaikan untuk konten Anda.

aws gameliftstreams create-application \ --description "MyGame v1" \ --runtime-environment '{"Type":"PROTON", "Version":"20241007"}' \ --executable-path "launcher.exe" \ --application-source-uri "s3://amzn-s3-demo-bucket/example"

di mana

  • description:

    Ini adalah label yang dapat dibaca manusia untuk aplikasi Anda. Nilai ini tidak harus unik. Untuk praktik terbaik, gunakan deskripsi, nama, atau label yang bermakna untuk aplikasi. Anda dapat mengedit bidang ini kapan saja.

  • runtime-environment:

    Ini adalah lingkungan runtime untuk menjalankan aplikasi Anda. Amazon GameLift Streams dapat berjalan di Windows, Ubuntu 22.04 LTS, atau Proton.

    Anda tidak dapat mengedit bidang ini setelah alur kerja pembuatan.

    Pilih dari salah satu lingkungan runtime berikut.

    • Untuk aplikasi Linux

      • Ubuntu 22.04 LTS () Type=UBUNTU, Version=22_04_LTS

    • Untuk aplikasi Windows

      • Basis Microsoft Windows Server 2022 (Type=WINDOWS, Version=2022)

      • Proton 8.0-2c () Type=PROTON, Version=20230704

      • Proton 8.0-5 () Type=PROTON, Version=20241007

  • executable-path:

    Ini adalah URI Amazon S3 ke file yang dapat dieksekusi yang akan dialirkan Amazon GameLift Streams. File harus terkandung dalam folder root aplikasi. Masukkan jalur relatif terhadapapplication-source-uri.

    Anda tidak dapat mengedit bidang ini setelah alur kerja pembuatan.

  • application-source-uri:

    Ini adalah URI Amazon S3 ke folder root aplikasi Anda di bucket Amazon S3. Folder harus berisi file build yang dapat dieksekusi dan file pendukung apa pun.

    URI yang valid adalah awalan bucket yang berisi semua file yang diperlukan untuk menjalankan dan streaming aplikasi. Misalnya, bucket yang disebut mygamebuild berisi tiga versi lengkap dari file build game, masing-masing dalam folder terpisah. Anda ingin melakukan streaming build di foldermygamebuild-EN101. Dalam contoh ini, URI adalahs3://amzn-s3-demo-bucket/mygamebuild-EN101.

    Anda tidak dapat mengedit bidang ini setelah alur kerja pembuatan.

Jika permintaan berhasil, Amazon GameLift Streams mengembalikan respons yang mirip dengan berikut ini:

{ "Arn": "arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6", "Description": "MyGame v1", "RuntimeEnvironment": { "Type": "PROTON", "Version": "20241007" }, "ExecutablePath": "launcher.exe", "ApplicationSourceUri": "s3://amzn-s3-demo-bucket/example", "Id": "a-9ZY8X7Wv6", "Status": "PROCESSING", "CreatedAt": "2022-11-18T15:47:11.924000-08:00", "LastUpdatedAt": "2022-11-18T15:47:11.924000-08:00" }

Untuk memeriksa status aplikasi Anda, panggil GetApplicationperintah, seperti yang ditunjukkan pada contoh berikut.

aws gameliftstreams get-application / --identifier a-9ZY8X7Wv6

Amazon GameLift Streams membutuhkan waktu beberapa menit untuk menyiapkan aplikasi Anda. Selama waktu ini, aplikasi baru dalam status Pemrosesan. Ketika aplikasi Anda dalam status Siap, Anda dapat pergi ke langkah berikutnya,Buat grup streaming.

Jika permintaan menampilkan kesalahan, atau jika aplikasi dibuat tetapi ditempatkan dalam status Kesalahan, pastikan Anda bekerja dengan kredenal pengguna yang menyertakan akses ke Amazon S3 dan GameLift Amazon Streams.

catatan

Saat aplikasi dalam status Siap, Amazon GameLift Streams telah berhasil menyalin file aplikasi Anda ke bucket Amazon S3 pribadinya. Anda dapat menghapus file aplikasi asli Anda tanpa mempengaruhi aplikasi baru Anda. Ini juga membantu Anda mengoptimalkan biaya penyimpanan. Untuk informasi selengkapnya, lihat Menghapus sebuah aplikasi.

Mengedit aplikasi

Anda dapat memperbarui pengaturan untuk aplikasi apa pun dalam status Siap. Jika Anda membuat perubahan pada aplikasi yang sudah ada, perubahan ini memengaruhi perilaku streaming untuk grup streaming baru dan yang sudah ada.

Console
Untuk mengedit aplikasi di konsol Amazon GameLift Streams
  1. Di bilah navigasi, pilih Aplikasi untuk melihat daftar aplikasi yang ada. Pilih aplikasi yang ingin Anda edit.

  2. Di halaman detail aplikasi, cari bagian yang berisi pengaturan yang ingin Anda ubah dan pilih Edit atau Kelola tag yang sesuai.

  3. Anda dapat mengubah pengaturan berikut:

    Deskripsi

    Ini adalah label yang dapat dibaca manusia untuk aplikasi Anda. Nilai ini tidak harus unik. Untuk praktik terbaik, gunakan deskripsi, nama, atau label yang bermakna untuk aplikasi. Anda dapat mengedit bidang ini kapan saja.

    Jalur log aplikasi

    Ini adalah path (atau path) ke folder aplikasi atau file yang berisi log yang ingin Anda simpan. Tentukan setiap jalur log relatif terhadap jalur dasar aplikasi Anda. Jika Anda menggunakan fitur ini, maka di akhir setiap sesi streaming, Amazon GameLift Streams akan menyalin file yang Anda tentukan ke bucket Amazon S3 yang Anda beri nama. Operasi penyalinan tidak dilakukan secara rekursif di subfolder folder aplikasi.

    Anda dapat mengedit bidang ini kapan saja.

    Keluaran log aplikasi

    Ini adalah URI ke bucket Amazon S3 tempat Amazon GameLift Streams akan menyalin file log aplikasi. Bidang ini diperlukan jika Anda menentukan jalur log aplikasi.

    Anda dapat mengedit bidang ini kapan saja.

    Untuk menyimpan file log atas nama Anda, Amazon GameLift Streams harus diberi izin ke bucket S3 Anda untuk disimpan. Jika Anda mengizinkan Amazon GameLift Streams membuat bucket untuk logging, kebijakan izin akan diterapkan secara otomatis setelah pembuatan. Jika Anda menyediakan ember Anda sendiri, Anda harus menerapkan kebijakan izin, sendiri.

    Untuk informasi selengkapnya, lihat Kebijakan izin bucket log aplikasi.

    Tanda

    Tag adalah label yang dapat membantu Anda mengatur AWS sumber daya Anda. Untuk informasi selengkapnya, lihat Menandai sumber daya AWS Anda.

    Misalnya untuk melacak versi aplikasi, gunakan tag sepertiapplication-version : my-game-1121.

  4. Pilih Simpan perubahan. Konsol Amazon GameLift Streams kembali ke halaman detail aplikasi, menampilkan pengaturan yang diperbarui.

CLI

Prasyarat

Anda harus mengkonfigurasi AWS CLI dengan kredensi pengguna Anda dan pilihan Anda. Wilayah AWS Untuk petunjuk penyiapan, lihatUnduh AWS CLI.

Untuk mengedit aplikasi menggunakan AWS CLI

Saat Anda AWS CLI menggunakan UpdateApplicationperintah, disesuaikan untuk konten Anda.

aws gameliftstreams update-application \ --identifier a-9ZY8X7Wv6 \ --description "MyGame v2" \ --application-log-paths '[".\\logs"]' \ --application-log-output-uri "s3://amzn-s3-demo-bucket/mygame"

di mana

  • identifier: Aplikasi untuk mengedit.

    Nilai ini adalah Nama Sumber Daya Amazon (ARN) atau ID yang secara unik mengidentifikasi sumber daya aplikasi.

    Contoh ARN: arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6

    Contoh ID: a-9ZY8X7Wv6

  • description:

    Ini adalah label yang dapat dibaca manusia untuk aplikasi Anda. Nilai ini tidak harus unik. Untuk praktik terbaik, gunakan deskripsi, nama, atau label yang bermakna untuk aplikasi. Anda dapat mengedit bidang ini kapan saja.

  • application-log-paths:

    Ini adalah path (atau path) ke folder aplikasi atau file yang berisi log yang ingin Anda simpan. Tentukan setiap jalur log relatif terhadap jalur dasar aplikasi Anda. Jika Anda menggunakan fitur ini, maka di akhir setiap sesi streaming, Amazon GameLift Streams akan menyalin file yang Anda tentukan ke bucket Amazon S3 yang Anda beri nama. Operasi penyalinan tidak dilakukan secara rekursif di subfolder folder aplikasi.

    Anda dapat mengedit bidang ini kapan saja.

  • application-log-output-uri:

    Ini adalah URI ke bucket Amazon S3 tempat Amazon GameLift Streams akan menyalin file log aplikasi. Bidang ini diperlukan jika Anda menentukan jalur log aplikasi.

    Anda dapat mengedit bidang ini kapan saja.

    Untuk menyimpan file log atas nama Anda, Amazon GameLift Streams harus diberi izin ke bucket S3 Anda untuk disimpan. Jika Anda mengizinkan Amazon GameLift Streams membuat bucket untuk logging, kebijakan izin akan diterapkan secara otomatis setelah pembuatan. Jika Anda menyediakan ember Anda sendiri, Anda harus menerapkan kebijakan izin, sendiri.

    Untuk informasi selengkapnya, lihat Kebijakan izin bucket log aplikasi.

Menghapus sebuah aplikasi

Hapus aplikasi jika Anda tidak lagi membutuhkannya. Tindakan ini menghapus aplikasi secara permanen, termasuk file konten aplikasi yang disimpan dengan Amazon GameLift Streams. Namun, ini tidak menghapus file asli yang Anda unggah ke bucket Amazon S3 Anda; Anda dapat menghapusnya kapan saja setelah GameLift Amazon Streams membuat aplikasi, yang merupakan satu-satunya saat Amazon Streams mengakses bucket GameLift Amazon S3 Anda.

Anda hanya dapat menghapus aplikasi yang memenuhi ketentuan berikut:

  • Aplikasi ini dalam status Siap atau Kesalahan.

  • Aplikasi ini bukan aplikasi default dari grup aliran apa pun. Anda harus terlebih dahulu menghapus grup streaming dengan menggunakan konsol Amazon GameLift Streams, atau dengan menggunakan DeleteStreamGroupdi Amazon GameLift Streams API.

  • Aplikasi ini tidak ditautkan ke grup aliran apa pun. Anda harus terlebih dahulu memutuskan tautan grup streaming dengan menggunakan konsol Amazon GameLift Streams, atau dengan menggunakan DisassociateApplicationsdi Amazon GameLift Streams API.

  • Aplikasi tidak streaming dalam sesi streaming yang sedang berlangsung. Anda harus menunggu hingga klien mengakhiri sesi streaming atau menelepon TerminateStreamSessiondi Amazon GameLift Streams API untuk mengakhiri streaming.

Console
Untuk menghapus aplikasi menggunakan konsol Amazon GameLift Streams
  1. Masuk ke AWS Management Console dan buka konsol Amazon GameLift Streams.

  2. Di bilah navigasi, pilih Aplikasi untuk melihat daftar aplikasi yang ada. Pilih aplikasi yang ingin Anda hapus.

  3. Di halaman detail aplikasi, pilih Hapus.

  4. Di kotak dialog Hapus, konfirmasikan tindakan hapus.

CLI

Prasyarat

Anda harus mengkonfigurasi AWS CLI dengan kredensi pengguna Anda dan pilihan Anda. Wilayah AWS Untuk petunjuk penyiapan, lihatUnduh AWS CLI.

Untuk menghapus aplikasi menggunakan AWS CLI

Saat Anda AWS CLI menggunakan DeleteApplicationperintah, disesuaikan untuk konten Anda.

aws gameliftstreams delete-application \ --identifier arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6

di mana

  • identifier: Aplikasi untuk menghapus.

    Nilai ini adalah Nama Sumber Daya Amazon (ARN) atau ID yang secara unik mengidentifikasi sumber daya aplikasi.

    Contoh ARN: arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6

    Contoh ID: a-9ZY8X7Wv6

Amazon GameLift Streams mulai menghapus aplikasi. Selama waktu ini, aplikasi dalam Deleting status. Setelah Amazon GameLift Streams menghapus aplikasi, Anda tidak dapat lagi mengambilnya.

Kebijakan izin bucket log aplikasi

Jika Anda menyediakan bucket Amazon S3 log aplikasi Anda sendiri, Anda harus menerapkan kebijakan izin ke bucket sehingga Amazon GameLift Streams dapat menyimpan file log ke bucket. Gunakan template berikut untuk memperbarui izin di Amazon S3.

Templat kebijakan izin bucket

Salin kode kebijakan berikut dan terapkan ke bucket yang ingin Anda gunakan untuk log aplikasi. Pastikan untuk mengganti amzn-s3-demo-bucket dengan nama bucket S3 Anda yang ada.

{ "Version": "2012-10-17", "Statement": [ { "Sid": "PutPolicy", "Effect": "Allow", "Principal": { "Service": [ "gameliftstreams.amazonaws.com" ] }, "Action": "s3:PutObject", "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*" } ] }

Grup aliran tertaut

Jika Anda ingin melakukan streaming beberapa aplikasi dengan menggunakan kumpulan sumber daya komputasi yang sama, Anda dapat menautkan beberapa aplikasi ke grup aliran yang sama. Demikian pula, jika Anda ingin melakukan streaming aplikasi dengan menggunakan kumpulan sumber daya komputasi yang berbeda, Anda dapat menautkan aplikasi ke beberapa grup aliran.

Untuk informasi selengkapnya tentang menautkan aplikasi ke grup streaming, lihat. Ikhtisar grup aliran multi-aplikasi