跳到主要内容

OffscreenSharedTexture 对象

  • textureInfo 对象 - 共享纹理信息。
    • widgetType string - 纹理的窗口小部件类型。可以是 popupframe
    • pixelFormat string - 纹理的像素格式。可以是 rgbabgra
    • codedSize Size - 视频帧的完整尺寸。
    • visibleRect Rectangle - [0, 0, codedSize.width(), codedSize.height()] 的一个子区域。在 OSR 情况下,它应该包含完整区域。
    • contentRect Rectangle - 捕获器想要填充的视频帧区域。在 OSR 情况下,它与需要绘制的 dirtyRect 相同。
    • timestamp number - 自捕获开始以来经过的时间(以微秒为单位)。
    • metadata 对象 - 额外元数据。有关准确详细信息,请参阅 src\media\base\video_frame_metadata.h 中的注释。
      • captureUpdateRect Rectangle (可选) - 帧的更新区域,可以视为 dirty 区域。
      • regionCaptureRect Rectangle (可选) - 如果内部使用区域捕获,则可能反映帧的内容原点。
      • sourceSize Rectangle (可选) - 源帧的完整大小。
      • frameCount number (可选) - 捕获帧的递增计数。如果两个连续接收的帧之间有帧丢失,则可能包含间隔。
    • sharedTextureHandle Buffer Windows macOS - 共享纹理的句柄。
    • planes 对象[] Linux - 共享纹理的每个平面信息。
      • stride number - 通过内存映射访问缓冲区时要使用的字节步幅和偏移量。每个条目对应一个平面。
      • offset number - 通过内存映射访问缓冲区时要使用的字节步幅和偏移量。每个条目对应一个平面。
      • size number - 平面大小(以字节为单位)。这是映射缓冲区所必需的。
      • fd number - 底层内存对象(通常是 dmabuf)的文件描述符。
    • modifier string Linux - 修饰符从 GBM 库检索并传递给 EGL 驱动程序。
  • release Function - 释放资源。texture 不能直接传递给另一个进程,用户需要在主进程中维护纹理生命周期,但将 textureInfo 传递给另一个进程是安全的。同一时间只能存在有限数量的纹理,因此在完成纹理操作后立即调用 texture.release() 非常重要。