GameLift Layanan Amazon API - Amazon GameLift

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

GameLift Layanan Amazon API

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

APIIni mencakup dua set operasi untuk hosting game terkelola:

GameLift Layanan Amazon API juga berisi operasi untuk digunakan dengan GameLift alat dan solusi Amazon lainnya. Untuk daftar FleetiQ, lihat operasi APIs FleetiQ. API Untuk daftar FlexMatch APIs perjodohan, lihat FlexMatch API operasi.

Kelola sumber daya GameLift hosting Amazon

Hubungi operasi ini untuk mengonfigurasi sumber daya hosting untuk server game Anda, skala kapasitas untuk memenuhi permintaan pemain, mendapatkan metrik kinerja dan penggunaan, dan banyak lagi. Gunakan API operasi ini saat menghosting server game dengan Amazon GameLift, termasuk Server Realtime. Anda juga dapat bekerja di GameLift konsol Amazon 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.

Mengelola build server game kustom

  • upload-build — Unggah file build dari jalur lokal dan buat resource build Amazon GameLift 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 di bucket Amazon S3.

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

  • DescribeBuild— Ambil informasi yang terkait dengan build.

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

  • DeleteBuild— Hapus build dari Amazon GameLift.

Mengelola skrip konfigurasi Server Realtime

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

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

  • DescribeScript— Ambil informasi yang terkait dengan skrip Realtime.

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

  • DeleteScript— Hapus skrip Realtime dari Amazon GameLift.

Mengatur sumber daya komputasi untuk hosting

Mengonfigurasi sumber daya hosting dan men-deploy sumber daya dengan build server game Anda atau konfigurasi skrip Realtime.

Membuat dan mengelola armada

  • CreateFleet— Konfigurasikan dan terapkan GameLift armada sumber daya komputasi Amazon 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 GameLift wilayah Amazon.

  • 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.

Mengatur antrian untuk penempatan sesi permainan

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 GameLift wilayah Amazon.

  • DescribeAlias— Mengambil informasi tentang alias yang ada.

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

  • DeleteAlias— Hapus alias dari wilayah tersebut.

  • ResolveAlias— Dapatkan ID armada yang ditunjuk alias tertentu.

Connect 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 instance dalam armada, termasuk ID instans, alamat IP, lokasi, dan status.

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

Mengatur VPC peering

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

Memulai sesi game dan bergabung dengan pemain

Hubungi operasi ini dari layanan backend untuk memulai sesi permainan baru, mendapatkan informasi tentang sesi permainan yang ada, dan bergabung dengan pemain ke sesi permainan. Operasi ini untuk digunakan dengan server game khusus yang di-host di Amazon GameLift. Jika Anda menggunakan Realtime Servers, kelola sesi game menggunakan Referensi klien Realtime Server API (C #).

  • Mulai sesi permainan baru untuk satu atau lebih pemain.

    • StartGameSessionPlacement— Minta Amazon GameLift untuk menemukan sumber daya hosting terbaik yang tersedia dan memulai sesi permainan baru. Ini adalah metode yang disukai untuk membuat sesi game baru. Ini bergantung pada antrean sesi game untuk melacak ketersediaan hosting di beberapa wilayah, dan menggunakan algoritme FleetIQ 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 tempat memulai sesi game, 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— Cadangan slot terbuka untuk beberapa pemain untuk bergabung dengan sesi permainan.

  • Bekerja dengan sesi permainan 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 permainan, untuk satu atau lebih sesi permainan.

    • 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 permainan.