版本记录

前言

针对短视频的上传、编辑等功能有很多的SDK，比如腾讯的SDK、七牛的SDK等，这里我就说一下我用过的美摄的SDK - 1.8.0，希望对大家有所帮助。

服务对象

  美摄SDK可以帮助开发者快速的在APP中实现视频制作服务，包括视频、图片处理、视频基础编辑、快速包装渲染等等，开发者可以根据自己的创意创建APP，实现各种特色功能，美摄公司会随时根据手机系统、手机硬件、使用场景的变化，快速调整，完善，升级SDK工具包，保证SDK包的稳定性、高效率、高兼容性、给开发者带来良好的服务体验。有需要的可以参考美摄SDK的开发文档和官网。

能力与限制

• 支持的系统：
  • ios 7.0以上系统
  • Android 4.1以上系统
• 输入规范：
  • 视频格式：MP4、MOV、WMV、M2V、MPG
  • 音频格式：MP3、FLAC、AAC、M4A
  • 图片格式：JPG、PNG
  • 视频编码：H264、WMV、MPEG4
  • 音频编码：MP3、AAC、PCM、FLAC
• 输出规范：
  • 视频格式：MP4
  • 视频编码：H264
  • 音频编码：AAC
• 扩展包格式（扩展包是美摄用来承载扩展素材的内容包，包括主题、字幕、滤镜、贴纸等）：
• 主题：.theme
• 字幕：.captionstyle
• 滤镜：.videofx
• 贴纸：.animatedsticker
• 转场：.videotransition

产品特点

1. 实时特效、高清录制

SDK支持1080P高清视频录制，提供非常丰富的拍摄录制功能，在录制的同时可以叠加多种特效，并实时预览，最大程度满足不同场景的录制需求，具体特点如下：

• 最大录制1080P视频，并可设定720P、480P等多种质量
• 支持16:9、1:1等不同的画幅比例
• 支持多段视频录制
• 带有基础录制功能，例如对焦，镜头切换，曝光补偿、闪光灯等
• 自带美肤功能
• 自带滤镜功能，支持扩展

2. 支持多轨道、多段编辑

支持同时将不同格式的视频、图片、进行混合多段编辑。

• 视频支持多轨道（视频、图片）
• 支持多种画幅16:9、1:1

3. 制作特效实时预览

通过预览窗口（LiveWindow）可以在制作的过程中实时预览制作效果，而不需进行预处理和打包，大大提升了制作的体验、降低了制作成本和时间。

4. 高清视频输出

SDK支持多种格式内容的输入，并最高支持到4K输入，同时最高支持1080P视频输出，并且开发者可以根据需求设定不同的输出级别（1080P、720P、480P等）。

5. 全能的基础编辑功能

美摄SDK包含市面上最为丰富的基础编辑功能，非常简单的调用方式，开发者们可以根据自己的需求进行灵活组合使用。基础功能包括：

• 视频裁剪、分割
• 视频变速
• 视频、图片插入
• 视频、图片排序
• 视频、图片删除
• 图片时长设定
• 图片画面裁剪
• 图片运动设定
• 画面参数调整（亮度、饱和度、对比度等）
• 画面旋转等

6. 视频实时美肤处理

SDK中自带视频实时美肤特效，可以在拍摄、编辑的过程中直接加入美肤效果，并进行实时预览，同时可以调节美肤处理的等级，美白参数等处理。

美肤处理

7. 绚丽的视频主题

SDK拥有一套强大的主题系统，每个主题都包含：片头尾、音乐、画面运动、前景动画、转场、字幕等，只需一键，就可以对视频进行智能处理，实现电影效果，具体特征如下：

• 拥有复杂的画面处理
• 配套片头尾、音乐、转场等
• 可嵌入配套字幕样式
• 支持3D场景
• 拥有150+已有主题可选
• 提供快速制作服务

8. 顶级字幕功能

SDK的字幕系统达到广电包装水准，不仅是添加一行文字这么简单，字幕功能可以实现一套非常绚丽的字幕包装效果，同时具有良好的扩展性，具体特征如下：

• 支持动画底图
• 支持文字运动，逐字运动
• 文字颜色、描边可调
• 支持透明度
• 支持多行字幕
• 支持载入字体

