View a markdown version of this page

API Layanan untuk GameLift Server Amazon - GameLift Server Amazon

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

API Layanan untuk GameLift Server Amazon

Gunakan daftar berbasis tugas ini untuk menemukan operasi API saat membangun solusi hosting Amazon GameLift Servers game dan fitur lainnya. AWS SDK menyertakan operasi ini di aws.gamelift namespace. Unduh AWS SDK atau lihat dokumentasi referensi Amazon GameLift Servers API. Anda juga dapat menggunakan API dengan antarmuka baris AWS perintah (AWS CLI), seperti yang didokumentasikan dalam referensi AWS CLI perintah.

API mencakup dua set operasi untuk hosting game terkelola:

Amazon GameLift ServersService API juga berisi operasi untuk digunakan dengan Amazon GameLift Servers alat dan solusi lain. Untuk daftar FleetIQ API, lihat Oper FleetIQ asi API. Untuk daftar FlexMatch API untuk perjodohan, lihat Oper FlexMatch asi API.

Kelola GameLift Server Amazon sumber daya hosting

Panggil operasi ini untuk mengonfigurasi sumber daya hosting untuk server game Anda, menskalakan kapasitas untuk memenuhi permintaan pemain, mendapatkan metrik kinerja dan penggunaan, dan banyak lagi. Gunakan operasi API ini saat menghosting server game denganAmazon GameLift Servers, termasuk Amazon GameLift ServersRealtime. Anda juga dapat bekerja di Amazon GameLift Servers konsol untuk sebagian besar tugas manajemen sumber daya, atau Anda dapat melakukan panggilan dengan alat AWS Command Line Interface (AWS CLI).

Siapkan server game untuk deployment

Unggah dan konfigurasikan kode server game Anda dalam persiapan deployment dan peluncuran sumber daya hosting.

Kelola build server game khusus

  • upload build — Unggah file build dari jalur lokal dan buat sumber daya Amazon GameLift Servers build baru. Operasi ini, tersedia sebagai AWS CLI perintah, adalah cara paling umum untuk mengunggah build server game.

  • CreateBuild— Buat build baru menggunakan file yang disimpan dalam bucket Amazon S3.

  • ListBuilds— Dapatkan daftar semua build yang diunggah ke suatu Amazon GameLift Servers wilayah.

  • DescribeBuild— Mengambil informasi yang terkait dengan build.

  • UpdateBuild— Ubah metadata build, termasuk nama dan versi build.

  • DeleteBuild— Hapus build dariAmazon GameLift Servers.

Kelola skrip Amazon GameLift Servers Realtime konfigurasi

  • CreateScript— Unggah JavaScript file dan buat sumber daya Amazon GameLift Servers skrip baru.

  • ListScripts— Dapatkan daftar semua Realtime skrip yang diunggah ke suatu Amazon GameLift Servers wilayah.

  • DescribeScript— Mengambil informasi yang terkait dengan Realtime skrip.

  • UpdateScript— Ubah metadata skrip dan unggah konten skrip yang direvisi.

  • DeleteScript— Hapus Realtime skrip dariAmazon GameLift Servers.

Mengatur sumber daya komputasi untuk hosting

Konfigurasikan sumber daya hosting dan terapkan dengan build server game atau skrip Realtime konfigurasi Anda.

Membuat dan mengelola armada

  • CreateFleet— Konfigurasikan dan gunakan Amazon GameLift Servers armada sumber daya komputasi baru untuk menjalankan server game Anda. Setelah di-deploy, server game secara otomatis diluncurkan sesuai konfigurasi dan siap untuk menjadi host sesi game.

  • ListFleets— Dapatkan daftar semua armada di suatu Amazon GameLift Servers wilayah.

  • DeleteFleet— Hapus armada yang tidak lagi menjalankan server game atau hosting pemain.

  • Melihat/memperbarui lokasi armada.

  • Melihat/memperbarui konfigurasi armada.

Kelola kapasitas armada

Pantau aktivitas armada.

Siapkan antrian untuk penempatan sesi game

Siapkan antrian multi-armada dan multi-wilayah untuk menempatkan sesi game dengan sumber daya hosting terbaik yang tersedia dalam hal biaya, latensi, dan ketahanan.

Mengelola alias

