Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Siapkan untuk pengembangan berulang dengan Amazon GameLift Servers Anywhere
Amazon GameLift Serversmenyediakan alat dan solusi untuk membantu Anda menyiapkan lingkungan pengujian yang dihosting untuk digunakan selama pengembangan game. Dengan alat ini, Anda dapat menciptakan lingkungan yang mencerminkan pengalaman pemain dunia nyata dari hosting terkelola Amazon GameLift Servers dan mendukung proses pengembangan yang cepat dan berulang.
Dengan lingkungan pengujian terpisah, Anda menghapus overhead armada Amazon GameLift Servers terkelola selama pengujian. Anda tidak perlu lagi mengunggah setiap iterasi build server game baru, membuat armada baru untuk itu, dan kemudian menunggu 15\$1 menit untuk mengaktifkannya. Sebagai gantinya, Anda dapat membuat build baru, memperbarui armada pengujian dengan cepat dengan build baru, memulainya, dan memulai pengujian.
Menggunakan armada Amazon GameLift Servers Anywhere, Anda dapat mengatur lingkungan pengujian menggunakan perangkat lokal, seperti workstation pengembangan Anda. Anda juga dapat menyiapkan lingkungan pengujian menggunakan sumber daya hosting berbasis cloud.
Siapkan lingkungan pengujian Anywhere untuk mengembangkan dan menguji berbagai skenario, termasuk ini:
+ Uji integrasi server game Anda dengan SDK Amazon GameLift Servers server. Anda dapat menguji bahkan tanpa klien game yang berfungsi dengan menggunakan panggilan AWS CLI untuk memulai sesi permainan baru dan melacak acara sesi game.
+ Uji interaksi antara klien game Anda, layanan backend, dan Amazon GameLift Servers layanan saat Anda mengembangkan komponen untuk game Anda. Sempurnakan pengalaman pemain untuk bergabung dengan game.
+ Bereksperimenlah dengan desain FlexMatch mak comblang Anda. Cobalah variasi set aturan dan implementasi fitur perjodohan lainnya. Siapkan dan uji isi ulang perjodohan.
+ Cobalah fitur Amazon GameLift Servers hosting lainnya, seperti pengaturan konfigurasi runtime (dengan Amazon GameLift Servers Agen) untuk manajemen siklus hidup server game.
+ Bangun, uji, dan ulangi dengan cepat untuk memvalidasi semua aspek pengalaman pemain game Anda, termasuk interaksi multipemain, di lingkungan langsung yang dihosting.
Kemudian, saat Anda mempersiapkan game untuk diluncurkan, Anda akan ingin menambahkan armada Amazon GameLift Servers terkelola untuk menyempurnakan konfigurasi hosting Anda dan menguji skenario tambahan, termasuk yang berikut ini:
+ Bereksperimenlah dengan dan uji desain antrian sesi permainan, termasuk penggunaan armada multi-lokasi, armada Spot dan On-Demand, dan beberapa jenis instans.
+ Cobalah opsi penempatan sesi game dengan armada terkelola, termasuk penggunaan kebijakan latensi opsional dan pengaturan prioritas armada.
+ Konfigurasikan penskalaan kapasitas untuk memenuhi permintaan pemain, menggunakan opsi penskalaan otomatis atau manual.
+ Siapkan AWS CloudFormation dengan armada Amazon GameLift Servers terkelola untuk mengelola sumber daya hosting Anda dalam jangka panjang.
**Alat Pembaruan Bangun Cepat (hanya untuk pengembangan)**
Dengan EC2 armada terkelola, untuk menerapkan pembaruan build server game, Anda perlu mengunggah setiap build baru Amazon GameLift Servers dan membuat armada baru untuknya.
Fast Build Update Tool memungkinkan Anda dapat melewati langkah-langkah ini selama pengembangan, menghemat waktu dan memungkinkan iterasi pengembangan yang lebih cepat. Dengan alat ini, Anda dapat dengan cepat memperbarui file build game Anda di semua komputasi dalam armada yang ada. Alat ini memiliki beberapa opsi; Anda dapat mengganti seluruh game build atau mengubah 6 file tertentu, dan Anda dapat mengelola cara memulai ulang proses server game setelah pembaruan. Anda juga dapat menggunakannya untuk memperbarui komputasi individu dalam armada.
Untuk mendapatkan Fast Build Update Tool dan mempelajari lebih lanjut tentang cara menggunakannya, kunjungi repo Amazon GameLift Servers Toolkit untuk The [Fast Build Update Tool](https://github.com/aws/amazon-gamelift-toolkit/tree/main/fast-build-update-tool) di Github.
**Topics**
+ [Membangun lingkungan pengujian berbasis cloud](integration-dev-iteration-cloud.md)
+ [Siapkan pengujian lokal dengan Amazon GameLift Servers Anywhere](integration-testing.md)
+ [Uji integrasi Anda menggunakan Amazon GameLift Servers Lokal](integration-testing-local.md)
# Membangun lingkungan pengujian berbasis cloud
**catatan**
Topik ini mencakup pengujian berulang untuk game yang terintegrasi dengan SDK server untuk Amazon GameLift Servers versi 5.x. Jika game Anda menggunakan server SDK versi 4.x atau yang lebih lama, lihat. [Uji integrasi Anda menggunakan Amazon GameLift Servers Lokal](integration-testing-local.md)
Gunakan armada Amazon GameLift Servers Anywhere untuk membangun dan menguji komponen game secara berulang di lingkungan yang dihosting berbasis cloud. Buat armada Anywhere dengan sumber daya hosting dan koneksi ke Amazon GameLift Servers layanan, jalankan server game Anda di dalamnya, dan uji fungsionalitas game sesuai kebutuhan.
**Menyebarkan armada Anywhere dengan Agen Amazon GameLift Servers**
Jika build server game terintegrasi dengan Amazon GameLift Servers SDK 5.x atau versi lebih baru, Anda dapat menerapkannya ke armada Anywhere berbasis cloud dengan Agen. Amazon GameLift Servers Agen adalah proses latar belakang yang mengelola siklus hidup server game dan tugas lain pada setiap komputasi dalam armada. Tugas-tugas ini termasuk mendaftarkan komputasi dengan armada Anywhere, memperoleh token otentikasi, dan proses server starting/stopping game berdasarkan serangkaian instruksi. Agen dikendalikan oleh konfigurasi runtime armada, yang dapat Anda perbarui kapan saja selama masa pakai armada. (Agen secara otomatis dikerahkan ke armada EC2 yang dikelola.) Untuk informasi selengkapnya dan mengunduh Agen, lihat [Amazon GameLift Servers GitHubrepositori](https://github.com/aws/amazon-gamelift-agent).
## Siapkan pengujian berulang dengan Amazon EC2
Gunakan alur kerja terpandu dalam [solusi Amazon GameLift Servers toolkit]( https://github.com/aws/amazon-gamelift-toolkit/tree/main/development-instance-with-amazon-gamelift-anywhere-and-gamelift-agent) ini untuk menyiapkan lingkungan hosting berbasis cloud yang mencerminkan pengalaman hosting terkelola. Amazon GameLift Servers
GitHub Repositori menyediakan serangkaian skrip yang mengotomatiskan sebagian besar proses untuk menyiapkan lingkungan pengujian dengan Amazon GameLift Servers Anywhere dan Agent. Amazon GameLift Servers Ini juga memberikan panduan untuk memperbarui lingkungan setiap kali Anda memiliki server game baru yang dibangun untuk diuji. Anda dapat menjalankan satu skrip yang menyebarkan lingkungan pengujian dengan contoh pembuatan server game, atau Anda dapat menelusuri setiap langkah untuk mengaturnya dengan build server game Anda sendiri.
Dalam alur kerja ini, Anda akan bekerja sepenuhnya di Konsol Manajemen AWS, menggunakan AWS CloudShell untuk menjalankan skrip dan menyelesaikan tugas baris perintah.
**catatan**
Untuk tugas-tugas dalam tutorial ini, Anda memerlukan pengguna AWS akun dengan izin untuk layanan berikut:Amazon GameLift Servers,, Amazon S3 AWS CloudShell,, Amazon EC2 AWS Systems Manager, dan. AWS Identity and Access Management Pengguna dengan akses tingkat admin ke AWS akun sudah memiliki izin yang diperlukan.
Alur kerja mencakup tugas-tugas berikut:
+ **Package build server game untukAmazon GameLift Servers.**Alur kerja menyediakan skrip untuk membangun contoh server game C\$1\$1, yang telah terintegrasi dengan SDK server untuk Amazon GameLift Servers versi 5.x dan siap untuk hosting. Atau, Anda dapat bekerja dengan proyek game Anda sendiri jika Anda telah menyelesaikan integrasi.
+ **Siapkan bucket Amazon Simple Storage Service untuk menyimpan build dan dependensi server game.** Saat Anda menghasilkan versi baru dari build game Anda, Anda dapat menyimpannya di S3 dan menggunakan skrip untuk memperbarui armada Anywhere untuk pengujian game.
+ **Dapatkan dan bangun Amazon GameLift Servers agen.** Agen mengelola proses server game pada sumber daya hosting berdasarkan konfigurasi Anda. Ini menggunakan logika yang sama dan berperilaku identik dengan hosting EC2 yang Amazon GameLift Servers dikelola.
+ **Siapkan armada Anywhere untuk sumber daya hosting Anda.** Dengan armada Anywhere Anda dapat menggunakan Amazon GameLift Servers layanan untuk hosting sumber daya yang tidak dikelola olehAmazon GameLift Servers. Pada langkah ini, Anda juga akan mengonfigurasi konfigurasi runtime, yang menginstruksikan Amazon GameLift Servers Agen kapan dan bagaimana memulai proses server game.
+ **Siapkan instans Amazon EC2.** Ini adalah lingkungan pengujian Anda untuk pengujian berulang. Jauh lebih cepat untuk menggunakan instans EC2 standar daripada instance yang dikelola Amazon GameLift Servers sepenuhnya (yang dioptimalkan untuk penggunaan tingkat produksi). Dengan instans EC2 standar, Anda dapat dengan cepat dan terus memperbarui server game sesuai kebutuhan.
+ **Terapkan build dan Amazon GameLift Servers Agen server game Anda ke instans Amazon EC2.**Alur kerja menyediakan skrip yang mendapatkan versi terbaru dari build game Anda dan semua dependensi dan menginstalnya di instans EC2 Anda. Dalam alur kerja ini, dependensi mencakup Amazon GameLift Servers Agen dan Agen. CloudWatch
+ **Mulai Amazon GameLift Servers Agen.** Setelah diinstal, Agen secara otomatis memulai dan mulai menjalankan instruksi. Ini termasuk:
+ Daftarkan instans EC2 sebagai komputasi di armada Amazon GameLift Servers Anywhere.
+ Buat WebSocket koneksi dengan Amazon GameLift Servers layanan dan dapatkan konfigurasi runtime terbaru.
+ Mulai proses server game berdasarkan instruksi dalam konfigurasi runtime. Dalam alur kerja ini, Agen diinstruksikan untuk memulai satu proses server game yang dapat dieksekusi.
+ **Uji skenario permainan Anda.** Dengan pengaturan lingkungan pengujian dan build server game terbaru Anda diinstal, Anda dapat memulai pengujian. Alur kerja berjalan melalui beberapa langkah untuk pengujian termasuk memulai sesi permainan. Akses log server CloudWatch game untuk melacak kemajuan saat sesi permainan dimulai dan bersiap untuk menerima pemain.
Saat Anda mengembangkan komponen game Anda, termasuk klien game dan layanan backend sisi klien, Anda dapat memasukkannya ke dalam skenario pengujian Anda. Gunakan klien game untuk meminta sesi permainan, mengambil info koneksi dari Amazon GameLift Servers layanan, dan kemudian terhubung langsung ke sesi permainan.
+ **Terapkan build server game baru dan ulangi tes.** Saat Anda mengembangkan game Anda, Anda dapat menghasilkan build server game baru, lalu dengan cepat menerapkannya ke lingkungan pengujian EC2 untuk pengujian. Unggah ke bucket Amazon S3 lalu gunakan skrip alur kerja untuk memperbarui lingkungan pengujian.
## Transisi game Anda ke armada Amazon GameLift Servers terkelola
Setelah Anda menyelesaikan pengujian pengembangan dan Anda siap untuk mempersiapkan peluncuran, ini adalah saat yang tepat untuk beralih ke armada Amazon GameLift Servers terkelola. Gunakan armada terkelola untuk menyempurnakan dan menguji sumber daya hosting game Anda. Terapkan solusi penempatan sesi permainan Anda (antrian dan mak comblang), pilih perangkat keras hosting optimal (termasuk armada Spot) dan lokasi, dan pilih strategi untuk kapasitas penskalaan. Anda mungkin juga ingin mulai menggunakan AWS CloudFormation untuk mengelola siklus hidup semua sumber daya hosting game Anda dengan lebih efisien, termasuk armada, antrian, dan mak comblang.
Dibutuhkan upaya minimal untuk transisi dari armada uji Anywhere berbasis cloud ke armada Amazon GameLift Servers terkelola. Anda tidak perlu mengubah kode permainan apa pun, dan Anda dapat menggunakan kembali antrian dan mak comblang yang sama. Lakukan tugas-tugas berikut:
+ **Buat sumber daya Amazon GameLift Servers build.** Dengan armada pengujian Anywhere, Anda harus menerapkan build dan dependensi server game secara manual ke setiap komputasi armada. Dengan armada terkelola, unggah paket build game AndaAmazon GameLift Servers, yang secara otomatis menerapkannya ke semua komputasi armada. Lihat [Buat build server game untuk Amazon GameLift Servers](gamelift-build-cli-uploading.md) detail tentang mengemas file build game Anda dan membuat sumber daya build dengan file di bucket Amazon S3.
+ **Buat armada yang dikelola.** Buat armada menggunakan konsol atau AWS CLI, menentukan armada terkelola EC2. Jenis armada ini memerlukan pengaturan konfigurasi tambahan, termasuk menentukan sumber daya build dan tipe instance. Anda dapat menggunakan konfigurasi runtime yang sama untuk mengelola siklus hidup server game pada setiap komputasi armada. Lihat [Buat EC2 armada Amazon GameLift Servers terkelola](fleets-creating.md) detail tentang membuat armada terkelola.
+ **Alias armada pengalihan (opsional).** Jika Anda mengatur alias untuk digunakan dengan armada Anywhere Anda, Anda dapat menggunakan kembali alias yang sama untuk armada terkelola Anda. Lihat [Buat sebuah Amazon GameLift Servers alias](aliases-creating.md) detail tentang membuat atau memperbarui alias.
# Siapkan pengujian lokal dengan Amazon GameLift Servers Anywhere
**catatan**
Topik ini mencakup pengujian lokal untuk game yang terintegrasi dengan SDK server untuk Amazon GameLift Servers versi 5.x. Jika game Anda menggunakan server SDK versi 4.x atau yang lebih lama, lihat. [Uji integrasi Anda menggunakan Amazon GameLift Servers Lokal](integration-testing-local.md)
Gunakan armada Amazon GameLift Servers Anywhere dan perangkat keras Anda sendiri untuk membangun dan menguji komponen game Anda secara berulang di lingkungan yang dihosting yang disimulasikan. Siapkan armada Anywhere dan daftarkan perangkat lokal untuk membuat koneksi ke Amazon GameLift Servers layanan. Instal build server game Anda ke perangkat, mulai proses server game, dan uji fungsionalitas game sesuai kebutuhan. Anda dapat memperbarui build server game sesering yang diperlukan untuk menguji setiap iterasi build baru.
Dengan armada Anywhere, Anda dapat menguji menggunakan AWS CLI atau dengan skrip pengujian. Jika Anda telah mengintegrasikan klien gameAmazon GameLift Servers, Anda dapat menjalankan klien di perangkat lokal yang sama atau di perangkat lain.
Menguji secara lokal dengan armada Anywhere sangat berguna untuk menguji integrasi server game Anda. Amazon GameLift Servers Anda memiliki visibilitas penuh ke semua aktivitas hosting di mesin lokal, serta peristiwa dan data logging.
**catatan**
Apakah Anda menggunakan Amazon GameLift Servers plugin untuk Unreal Engine atau Unity? Alat-alat ini mencakup alur kerja terpandu untuk menyiapkan pengujian lokal dengan armada Anywhere. Ikuti dokumentasi untuk [Plugin untuk Unity: Siapkan pengujian lokal dengan Amazon GameLift Servers Anywhere](unity-plug-in-anywhere.md) atau[Plugin untuk Unreal: Tuan rumah game Anda secara lokal dengan Anywhere Amazon GameLift Servers](unreal-plugin-anywhere.md).
**Topics**
+ [Siapkan armada Anywhere lokal](#integration-testing-anywhere-fleet)
+ [Perbarui dan instal server game Anda](#integration-testing-dev)
+ [Uji aktivitas sesi permainan](#integration-testing-test)
+ [Iterasi di server game Anda](#fleet-anywhere-iteration)
+ [Transisi game Anda ke armada Amazon GameLift Servers terkelola](#fleet-anywhere-transition)
## Siapkan armada Anywhere lokal
Ikuti langkah-langkah ini untuk membuat armada Anywhere untuk workstation lokal Anda. Untuk petunjuk terperinci menggunakan AWS CLI atau Konsol Manajemen AWS forAmazon GameLift Servers, lihat. [Buat sebuah Amazon GameLift Servers Armada di mana saja](fleets-creating-anywhere.md)
**Untuk membuat armada Anywhere**
1. **Buat lokasi khusus untuk workstation lokal Anda. (AWS CLI atau konsol).** Lokasi khusus hanyalah label untuk sumber daya komputasi yang Anda rencanakan untuk disertakan dalam armada Anywhere Anda. Nama lokasi khusus harus dimulai dengan`custom-`. Sebagai contoh: `custom-my_laptop`. Lihat [Buat lokasi kustom](fleets-creating-anywhere.md#fleet-anywhere-location).
1. **Buat armada Anywhere (AWS CLI atau konsol).** Pada langkah ini, buat sumber daya armada dengan lokasi khusus untuk workstation lokal Anda. Lihat [Buat armada Anywhere](fleets-creating-anywhere.md#fleet-anywhere-create).
Catat ID armada baru atau nilai ARN. Anda akan membutuhkan nilai ini untuk langkah selanjutnya.
1. **Daftarkan workstation lokal Anda sebagai komputasi armada (hanya AWS CLI).** Armada Anywhere harus memiliki setidaknya satu sumber daya komputasi untuk meng-host server game Anda. Lihat [Tambahkan komputasi ke armada](fleets-creating-anywhere.md#fleet-anywhere-compute). Untuk menambahkan komputasi ke armada, Anda memerlukan informasi berikut:
+ Nama komputasi. Setiap komputasi dalam armada harus memiliki nama yang unik.
+ Pengidentifikasi armada Anywhere. Anda dapat menggunakan salah satu `FleetID` atau`FleetArn`.
+ Info koneksi komputasi. Tentukan salah satu dari `IpAddress` atau `DnsName`. Ini adalah bagaimana Amazon GameLift Servers dan klien game akan terhubung ke server game.
+ Lokasi khusus di armada Anywhere.
Catat nilai `GameLiftServiceSdkEndpoint` pengembalian. Anda akan membutuhkan nilai ini saat memperbarui server game agar berjalan di armada Anywhere.
## Perbarui dan instal server game Anda
Tugas ini mengasumsikan bahwa Anda telah mengintegrasikan build server game dengan Amazon GameLift Servers server SDK 5.x. Proses integrasi melibatkan penambahan kode ke server game Anda sehingga dapat berinteraksi dengan Amazon GameLift Servers layanan untuk memulai dan mengelola sesi permainan.
Untuk armada Anywhere, Anda perlu mengonfigurasi pengaturan server game tertentu secara manual. Pada armada yang Amazon GameLift Servers dikelola, pengaturan ini dikonfigurasi secara otomatis.
**Untuk mempersiapkan server game Anda untuk armada Anywhere**
1. **Dapatkan token otentikasi.** Server game Anda harus menyertakan token otentikasi dengan setiap komunikasi dengan Amazon GameLift Servers layanan. Amazon GameLift Serverstoken autentikasi berumur pendek dan harus disegarkan secara teratur.
Sebagai praktik terbaik, buat skrip untuk menyelesaikan tugas-tugas berikut:
+ Panggil tindakan AWS CLI. `get-compute-auth-token`
+ Simpan nilai token yang dikembalikan di mana proses server game dapat mengambilnya, seperti dalam variabel lingkungan pada komputasi lokal.
Instal skrip dengan server game Anda di komputasi. Atur skrip untuk dijalankan sebelum memulai proses server game pertama. Saat proses server game aktif, jalankan skrip secara teratur untuk mempertahankan token autentikasi yang valid. Semua proses server game pada komputasi dapat menggunakan token autentikasi yang sama.
1. **Perbarui kode server Amazon GameLift Servers game Anda.** Saat Anda mengintegrasikan kode server game Anda dengan SDK server untukAmazon GameLift Servers, Anda menambahkan panggilan ke tindakan`InitSdk()`. Ketika server game berjalan pada armada Anywhere, panggilan ini memerlukan parameter server tambahan. Untuk informasi selengkapnya, lihat [Inisialisasi proses server](gamelift-sdk-server-api.md#gamelift-sdk-server-initialize) dan [Server SDK 5.x untuk Amazon GameLift Servers](reference-serversdk.md) untuk bahasa pengembangan Anda. Parameter server adalah:
+ `webSocketUrl`— Tetapkan parameter ini ke `GameLiftServiceSdkEndpoint` nilai yang dikembalikan saat Anda mendaftarkan komputasi dengan armada.
+ `hostId`— Setel parameter ini ke nama komputasi yang Anda tentukan saat Anda mendaftarkan komputasi dengan armada Anywhere.
+ `fleetId`— Atur parameter ini ke ID armada Anywhere.
+ `authToken`— Setel parameter ini ke token yang dikembalikan sebagai tanggapan atas permintaan untuk mengambil token otentikaiton untuk komputasi.
+ `processId`— Tetapkan parameter ini untuk mengidentifikasi proses server game yang berjalan pada komputasi lokal. Setiap proses server game bersamaan harus memiliki ID proses yang unik.
Nilai parameter server yang digunakan setiap proses server game harus spesifik untuk komputasi armada Anywhere tempat proses berjalan. Untuk detail tentang cara mendapatkan nilai yang sesuai untuk komputasi, lihat[Tambahkan komputasi ke armada](fleets-creating-anywhere.md#fleet-anywhere-compute). Sebagai praktik terbaik, atur`webSocketUrl`,, `hostId``fleetId`, dan `authToken` sebagai variabel lingkungan pada komputasi lokal. Semua proses server yang berjalan pada komputasi akan menggunakan nilai-nilai ini.
1. Instal server game yang dibangun di komputasi lokal. Sertakan semua dependensi yang diperlukan untuk menjalankan server game.
1. Mulai satu atau beberapa proses server game yang berjalan pada komputasi lokal. Saat proses server game memanggil aksi SDK server`ProcessReady()`, prosesnya siap untuk meng-host sesi game.
## Uji aktivitas sesi permainan
Uji integrasi server game Anda dengan bekerja dengan sesi permainan. Jika Anda tidak memiliki klien game yang terintegrasi dengan Amazon GameLift Servers fungsionalitas, Anda dapat menggunakan AWS CLI untuk memulai sesi permainan. Coba skenario berikut:
+ **Buat sesi permainan.** [create-game-session ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/create-game-session.html)Perintah panggilan (atau operasi [ CreateGameSession](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_CreateGameSession.html)API). Tentukan ID armada Anywhere dan lokasi kustom Anda. Panggilan ini mengembalikan pengenal unik untuk sesi permainan baru.
+ **Periksa status sesi permainan.**Panggil [describe-game-sessions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-game-sessions.html)perintah (atau tindakan [DescribeGameSessions](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_DescribeGameSessions.html)API). Tentukan ID sesi permainan. Panggilan ini mengembalikan informasi sesi permainan terperinci, termasuk status sesi permainan. Sesi permainan dalam status Aktif siap untuk pemain terhubung. Untuk mendapatkan daftar semua sesi game untuk armada, panggil [list-game-sessions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/list-game-sessions.html)perintah (atau aksi [ListGameSessions](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_ListGameSessions.html)API).
+ **Connect ke sesi permainan.** Jika klien game Anda memiliki kemampuan untuk bergabung dengan sesi permainan, gunakan informasi koneksi yang termasuk dalam informasi sesi permainan.
## Iterasi di server game Anda
Anda dapat menggunakan Anywhere armada dan komputasi yang sama untuk menguji versi lain dari build server game Anda.
1. **Bersihkan yang sudah ada`GameSession`.** Jika proses server game mogok atau tidak mau menelepon`ProcessEnding()`, Amazon GameLift Servers bersihkan `GameSession` setelah server game berhenti mengirim pemeriksaan kesehatan.
1. **Hasilkan build server game baru.** Buat perubahan pada server game Anda dan paketkan build yang direvisi.
1. **Perbarui build server game di komputasi lokal Anda.** Armada Anywhere Anda sebelumnya masih aktif dan laptop Anda masih terdaftar sebagai sumber daya komputasi di armada.
1. **Dapatkan token otorisasi yang diperbarui.** Panggil perintah [get-compute-auth-token](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/get-compute-auth-token.html)CLI dan simpan token pada komputasi lokal.
1. **Mulai satu atau beberapa proses server game yang berjalan pada komputasi lokal.** Ketika server game memproses panggilan`ProcessReady()`, itu siap digunakan untuk pengujian.
## Transisi game Anda ke armada Amazon GameLift Servers terkelola
Setelah Anda menyelesaikan pengujian pengembangan dan Anda siap untuk mempersiapkan peluncuran, ini adalah saat yang tepat untuk beralih ke armada Amazon GameLift Servers terkelola. Gunakan armada terkelola untuk menyempurnakan dan menguji sumber daya hosting game Anda. Terapkan solusi penempatan sesi permainan Anda (antrian dan mak comblang), pilih perangkat keras hosting optimal (termasuk armada Spot) dan lokasi, dan pilih strategi untuk kapasitas penskalaan. Anda mungkin juga ingin mulai menggunakan AWS CloudFormation untuk mengelola siklus hidup semua sumber daya hosting game Anda dengan lebih efisien, termasuk armada, antrian, dan mak comblang.
Anda perlu membuat beberapa modifikasi kecil untuk transisi dari armada uji Anywhere lokal ke armada Amazon GameLift Servers terkelola. Anda dapat menggunakan kembali antrian dan mak comblang yang sama. Lakukan tugas-tugas berikut:
+ **Ubah panggilan kode server game ke`InitSdk()`.** Hapus parameter server. Untuk armada yang dikelola, Amazon GameLift Servers secara otomatis melacak informasi ini.
+ **Buat sumber daya Amazon GameLift Servers build.** Dengan armada pengujian Anywhere, Anda harus menerapkan build dan dependensi server game secara manual ke setiap komputasi armada. Dengan armada terkelola, Anda membuat dan mengunggah paket build game AndaAmazon GameLift Servers, yang secara otomatis menerapkannya ke semua komputasi armada. Lihat [Buat build server game untuk Amazon GameLift Servers](gamelift-build-cli-uploading.md) detail tentang mengemas file build game Anda dan membuat sumber daya build dengan file di bucket Amazon S3. Jangan sertakan skrip yang mendaftarkan komputasi dan mendapatkan token otentikasi, karena Amazon GameLift Servers secara otomatis menangani tugas ini dengan armada terkelola.
+ **Buat armada yang dikelola.** Buat armada menggunakan konsol atau AWS CLI, menentukan armada terkelola EC2. Jenis armada ini memerlukan pengaturan konfigurasi tambahan, termasuk menentukan sumber daya build dan tipe instance. Anda semua perlu menyiapkan konfigurasi runtime untuk mengelola siklus hidup server game pada setiap komputasi armada. Lihat [Buat EC2 armada Amazon GameLift Servers terkelola](fleets-creating.md) detail tentang membuat armada terkelola.
+ **Alias armada pengalihan (opsional).** Jika Anda mengatur alias untuk digunakan dengan armada Anywhere Anda, Anda dapat menggunakan kembali alias yang sama untuk armada terkelola Anda. Lihat [Buat sebuah Amazon GameLift Servers alias](aliases-creating.md) detail tentang membuat atau memperbarui alias.
# Uji integrasi Anda menggunakan Amazon GameLift Servers Lokal
**catatan**
Topik ini mencakup pengujian untuk game yang terintegrasi dengan SDK server untuk Amazon GameLift Servers versi 3.x dan 4.x saja. Paket SDK server Anda menyertakan versi Amazon GameLift Servers Lokal yang kompatibel. Jika Anda menggunakan SDK server versi 5.x, lihat [Pengujian lokal dengan GameLift Server SDK 5.x untuk pengujian](https://docs.aws.amazon.com/gameliftservers/latest/developerguide/integration-testing-local.html) lokal dengan armada Anywhere. Amazon GameLift Servers Untuk panduan tentang migrasi dari SDK 4.x ke 5.x, lihat [Migrasi](https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-serversdk5-migration.html) ke Server SDK 5.x. GameLift
Gunakan Amazon GameLift Servers Lokal untuk menjalankan versi terbatas dari Amazon GameLift Servers layanan terkelola pada perangkat lokal dan uji integrasi game Anda terhadapnya. Alat ini berguna ketika melakukan pengembangan berulang pada integrasi game Anda. Alternatif—mengunggah setiap build baru Amazon GameLift Servers dan mengonfigurasi armada untuk menghosting game Anda—dapat memakan waktu beberapa atau lebih setiap kali.
Dengan Amazon GameLift Servers Local, Anda dapat memverifikasi hal-hal berikut:
+ Server game Anda terintegrasi dengan benar dengan Server SDK dan berkomunikasi dengan benar dengan Amazon GameLift Servers layanan untuk memulai sesi permainan baru, menerima pemain baru, dan melaporkan kesehatan dan status.
+ Klien game Anda terintegrasi dengan benar dengan AWS SDK untuk Amazon GameLift Servers dan dapat mengambil informasi tentang sesi permainan yang ada, memulai sesi permainan baru, bergabung dengan pemain ke game dan terhubung ke sesi permainan.
Amazon GameLift ServersLokal adalah alat baris perintah yang memulai versi mandiri dari layanan terkelola. Amazon GameLift Servers Amazon GameLift Servers Local juga menyediakan log peristiwa yang berjalan dari inisialisasi proses server, pemeriksaan kesehatan, dan panggilan dan respons API. Amazon GameLift Servers Local mengenali subset tindakan AWS SDK untuk. Amazon GameLift Servers Anda dapat melakukan panggilan dari AWS CLI atau dari klien game Anda. Semua tindakan API dilakukan secara lokal seperti yang mereka lakukan di layanan Amazon GameLift Servers web.
Setiap proses server seharusnya hanya meng-host satu sesi permainan. Sesi permainan adalah executable yang Anda gunakan untuk terhubung ke Amazon GameLift Servers Lokal. Ketika sesi permainan selesai, Anda harus menelepon `GameLiftServerSDK::ProcessEnding` dan kemudian keluar dari proses. Saat menguji secara Amazon GameLift Servers lokal dengan Local, Anda dapat memulai beberapa proses server. Setiap proses akan terhubung ke Amazon GameLift Servers Lokal. Anda kemudian dapat membuat satu sesi permainan untuk setiap proses server. Ketika sesi permainan Anda berakhir, proses server game Anda harus keluar. Anda kemudian harus secara manual memulai proses server lain.
Amazon GameLift Serverslokal mendukung yang berikut APIs:
+ CreateGameSession
+ CreatePlayerSession
+ CreatePlayerSessions
+ DescribeGameSessions
+ DescribePlayerSessions
## Menyiapkan Amazon GameLift Servers lokal
Amazon GameLift Servers[Lokal disediakan sebagai `.jar` file yang dapat dieksekusi yang dibundel dengan Server SDK.](https://aws.amazon.com/gamelift/servers/getting-started/) Ini dapat dijalankan di Windows atau Linux dan digunakan dengan bahasa apa pun yang Amazon GameLift Servers didukung. Untuk SDK versi 4.0.2, Anda dapat mengunduhnya dari rilis [resmi GitHub ](https://github.com/amazon-gamelift/amazon-gamelift-servers-csharp-server-sdk/releases). GameLiftLocalFile.jar disertakan dalam artefak GameLift-CSharp-ServerSDK -4.0.2.zip.
Sebelum menjalankan Local, Anda juga harus memiliki berikut yang diinstal.
+ Sebuah build SDK server untuk Amazon GameLift Servers versi 3.1.5 hingga 4.x.
+ Java 8
## Uji server game
Jika Anda ingin menguji server game Anda saja, Anda dapat menggunakan AWS CLI untuk mensimulasikan panggilan klien game ke layanan Amazon GameLift Servers Lokal. Ini memverifikasi bahwa server game Anda melakukan seperti yang diharapkan dengan berikut ini:
+ Server game diluncurkan dengan benar dan menginisialisasi SDK server untuk. Amazon GameLift Servers
+ Sebagai bagian dari proses peluncuran, server game memberi tahu Amazon GameLift Servers bahwa server siap untuk meng-host sesi game.
+ Server game mengirimkan status kesehatan ke Amazon GameLift Servers setiap menit saat berjalan.
+ Server game menanggapi permintaan untuk memulai sesi game baru.
1. **Mulai Amazon GameLift Servers Lokal.**
Buka jendela command prompt, arahkan ke direktori yang berisi file `GameLiftLocal.jar` dan menjalankannya. Secara default, Local mendengarkan permintaan dari klien game pada port 8080. Untuk menentukan nomor port yang berbeda, gunakan parameter `-p`, seperti yang ditunjukkan dalam contoh berikut:
```
java -jar GameLiftLocal.jar -p 9080
```
Setelah Local dimulai, Anda melihat log yang menunjukkan bahwa dua server Local dimulai, satu mendengarkan untuk server game Anda dan satu mendengarkan untuk klien game Anda atau AWS CLI. Log terus melaporkan aktivitas pada dua server Local, termasuk komunikasi dan dari komponen game Anda.
1. **Mulai server game Anda.**
Mulai server game Amazon GameLift Servers -terintegrasi Anda secara lokal. Anda tidak perlu mengubah titik akhir untuk server game.
Di jendela prompt perintah Lokal, pesan log menunjukkan bahwa server game Anda telah terhubung ke layanan Amazon GameLift Servers Lokal. Ini berarti server game Anda berhasil menginisialisasi SDK server untuk Amazon GameLift Servers (with`InitSDK()`). Ini telah memanggil `ProcessReady()` dengan jalur log yang ditampilkan dan, jika berhasil, siap untuk meng-host sesi game. Saat server game berjalan, Amazon GameLift Servers mencatat setiap laporan status kesehatan dari server game. Contoh log olah pesan berikut menunjukkan server game berhasil terintegrasi:
```
16:50:53,217 INFO || - [SDKListenerImpl] nioEventLoopGroup-3-1 - SDK connected: /127.0.0.1:64247
16:50:53,217 INFO || - [SDKListenerImpl] nioEventLoopGroup-3-1 - SDK pid is 17040, sdkVersion is 3.1.5 and sdkLanguage is CSharp
16:50:53,217 INFO || - [SDKListenerImpl] nioEventLoopGroup-3-1 - NOTE: Only SDK versions 3.1.5 and above are supported in GameLiftLocal!
16:50:53,451 INFO || - [SDKListenerImpl] nioEventLoopGroup-3-1 - onProcessReady received from: /127.0.0.1:64247 and ackRequest requested? true
16:50:53,543 INFO || - [SDKListenerImpl] nioEventLoopGroup-3-1 - onProcessReady data: logPathsToUpload: "C:\\game\\logs"
logPathsToUpload: "C:\\game\\error"
port: 1935
16:50:53,544 INFO || - [HostProcessManager] nioEventLoopGroup-3-1 - Registered new process true, true,
16:50:53,558 INFO || - [SDKListenerImpl] nioEventLoopGroup-3-1 - onReportHealth received from /127.0.0.1:64247 with health status: healthy
```
Kemungkinan kesalahan dan pesan peringatan meliputi berikut ini:
+ Kesalahan: "ProcessReady tidak menemukan proses dengan PID:**\$1 Apakah initSDK () dipanggil?”
+ Peringatan: “Status proses sudah ada untuk proses dengan PID:**\$1 Apakah ProcessReady (...) dipanggil lebih dari sekali?”
1. **Mulai AWS CLI.**
Setelah server game Anda berhasil memanggil `ProcessReady()`, Anda dapat mulai melakukan panggilan klien. Buka jendela prompt perintah lain dan mulai AWS CLI alat. Secara AWS CLI default menggunakan endpoint layanan Amazon GameLift Servers web. Anda harus mengganti ini dengan titik akhir Local di setiap permintaan menggunakan parameter `--endpoint-url`, seperti yang ditunjukkan dalam permintaan contoh berikut.
```
AWS gamelift describe-game-sessions --endpoint-url http://localhost:9080 --fleet-id fleet-123
```
Di jendela AWS CLI command prompt, `AWS gamelift` perintah menghasilkan respons seperti yang didokumentasikan dalam [AWS CLI Command Reference](https://docs.aws.amazon.com/cli/latest/reference/gamelift).
1. **Buat sesi permainan.**
Dengan AWS CLI, kirimkan permintaan [CreateGameSession()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_CreateGameSession.html). Permintaan harus mengikuti sintaks yang diharapkan. Untuk Local, parameter `FleetId` dapat diatur ke string yang valid()`^fleet-\S+`.
```
AWS gamelift create-game-session --endpoint-url http://localhost:9080 --maximum-player-session-count 2 --fleet-id
fleet-1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d
```
Di jendela prompt perintah Lokal, pesan log menunjukkan bahwa Amazon GameLift Servers Local telah mengirim `onStartGameSession` panggilan balik server game Anda. Jika sesi game berhasil dibuat, server game Anda merespon dengan menerapkan `ActivateGameSession`.
```
13:57:36,129 INFO || - [SDKInvokerImpl]
Thread-2 - Finished sending event to game server to start a game session:
arn:aws:gamelift:local::gamesession/fleet-1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d/gsess-ab423a4b-b827-4765-aea2-54b3fa0818b6.
Waiting for ack response.13:57:36,143 INFO || - [SDKInvokerImpl]
Thread-2 - Received ack response: true13:57:36,144 INFO || -
[CreateGameSessionDispatcher] Thread-2 - GameSession with id:
arn:aws:gamelift:local::gamesession/fleet-1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d/gsess-ab423a4b-b827-4765-aea2-54b3fa0818b6
created13:57:36,227 INFO || - [SDKListenerImpl]
nioEventLoopGroup-3-1 - onGameSessionActivate received from: /127.0.0.1:60020 and ackRequest
requested? true13:57:36,230 INFO || - [SDKListenerImpl]
nioEventLoopGroup-3-1 - onGameSessionActivate data: gameSessionId:
"arn:aws:gamelift:local::gamesession/fleet-1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d/gsess-abcdef12-3456-7890-abcd-ef1234567890"
```
Di AWS CLI jendela, Amazon GameLift Servers merespons dengan objek sesi permainan termasuk ID sesi game. Perhatikan bahwa status sesi game baru adalah Mengaktifkan. Status berubah menjadi Aktif setelah server game Anda dipanggil. ActivateGameSession Jika Anda ingin melihat status yang diubah, gunakan AWS CLI untuk memanggil`DescribeGameSessions()`.
```
{
"GameSession": {
"Status": "ACTIVATING",
"MaximumPlayerSessionCount": 2,
"FleetId": "fleet-1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
"GameSessionId": "arn:aws:gamelift:local::gamesession/fleet-1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d/gsess-abcdef12-3456-7890-abcd-ef1234567890",
"IpAddress": "127.0.0.1",
"Port": 1935
}
}
```
## Uji server game dan klien
Untuk memeriksa integrasi game lengkap Anda, termasuk menghubungkan pemain ke game, Anda dapat menjalankan server game dan klien secara Local. Ini memungkinkan Anda untuk menguji panggilan terprogram dari klien game Anda ke Amazon GameLift Servers Lokal. Anda dapat memverifikasi tindakan berikut:
+ Klien game berhasil membuat permintaan AWS SDK ke layanan Amazon GameLift Servers Lokal, termasuk membuat sesi game, mengambil informasi tentang sesi game yang ada, dan membuat sesi pemain.
+ Server game betul memvalidasi pemain ketika mereka mencoba untuk bergabung dengan sesi game. Untuk pemain divalidasi, server game dapat mengambil data pemain (jika diimplementasikan).
+ Server game melaporkan connection terputus ketika pemain meninggalkan game.
+ Laporan server game mengakhiri sesi game.
1. **Mulai Amazon GameLift Servers Lokal.**
Buka jendela command prompt, arahkan ke direktori yang berisi file `GameLiftLocal.jar` dan menjalankannya. Secara default, Local mendengarkan permintaan dari klien game pada port 8080. Untuk menentukan nomor port yang berbeda, gunakan parameter `-p`, seperti yang ditunjukkan dalam contoh berikut.
```
./gamelift-local -p 9080
```
Setelah Local dimulai, Anda melihat log yang menunjukkan bahwa dua server Local dimulai, satu mendengarkan server game Anda dan satu mendengarkan untuk klien game Anda atau AWS CLI.
1. **Mulai server game Anda.**
Mulai server game Amazon GameLift Servers -terintegrasi Anda secara lokal. Lihat [Uji server game](#integration-testing-local-server) untuk detail lebih lanjut tentang log pesan.
1. **Konfigurasikan klien game Anda untuk Lokal dan mulai.**
Untuk menggunakan klien game Anda dengan layanan Amazon GameLift Servers Lokal, Anda harus membuat perubahan berikut pada pengaturan klien game Anda, seperti yang dijelaskan dalam[Siapkan Amazon GameLift Servers API](gamelift-sdk-client-api.md#gamelift-sdk-client-api-initialize):
+ Mengubah `ClientConfiguration` objek untuk menunjuk ke titik akhir Local Anda, seperti `http://localhost:9080`.
+ Atur nilai ID armada target. Untuk Local, Anda tidak memerlukan ID armada nyata; atur armada target ke string yang valid (`^fleet-\S+`), seperti `fleet-1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d`.
+ Tetapkan AWS kredensil. Untuk Local, Anda tidak perlu kredensial nyata AWS ; Anda dapat mengatur access key dan kunci rahasia ke string apapun.
Di jendela prompt perintah Lokal, setelah Anda memulai klien game, pesan log harus menunjukkan bahwa ia telah menginisialisasi `GameLiftClient` dan berhasil dikomunikasikan dengan layanan. Amazon GameLift Servers
1. **Uji panggilan klien game ke Amazon GameLift Servers layanan.**
Verifikasi bahwa klien game Anda berhasil membuat salah satu atau semua panggilan API berikut:
+ [CreateGameSession()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_CreateGameSession.html)
+ [DescribeGameSessions()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_DescribeGameSessions.html)
+ [CreatePlayerSession()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_CreatePlayerSession.html)
+ [CreatePlayerSessions()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_CreatePlayerSessions.html)
+ [DescribePlayerSessions()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_DescribePlayerSessions.html)
Di jendela prompt perintah Local, hanya panggilan ke `CreateGameSession()` yang menghasilkan log olah pesan. Pesan log ditampilkan ketika Amazon GameLift Servers Local meminta server game Anda untuk memulai sesi permainan (`onStartGameSession`callback) dan berhasil `ActivateGameSession` ketika server game Anda memanggilnya. Di jendela AWS CLI , semua panggilan API menghasilkan respons atau pesan kesalahan seperti yang didokumentasikan.
1. **Verifikasi bahwa server game Anda memvalidasi koneksi pemain baru.**
Setelah membuat sesi game dan sesi pemain, buat connection langsung ke sesi game.
Di jendela prompt perintah Local, log olah pesan harus menunjukkan bahwa server game telah mengirim `AcceptPlayerSession()` untuk memvalidasi connection pemain baru. Jika Anda menggunakan AWS CLI to call`DescribePlayerSessions()`, status sesi pemain harus berubah dari Reserved ke Active.
1. **Verifikasi bahwa server game Anda melaporkan status game dan pemain ke Amazon GameLift Servers layanan.**
Amazon GameLift ServersUntuk mengelola permintaan pemain dan melaporkan metrik dengan benar, server game Anda harus melaporkan berbagai status kembali. Amazon GameLift Servers Verifikasi bahwa Local mencatat peristiwa yang terkait dengan tindakan berikut. Anda mungkin juga ingin menggunakan AWS CLI untuk melacak perubahan status.
+ **Pemain terputus dari sesi permainan** - Pesan log Amazon GameLift Servers lokal harus menunjukkan bahwa server game Anda memanggil`RemovePlayerSession()`. Sebuah AWS CLI panggilan ke `DescribePlayerSessions()` harus mencerminkan perubahan status dari `Active` ke `Completed`. Anda juga dapat menghubungi `DescribeGameSessions()` untuk memeriksa bahwa jumlah pemain sesi game saat ini berkurang satu per satu.
+ **Sesi permainan berakhir** - Pesan log Amazon GameLift Servers lokal harus menunjukkan bahwa server game Anda memanggil`TerminateGameSession()`.
**catatan**
Bimbingan sebelumnya adalah memanggil `TerminateGameSession()` saat mengakhiri sesi game. Metode ini tidak digunakan lagi dengan Amazon GameLift Servers Server SDK v4.0.1. Lihat [Mengakhiri sesi game](gamelift-sdk-server-api.md#gamelift-sdk-server-shutdownsession).
+ **Proses server dihentikan** - Pesan log Amazon GameLift Servers lokal harus menunjukkan bahwa server game Anda memanggil`ProcessEnding()`. AWS CLI Panggilan ke `DescribeGameSessions()` harus mencerminkan perubahan status dari `Active` ke `Terminated` (atau`Terminating`).
## Variasi dengan lokal
Saat menggunakan Amazon GameLift Servers Lokal, ingatlah hal berikut:
+ Berbeda dengan layanan Amazon GameLift Servers web, Local tidak melacak status kesehatan server dan memulai `onProcessTerminate` callback. Local hanya berhenti mencatat laporan kondisi untuk server game.
+ Untuk panggilan ke AWS SDK, armada tidak IDs divalidasi, dan dapat berupa nilai string apa pun yang memenuhi persyaratan parameter ()`^fleet-\S+`.
+ Sesi permainan IDs yang dibuat dengan Lokal memiliki struktur yang berbeda. Mereka termasuk string `local`, seperti yang ditunjukkan di sini:
```
arn:aws:gamelift:local::gamesession/fleet-123/gsess-56961f8e-db9c-4173-97e7-270b82f0daa6
```