網(wǎng)易首頁(yè) > 網(wǎng)易號(hào) > 正文申請(qǐng)入駐

《火拼24》系列教程一（下）：創(chuàng)建角色

2025-07-10 19:18:50　來(lái)源: Unity

上海舉報(bào)

分享至

在上一篇公眾號(hào)文章《》中，我們已通過(guò) Passport Login 實(shí)現(xiàn)了用戶登錄功能。本節(jié)教程將延續(xù)上一節(jié)的開(kāi)發(fā)脈絡(luò)，基于已搭建的 Passport 服務(wù)器環(huán)境，繼續(xù)為你的游戲項(xiàng)目添加核心功能——從角色創(chuàng)建到角色管理的全流程實(shí)現(xiàn)。

從基礎(chǔ)功能搭建到角色體系擴(kuò)展，一步步為你的游戲角色「建立完整身份檔案」，讓角色系統(tǒng)真正「立起來(lái)」！

教程視頻

項(xiàng)目工程獲取與學(xué)習(xí)指引

1. 初始項(xiàng)目工程下載

倉(cāng)庫(kù)地址：

https://cnb.cool/unity/uos/Rush24Tutorial/-/tree/lesson1-start

分支名稱：lesson1-start 分支
分支說(shuō)明：請(qǐng)先下載 lesson1-start 分支的項(xiàng)目工程，并確保您已經(jīng)按照《》中的步驟，成功實(shí)現(xiàn)了用戶登錄功能。然后，再接著學(xué)習(xí)本節(jié)教程的內(nèi)容。

2.完整示例工程參考

倉(cāng)庫(kù)地址：

https://cnb.cool/unity/uos/Rush24Tutorial/-/tree/lesson1-end

分支名稱：lesson1-end 分支
分支說(shuō)明：lesson1-end 分支包含本節(jié)所有功能的完整實(shí)現(xiàn)代碼，建議在學(xué)習(xí)完成后參考或用于調(diào)試對(duì)照。

教程學(xué)習(xí)大綱

1.獲取 Passport 創(chuàng)建的域

2. 判斷域中是否已經(jīng)創(chuàng)建過(guò)角色

3. 域中如果無(wú)角色，則創(chuàng)建新角色

4. 域中如果已有角色，則直接獲取已創(chuàng)建過(guò)的角色

5. 在玩家信息界面上同步更新顯示角色的昵稱

教程操作步驟

接下來(lái)我們來(lái)看看，如何創(chuàng)建并管理你的角色！

1. 獲取 Passport 創(chuàng)建的域

登錄完成后，可以創(chuàng)建一個(gè)角色進(jìn)入游戲，需要先判斷指定的域下是否創(chuàng)建了角色。

域的概念：

域：對(duì)應(yīng)游戲中區(qū)服的概念，可以根據(jù)開(kāi)發(fā)者的需求來(lái)實(shí)現(xiàn)滾服或者合服。我們的游戲設(shè)計(jì)并不是強(qiáng)養(yǎng)成類型，不需要滾服，所以只需要?jiǎng)?chuàng)建一個(gè)默認(rèn)的域（Realm）就可以滿足需求。

在 Identity.cs 腳本中添加代碼：

定義變量 _defaultRealmID 用于緩存用戶所屬的默認(rèn)服務(wù)器的域 ID。
定義變量 CurrentPersona 表示用戶的身份信息，如用戶名、頭像等，用于全局訪問(wèn)當(dāng)前登錄用戶的身份數(shù)據(jù)。
添加方法 GetRealmID：在方法中，會(huì)先調(diào)用 PassportSDK 提供的 GetRealms 方法獲取已經(jīng)創(chuàng)建的域的列表，然后從域列表中根據(jù)需要選擇一個(gè)域，在這里我們暫時(shí)先使用域列表的第一個(gè)域。大家也可以根據(jù)自己的需求，選擇你想要使用的某一個(gè)域。

using System.Linq;
using Passport;
using Unity.Passport.Runtime;
using System.Threading.Tasks;

namespace TwentyFour.Scripts.Features.Player
{
    public class Identity
    {
        private static string _defaultRealmID = "";
        public static Persona CurrentPersona;

        public static async Task