Gunakan alias untuk mewakili armada Anda atau membuat tujuan alternatif terminal. Alias berguna saat melakukan transisi aktivitas game dari satu armada ke armada lainnya, seperti saat memperbarui build server game.

  • CreateAlias— Tentukan alias baru dan secara opsional menetapkannya ke armada.

  • ListAliases— Dapatkan semua alias armada yang ditentukan di suatu Amazon GameLift Servers wilayah.

  • DescribeAlias— Mengambil informasi tentang alias yang ada.

  • UpdateAlias— Ubah pengaturan untuk alias, seperti mengalihkannya dari satu armada ke armada lainnya.

  • DeleteAlias— Hapus alias dari wilayah tersebut.

  • ResolveAlias— Dapatkan ID armada yang ditunjuk oleh alias tertentu.

Hubungkan ke instans hosting terkelola

Melihat informasi tentang masing-masing instans dalam armada, atau meminta akses jarak jauh ke instans armada tertentu untuk pemecahan masalah.

  • DescribeInstances— Dapatkan informasi tentang setiap instans dalam armada, termasuk ID instans, alamat IP, lokasi, dan status.

  • GetInstanceAccess— Minta kredentif akses yang diperlukan untuk terhubung dari jarak jauh ke instance tertentu dalam armada.

Mengatur peering VPC

Buat dan kelola koneksi peering VPC antara sumber daya Amazon GameLift Servers hosting Anda dan sumber daya lainnya AWS .

Memulai sesi game dan bergabung dengan pemain

Panggil operasi ini dari layanan backend untuk memulai sesi game baru, mendapatkan informasi tentang sesi game yang ada, dan bergabung dengan pemain ke sesi game. Operasi ini untuk digunakan dengan server game khusus yang dihosting diAmazon GameLift Servers. Jika Anda menggunakan Amazon GameLift ServersRealtime, kelola sesi game menggunakan API Amazon GameLift ServersRealtime klien (C#).

  • Mulai sesi permainan baru untuk satu atau lebih pemain.

    • StartGameSessionPlacement— Min Amazon GameLift Servers ta untuk menemukan sumber daya hosting terbaik yang tersedia dan mulai sesi permainan baru. Ini adalah metode yang disukai untuk membuat sesi game baru. Ini bergantung pada antrian sesi game untuk melacak ketersediaan hosting di beberapa wilayah, dan menggunakan FleetIQ algoritma untuk memprioritaskan penempatan berdasarkan latensi pemain, biaya hosting, lokasi, dll.

    • DescribeGameSessionPlacement— Dapatkan detail dan status pada permintaan penempatan.

    • StopGameSessionPlacement— Batalkan permintaan penempatan.

    • CreateGameSession— Mulai sesi permainan baru yang kosong di lokasi armada tertentu. Operasi ini memberi Anda kontrol yang lebih besar atas di mana memulai sesi permainan, alih-alih menggunakan FleetIQ untuk mengevaluasi opsi penempatan. Anda harus menambahkan pemain ke sesi game baru dalam langkah terpisah.

  • Dapatkan pemain ke sesi permainan yang ada. Cari sesi game berjalan dengan slot pemain yang tersedia dan simpan untuk pemain baru.

    • CreatePlayerSession— Pesan slot terbuka bagi pemain untuk bergabung dengan sesi permainan.

    • CreatePlayerSessions— Cadangkan slot terbuka untuk beberapa pemain untuk bergabung dengan sesi permainan.

  • Bekerja dengan sesi game dan data sesi pemain. Kelola informasi tentang sesi game dan sesi pemain.

    • SearchGameSessions— Minta daftar sesi permainan aktif berdasarkan serangkaian kriteria pencarian.

    • DescribeGameSessions— Ambil metadata untuk sesi permainan tertentu, termasuk lamanya waktu aktif dan jumlah pemain saat ini.

    • DescribeGameSessionDetails— Ambil metadata, termasuk pengaturan perlindungan sesi game, untuk satu atau lebih sesi game.

    • DescribePlayerSessions— Dapatkan detail tentang aktivitas pemain, termasuk status, waktu bermain, dan data pemain.

    • UpdateGameSession— Ubah pengaturan sesi permainan, seperti jumlah pemain maksimum dan kebijakan bergabung.

    • GetGameSessionLogUrl— Dapatkan lokasi log yang disimpan untuk sesi game.