全闭环转码系统使用参考

一、本地/远程上传视频 + 自动转码 + 自动获取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就是分辨率标识，如720、1080；这样做的目的就是我们上传后，可以通过获取到的视频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，此id是EFV中视频的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年代大受欢迎的少女漫画《窈窕淑女》改编的剧场版动画，《窈窕淑女》的题目字面意思出自诗经：“窈窕淑女，君子好逑&#34;。大和和纪的《窈窕淑女》是1977年的少女漫画优秀杰作，曾经红极一时。讲述了一个关...',
year: 2017
}

注意m3u8paths里边的hd参数，320为240P、480为360P、640为480P、1138为640P、1280为720P、1920为1080P、2560为2K、20000为原画。

封面/截图动态转换成文本

APP详情介绍

相关说明