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

Integrasikan Amazon GameLift ke dalam proyek Unity

Topik ini menjelaskan cara menyiapkan SDKplugin Amazon GameLift C# Server untuk Unity dan mengintegrasikannya ke dalam proyek game Anda.

Sumber daya tambahan:

Prasyarat

Untuk menggunakan SDK plugin Amazon GameLift C# server untuk Unity, Anda memerlukan komponen berikut:

Mengatur UnityNuGet

Jika Anda belum UnityNuGet menyiapkan proyek game Anda, gunakan langkah-langkah berikut untuk menginstal alat menggunakan manajer paket Unity. Atau, Anda dapat menggunakan NuGet CLI untuk mengunduh file secara manualDLLs. Untuk informasi selengkapnya, lihat server Amazon GameLift C# SDK untuk UnityREADME.

Pasang plugin

Gunakan prosedur berikut untuk menginstal SDK plugin Amazon GameLift C# server untuk Unity dan mengkonfigurasi log4net logging.

GameLift Server Amazon SDK menggunakan kerangka log4net untuk mengeluarkan pesan log. Ini dikonfigurasi untuk menampilkan pesan ke terminal server build secara default, tetapi Unity memerlukan konfigurasi untuk menambahkan dukungan pencatatan file. Anda dapat menambahkan dukungan ini ke proyek Anda dengan mengimpor sampel yang disediakan di dalam SDK paket Amazon GameLift Server. Gunakan prosedur berikut untuk menambahkan sampel dan mengkonfigurasi log4net:

Untuk petunjuk lebih rinci dan panduan pengujian, lihat yang README terletak di download plugin.

Siapkan Amazon GameLift Anywhere armada untuk pengujian

Anda dapat mengatur workstation pengembangan Anda sebagai Amazon GameLift Anywhere armada hosting untuk menguji GameLift integrasi Amazon Anda secara berulang. Dengan pengaturan ini, Anda dapat memulai proses server game di workstation Anda, mengirim permintaan bergabung pemain atau perjodohan ke Amazon GameLift untuk memulai sesi permainan, dan menghubungkan klien ke sesi permainan baru. Dengan workstation Anda sendiri yang disiapkan sebagai server hosting, Anda dapat memantau semua aspek integrasi game Anda dengan Amazon GameLift.

Untuk petunjuk tentang pengaturan workstation Anda, lihat Siapkan pengujian lokal dengan Amazon GameLift Anywhere untuk menyelesaikan langkah-langkah berikut:

Tambahkan kode GameLift server Amazon ke proyek Unity Anda

Server game Anda berkomunikasi dengan GameLift layanan Amazon untuk menerima instruksi dan melaporkan status yang sedang berlangsung. Untuk mencapai ini, Anda menambahkan kode server game yang menggunakan GameLift server SDK Amazon.

Contoh kode yang disediakan menggambarkan elemen integrasi dasar yang diperlukan. Ini menggunakan a MonoBehavior untuk mengilustrasikan inisialisasi server game sederhana dengan Amazon. GameLift Contohnya mengasumsikan bahwa server game berjalan di Amazon GameLift Anywhere armada untuk pengujian. Ini termasuk kode untuk:

Kode yang disajikan dalam topik ini membangun komunikasi dengan GameLift layanan Amazon dan. Hal ini juga mengimplementasikan satu set fungsi callback yang menanggapi permintaan dari. Untuk informasi selengkapnya tentang setiap fungsi dan apa yang dilakukan kode, lihat Menginisialisasi proses server. Untuk informasi lebih lanjut tentang SDK tindakan dan tipe data yang digunakan dalam kode ini, bacaAmazon GameLift server SDK 5.x untuk C # dan Unity: Tindakan.

Contoh ini menunjukkan cara menambahkan semua elemen yang diperlukan, seperti yang dijelaskan dalam Tambahkan Amazon GameLift ke server game Anda. Ini termasuk:

Untuk informasi selengkapnya tentang menambahkan GameLift fungsionalitas Amazon, lihat topik berikut:

using System.Collections.Generic;
using Aws.GameLift.Server;
using UnityEngine;