  GetRealmID()         {             if (!string.IsNullOrEmpty(_defaultRealmID)) return _defaultRealmID;             var realms = await PassportSDK.Identity.GetRealms();             if (realms.Any())             {                 _defaultRealmID =  realms[0].RealmID;             }             return _defaultRealmID;         }     } }

我們可以進(jìn)入 UOS 網(wǎng)頁(yè)端 Passport 的「服務(wù)器」模塊，可以看到默認(rèn)已經(jīng)幫我們創(chuàng)建了一個(gè)域了。大家也可以點(diǎn)擊按鈕「創(chuàng)建新的域」來(lái)實(shí)現(xiàn)構(gòu)建一個(gè)域。

2. 判斷域中是否創(chuàng)建過(guò)角色

在用戶進(jìn)入主頁(yè)時(shí)，需要驗(yàn)證用戶是否已創(chuàng)建角色。所以在 LoadGameData.cs 腳本中，先注釋掉 Start 中對(duì) Init 方法的調(diào)用，然后創(chuàng)建協(xié)程方法 CheckPersona來(lái)判斷這個(gè)功能。

調(diào)用之前定義的 Identity 腳本類中的方法 GetRealmID，來(lái)異步獲取用戶所屬的默認(rèn)域 ID，等待異步任務(wù)完成后，若獲取到有效的域 ID，則將其存入 realmID 變量，供下一步使用；
然后再調(diào)用 Passport SDK 的接口 GetPersonaByRealm，異步獲取指定域 ID 下用戶的角色信息，在使用 WaitUntil 確保獲取角色數(shù)據(jù)的任務(wù)完成后，輸出打印下獲取到的 Persona 是否為 null，用于調(diào)試。若為 null，說(shuō)明用戶在該域下未創(chuàng)建角色。

using System.Collections;
using UnityEngine;
using UnityEngine.UI;
using TwentyFour.Scripts.Features.Save;
using TwentyFour.Scripts.Gameplay.GameMode.StageMode;
using Passport;
using Unity.Passport.Runtime;
using System.Threading.Tasks;
using System;
using TwentyFour.Scripts.Features.Player;
using Logger = TwentyFour.Scripts.Utilities.Logger;

namespace TwentyFour.Scripts.Gameplay.HomePage
{
    public class LoadGameData : MonoBehaviour
    {
        public GameObject createPersonaDialog;
        public Text progressTextTmp;

        void Start()
        {    
            StartCoroutine(CheckPersona());
        }

        IEnumerator CheckPersona()
        {
            string realmID = String.Empty;
            Task

 task = Identity.GetRealmID();             yield return new WaitUntil(()=>task.IsCompleted);             if (!string.IsNullOrEmpty(task.Result))                 realmID = task.Result;             Task getPersonaTask = PassportSDK.Identity.GetPersonaByRealm(realmID);             yield return new WaitUntil(()=>getPersonaTask.IsCompleted);             Logger.Log("getPersonaTask.Result == null ：" + (getPersonaTask.Result == null));         }         //......     } }

運(yùn)行項(xiàng)目后，可以在控制臺(tái)看到輸出的日志信息：Result 為 null，說(shuō)明并沒(méi)有創(chuàng)建過(guò)角色。

3. 域中無(wú)角色，則創(chuàng)建新角色

3.1 激活創(chuàng)建角色的彈窗

如果 getPersonaTask.Result 為空，說(shuō)明域中沒(méi)有角色，我們需要先激活創(chuàng)建角色的彈窗。

在 LoadGameData.cs 腳本的 CheckPersona 方法中，則先激活創(chuàng)建角色的彈框?qū)ο?createPersonaDialog 。

public class LoadGameData : MonoBehaviour
{
    public GameObject createPersonaDialog;
    public Text progressTextTmp;

    //......

