在鸿蒙HarmonyOS 5中使用Unity完成一个王者荣耀英雄的技能

勿念436

418人浏览 · 2025-06-20 13:22:00

勿念436 · 2025-06-20 13:22:00 发布

下面我将详细介绍如何在鸿onyOS 5中使用Unity开发一个展示王者荣耀英雄技能的应用。

1. 项目结构与准备

1.1 项目目录结构

Assets/
├── Resources/
│   ├── Heroes/          # 英雄资源文件夹
│   │   ├── 101/         # 英雄ID为文件夹
│   │   │   ├── icon.png # 英雄头像
│   │   │   ├── model.fbx # 英雄3D模型
│   │   │   └── skills/  # 技能资源
├── Scripts/
│   ├── Data/
│   │   ├── HeroData.cs  # 英雄数据结构
│   │   └── SkillData.cs # 技能数据结构
│   ├── Managers/
│   │   ├── GameManager.cs
│   │   └── UIManager.cs
│   └── UI/
│       ├── HeroCard.cs
│       └── SkillPanel.cs
└── Scenes/
    ├── Main.unity       # 主场景
    └── HeroDetail.unity # 英雄详情场景

2. 数据模型设计

2.1 英雄数据结构 (`HeroData.cs`)

using System.Collections.Generic;
using UnityEngine;

[System.Serializable]
public class HeroSkill
{
    public int skillId;
    public string skillName;
    public string skillDescription;
    public Sprite skillIcon;
    public float cooldown;
    public string skillEffectPath; // 技能特效预制体路径
}

[System.Serializable]
public class HeroData
{
    public int heroId;
    public string heroName;
    public string heroTitle;
    public Sprite heroIcon;
    public GameObject heroModelPrefab;
    public List<HeroSkill> skills = new List<HeroSkill>();
    public string passiveSkillDescription;
}

[CreateAssetMenu(fileName = "HeroDatabase", menuName = "Game/Hero Database")]
public class HeroDatabase : ScriptableObject
{
    public List<HeroData> heroes;
}

3. 主场景实现

3.1 英雄选择界面

using System.Collections.Generic;
using UnityEngine;
using TMPro;

public class HeroSelection : MonoBehaviour
{
    public HeroDatabase heroDatabase;
    public Transform heroGrid;
    public GameObject heroCardPrefab;
    public TMP_InputField searchInput;
    
    private List<HeroData> currentDisplayedHeroes = new List<HeroData>();
    
    void Start()
    {
        LoadAllHeroes();
        searchInput.onValueChanged.AddListener(OnSearchInputChanged);
    }
    
    private void LoadAllHeroes()
    {
        currentDisplayedHeroes = heroDatabase.heroes;
        PopulateHeroGrid(currentDisplayedHeroes);
    }
    
    private void PopulateHeroGrid(List<HeroData> heroes)
    {
        ClearHeroGrid();
        
        foreach (var hero in heroes)
        {
            GameObject card = Instantiate(heroCardPrefab, heroGrid);
            HeroCard cardScript = card.GetComponent<HeroCard>();
            cardScript.Initialize(hero, OnHeroSelected);
        }
    }
    
    private void OnHeroSelected(HeroData hero)
    {
        GameManager.Instance.CurrentHero = hero;
        SceneManager.LoadScene("HeroDetail");
    }
    
    private void OnSearchInputChanged(string searchText)
    {
        var filtered = heroDatabase.heroes.FindAll(h => 
            h.heroName.Contains(searchText));
        PopulateHeroGrid(filtered);
    }
    
    private void ClearHeroGrid()
    {
        foreach (Transform child in heroGrid)
        {
            Destroy(child.gameObject);
        }
    }
}

4. 英雄详情场景

4.1 英雄3D模型展示

using UnityEngine;

public class HeroModelDisplay : MonoBehaviour
{
    public Transform modelParent;
    private GameObject currentModel;
    
    public void DisplayHeroModel(HeroData hero)
    {
        if (currentModel != null)
        {
            Destroy(currentModel);
        }
        
        currentModel = Instantiate(hero.heroModelPrefab, modelParent);
        currentModel.transform.localPosition = Vector3.zero;
        currentModel.transform.localRotation = Quaternion.identity;
        
        // 设置模型动画为待机状态
        Animator animator = currentModel.GetComponent<Animator>();
        if (animator != null)
        {
            animator.Play("Idle");
        }
    }
}

4.2 技能面板控制器

using System.Collections;
using UnityEngine;
using TMPro;

public class SkillPanel : MonoBehaviour
{
    public GameObject skillItemPrefab;
    public Transform skillItemsParent;
    public TextMeshProUGUI passiveSkillText;
    public GameObject skillPreviewPanel;
    public TextMeshProUGUI skillNameText;
    public TextMeshProUGUI skillDescText;
    public TextMeshProUGUI cooldownText;
    
    private HeroData currentHero;
    
    public void Initialize(HeroData hero)
    {
        currentHero = hero;
        passiveSkillText.text = hero.passiveSkillDescription;
        PopulateSkills();
    }
    
    private void PopulateSkills()
    {
        ClearSkills();
        
        foreach (var skill in currentHero.skills)
        {
            GameObject skillItem = Instantiate(skillItemPrefab, skillItemsParent);
            SkillItem itemScript = skillItem.GetComponent<SkillItem>();
            itemScript.Initialize(skill, OnSkillSelected);
        }
    }
    
    private void OnSkillSelected(HeroSkill skill)
    {
        skillNameText.text = skill.skillName;
        skillDescText.text = skill.skillDescription;
        cooldownText.text = $"冷却时间: {skill.cooldown}秒";
        
        // 加载并播放技能特效
        StartCoroutine(LoadAndPlaySkillEffect(skill.skillEffectPath));
    }
    
