跳到主要内容

aclvdecSendSkippedFrame

aclvdecSendSkippedFrame​

函数功能​

如果不想获取某一帧的解码结果， 可以调用本接口， 将待解码的码流（输入内存)传到解码器进行解码，此时，解码结果最终不会输出，解码完成的回调函数中返回的output为nullptr。异步接口。

约束说明​

  • 发送数据前必须保证通道已经被创建，否则返回错误。
  • 发送码流时须按帧发送，一次只发送完整的一帧码流。
  • 不能发送eos为0的空码流包（码流长度为0或码流地址为空）。
  • 不可以发送eos为1的帧。
  • 由于码流异常、解码超时等原因，可能导致aclvdecSendFrame接口发送帧或发送eos失败，建议用户在编写代码时，获取该接口的返回码，当该接口调用失败时，进行异常处理。
  • aclvdecSendSkippedFrame接口内部封装了aclrtLaunchCallback接口，用于在Stream的任务队列中增加一个需要执行的回调函数。用户在实现VDEC功能时，无需再单独调用aclrtLaunchCallback接口。

函数原型​

aclError aclvdecSendSkippedFrame(****aclvdecChannelDesc *channelDesc,

acldvppStreamDesc *input,

aclvdecFrameConfig *config,

void *userData)

参数说明​

参数名输入/输出说明
channelDesc输入通道描述信息的指针。 与调用aclvdecCreateChannel接口创建通道时指定的channelDesc保持一致。 调用aclvdecSetChannelDesc系列接口设置通道描述信息的属性，包括解码通道号、线程、回调函数、视频编码协议等。
input输入输入码流描述信息的指针，输入内存用户需提前申请。
- 调用acldvppCreateStreamDesc接口创建码流描述信息，调用acldvppSetStreamDesc系列接口设置视频码流信息的属性（例如，码流格式）。 输入码流格式以通道描述信息中设置的格式为准，调用acldvppSetStreamDescFormat接口设置输入码流格式无效。
- 输入视频码流的分辨率、视频格式的要求，请参见功能及约束说明。
config输入解码配置的指针，预留，当前可填NULL。
userData输入用户自定义数据的指针。 如果用户需要获取解码的帧序号，则可以在userData参数处定义，然后解码的帧序号可以通过userData参数传递给VDEC的回调函数，用于确定回调函数中处理的是第几帧数据。

返回值说明​

返回0表示成功，返回非0表示失败。

父主题： VDEC功能

aclvdecCallback​

函数功能​

视频解码回调函数，同步接口。用户需自定义该回调函数。

约束说明​

  • 在回调函数中不能执行销毁通道操作，否则会导致程序执行死锁。

  • 回调函数处理的时延应满足发帧帧率要求，否则会影响aclvdecSendFrame接口进行视频帧处理的实时性。

  • 注销回调线程要在所有Callback执行完成后（即注销送码流线程之后）。

  • 当使用了抽帧功能后（调用aclvdecSendSkippedFrame接口），回调相应帧的output为nullptr。

    对于抽帧的情况，输出Buffer无解码结果，且抽掉的帧按照顺序输出。

    对于不抽帧的情况，输出Buffer中才会有解码结果，且不抽的帧按照顺序输出。

    如果解码码流中同时存在抽帧、不抽帧的情况，则系统不保证抽掉的帧与不抽的帧之间按照顺序输出。

函数原型​

void (* aclvdecCallback) (****acldvppStreamDesc * input, acldvppPicDesc * output, void* userData)

参数说明​

参数名输入/输出说明
input输入输入码流描述信息的指针。与aclvdecSendFrame接口中的input一致。
output输入VDEC解码后的输出图片描述信息的指针，输出内存用户需提前申请。
userData输入用户自定义数据的指针。

返回值说明​

无

参考资源​

接口调用流程及示例，参见VDEC视频解码。

父主题： VDEC功能

功能及约束说明​

功能说明​

VENC（Video Encoder）将YUV420SP NV12/NV21-8bit图片数据编码成H264/H265格式的视频码流。

分辨率约束​

  • 输入图片分辨率：

    版本分辨率范围
    Atlas 200/500 A2推理产品最大分辨率8192*8192，最小分辨率114*114。

  • 输出码流分辨率

    VENC只对图片编码，不会改变图片分辨率，因此输出与输入的图片分辨率保持一致。

码流/图片格式、宽高对齐、内存约束​

实现VENC视频编码功能时：

  • 输入内存

    需调用acldvppMalloc接口申请Device上的输入内存，调用acldvppFree接口释放输入内存，这部分内存的生命周期由用户自行管理。内存大小参见下表中的计算公式。

  • 输出内存

    不需要用户管理输出内存，由系统管理内存。

:::note 说明 输入图片格式的定义请参见acldvppPixelFormat，宽stride、高stride等概念请参见基本概念。 :::

表1 图片格式、宽高对齐、内存大小约束

输入图片格式

输入图片宽、高对齐要求

输入图片宽stride、高stride、内存大小要求

输出码流格式

YUV420SP NV12 8bit

宽2对齐

高2对齐

宽stride为宽16对齐后的值。

高stride无需设置。

内存大小（单位Byte）= 宽stride * 高 * 3/2

  • H264 BP/MP/HP
  • H265 MP（仅支持Slice码流）

YUV420SP NV21 8bit

父主题： VENC功能

性能指标说明​

性能指标说明（Atlas 200/500 A2推理产品）​

单个Device的基本场景性能指标参考如下（1路对应一个通道，一个通道对应一个线程）:

720p指分辨率为1280*720的图片；1080p指分辨率为1920*1080的图片；4K指分辨率为3840*2160的图片。

场景举例总帧率
720p*n路(1≤n≤3)n*400fps
720p*n路(n>3)1200fps
1080p*n路(1≤n≤3)n*200fps
1080p*n路(n>3)600fps
4k*n路(1≤n≤3)n*50fps
4k*n路(n>3)150fps

注：其它分辨率可以等量估算。

父主题： VENC功能

aclvencSendFrame​

函数功能​

将待编码的图片传到编码器进行编码。异步接口。

约束说明​

  • 发送数据前必须保证通道已经被创建，否则返回错误。
  • 不能发送eos为0的空码流包（码流长度为0或码流地址为空）。
  • 结束视频编码时可以发送eos为1的空图片，表示当前编码结束。
  • 编码时，输入内存需要在aclvencCallback回调函数内获取结果之后才能进行释放。

函数原型​

aclError aclvencSendFrame(aclvencChannelDesc *channelDesc,

acldvppPicDesc *input,

void *reserve,

aclvencFrameConfig *config,

void *userdata)

参数说明​

参数名输入/输出说明
channelDesc输入通道描述信息的指针。 与调用aclvencCreateChannel接口创建通道时指定的channelDesc保持一致。 在通道描述信息中指定视频编码的回调函数。
input输入输入图片描述信息的指针，输入内存用户需提前申请。
- 调用acldvppCreatePicDesc接口创建图片描述信息，调用acldvppSetPicDesc系列接口设置图片描述参数（例如，宽、高等）。 输入图片格式以通道描述信息中设置的格式为准，调用acldvppSetPicDescFormat接口设置输入图片格式无效。
- 输入图片的分辨率、格式的要求，请参见功能及约束说明。
reserve输入预留参数，暂不使用。
config输入单帧配置数据的指针。
userdata输入用户自定义数据的指针。

返回值说明​

返回0表示成功，返回非0表示失败。

参考资源​

接口调用流程及示例，参见VENC视频编码。

父主题： VENC功能

在线提单