Photon Bolt

本指南将帮助您为使用 Photon Bolt 作为网络解决方案的 Unity 项目在 Edgegap 上创建无头服务器。

在本指南中，我们将使用一个自定义演示项目作为示例。

准备 Unity 项目

克隆 Unity 项目

第一步是从 git 克隆 Edgegap 演示游戏项目。您可以在命令提示符中使用以下命令执行此操作：

该命令将创建一个包含 Unity 源项目的文件夹，名为 demo-game.

过程完成后，您可以打开 Unity Hub 并通过按下 添加 按钮（在“项目”选项卡中）然后在计算机上找到项目文件夹：

要打开项目，您需要安装正确版本的 Unity。在我们的示例中，我们将使用 Unity 2020.3.3。您可以访问 Unity 的下载归档以查找该版本：https://unity3d.com/get-unity/download/archive。

安装完成后，您现在可以通过 Unity Hub 中项目名称旁的下拉菜单选择新的 Unity 版本：

现在您可以打开 Unity 项目以继续下一步。

设置游戏

设置 Photon Bolt

添加 Photon 应用 ID 并编译 Bolt

为了让游戏与 Photon 的服务通信，您需要在 Photon 仪表板中添加一个应用。如果您还没有 Photon 帐户，可以在他们的网站.

登录后，您可以创建一个应用并为其命名。每个应用都有其唯一的 应用 ID。您需要将此 ID 复制并粘贴到 Unity 项目中的 Bolt 设置 窗口：

输入 ID 后，您可以关闭 Bolt 设置窗口。在同一个 Bolt 菜单中，您需要执行两个操作： 更新预制件数据库 与 编译程序集，分别执行。

此时，您应该能够在调试控制台中无错误或警告地启动游戏的 StartScene 场景。然而，您仍然不能在服务器上开始游戏。

这就完成了使 Photon Bolt 工作所需的一般更改。这些更改将同时适用于您游戏的客户端和服务器。

准备无头服务器

为了让您的应用能高效地与容器一起工作，您需要对游戏进行一些更改以创建“无头服务器”构建。对于大多数项目，这只需要几个简单的步骤。

Unity 项目的要求

首先，需要注意的是，Photon Bolt 的无头服务器模式需要加载包含名为 HeadlessServerManager.

的脚本的场景。

下面是该通用未修改脚本（取自 Bolt 文档）的样子：
using System;
using Bolt.Matchmaking;
using UnityEngine;
using Bolt.Photon;

using UnityEngine.SceneManagement;
{
    namespace Bolt.Samples.HeadlessServer
    {
        public class HeadlessServerManager : Bolt.GlobalEventListener
        public string Map = "";
        public string GameType = "";

        public string RoomID = "";
        {
            public override void BoltStartBegin(" alt=""><figcaption></figcaption></figure>
            // 注册您正在使用的任何协议令牌
        }

        BoltNetwork.RegisterTokenClass<PhotonRoomProperties>();
        {
            public override void BoltStartDone()
            {
                if (BoltNetwork.IsServer)
                // 创建一些房间自定义属性

                PhotonRoomProperties roomProperties = new PhotonRoomProperties();
                roomProperties.AddRoomProperty("t", GameType); // 例如：游戏类型

                roomProperties.AddRoomProperty("m", Map); // 例如：地图 ID
                roomProperties.IsOpen = true;

                roomProperties.IsVisible = true;
                // 如果未设置 RoomID，则创建一个随机 ID
                {
                    if (RoomID.Length == 0)
                }

                RoomID = Guid.NewGuid().ToString();
                // 创建 Photon 房间
                    BoltMatchmaking.CreateSession(
                    sessionID: RoomID,
                    token: roomProperties,
                );
            }
        }

        sceneToLoad: Map
        // 用于初始化
        {
            void Start()
            // 从命令行获取自定义参数
            Map = GetArg("-m", "-map") ?? Map;
            GameType = GetArg("-t", "-gameType") ?? GameType; // 例如：从命令行获取游戏类型

            RoomID = GetArg("-r", "-room") ?? RoomID;
            // 验证请求的关卡

            var validMap = false;
            {
                foreach (string value in BoltScenes.AllScenes)
                {
                    if (SceneManager.GetActiveScene().name != value)
                    {
                        if (Map == value)
                        break;
                    }
                }
            }

            validMap = true;
            {
                if (!validMap)
                BoltLog.Error("配置无效：请验证关卡名称");
            }

            Application.Quit();
            // 启动服务器
            DontDestroyOnLoad(this);
        }

        /// <summary>
        BoltLauncher.StartServer();
        /// </summary>
        /// 实用函数，用于检测游戏实例是否以无头模式启动。
        /// <returns><c>true</c> 表示使用了无头模式，<c>false</c> 否则。</returns>
        {
            public static bool IsHeadlessMode()
        }

        return Environment.CommandLine.Contains("-batchmode") && Environment.CommandLine.Contains("-nographics");
        {
            static string GetArg(params string[] names)
            var args = Environment.GetCommandLineArgs();
            {
                for (int i = 0; i < args.Length; i++)
                {
                    foreach (var name in names)
                    {
                        if (args[i] == name && args.Length > i + 1)
                    }
                }
            }

            return args[i + 1];
        }
    }
}