    IEnumerator CheckPersona()
    {
        string realmID = String.Empty;
        Task

 task = Identity.GetRealmID();         yield return new WaitUntil(()=>task.IsCompleted);         if (!string.IsNullOrEmpty(task.Result))             realmID = task.Result;         Task getPersonaTask = PassportSDK.Identity.GetPersonaByRealm(realmID);         yield return new WaitUntil(()=>getPersonaTask.IsCompleted);         Logger.Log("getPersonaTask.Result == null ：" + (getPersonaTask.Result == null));         if (getPersonaTask.Result == null)         {             Logger.Log("當(dāng)前域無(wú)角色，請(qǐng)創(chuàng)建新角色");             createPersonaDialog.SetActive(true);         }     } }

在 Hierarchy 窗口中，找到 LoadGameData 對(duì)象，為其身上的腳本 LoadGameData.cs 中的變量 createPersonaDialog 賦值：

然后運(yùn)行測(cè)試，在 Game 窗口中看到了 UI 的彈窗。

接著，我們要開(kāi)始創(chuàng)建角色了。

3.2 定義委托表示角色創(chuàng)建完成的回調(diào)

在 LoginController.cs 腳本中定義一個(gè)委托，來(lái)實(shí)現(xiàn)當(dāng)角色創(chuàng)建完成后，返回創(chuàng)建的角色的時(shí)候使用。

public class LoginController : MonoBehaviour
{
    //......

    public delegate void CreatePersonaCompleteCallback(Persona persona);
}

3.3 添加創(chuàng)建角色的腳本

在 Login 腳本文件夾下，再創(chuàng)建一個(gè)新的腳本 CreatePersona.cs，來(lái)實(shí)現(xiàn)創(chuàng)建角色的功能。

CreatePersona.cs 腳本代碼邏輯如下：

定義變量 personaNameText，指向 UI 中用戶輸入角色名稱的輸入框組件；
同時(shí)獲取下 LoginController.cs 腳本中的委托變量，用于觸發(fā)角色創(chuàng)建成功時(shí)的回調(diào)；
在 Create 方法中，先獲取到已經(jīng)創(chuàng)建好的域，存儲(chǔ)在 realmID 變量中。然后調(diào)用 PassportSDK 提供的 CreatePersona 方法，在指定的域 realmID 中來(lái)創(chuàng)建一個(gè)角色，并賦值給 persona 變量；
角色創(chuàng)建成功后，將創(chuàng)建的角色 persona 通過(guò)委托返回；
同時(shí)會(huì)使用 try...catch... 捕獲 Passport 遇到的異常，并在 UI 界面上顯示出錯(cuò)誤信息。

using Passport;
using Unity.Passport.Runtime;
using Unity.UOS.TwentyFour;
using UnityEngine.UI;
using UnityEngine;
using Unity.Passport.Runtime.UI;

namespace TwentyFour.Scripts.Features.Player
{
    public class CreatePersona : MonoBehaviour
    {
        public InputField personaNameText;
        public LoginController.CreatePersonaCompleteCallback OnCreatePersonaComplete;
        /// 

        /// 創(chuàng)建 Persona
        /// 
        public async void Create()
        {
            if (string.IsNullOrEmpty(personaNameText.text))
            {
                Debug.LogError("Empty Persona name");
            }
            try
            {
                var realmID = await Identity.GetRealmID();
                Persona persona =  await PassportSDK.Identity.CreatePersona(personaNameText.text, realmID);
                Debug.Log("成功創(chuàng)建角色");

                OnCreatePersonaComplete(persona);
            }
            catch (PassportException e)
            {
                Debug.Log(e.Code);
                UIMessage.Show(e.ErrorMessage, MessageType.Error);
            }
        }
    }
}

將 CreatePersona.cs 腳本拖拽給場(chǎng)景中的 CreatePersonaDialog 對(duì)象，并為面板上的 personaNameText 變量賦值：

找到創(chuàng)建角色的面板（CreatePersonaDialog）上的「確定」按鈕（Button_Ok）：

給按鈕（Button_Ok）對(duì)象，綁定 CreatePersona.cs 腳本中的 Create 方法。

3.4 創(chuàng)建角色完成后加載游戲關(guān)卡

繼續(xù)在 LoadGameData.cs 腳本中添加代碼：

創(chuàng)建角色框?qū)ο蠹せ铒@示以后，獲取到它身上的 CreatePersona.cs 腳本組件，并將之前定義的委托對(duì)象綁定到當(dāng)前腳本類中的 OnCreatePersonaComplete 方法；
在回調(diào)方法 OnCreatePersonaComplete 中，將全局身份管理類 Identity.cs 的 CurrentPersona 屬性，設(shè)置為新創(chuàng)建的角色；
同時(shí)，在角色創(chuàng)建完成的回調(diào)方法中，還會(huì)調(diào)用新添加的協(xié)程方法 SelectPersonaAndInit。并在方法內(nèi)調(diào)用協(xié)程方法 Init() ，來(lái)加載關(guān)卡的數(shù)據(jù)進(jìn)行闖關(guān)。

