[TOC]

libqy265enc.c和libqy265dec.c分别是编码器和解码器集成到FFMPEG的wrapper文件，同时也可以作为编解码器接口调用的示例代码供参考。其中的代码示例默认为服务端集成方案，移动端集成时需参考ksc265_sdk文档中的鉴权章节来更新参数传递部分。

以下说明同时包含编码器和解码器的集成，如果只集成编码器或解码器，可以选择相应的部分。

1. 将接口文件qy265def.h, qy265enc.h, qy265dec.h，以及wrapper文件libqy265enc.c, libqy265dec.c放到libavcodec目录
2. 修改ffmpeg的文件libavcodec/allcodec.c添加 REGISTER_ENCDEC(LIBQY265, libqy265);
3. 修改ffmpeg的配置，libavcodec/Makefile添加

OBJS-$(CONFIG_LIBQY265_ENCODER)           += libqy265enc.o
OBJS-$(CONFIG_LIBQY265_DECODER)           += libqy265dec.o

与libqy265enc.c和libqy265dec.c对应。

执行./configure时增加以下选项：

• --enable-encoder=libqy265以及--enable-decoder=libqy265

• 如果qy265def.h, qy265enc.h, qy265dec.h没有放置在libavcodec目录，增加--extra-cflags='-Ixxxdir '，xxxdir为对应目录

• --extra-ldflags='-Lxxxlibs', xxxlibs为编解码库所在目录

• --extra-libs="-lqy265 -lstdc++"， libqy265.a是编解码打包在一起的库，此外目前编解码器还用到c++标准库。对于单独链接编码器或解码器，在不同平台上有差异。

• linux: 编码库libqyencoder.a, 解码库libqydecoder.a，c++标准库-lstdc++

• android: 编码库libqyencoder.a, 解码库libqydecoder.a，c++标准库gnustl_static。Android还需要链接cpufeatures，链接顺序示例: -lqydecoder -lcpufeatures -llog -lgnustl_static

• ios: 编码库libqyencoder.a + libqycommon.a，解码库libqydecoder.a + libqycommon.a。libqycommon.a是编码器和解码器的公用库。链接顺序示例: -lqycommon -lqydecoder -lc++

对于服务端转码还需要定 -DKSAUTH_PRIVATE_AUTH=1 或者将在qyauth_env.h中将 KSAUTH_PRIVATE_AUTH 的默认值改为1

ffmpeg解码

./ffmpeg -qydec_threads [number] -vcodec libqy265dec -qylf ./qy265.key -i [name].[hevc|mp4] -pix_fmt yuv420p -f rawvideo -y /dev/null

服务端转码： ./ffmpeg -i [name] -c:v libqy265 -qylf ./qy265.key -qy265-params [name0=value0,name1=value1...] -y [name]

示例: ./ffmpeg -i test.mp4 -c:v libqy265 -qylf ./qy265.key -qy265-params rcType=1:threads=4 -y out.mp4

恒定质量模式编码：

./ffmpeg -i [name] [params] -vcodec libqy265 -r [frnum] -pix_fmt yuv420p -preset [superfast|veryfast|fast|medium|slow|veryslow|placebo] -latency [zerolatency|livestreaming|offline] -qy265-params rctype=3:crf=[crfnum]:threads=[thrnum]:iper=[ipernum]:qpmin=[qminnum] :qpmax=[qmaxnum]:fr=[frnum]:bframes=[bfnum]:wpp=[0|1]:fpp=[0|1]:psnr=[0|1|2]:temporalLayer=[0|1]:VbvMaxRate=[vbvrate]:VbvBufsize=[vbvsize] -y [output]

恒定码率模式编码：

./ffmpeg -i [name] [params] -vcodec libqy265 -r [frnum] -pix_fmt yuv420p -preset [superfast|veryfast|fast|medium|slow|veryslow] -latency [zerolatency|livestreaming|offline] -qy265-params rctype=[1|2]:br=[btrnum]:threads=[thrnum]:iper=[ipernum]:qpmin=[qminnum]:qpmax=[qmaxnum]:fr=[frnum]:bframes=[bfnum]:wpp=[0|1]:fpp=[0|1]:psnr=[0|1|2]:temporalLayer=[0|1]:VbvMaxRate=[vbvrate]:VbvBufsize=[vbvsize] -y [output]