    private IEnumerator LoadAndPlaySkillEffect(string effectPath)
    {
        ResourceRequest request = Resources.LoadAsync<GameObject>(effectPath);
        yield return request;
        
        if (request.asset != null)
        {
            GameObject effect = Instantiate(request.asset as GameObject);
            Destroy(effect, 3f); // 3秒后自动销毁特效
        }
    }
    
    private void ClearSkills()
    {
        foreach (Transform child in skillItemsParent)
        {
            Destroy(child.gameObject);
        }
    }
}

5. HarmonyOS集成

5.1 数据持久化

using UnityEngine;

public class HarmonyOSDataManager : MonoBehaviour
{
    public static void SaveHeroProgress(int heroId, string progressData)
    {
        using (AndroidJavaClass unityPlayer = new AndroidJavaClass("com.unity3d.player.UnityPlayer"))
        using (AndroidJavaObject activity = unityPlayer.GetStatic<AndroidJavaObject>("currentActivity"))
        using (AndroidJavaObject preferences = activity.Call<AndroidJavaObject>("getSharedPreferences", "hero_progress", 0))
        {
            preferences.Call<AndroidJavaObject>("edit")
                      .Call<AndroidJavaObject>("putString", heroId.ToString(), progressData)
                      .Call<bool>("commit");
        }
    }
    
    public static string LoadHeroProgress(int heroId)
    {
        using (AndroidJavaClass unityPlayer = new AndroidJavaClass("com.unity3d.player.UnityPlayer"))
        using (AndroidJavaObject activity = unityPlayer.GetStatic<AndroidJavaObject>("currentActivity"))
        using (AndroidJavaObject preferences = activity.Call<AndroidJavaObject>("getSharedPreferences", "hero_progress", 0))
        {
            return preferences.Call<string>("getString", heroId.ToString(), "");
        }
    }
}

5.2 调用HarmonyOS原生UI

public void ShowHarmonyOSToast(string message)
{
    using (AndroidJavaClass unityPlayer = new AndroidJavaClass("com.unity3d.player.UnityPlayer"))
    using (AndroidJavaObject activity = unityPlayer.GetStatic<AndroidJavaObject>("currentActivity"))
    using (AndroidJavaClass toastClass = new AndroidJavaClass("ohos.agp.window.service.Toast"))
    {
        AndroidJavaObject toast = toastClass.CallStatic<AndroidJavaObject>("makeText", 
            activity, 
            message, 
            toastClass.GetStatic<int>("LENGTH_SHORT"));
        toast.Call("show");
    }
}

6. 性能优化

6.1 资源异步加载

using System.Collections;
using UnityEngine;
using UnityEngine.UI;

public class HeroIconLoader : MonoBehaviour
{
    public Image heroIcon;
    public string iconPath;
    
    IEnumerator Start()
    {
        ResourceRequest request = Resources.LoadAsync<Sprite>(iconPath);
        yield return request;
        
        if (request.asset != null)
        {
            heroIcon.sprite = request.asset as Sprite;
        }
    }
}

6.2 对象池管理技能特效

using System.Collections.Generic;
using UnityEngine;

public class SkillEffectPool : MonoBehaviour
{
    public GameObject effectPrefab;
    public int poolSize = 5;
    
    private Queue<GameObject> effectPool = new Queue<GameObject>();
    
    void Start()
    {
        for (int i = 0; i < poolSize; i++)
        {
            GameObject effect = Instantiate(effectPrefab);
            effect.SetActive(false);
            effectPool.Enqueue(effect);
        }
    }
    
    public GameObject GetEffect()
    {
        if (effectPool.Count > 0)
        {
            GameObject effect = effectPool.Dequeue();
            effect.SetActive(true);
            return effect;
        }
        return Instantiate(effectPrefab);
    }
    
    public void ReturnEffect(GameObject effect)
    {
        effect.SetActive(false);
        effectPool.Enqueue(effect);
    }
}

7. 扩展功能

7.1 技能连招演示

public class ComboSystem : MonoBehaviour
{
    public List<HeroSkill> comboSequence = new List<HeroSkill>();
    public float comboDelay = 0.5f;
    
    private bool isPlayingCombo = false;
    
    public void PlayCombo()
    {
        if (!isPlayingCombo)
        {
            StartCoroutine(PlayComboSequence());
        }
    }
    
    private IEnumerator PlayComboSequence()
    {
        isPlayingCombo = true;
        
        foreach (var skill in comboSequence)
        {
            // 播放技能特效
            PlaySkillEffect(skill);
            
            // 更新UI显示当前技能
            UIManager.Instance.UpdateCurrentSkill(skill);
            
            yield return new WaitForSeconds(comboDelay);
        }
        
        isPlayingCombo = false;
    }
    
    private void PlaySkillEffect(HeroSkill skill)
    {
        // 实现技能特效播放逻辑
    }
}

7.2 技能升级系统

public class SkillUpgradeSystem : MonoBehaviour
{
    public HeroData currentHero;
    
    public void UpgradeSkill(int skillIndex)
    {
        if (skillIndex >= 0 && skillIndex < currentHero.skills.Count)
        {
            HeroSkill skill = currentHero.skills[skillIndex];
            
            // 减少冷却时间
            skill.cooldown = Mathf.Max(0.5f, skill.cooldown * 0.9f);
            
            // 更新技能描述
            skill.skillDescription += "\n(已升级)";
            
            // 保存升级数据
            SaveSkillUpgrade(currentHero.heroId, skillIndex);
        }
    }
    
    private void SaveSkillUpgrade(int heroId, int skillIndex)
    {
        string key = $"{heroId}_skill_{skillIndex}";
        PlayerPrefs.SetInt(key, PlayerPrefs.GetInt(key, 0) + 1);
    }
}