全闭环转码系统使用参考

相关说明

全闭环转码系统,即搭建好EFV高级版系统后,设置好相关的转码参数,然后可以不用管了,这时候可以在任意服务器或者第三方程序上利用EFV高级版API各种调用。

提示:注意使用api前,请前往转码设置,开启api,然后修改下apikey等各种参数,尽量复杂点;且自动转码队列需要开启。

这里只列举2个常用示例,如下:

1、远程上传视频 + 自动转码 + 自动获取m3u8等链接信息
2、远程创建转码任务 + 自动转码 + 自动获取m3u8等链接信息
3、远程下载m3u8/mp4、youtube等直链视频 + 自动转码 + 自动获取m3u8等链接信息

其它玩法可自行参考api文档,Fluent API使用(转码端)CMS API使用(CMS端)

一、本地/远程上传视频 + 自动转码 + 自动获取m3u8等链接信息

1、上传视频

这里推荐使用简易上传接口,接口如下:

POST /api/simpleupload  //可根据后台设置m3u8路径自己架构返回的m3u8地址。

body: {
    uploadkey,
    file,
}

response: {
    success: 1,
    id, //返回上传成功的视频objectid,用于构建m3u8地址。
}

#curl命令使用示例,uploadkey为上传凭证,可在转码设置处获取
curl http://efv.moemv.com/api/simpleupload?uploadkey=7e8EgFAe -F "file=@/root/xx.mp4"

我们上传后,会自动返回一个视频objectid,我们可以直接拿来识别该视频的相关链接信息。

注意上传如果报错413状态码,则可能是nginx上传限制,调整下nginx上传限制大小即可。

2、如何自动获取视频m3u8,截图等信息

1种方法,前往转码设置 开启转码完成自动通知,并设置好通知域名,即视频转码完成后,立马会将m3u8链接等信息自动通知到指定域名,我们只需要接收好信息即可,更多通知玩法可参考该文档:点击查看,下方列举的通知域名获取转码信息详细说明。

2种方法,由于我们上传后,会获取到视频id,我们可以先设置好切片路径:设置教程,推荐设置{id}/{hd}hd就是分辨率标识,如7201080;这样做的目的就是我们上传后,可以通过获取到的视频id提前组装好相关链接,等待视频自动转码切片后,就可以直接用了。

链接参考:

自适应m3u8链接
/movie/auto/6372efe36ba1696083763a27.m3u8
720P M3U8链接
/videos/6372efe36ba1696083763a27/720/index.m3u8
1080P M3U8链接
/videos/6372efe36ba1696083763a27/1080/index.m3u8

二维码分享链接
/qrcode/share/6372efe36ba1696083763a27
二维码分享图片
/shareimage/6372efe36ba1696083763a27

MP4地址
/videos/6372efe36ba1696083763a27/720.mp4
/videos/6372efe36ba1696083763a27/1080.mp4

封面1
/videos/6372efe36ba1696083763a27/cover.jpg
封面2
/videos/6372efe36ba1696083763a27/poster2.jpg

预览视频
/videos/6372efe36ba1696083763a27/preview.mp4

缩略图和动态图
/videos/6372efe36ba1696083763a27/1.gif
/videos/6372efe36ba1696083763a27/0.jpg
/videos/6372efe36ba1696083763a27/1.jpg
/videos/6372efe36ba1696083763a27/2.jpg
/videos/6372efe36ba1696083763a27/3.jpg

上方6372efe36ba1696083763a27为视频id,差不多就这一个变量,其余都是固定参数,可自由组装提前获取。

二、远程创建转码任务 + 自动转码 + 自动获取m3u8等链接信息

1、远程创建转码任务

post: /apifluent/createjob

data: {
apikey,
apisecret,
clientId,  //传递一个数据库id,即客户端辨识视频id,返回信息的时候会返回该id,让你对应并进行数据填充。
remotePath,  //远程视频地址,即可访问的视频地址,也可以是本地内网地址
notifyUrl  //通知域名,转码完成的clientId、视频名称、m3u8链接、海报截图会自动回传到这个地址。
}

{
 "success": 1|0  //1为创建成功
}

API可远程创建任务,并调用远程连接转码,建议配合队列转码一起使用,这样创建任务后后,会自动转码,自动返回数据,无需后台操作。

回传数据参考:

{
  success: 1,
  movie: {
    count: 0,
    retry: false,
    director: [],
    writer: [],
    stars: [],
    country: [],
    tags: [],
    screenshots: [],
    _id: '5fe19c79cb8b853f256a458f',
    status: '转码完成',
    originalname: '远程测试.avi',
    path: './download/远程测试.avi',
    size: '112406774',
    notifyUrl: 'https://www.beefun.cc/api/payback',
    clientId: '5fe19c7888f5be253328806a',
    m3u8paths: [ [Object], [Object], [Object] ],
    thirdm3u8: [],
    createAt: '2020-12-22T07:15:47.300Z',
    __v: 0,
    duration: '3分钟',
    moviepath: '/videos/202012/22/5fe19c79cb8b853f256a458f',
    previewvideo: '/videos/202012/22/5fe19c79cb8b853f256a458f/preview.mp4',
    poster: '/videos/202012/22/5fe19c79cb8b853f256a458f/cover.jpg'
  },
  apikey: '5c20cEga22FgG7f7B1c1',
  apisecret: 'cd5c5ffd476f93602135'
}
[
  [Object: null prototype] {
    id: '5fc7242b0446292f13401fe2',
    domain: 'https://demo.efvcms.com'
  }
]
{
  title: '远程测试.avi',
  url: '240P$https://demo.efvcms.com/videos/202012/22/5fe19c79cb8b853f256a458f/3413b2/index.m3u8#480P$https://demo.efvcms.com/videos/202012/22/5fe19c79cb8b853f256a458f/927817/index.m3u8#',
  server: { connect: { id: '5fc7242b0446292f13401fe2' } }
}