字幕

9. 多轨道音频编辑

SDK支持不限数量的音频轨道编辑，单轨道音频同时支持多段音频导入与编辑，同时具有多种音频处理方式，具体如下：

• 多轨道音频输入
• 支持多段音频
• 音频裁剪
• 多种音频处理（电音、娃娃音效果等）
• 音频转场（淡入淡出等）
• 音量独立控制

10. 画面前景滤镜

拥有独有的前景滤镜处理方式，整个滤镜由图像处理，边框处理，前景动画效果叠加组成，不仅可以完成简单的调色，还可以实现更多丰富的画面效果，同时还提供前景滤镜的定制服务，满足个性化需求。

滤镜

11. 动画贴纸效果

SDK支持在制作过程中，向视频中加入动画贴纸进行修饰，同时可以对贴纸进行属性设置，达到美化视频画面的作品，具体如下：

• 支持复杂运动效果
• 支持有声贴纸
• 支持镜像
• 支持旋转
• 支持大小修改
• 支持贴纸扩展

动画贴纸

12. 转场过渡效果

SDK支持在片段间添加转场，保证衔接的过程中达到平滑、出色的过渡效果，让视频间更加流畅，同时美摄提供非常多的预置转场效果，供开发者们进行选择，同时可以根据开发者的需求，提供定制化转场服务。

转场过渡效果

13. 丰富的素材库和定制化服务

SDK同时会提供丰富的素材库供开发者们选择使用，并且会定期更新一些新的内容进入素材库中，并会有一定比例的免费内容让开发者们无偿使用，同时提供个性化定制内容，只需少量花费，专业团队为开发者们定制个性化素材，当前素材库包含：

• 主题样式：150个
• 字幕样式：60个
• 贴纸：360个
• 滤镜：50个
• 转场：30个

具体素材库可以参考美摄官网。

名词解释

• 流媒体上下文(Streaming Context)
  包含时间线、预览窗口、采集、资源包管理等相关信息集合的对象，Context被销毁之后，SDk视频制作框架也随之不复存在。

• 定位(Seek)
  渲染出指定位置的画面，并更新时间线的时间戳。

• 生成(Compile)
  以指定码率、帧速率和压缩格式输出文件。

• 采集(Capture)
  捕获摄像头设备画面。

• 录制(Record)
  输出采集画面到指定格式文件中。

• 时间线(Timeline)
  编辑场景的时间轴实体，由轨道组成，可以有多个视频轨道和音频轨道，由视频轨道决定长度。

• 轨道(Track)
  容纳片段的实体，分为视频轨道(Video Track)和音频轨道(Audio Track)，可随片段的增加不断延展。

• 片段(Clip)
  容纳音视频内容的实体，分为视频片段(Video Clip)和音频片段(Audio Clip)，视频片段可以是图片或者视频。

• 采集视频特效(Capture Video Fx)
  一种应用在采集中的视频特效。

• 视频特效(Video Fx)
  一种视频图像的特殊效果，可能改变视频图像的整体或局部的颜色、亮度、透明度等信息，使视频显示特殊的效果。

• 音频特效(Audio Fx)
  一种音频的特殊效果，可能改变音频的声调、速率等信息。

• 视频转场(Video Transition)
  片段间切换的特效，从一个视频到另一个视频的播放衔接过渡效果。添加转场后，片段在转场时间内可能有重叠效果。

• 主题(Theme)
  一系列特效应用的集合，包括片头、片尾、视频特效、视频转场、音乐、字幕样式等。

• 字幕(Caption)
  视频上叠加的自定义文字，可以设置字号和颜色等样式。

• 字幕样式(Caption Style)
  预定义字幕属性集合，包括字号和颜色等。

• 动画贴纸(Animated Sticker)
  带有动画效果的贴纸，叠加在视频上产生一些特殊效果。

• 预览窗口(Live Window)
  实时显示时间线或者采集图像的窗口。

• 视频解析度(Video Resolution)
  视频的基本信息，包括图像宽高和像素横纵比等。

• 音频解析度(Audio Resolution)
  音频的基本信息，包括采样率和声道数等。

• 摇摄和扫描(Pan and Scan)
  一种调整图像适配的方法，可以横向剪切和纵向平移。

