Unity 2022.3.31f1中iOS平台Vuforia AR视频背景纹理访问异常

环境参数 #

• Unity版本：2022.3.31f1
• 目标平台：iOS
• Vuforia SDK版本：10.24.4

问题概述 #

调用VuforiaBehaviour.Instance.VideoBackground.VideoBackgroundTexture获取的纹理对象不为空，但赋值给Raw Image组件后呈现完全透明状态（所有像素通道无图像），调用StartVideoBackgroundRendering()/StopVideoBackgroundRendering()无法解决问题。

解决步骤 #

1. 调整Vuforia视频背景渲染模式 #

打开Vuforia Configuration面板，将Video Background模块的Render Mode设置为Texture。只有该模式下，VideoBackgroundTexture才会被正确填充视频流像素数据。

2. 转换纹理格式适配Raw Image #

iOS平台下Vuforia返回的视频纹理可能为YUV格式，Raw Image无法直接解析。可通过Graphics.CopyTexture转换为兼容的RGBA格式：

using UnityEngine;
using UnityEngine.UI;
using Vuforia;

public class VideoBackgroundDebug : MonoBehaviour
{
    public RawImage debugRawImage;

    void Update()
    {
        Texture vuforiaTexture = VuforiaBehaviour.Instance.VideoBackground.VideoBackgroundTexture;
        if (vuforiaTexture != null && debugRawImage.texture != vuforiaTexture)
        {
            Texture2D convertedTexture = new Texture2D(vuforiaTexture.width, vuforiaTexture.height, TextureFormat.RGBA32, false);
            Graphics.CopyTexture(vuforiaTexture, convertedTexture);
            debugRawImage.texture = convertedTexture;
            // 释放旧纹理避免内存泄漏
            Destroy(debugRawImage.texture);
        }
    }
}

3. 延迟获取纹理至Vuforia初始化完成 #

Vuforia初始化阶段纹理已创建但未填充数据，需等待初始化完成后再获取：

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

public class VideoBackgroundDebug : MonoBehaviour
{
    public RawImage debugRawImage;

    void Start()
    {
        VuforiaARController.Instance.OnVuforiaInitialized += OnVuforiaReady;
    }

    void OnVuforiaReady(VuforiaInitError error)
    {
        if (error == VuforiaInitError.NONE)
        {
            StartCoroutine(AssignTextureAfterDelay(0.5f));
        }
    }

    IEnumerator AssignTextureAfterDelay(float delay)
    {
        yield return new WaitForSeconds(delay);
        debugRawImage.texture = VuforiaBehaviour.Instance.VideoBackground.VideoBackgroundTexture;
    }

    void OnDestroy()
    {
        VuforiaARController.Instance.OnVuforiaInitialized -= OnVuforiaReady;
    }
}

4. 验证相机权限与初始化状态 #

• 检查iOS项目的Info.plist，确保已添加NSCameraUsageDescription键并填写权限说明，无相机权限时Vuforia无法捕获视频流。
• 代码中判断Vuforia初始化状态，未完成时不访问纹理：

if (VuforiaBehaviour.Instance.InitializationState == InitializationState.INITIALIZED)
{
    // 访问VideoBackgroundTexture
}

5. 确认视频背景激活状态 #

确保VuforiaBehaviour.Instance.VideoBackground.VideoBackgroundEnabled为true，该参数为false时视频背景不会渲染，纹理无数据更新。

内容的提问来源于stack exchange，提问作者MD. Nurul Amin OLY