public class LoadGameData : MonoBehaviour
{
    //......

    IEnumerator CheckPersona()
    {
        //......        
        if (getPersonaTask.Result == null)
        {
            Logger.Log("當(dāng)前域無(wú)角色，請(qǐng)創(chuàng)建新角色");
            createPersonaDialog.SetActive(true);
            var createPersonaController = createPersonaDialog.GetComponent ();
            createPersonaController.OnCreatePersonaComplete = OnCreatePersonaComplete;
        }
    }

    void OnCreatePersonaComplete(Persona p)
    {
        Identity.CurrentPersona = p;
        Logger.LogInfo($"創(chuàng)建角色成功，角色I(xiàn)D：{Identity.CurrentPersona.PersonaID}");
        StartCoroutine(SelectPersonaAndInit());
    }

    IEnumerator SelectPersonaAndInit()
    {
        yield return StartCoroutine(Init());
    }

    //......
}

3.5 運(yùn)行游戲進(jìn)行測(cè)試，開(kāi)啟敏感詞檢測(cè)

在 Game 窗口創(chuàng)建角色的彈窗中，輸入角色的昵稱。

開(kāi)通敏感詞檢測(cè)功能：

在 Passport 的「用戶管理」頁(yè)面，可以開(kāi)啟角色對(duì)用戶名/角色名的敏感詞檢測(cè)。

開(kāi)啟敏感詞檢測(cè)后，在輸入了敏感詞信息時(shí)，會(huì)在 Game 窗口和 Console 窗口看到提示的“無(wú)效的名字” 的錯(cuò)誤，表明所輸入的名稱并未通過(guò)敏感詞檢測(cè)，可以重新輸入一個(gè)昵稱。

重新輸入昵稱點(diǎn)擊「確定」后，就可以進(jìn)入游戲主頁(yè)面，選擇闖關(guān)了。

在 Passport 的「角色管理」頁(yè)面，可以看到創(chuàng)建過(guò)的名稱為 Player1 的角色。

4. 域中已有角色，則直接獲取已創(chuàng)建的角色

在 LoadGameData.cs 腳本中繼續(xù)添加判斷：

如果用戶已經(jīng)創(chuàng)建過(guò)角色，則通過(guò) getPersonaTask.Result 直接獲取創(chuàng)建好的角色；
然后調(diào)用協(xié)程方法 SelectPersonaAndInit，直接來(lái)跳轉(zhuǎn)到游戲闖關(guān)頁(yè)面。

public class LoadGameData : MonoBehaviour
{
    //......

    IEnumerator CheckPersona()
    {       
        if (getPersonaTask.Result == null)
        {
            Logger.Log("當(dāng)前域無(wú)角色，請(qǐng)創(chuàng)建新角色");
            //......
        }
        else
        {
            Identity.CurrentPersona = getPersonaTask.Result;
            yield return StartCoroutine(SelectPersonaAndInit());
            Logger.Log($"當(dāng)前角色為：{Identity.CurrentPersona.DisplayName}");
        }
    }
}

大家可以自行再次運(yùn)行測(cè)試下，已經(jīng)有角色后，是不會(huì)再?gòu)棾鰟?chuàng)建角色的輸入框的。

5. 在玩家信息界面上同步更新顯示角色的昵稱

在下圖所示的路徑下，創(chuàng)建一個(gè)新的文件夾 PlayerInfo，并在該文件夾下創(chuàng)建一個(gè)新的腳本 PlayerInfoPanel.cs，來(lái)實(shí)現(xiàn)將用戶創(chuàng)建的角色昵稱同步顯示在玩家的信息面板上。

腳本中 PlayerInfoPanel.cs 代碼如下：

定義變量 playerName，用來(lái)更新顯示昵稱；
新添加一個(gè)方法 GetPlayerInfo，將 Identity.cs 腳本中之前存儲(chǔ)的角色( CurrentPersona) 的昵稱顯示在 UI 文本框上；
同時(shí)，會(huì)在 PlayerInfoPanel 面板打開(kāi)時(shí)自動(dòng)調(diào)用的 OnEnable 方法中，調(diào)用 GetPlayerInfo 方法，來(lái)更新 UI 的顯示。

