如何基于PUN2实现Meta Quest 3多用户空间锚点共享同步？

核心实现逻辑 #

Meta空间锚点无法直接通过网络传输，需先将其序列化为字节数组，再通过PUN2的RPC机制或房间自定义属性同步至其他客户端；远端客户端接收字节数据后，反序列化为本地空间锚点，最终将场景物体绑定到重建的锚点上完成空间同步。

代码示例 #

1. 空间锚点序列化/反序列化工具类 #

封装Meta XR SDK的锚点序列化逻辑，处理异步操作：

using UnityEngine;
using UnityEngine.XR.MagicLeap;
using System.Threading.Tasks;

public static class SpatialAnchorSyncUtils
{
    // 序列化空间锚点为字节数组
    public static async Task<byte[]> SerializeAnchor(XRSpatialAnchor anchor)
    {
        if (anchor == null) return null;
        
        var serializeTask = new TaskCompletionSource<byte[]>();
        XRSpatialAnchorUtility.SerializeAsync(anchor, (success, data) =>
        {
            serializeTask.SetResult(success ? data : null);
        });
        
        return await serializeTask.Task;
    }

    // 反序列化字节数组为本地空间锚点
    public static async Task<XRSpatialAnchor> DeserializeAnchor(byte[] anchorData)
    {
        if (anchorData == null || anchorData.Length == 0) return null;
        
        var deserializeTask = new TaskCompletionSource<XRSpatialAnchor>();
        XRSpatialAnchorUtility.DeserializeAsync(anchorData, (success, anchor) =>
        {
            deserializeTask.SetResult(success ? anchor : null);
        });
        
        return await deserializeTask.Task;
    }
}

2. 本地锚点创建与同步脚本 #

挂载到负责创建锚点的物体上，需添加PhotonView组件：

using UnityEngine;
using UnityEngine.XR.MagicLeap;
using Photon.Pun;
using System.Threading.Tasks;

public class LocalAnchorCreator : MonoBehaviourPunCallbacks
{
    // 锚点对应的可视化预制体（需在Photon Dashboard中注册）
    public GameObject anchorPrefab;

    // 本地创建锚点并同步至所有客户端
    public async void CreateAndSyncAnchor(Vector3 position, Quaternion rotation)
    {
        // 1. 创建本地空间锚点载体
        var anchorGameObject = new GameObject("LocalSpatialAnchor");
        anchorGameObject.transform.SetPositionAndRotation(position, rotation);
        var spatialAnchor = anchorGameObject.AddComponent<XRSpatialAnchor>();
        
        // 等待锚点初始化完成
        await Task.Delay(500);
        if (!spatialAnchor.isActiveAndEnabled)
        {
            Debug.LogError("空间锚点初始化失败");
            Destroy(anchorGameObject);
            return;
        }

        // 2. 序列化锚点数据
        byte[] anchorData = await SpatialAnchorSyncUtils.SerializeAnchor(spatialAnchor);
        if (anchorData == null)
        {
            Debug.LogError("锚点序列化失败");
            Destroy(anchorGameObject);
            return;
        }

        // 3. 通过RPC同步到所有客户端（包括自身）
        photonView.RPC(nameof(SyncAnchorToClients), RpcTarget.All, anchorData, position, rotation);
        // 销毁本地临时锚点载体，改用同步后的实例
        Destroy(anchorGameObject);
    }

    [PunRPC]
    private async void SyncAnchorToClients(byte[] anchorData, Vector3 initPos, Quaternion initRot)
    {
        // 4. 反序列化重建远端锚点
        XRSpatialAnchor remoteAnchor = await SpatialAnchorSyncUtils.DeserializeAnchor(anchorData);
        if (remoteAnchor == null)
        {
            Debug.LogError("远端锚点反序列化失败");
            return;
        }

        // 5. 实例化锚点预制体并绑定到重建的空间锚点
        GameObject anchorInstance = PhotonNetwork.Instantiate(anchorPrefab.name, initPos, initRot);
        anchorInstance.transform.SetParent(remoteAnchor.transform);
    }
}

3. 房间历史锚点同步（可选） #

确保新加入房间的客户端能同步已创建的锚点，通过房间自定义属性存储锚点数据：

using Photon.Pun;
using Photon.Realtime;
using System.Collections.Generic;
using UnityEngine;

public class RoomAnchorManager : MonoBehaviourPunCallbacks
{
    private Dictionary<string, byte[]> roomAnchors = new Dictionary<string, byte[]>();
    public GameObject anchorPrefab;

    public override void OnJoinedRoom()
    {
        // 加载房间已有的锚点数据
        if (PhotonNetwork.CurrentRoom.CustomProperties.TryGetValue("RoomAnchors", out var anchorsObj))
        {
            roomAnchors = anchorsObj as Dictionary<string, byte[]>;
            foreach (var anchorData in roomAnchors.Values)
            {
                _ = SpatialAnchorSyncUtils.DeserializeAnchor(anchorData).ContinueWith(task =>
                {
                    if (task.Result != null)
                    {
                        GameObject anchorInstance = PhotonNetwork.Instantiate(anchorPrefab.name, Vector3.zero, Quaternion.identity);
                        anchorInstance.transform.SetParent(task.Result.transform);
                    }
                });
            }
        }
    }

    // 将新锚点数据存入房间属性
    public void AddAnchorToRoom(string anchorId, byte[] anchorData)
    {
        if (!roomAnchors.ContainsKey(anchorId))
        {
            roomAnchors.Add(anchorId, anchorData);
            PhotonNetwork.CurrentRoom.SetCustomProperties(new ExitGames.Client.Photon.Hashtable { { "RoomAnchors", roomAnchors } });
        }
    }
}

最佳实践 #

• 权限控制：仅允许锚点创建者或房间主人发起同步请求，通过PhotonNetwork.IsMasterClient或本地玩家ID判断，避免重复创建锚点。
• 错误处理：序列化/反序列化失败时，及时提示用户重新创建锚点，避免无效同步。
• 唯一ID管理：为每个锚点生成唯一标识（如$"{PhotonNetwork.LocalPlayer.ActorNumber}_{System.Guid.NewGuid()}"），防止数据冲突。
• 性能优化：锚点序列化数据体积较大，仅在锚点创建/修改时发起同步，避免频繁网络传输。
• 资源清理：客户端离开房间时，遍历销毁所有本地重建的空间锚点与对应物体，避免内存泄漏。
• 定位验证：锚点重建后，通过XRSpatialAnchor.isLocated属性确认锚点是否成功定位到物理空间，若失败则触发重试逻辑。

内容的提问来源于stack exchange，提问作者Yumekawa-chan