Unity NGO

了解如何使用以下内容中的技术在 Edgegap 上托管 Unity 项目 NGO Boss Room 示例.

此示例 不需要任何 Unity Gaming Services（UGS）、Multiplay 或 Relay 即可运行。

✔️ 准备工作

在开始之前，你需要：

• Unity 6 - 使用 Unity Hub 下载,

• Unity NGO [Netcode for Game Objects] Boss Room 示例项目（已为 Edgegap 修改）：

  • 从 Github 下载.

⚡ 部署并连接

1. 在 Edgegap 上部署服务器

☑️ 要开始，你需要 在 Edgegap 创建一个免费账户。无需信用卡。

☑️ 为你的应用创建一个新的应用版本，选择 NGO Boss Room 示例。

☑️ 使用你的 NGO Boss Room 示例应用版本部署服务器.

☑️ 打开你新部署的详情 并找到你唯一的一次性连接信息：

• 外部端口，例如 30854 （随机选择）。

☑️ 切换到“日志”标签并查找（CTRL+F）你唯一的一次性连接信息：

• ARBITRIUM_PUBLIC_IP ，例如 IPv4： 172.234.244.38 .

✅ 你现在可以进行下一步了。

2. 从编辑器连接

☑️ 在 Unity 中打开你的新项目。

☑️ 确认你已打开场景： Assets/Scenes/MainMenu.unity.

☑️ 按下 ▶️ Play 按钮来启动你的游戏客户端：

• 按 START WITH DIRECT IP 按钮，

• 选择标签页 JOIN WITH IP。

☑️ 输入上一步中的连接信息。

☑️ 按 JOIN 按钮连接到你的服务器。

☑️ 使用 Multiplayer Play Mode 或 ParrelSync.

🙌 恭喜你在 Edgegap 上完成了第一次部署！

✏️ 自定义服务器构建

参见 Unity 以了解 Unity 如何 学习如何构建和自定义服务器.

以专用服务器运行

为了让此示例以专用服务器运行，我们做了以下更改：

服务器初始化

新脚本（添加到你的 MainMenu 场景中的一个新的空 GameObject):

Assets/Scripts/EdgegapServerStarter.cs

using System;
using System.Collections;
using System.Collections.Generic;
using Unity.BossRoom.ConnectionManagement;
using UnityEngine;

namespace Unity.Multiplayer.Samples.BossRoom
{
    public class EdgegapServerStarter : MonoBehaviour
    {
        public string portMapName = "gameport";

        // 在第一帧更新之前调用 Start
        void Start()
        {
            if (Application.isBatchMode)
            {
                ConnectionManager connectionManager = GameObject.Find("ConnectionManager").GetComponent<ConnectionManager>();
                string internalPortAsStr = Environment.GetEnvironmentVariable($"ARBITRIUM_PORT_{portMapName.ToUpper()}_INTERNAL");

                if (internalPortAsStr == null || !ushort.TryParse(internalPortAsStr, out ushort port))
                {
                    throw new Exception($"找不到端口映射，请确保你的应用版本端口名称与 \"{portMapName}\" 一致");
                }

                connectionManager.StartHostIp("SERVER", "0.0.0.0", port);
            }
        }
    }
}

连接管理

已修改文件：

Assets/Scripts/ConnectionManagement/ConnectionMethod.cs

116        public override async Task SetupHostConnectionAsync()
117        {
118            //SetConnectionPayload(GetPlayerId(), m_PlayerName); // 也需要为 host 设置连接负载，因为 host 也是客户端
119            var utp = (UnityTransport)m_ConnectionManager.NetworkManager.NetworkConfig.NetworkTransport;
120            utp.SetConnectionData(m_Ipaddress, m_Port);
121        }

Assets/Scripts/ConnectionManagement/ConnectionState/StartingHostState.cs

66        async void StartHost()
67        {
              ...

72                // NGO 的 StartHost 会启动所有内容
--                //if (!m_ConnectionManager.NetworkManager.StartHost())
73                if (!m_ConnectionManager.NetworkManager.StartServer())
74                {
75                    StartHostFailed();
76                }

              ...

Assets/Scripts/Gameplay/GameplayObjects/Character/ClientCharacter.cs

112        public override void OnNetworkSpawn()
113        {
               ...

125            m_ServerCharacter.IsStealthy.OnValueChanged += OnStealthyChanged;
126            m_ServerCharacter.MovementStatus.OnValueChanged += OnMovementStatusChanged;
127            //OnMovementStatusChanged(MovementStatus.Normal, m_ServerCharacter.MovementStatus.Value);
 
               ...

编辑器/服务器兼容性

修改文件：

Assets/Scripts/ConnectionManagement/ConnectionState/HostingState.cs

148        ConnectStatus GetConnectStatus(ConnectionPayload connectionPayload)
149        {
               ...
                
155            //if (connectionPayload.isDebug != Debug.isDebugBuild)
156            //{
157            //    return ConnectStatus.IncompatibleBuildType;
158            //}

               ...