Menguji integrasi Anda menggunakan Amazon GameLift Local

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

Mulai server game Anda.

Mulai server game GameLift terintegrasi Amazon 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 Local. Ini berarti server game Anda berhasil menginisialisasi Amazon GameLift Server SDK (denganInitSDK()). Ini telah memanggil ProcessReady() dengan jalur log yang ditampilkan dan, jika berhasil, siap untuk meng-host sesi game. Saat server game berjalan, Amazon GameLift 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:

MulaiAWS 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 titik akhir layanan GameLift web Amazon. 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 AWS CLI Jendela prompt perintah, AWS gamelift menghasilkan tanggapan seperti yang didokumentasikan di Referensi Perintah AWS CLI.

Buat sesi permainan.

DenganAWS CLI, kirimkan permintaan CreateGameSession(). 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 Local telah mengirim onStartGameSession callback 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 merespons dengan objek sesi game 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 berubah, 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
    }
}

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

Mulai server game Anda.

Mulai server game GameLift terintegrasi Amazon Anda secara lokal. Lihat Menguji server game untuk detail lebih lanjut tentang log pesan.

Konfigurasikan klien game Anda untuk Lokal dan mulailah.

Untuk menggunakan klien game Anda dengan layanan Amazon GameLift Local, Anda harus membuat perubahan berikut pada pengaturan klien game Anda, seperti yang dijelaskan dalamSiapkan Amazon GameLift di layanan backend:

Di jendela prompt perintah lokal, setelah Anda memulai klien game, pesan log harus menunjukkan bahwa ia telah menginisialisasi GameLiftClient dan berhasil dikomunikasikan dengan layanan AmazonGameLift.

Uji panggilan klien game ke GameLift layanan Amazon.

Verifikasi bahwa klien game Anda berhasil membuat salah satu atau semua panggilan API berikut:

Di jendela prompt perintah Local, hanya panggilan ke CreateGameSession() yang menghasilkan log olah pesan. Pesan log menunjukkan saat Amazon GameLift Local meminta server game Anda untuk memulai sesi permainan (onStartGameSessioncallback) dan berhasil ActivateGameSession saat server game Anda memanggilnya. Di jendela AWS CLI, semua panggilan API menghasilkan respons atau pesan kesalahan seperti yang didokumentasikan.

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 memanggil DescribePlayerSessions(), status sesi pemain harus berubah dari Disimpan ke Aktif.

Verifikasi bahwa server game Anda melaporkan status game dan pemain ke GameLift layanan Amazon.

GameLiftAgar Amazon dapat mengelola permintaan pemain dan melaporkan metrik dengan benar, server game Anda harus melaporkan berbagai status kembali ke Amazon. GameLift Verifikasi bahwa Local mencatat peristiwa yang terkait dengan tindakan berikut. Anda mungkin juga ingin menggunakan AWS CLI untuk melacak perubahan status.