短视频类场景对接案例

适用场景

垂类短视频视频业务，Feed流形式播放的业务
典型App：

• 类似抖音场景：滑动式播放
• 类似皮皮虾场景：滑动式的Feed信息流

业务特点：

• UGC形式拍摄和上传
• feed形式滑动播放，视频长度较短，一般在15s～5min之间
• 只需要一个清晰度，不需要做清晰度间的转换
• 对首屏敏感

准备工作

1、点播基础配置

• 创建空间：推荐创建2个空间，一个用于线上环境，一个用于开发测试环境；
• 配置CDN分发域名：在「空间管理-分发加速配置」中创建域名，域名鉴权过期时间60分钟。在创建之前，您需要先完成域名备案。
• 配置工作流：按照业务需求（比如对画质要求），配置工作流。
• 配置回调：「控制台-空间管理-回调设置」中设置回调地址。按需开启「媒资上传完成」、「URL批量拉取上传完成」、「工作流执行完成」事件的回调；
• 申请AppId：在「控制台-点播SDK」中点击「创建应用」，一般只需要申请1个；

推荐转码配置：

一般情况不建议播放片源，以下为常用转码配置：

• 主要客户群体在中国/美国/欧洲的，推荐使用540P的转码。
• 主要客户群体在印度/非洲等网络条件较差的国家的，推荐使用480P或360P的转码。
• 对成本敏感的推荐同时转一份H.265：按经验值，1周内平均视频播放次数超过5000次的业务方，H.265对播放对成本有明显减少。

2、准备AKSK

参考文档IAM子账号来创建子账号并生成AK/SK；

对接开发

媒资管理迁移

URL批量拉取上传
针对您已有的媒资需要迁移到视频点播时，推荐使用URL批量拉取上传OpenAPI。在每条URL拉取并上传成功后，将收到回调URL拉取视频上传完成。请根据收到的SourceUrl字段来映射是哪条URL已经上传成功，并记录其对应的Vid。

直接上传： 如果媒资在本地，可以直接使用服务端SDK的上传功能，详见服务器上传。

对接客户端「上传」能力

生成上传凭证

AppServer生成上传凭证，并通过App与AppServer的信息通道，传递给App。

对接上传SDK

APP对接上传SDK，参考上传SDK介绍。

对接「播放」能力

建议AppServer在生成Feed流时，携带Vid和PlayAuthToken，传递给App端进行播放。

AppServer开发

生成播放凭证: 生成PlayAuthToken，并通过App与AppServer的信息通道，传递给App。该方法为离线的、本地的计算方法，请放心使用。

App端开发

对接播放SDK：参考点播SDK介绍来对接，建议使用以下能力：

• 使用预加载，参考iOS点播SDK预加载接入和Android点播SDK预加载接入
• 在每个视频启播后，对下一个视频进行预加载；
• 不适合预加载的场景，建议您在获取到vid后，对vid进行预请求；

对接「封面图」能力

建议AppServer在生成Feed流时，拼接出封面图的URL，并传递给App端。

AppServer开发

拼接封面图URL：参考封面图能力，建议使用服务端SDK来完成

其他AppServer准备

接收回调

• 接收「媒资上传完成」事件回调后，建议记录对应的vid信息；如有媒资处理需求，参考下一步的「触发工作流」；
• 接收「工作流完成」回调后，建议根据vid信息，记录Definition字段，并参考下一步进行「发布」；

触发工作流

收到上传完成回调后，请调用触发工作流来发起转码。工作流执行完成后，将收到回调工作流执行完成。请按Vid对应记录转码已完成。
如果AppServer希望进行码率控制，可以记录下对应的Definition字段。

发布

收到工作流执行完成回调后，请调用修改媒资状态的API来设置为「已发布」状态，视频即可被正常分发。