基于Unity Netcode实现玩家自定义头像及跨客户端同步的技术咨询

一、本地加载并显示头像 #

1. 跨平台文件选择 #

EditorUtility.OpenFilePanel仅在编辑器生效，打包后需用平台原生文件选择API：

public void OnPickAvatarBtnClick()
{
    string filePath = string.Empty;
#if UNITY_WINDOWS
    filePath = UnityEngine.Windows.Directory.OpenFilePanel("选择头像", "", "png,jpg", false);
#elif UNITY_STANDALONE_OSX
    filePath = UnityEditor.EditorUtility.OpenFilePanel("选择头像", "", "png,jpg");
#endif

    if (!string.IsNullOrEmpty(filePath))
    {
        LoadAvatarToLocal(filePath);
    }
}

2. 转Texture2D并绑定到UI组件 #

读取本地图片字节流，转成可显示的Sprite：

private void LoadAvatarToLocal(string path)
{
    byte[] imgBytes = System.IO.File.ReadAllBytes(path);
    Texture2D avatarTex = new Texture2D(2, 2);
    avatarTex.LoadImage(imgBytes); // 自动适配图片尺寸

    // 生成Sprite并赋值给Image组件
    Sprite avatarSprite = Sprite.Create(avatarTex, new Rect(0,0,avatarTex.width,avatarTex.height), new Vector2(0.5f,0.5f));
    GetComponent<UnityEngine.UI.Image>().sprite = avatarSprite;

    // 同步到其他客户端
    SyncAvatarToServer(avatarTex);
}

二、Netcode跨客户端同步 #

1. 用NetworkVariable实现自动同步 #

在玩家的NetworkBehaviour脚本中，定义存储头像数据的NetworkVariable，监听变化更新UI：

using Unity.Netcode;

public class PlayerAvatarSync : NetworkBehaviour
{
    [SerializeField] private UnityEngine.UI.Image avatarDisplay;

    // 服务器可写，所有客户端可读的头像字节数据
    private NetworkVariable<byte[]> _avatarData = new NetworkVariable<byte[]>(null, NetworkVariableReadPermission.Everyone, NetworkVariableWritePermission.Server);

    void Awake()
    {
        // 监听头像数据变化，自动更新本地UI
        _avatarData.OnValueChanged += OnAvatarDataUpdated;
    }

    void OnAvatarDataUpdated(byte[] oldData, byte[] newData)
    {
        if (newData == null || newData.Length == 0) return;

        Texture2D tex = new Texture2D(2,2);
        tex.LoadImage(newData);
        avatarDisplay.sprite = Sprite.Create(tex, new Rect(0,0,tex.width,tex.height), new Vector2(0.5f,0.5f));
    }

    // 客户端向服务器提交头像数据的ServerRpc（仅自身可调用）
    [ServerRpc(RequireOwnership = true)]
    void UploadAvatarServerRpc(byte[] avatarBytes)
    {
        _avatarData.Value = avatarBytes;
    }

    // 本地加载完成后调用，发起同步请求
    private void SyncAvatarToServer(Texture2D avatarTex)
    {
        byte[] compressedData = avatarTex.EncodeToPNG(); // 或EncodeToJPG(80)压缩体积
        UploadAvatarServerRpc(compressedData);
    }
}

2. 关键优化点 #

• 限制图片尺寸：避免大图片占用带宽，加载时可强制压缩：

  avatarTex.Resize(256, 256);
  avatarTex.Apply();
  

• 权限控制：RequireOwnership = true确保只有玩家自己能修改头像，防止恶意操作。
• 默认头像：初始化时给_avatarData赋值默认头像的字节数组，避免空数据。

流程梳理 #

1. 玩家点击按钮选择本地图片
2. 本地加载图片并更新UI
3. 客户端调用ServerRpc将图片字节数据传给服务器
4. 服务器更新NetworkVariable，Netcode自动同步到所有客户端
5. 各客户端监听数据变化，更新对应玩家的头像显示

内容的提问来源于stack exchange，提问作者couchpotat