2、远程删除视频库视频

delete: /apifluent/delete?id=5fcf24ed3fd3764f5b40f95f

data: {
apikey,
apisecret
}

{
 "success": 1|0  //1为删除成功
}

注意id=5fcf24ed3fd3764f5b40f95f,此idEFV中视频的id,在远程创建任务,并转码服务完成时会带上efv中的id传递到notifyUrl上,对接的系统接收到此id储存到自己的数据库中,在删除时就请求delete删除efv中的视频数据和切片图片等一切内容。

3、远程检测转码服务器运行/连接状态

post: /apifluent/ping

data: {
apikey,
apisecret,
}

response: {
success: 1,  //1为运行并连接正常,
}

API可检测转码程序运行状态,或者和远程转码程序连接情况是否正常。

三丶远程下载m3u8/mp4、youtube等直链视频 + 自动转码 + 自动获取m3u8等链接信息

1、使用下载api创建数据

POST /api/downloadm3u8

body: {
    category, //视频分类,可选项,请自行在转码设置分类处设置好分类,且默认只能一个
    apikey, //转码设置获取
    name, //视频名称,为必填项,下载完会自动命名
    url,  //下载链接,为必填项,注意如果地址包含&等特殊符号,如果影响到使用,记得转义下
    poster,  //封面链接,可选项,封面仅支持jpg、png、jpeg格式,下载转码后,会自动转换成封面1和封面2;如不填会自动生成封面。
    type,  //downloadall、m3u8、video;downloadall适用于m3u8、mp4、mkv等其它视频格式直链和youtube视频地址,建议为首选,如非youtube视频下载错误,可选择m3u8、video类型进行下载。
    clientId, //可选项,传递一个数据库id,即客户端辨识视频id,当使用通知接口返回信息的时候会返回该id,让你对应并进行数据填充。
}

response: {
    success: 1|0,  //1成功,0失败
}

2、获取M3U8等信息

先前往转码设置 开启转码完成自动通知,并设置好通知域名,转码完成会自动将视频信息都POST到该域名,自己接收处理一下就行。

接收完整版数据参考:

{
poster2: {
  url: '/videos/202202/07/61ffbfbb9b36dd00c878b4a1/poster.jpg',
  height: 773,
  width: 540
},
count: 23,
retry: false,
autoPublish: false,
director: [ '古桥一浩' ],
writer: [ '古桥一浩' ],
stars: [
  '三宅健太',  '宫野真守', '樱井孝宏',
  '伊藤静',   '梶裕贵',  '绵贯龙之介',
  '濑户麻沙美', '早见沙织', '滨野大辉',
  '柳田淳一',  '铃木玲子', '石冢运升',
  '中井和哉',  '天崎滉平', '菅原慎介',
  '町山芹菜'
],
country: [ '日本' ],
tags: [ '剧情', '喜剧', '战争', '动画' ],
screenshots: [
  '/videos/202202/07/61ffbfbb9b36dd00c878b4a1/0.jpg',
  '/videos/202202/07/61ffbfbb9b36dd00c878b4a1/2.jpg',
  '/videos/202202/07/61ffbfbb9b36dd00c878b4a1/1.jpg',
  '/videos/202202/07/61ffbfbb9b36dd00c878b4a1/3.jpg'
],
_id: '61ffbfbb9b36dd00c878b4a1',
originalname: '窈窕淑女前篇:红绪,花样的17岁',
status: 'finished',
path: './movies/Haikara-san ga Toru the movie.mkv',
category: '日本动漫',
size: '5497612960',
createAt: '2022-02-16T09:25:49.733Z',
m3u8paths: [
  {
    _id: '6200c8949dc15a00c15be7db',
    hd: 640,
    path: './public/videos/202202/07/61ffbfbb9b36dd00c878b4a1/8f89fb/index.m3u8'
  },
  {
    _id: '6200cc499dc15a00c15be809',
    hd: 1280,
    path: './public/videos/202202/07/61ffbfbb9b36dd00c878b4a1/08cad8/index.m3u8'
  }
],
thirdm3u8: [],
__v: 1,
height: 1080,
width: 1920,
duration: '97分钟',
moviepath: '/videos/202202/07/61ffbfbb9b36dd00c878b4a1',
gif: '/videos/202202/07/61ffbfbb9b36dd00c878b4a1/1.gif',
previewvideo: '/videos/202202/07/61ffbfbb9b36dd00c878b4a1/preview.mp4',
poster: '/videos/202202/07/61ffbfbb9b36dd00c878b4a1/cover.jpg',
firstScreen: '/videos/202202/07/61ffbfbb9b36dd00c878b4a1/first.jpg',
aka: '',
banben: 'HD',
language: '日语',
originaltitle: '劇場版 はいからさんが通る 前編 ~紅緒、花の17歳~',
rate: 7.5,
summary: '根据70年代大受欢迎的少女漫画《窈窕淑女》改编的剧场版动画,《窈窕淑女》的题目字面意思出自诗经:“窈窕淑女,君子好逑"。大和和纪的《窈窕淑女》是1977年的少女漫画优秀杰作,曾经红极一时。讲述了一个关...',
year: 2017
}

注意m3u8paths里边的hd参数,320240P480360P640480P1138640P1280720P19201080P25602K20000为原画。