• 资源包(Asset Package)
  一种需要安装的特效资源，安装后可以作为特效使用，包括视频特效、视频转场、主题、字幕样式、动画贴纸。

• 资源包ID(Asset Package ID)
  资源包的唯一标识，安装资源包成功后获得，添加特效时使用。

• 裁剪入点(Trim In)
  裁剪片段的起始点。对于裁剪入点，裁剪出点，入点，出点的详细解释，请参见裁剪入点与出点(trimIn and trimOut)专题

• 裁剪出点(Trim Out)
  裁剪片段的终止点。

• 入点(In Point)
  片段在时间线的起始点。

• 出点(Out Point)
  片段在时间线上的终止点。

• 播放速度(Speed)
  片段播放的速度，速度没有改变的情况下，(出点-入点)=(裁剪出点-裁剪入点)，如果播放速度为2倍速，(出点-入点)*2=(裁剪出点-裁剪入点)。

• 码率(Bitrate)
  每秒传送的比特数，码率越高，视频质量越好。

• 采样率(Sample Rate)
  每秒从连续信号中采集的离散信号个数。

• 帧速率(Frame Rate)
  每秒刷新图像的帧数，帧速率越高，视频的连续性越好。

• 横纵比(Aspect Ratio)
  图像的横向尺寸与纵向尺寸的比例。

• 像素横纵比(Pixel Aspect Ratio)
  一个像素点的宽与高的比例。SDK中仅支持1:1。

项目搭建指南

1. 新建工程

(a)选择File->New->Project来新建工程。
(b)在工程类型界面选择适合的工程类型，点击“Next”。
(c)输入工程名，点击“Next”。
(d)输入工程路径，点击”Create“。

新建工程

2. 禁用Bitcode

(a)在工程设置界面，选择“Build Settings”。
(b)在搜索框输入“bit code”。
(c)在“Enable Bitcode”选项卡中选择“No”。

禁用Bitcode

3. 添加SDK头文件和库文件的引用

(a)在工程设置界面，选择“Build Settings”。
(b)在搜索框输入“search Paths”。
(c)在“search paths”中输入SDK的头文件和库文件地址。

添加文件引用

4. 添加库文件

(a)在工程设置界面，选择”General“。
(b)找到“Linked Frameworks and Libraries”。
(c)添加SDK库文件。
(d)添加framework库文件。

添加库文件

基础结构与概念

1. 模块结构

美摄SDK核心模块包括流媒体上下文、时间线、字幕、动画贴纸、轨道、音/视频片段等。流媒体上下文是SDK中最基础的模块，它负责生成、保存并维护SDK引擎运行时的上下文环境。时间线由流媒体上下文生成，包含字幕，动画贴纸以及多个音视频轨道，各模块协同工作以生成最终的视频效果。其中每条音/视频轨道上可以添加若干个音/视频片段，片段上可以添加各种特效，片段之间可以设置不同的转场效果。

模块结构

2. 数据流

美摄SDK支持两种媒体输入方式，标准媒体文件与摄像头采集。

当输入为一个或多个媒体文件时，SDK会首先从文件中提取出对应的音频与视频片段，这些片段可以理解为对原音频流与视频流的裁剪与封装。以视频为例，在编辑过程中，用户可以对这些视频片段进行任意拼接，放到对应轨道上，轨道再放到时间线上。每一个轨道可以类比成一个图层，SDK引擎对轨道渲染的顺序是自下到上的，各层轨道之间可以通过设置透明度等参数来实现一些特殊的效果。SDK引擎支持对时间线、轨道与音/视频片段添加特效，包括音/视频特效、转场、字幕、动画贴纸以及主题等，其中主题可以当成是上述特效的一个闭包。SDK默认提供若干内置的编辑特效，更多的特效资源包可以在美摄官网下载。编辑后的视频可以通过SDK提供的预览窗口进行预览，或者直接打包生成媒体文件。

当使用摄像头设备作为输入时，SDK引擎只能对其添加采集特效与包特效，不能使用转场、字幕、动画贴纸等其他特效。生成的视频同样可以通过SDK提供的预览窗口进行预览，或者直接打包生成媒体文件。

数据流

数据流

后记

未完，待续~~

秋