You need to enable JavaScript to run this app. Unity安卓USB摄像头推Agora流时GetRawTextureData返回空数组问题
优惠活动
大模型
产品
解决方案
定价
更多

Unity安卓USB摄像头推Agora流时GetRawTextureData返回空数组问题

问题根源

你遇到的空字节数组问题,核心原因和插件实现机制直接相关,和调用逻辑本身没有直接错误:

  • 该USB相机插件返回的Texture2D为外部纹理(External Texture) 类型,这类纹理为了实现低延迟采集,不会在Unity托管内存中存储CPU可访问的像素副本,仅保留GPU侧的纹理句柄。
  • Texture2D.GetRawTextureData()方法的读取范围是Unity托管侧分配的可读纹理内存,外部纹理没有对应的托管内存块,因此无论怎么调用,返回的数组长度都为0。
  • 你能把该纹理输出到UI正常显示,是因为RawImage组件直接采样GPU侧的纹理句柄完成渲染,整个渲染流程完全不经过CPU内存,所以显示效果正常和CPU侧能否读取到纹理字节是两个独立的逻辑链路,不存在因果关系。
  • 少量场景下,插件返回的Texture2D会使用堆外原生内存存储像素数据,Unity托管层没有这块内存的访问权限,也会导致GetRawTextureData返回空数组。
可落地的替代实现方案

按照性能优先级从高到低排序:

方案1:直接使用Agora外部纹理推送能力(性能最优,零拷贝)

Agora视频SDK本身支持直接接收GPU侧的外部纹理ID完成推流,完全不需要将纹理数据读回CPU内存、转换为字节数组:

  • 获取插件返回Texture2D对应的Android原生纹理ID(插件API一般会提供获取该值的方法)
  • 直接通过Agora的IVideoFrameConsumer接口,传入外部纹理ID、对应的纹理坐标变换矩阵、时间戳参数即可完成推流,没有额外的CPU/GPU拷贝开销,延迟最低。

方案2:调用插件的原生帧字节回调(性能次优)

绝大多数USB相机采集类插件,都会在原生层提供原始采集帧的回调接口,直接将采集到的YUV/RGB格式字节流抛到Unity层:

  • 跳过GetFrame()返回Texture2D的路径,直接注册插件的原生帧回调
  • 拿到的字节流可以直接对接Agora的自定义视频帧接口,不需要经过纹理中转的读回流程,性能远高于纹理读回方案。

方案3:RenderTexture中转实现纹理读回(通用兼容方案)

如果插件没有提供上述两个接口,就需要通过RenderTexture中转,把GPU侧的纹理内容拷贝到CPU可读的托管内存中,核心是不要直接读取插件返回的原纹理数据:

  1. 提前初始化固定大小的中转资源,避免每帧创建带来的GC开销
  2. 通过Graphics.Blit()将原外部纹理的内容拷贝到临时RenderTexture
  3. 激活RenderTexture后,用自建的可读Texture2D通过ReadPixels()把像素内容从GPU读回CPU内存
  4. 读取自建Texture2D的原始字节数组即可推送Agora

示例实现代码:

// 提前初始化固定资源,避免GC
private RenderTexture _tempRT;
private Texture2D _readableFrameTex;
private readonly int _frameWidth = 640;
private readonly int _frameHeight = 480;
private byte[] _fixedFrameBuffer;

void Init()
{
    // 创建和帧分辨率一致的临时RenderTexture
    _tempRT = RenderTexture.GetTemporary(_frameWidth, _frameHeight, 0, RenderTextureFormat.ARGB32);
    // 创建可读的托管纹理,必须设置为可读(默认创建的NonReadable属性的Texture2D也会导致读回失败)
    _readableFrameTex = new Texture2D(_frameWidth, _frameHeight, TextureFormat.RGBA32, false);
    // 预分配固定大小的字节缓冲区,避免每帧新建数组
    _fixedFrameBuffer = new byte[_frameWidth * _frameHeight * 4];
}

// 取帧循环逻辑
while (!usbStopped)
{
    tempTexture2D = usbCamera.GetFrame(0);
    if (tempTexture2D == null) continue;

    // 将GPU侧的外部纹理拷贝到临时RenderTexture
    Graphics.Blit(tempTexture2D, _tempRT);
    // 激活目标RenderTexture准备读回
    RenderTexture.active = _tempRT;
    // 将像素读取到自有的可读纹理中
    _readableFrameTex.ReadPixels(new Rect(0, 0, _frameWidth, _frameHeight), 0, 0);
    _readableFrameTex.Apply();
    // 重置激活的RenderTexture,避免影响其他渲染逻辑
    RenderTexture.active = null;

    // 将纹理数据拷贝到预分配的固定缓冲区
    _readableFrameTex.GetRawTextureData().CopyTo(_fixedFrameBuffer);
    
    // 此时_fixedFrameBuffer长度固定,可直接用于Agora推流
    yield return StartCoroutine(PushFrame(_fixedFrameBuffer, _frameWidth, _frameHeight, () => { }));
}
原代码的额外注意点
  • 不要直接使用GetRawTextureData()返回的内存引用作为跨协程传参:该方法返回的是Unity原生内存的直接映射,不是独立的托管数组,一旦将引用置空或者被其他逻辑覆盖,会导致推流的帧数据出现撕裂、花屏的问题,必须拷贝到独立的托管字节缓冲区再使用。
  • 协程中不要在启动时就把bytes引用置空,应该等帧推送完成后再做缓冲区的复用,避免空引用问题。

内容的提问来源于stack exchange,提问作者Salbrox

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.25 15:15:03