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可读的托管内存中,核心是不要直接读取插件返回的原纹理数据:
- 提前初始化固定大小的中转资源,避免每帧创建带来的GC开销
- 通过
Graphics.Blit()将原外部纹理的内容拷贝到临时RenderTexture - 激活RenderTexture后,用自建的可读Texture2D通过
ReadPixels()把像素内容从GPU读回CPU内存 - 读取自建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
相关产品推荐
相关产品推荐