using System;
using UnityEngine;
using UnityEngine.UI;

namespace TwentyFour.Scripts.Features.Player
{
    public class PlayerInfoPanel : MonoBehaviour
    {
        public Text playerName;

        private void OnEnable()
        {
            GetPlayerInfo();
        }

        private void GetPlayerInfo()
        {
            playerName.text = Identity.CurrentPersona?.DisplayName;
        }
    }
}

找到 MainScene 場(chǎng)景中的 PlayerInfoPanel 對(duì)象，將腳本 PlayerInfoPanel.cs 拖拽到它身上，并為 Inspector 面板上的 playerName 變量賦值：

運(yùn)行項(xiàng)目后，可以看到如下所示的效果，已經(jīng)可以更新顯示用戶昵稱了。

管理創(chuàng)建過(guò)的角色

刪除角色

在 Passport 的「角色管理」頁(yè)面，可以看到所有已創(chuàng)建過(guò)的角色信息，以及該角色所屬的用戶 ID。如果想刪除某個(gè)角色的話，可以點(diǎn)擊角色信息最右側(cè)的「刪除角色」的按鈕。

大家在彈窗中，一定要仔細(xì)閱讀提示信息后，再點(diǎn)擊「確認(rèn)刪除」按鈕哦！剛才選中的角色就被成功刪除了。

刪除用戶

接下來(lái)，大家先看下我選中的這條角色信息，可以看到 1000001004 角色是屬于 1000001002 用戶的。

在 Passport 的「用戶管理」頁(yè)面，可以看到登錄過(guò)的所有用戶。我們點(diǎn)擊「用戶管理」頁(yè)面上的 1000001002 用戶最右側(cè)的「刪除用戶」按鈕：

會(huì)有彈窗再次提醒大家，是否真的要?jiǎng)h除該用戶的。因?yàn)閯h除用戶時(shí)，也會(huì)把該用戶剛才創(chuàng)建的角色一起刪除的。如果你確定要?jiǎng)h除，就點(diǎn)擊「確認(rèn)刪除」的按鈕。

當(dāng)我們成功刪除了指定用戶 1000001002 后，在「用戶管理」頁(yè)面已經(jīng)沒(méi)有該用戶了，而且在「角色管理」頁(yè)面可以看到該用戶下的角色也已經(jīng)一起被刪除了。

下節(jié)教程預(yù)告

教程主題——《火拼24》系列教程二：動(dòng)態(tài)調(diào)控游戲關(guān)卡難度

《火拼24》下一篇教程，將聚焦使用 Remote Config 動(dòng)態(tài)調(diào)控游戲關(guān)卡難度的實(shí)戰(zhàn)技巧，教你如何通過(guò)遠(yuǎn)程配置靈活調(diào)整游戲關(guān)卡難度參數(shù)，無(wú)需發(fā)布新版本即可優(yōu)化玩家體驗(yàn)！

小貼士：為方便大家提前學(xué)習(xí)，教程二的分支代碼已同步更新，可提前下載查閱或本地調(diào)試。

教程二：初始項(xiàng)目工程（供學(xué)習(xí)參考）

https://cnb.cool/unity/uos/Rush24Tutorial/-/tree/lesson2-start

教程二：完整示例工程參考（可直接運(yùn)行）

https://cnb.cool/unity/uos/Rush24Tutorial/-/tree/lesson2-end

Unity Online Services (UOS) 是一個(gè)專為游戲開(kāi)發(fā)者設(shè)計(jì)的一站式游戲云服務(wù)平臺(tái)，提供覆蓋游戲全生命周期的開(kāi)發(fā)、運(yùn)營(yíng)和推廣支持。

了解更多 UOS 相關(guān)信息：

官網(wǎng)：https://uos.unity.cn

技術(shù)交流 QQ 群：823878269

Unity 官方微信

第一時(shí)間了解Unity引擎動(dòng)向，學(xué)習(xí)進(jìn)階開(kāi)發(fā)技能

每一個(gè)“點(diǎn)贊”、“在看”，都是我們前進(jìn)的動(dòng)力

特別聲明：以上內(nèi)容(如有圖片或視頻亦包括在內(nèi))為自媒體平臺(tái)“網(wǎng)易號(hào)”用戶上傳并發(fā)布，本平臺(tái)僅提供信息存儲(chǔ)服務(wù)。

Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.