public class ServerSDKManualTest : MonoBehaviour
{    
    //This example is a simple integration that initializes a game server process 
    //that is running on an Amazon GameLift Anywhere fleet.
    void Start()
    {        
        //Identify port number (hard coded here for simplicity) the game server is listening on for player connections
        var listeningPort = 7777;

        //WebSocketUrl from RegisterHost call
        var webSocketUrl = "wss://us-west-2.api.amazongamelift.com";

        //Unique identifier for this process
        var processId = "myProcess";

        //Unique identifier for your host that this process belongs to
        var hostId = "myHost";

        //Unique identifier for your fleet that this host belongs to
        var fleetId = "myFleet";

        //Authorization token for this host process
        var authToken = "myAuthToken";

        //Server parameters are required for a GameLift Anywhere fleet.
        //They are not required for a GameLift managed EC2 fleet.
        ServerParameters serverParameters = new ServerParameters(
            webSocketUrl,
            processId,
            hostId,
            fleetId,
            authToken);

        //InitSDK establishes a local connection with an Amazon GameLift agent 
        //to enable further communication.
        var initSDKOutcome = GameLiftServerAPI.InitSDK(serverParameters);        
        if (initSDKOutcome.Success)
        {
            //Implement callback functions
            ProcessParameters processParameters = new ProcessParameters(
            //Implement OnStartGameSession callback
                (gameSession) => {
                    //GameLift sends a game session activation request to the game server 
                    //with game session object containing game properties and other settings.
                    //Here is where a game server takes action based on the game session object.
                    //When the game server is ready to receive incoming player connections, 
                    //it invokes the server SDK call ActivateGameSession().
                    GameLiftServerAPI.ActivateGameSession();
                },
                (updateGameSession) => {
                    //GameLift sends a request when a game session is updated (such as for 
                    //FlexMatch backfill) with an updated game session object. 
                    //The game server can examine matchmakerData and handle new incoming players.
                    //updateReason explains the purpose of the update.
                },
                () => {
                    //Implement callback function OnProcessTerminate
                    //GameLift invokes this callback before shutting down the instance hosting this game server.
                    //It gives the game server a chance to save its state, communicate with services, etc., 
                    //and initiate shut down. When the game server is ready to shut down, it invokes the 
                    //server SDK call ProcessEnding() to tell GameLift it is shutting down.
                    GameLiftServerAPI.ProcessEnding();
                }, 
                () => {
                    //Implement callback function OnHealthCheck
                    //GameLift invokes this callback approximately every 60 seconds.
                    //A game server might want to check the health of dependencies, etc.
                    //Then it returns health status true if healthy, false otherwise.
                    //The game server must respond within 60 seconds, or GameLift records 'false'.
                    //In this example, the game server always reports healthy.
                    return true;
                },
                //The game server gets ready to report that it is ready to host game sessions
                //and that it will listen on port 7777 for incoming player connections.
                listeningPort, 
                new LogParameters(new List<string>()
                {
                    //Here, the game server tells GameLift where to find game session log files.
                    //At the end of a game session, GameLift uploads everything in the specified 
                    //location and stores it in the cloud for access later.
                    "/local/game/logs/myserver.log"
                }));

            //The game server calls ProcessReady() to tell GameLift it's ready to host game sessions.
            var processReadyOutcome = GameLiftServerAPI.ProcessReady(processParameters);
            if (processReadyOutcome.Success)
            {
                print("ProcessReady success.");
            }
            else
            {
                print("ProcessReady failure : " + processReadyOutcome.Error.ToString());
            }
        }
        else
        {
            print("InitSDK failure : " + initSDKOutcome.Error.ToString());
        }
    }  

    void OnApplicationQuit()
    {
        //Make sure to call GameLiftServerAPI.ProcessEnding() and GameLiftServerAPI.Destroy() before terminating the server process.
        //These actions notify Amazon GameLift that the process is terminating and frees the API client from memory. 
        GenericOutcome processEndingOutcome = GameLiftServerAPI.ProcessEnding();
        GameLiftServerAPI.Destroy();
        if (processEndingOutcome.Success)
        {
            Environment.Exit(0);
        }
        else
        {
            Console.WriteLine("ProcessEnding() failed. Error: " + processEndingOutcome.Error.ToString());
            Environment.Exit(-1);  
        }
    }
}

Sumber daya tambahan

Gunakan sumber daya berikut untuk menguji server game Anda dan memperluas fungsionalitasnya: