Uji integrasi Anda menggunakan GameLift Server Amazon Lokal:

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.

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

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 titik akhir 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 Referensi AWS CLI Perintah.

Buat sesi permainan.

Dengan AWS 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 Servers Local telah mengirim panggilan balik ke server game Anda. onStartGameSession 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 game termasuk ID sesi game. Perhatikan bahwa status sesi game baru adalah Mengaktifkan. Status berubah menjadi Aktif setelah server game Anda memanggil. ActivateGameSession Jika Anda ingin melihat status yang berubah, gunakan AWS CLI untuk meneleponDescribeGameSessions().

{
    "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 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.

Mulai server game Anda.

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

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 dalamSiapkan GameLift Server Amazon API:

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

Uji panggilan klien game ke Amazon GameLift Servers layanan.

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 ditampilkan ketika Amazon GameLift Servers Lokal meminta server game Anda untuk memulai sesi permainan (onStartGameSessioncallback) dan berhasil ActivateGameSession ketika server game Anda memanggilnya. Di jendela AWS CLI , semua panggilan API menghasilkan respons atau pesan kesalahan seperti yang didokumentasikan.

Pastikan 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 untuk memanggilDescribePlayerSessions(), status sesi pemain harus berubah dari Cadangan menjadi Aktif.

Pastikan 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 keAmazon GameLift Servers. Verifikasi bahwa Local mencatat peristiwa yang terkait dengan tindakan berikut. Anda mungkin juga ingin menggunakan AWS CLI untuk melacak perubahan status.