七牛短视频文档

iOS 短视频 SDK

https://developer.qiniu.com/pili/3733/short-video-ios-sdk

1 概述

PLShortVideoKit 是七牛推出的一款适用于 iOS 平台的短视频 SDK，提供了包括美颜、滤镜、水印、断点录制、分段回删、视频编辑、混音特效、MV 特效、本地/云端存储在内的多种功能，支持高度定制以及二次开发。

1.1 下载地址

2. 功能列表

短视频 SDK 主要区分精简版、基础版、进阶版、专业版 4 个版本，不同版本的功能请参考

3 阅读对象

本文档为技术文档，需要阅读者：

  • 具有基本的 iOS 开发能力
  • 准备接入七牛云存储

4 总体设计

4.1 基本规则

为了方便理解和使用，对于 SDK 的接口设计，我们遵循了如下的原则：

  • 每一个接口类，均以 PLS 开头
  • 简单的配置，通过 NSDictionary 来设置
  • 复杂的配置类，以 PLSXXXConfiguration 命名
  • 所有的回调代理，以 PLSXXXXDelegate 命名

4.2 核心接口

核心的接口类说明如下：

接口类名 功能 备注
PLShortVideoRecorder 负责视频的拍摄 音视频采集、美颜、编码、封包等
PLShortVideoEditor 负责视频内容的编辑 添加滤镜、水印、文字特效等
PLSAVAssetExportSession 负责视频的拼接、导出 视频导出等
PLShortVideoTranscoder 负责视频的转码 视频转码，获取视频信息等
PLShortVideoUploader 负责视频的上传 视频文件的上传
PLSTransitionMaker 负责文字动画生成视频文件 文字转 mp4
PLSMultiVideoMixer 负责将多个视频文件合并 多视频合并
PLSVideoMixRecorder 负责素材视频合拍 视频编辑
PLSImageVideoComposer 负责图片、GIF 图和视频混排 视频编辑

4.3 视频拍摄接口类

拍摄功能相关的类说明如下：

接口名 功能 备注
PLShortVideoRecorder 视频拍摄的核心接口 核心接口
PLSVideoConfiguration 配置摄像头参数 预览分辨率，前后摄像头等
PLSAudioConfiguration 配置麦克风参数 通道，采样率等
PLSFilter 内置滤镜对象 滤镜名称，缩略图等
PLShortVideoRecorderDelegate 视频拍摄回调 包括原始数据回调及拍摄回调等

4.4 视频编辑接口类

4.4.1 视频内容编辑接口类

视频编辑功能相关的类说明如下：

接口名 功能 备注
PLShortVideoEditor 视频编辑的核心接口 核心接口
PLSEditSettings 配置视频编辑参数 源文件、音效、水印设置等
PLSAVAssetExportSession 导出视频接口 根据设置的相应参数导出视频
PLSGifComposer 制作 GIF 图接口 根据视频帧／图片数组合成 GIF图
PLSMovieComposer 多个视频拼接接口 将多个视频拼接为1个视频
PLSReverserEffect 时光倒流特效接口 将视频倒序

4.4.2 视频转码接口类

接口名 功能 备注
PLSAVAssetExportSession 视频导出的核心接口 核心接口
PLShortVideoTranscoder 视频转码的核心接口 核心接口

4.5 视频上传接口类

视频上传功能相关的类说明如下：

接口名 功能 备注
PLShortVideoUploader 视频上传的核心接口 核心接口
PLSUploaderConfiguration 配置上传参数 上传视频空间 token 等
PLShortVideoUploaderDelegate 上传进度及结果回调 回调上传进度及结果
0.052011s