QVCloudEngine

示例

要运行示例项目，请克隆仓库，并首先从 Example 目录运行 pod install。

需求

安装

QVCloudEngine 通过 CocoaPods 提供。要安装它，只需在 Podfile 中添加以下行：

pod 'QVCloudEngine'

作者

阳光，[email protected]

接口文档

运行Demo工程，需要将申请到的AppKey、AppSecret添加到以下位置。

    engineConfig.appKey = @"申请的appKey ";
    engineConfig.appSecrect = @"申请的appSecrect";

功能概览

小影云端合成支持图片和视频云端模版合成。

前期准备

1. 向小影对接人申请appKey和appSecrect（后续API接口签名认证将使用到）；
2. 申请小影云端合成SDK最新版本。

参数配置

1. 网络请求支持http，在Info.plist中添加权限：

在Info.plist中添加 App Transport Security Settings 类型 Dictionary ;
并在App Transport Security Settings 下添加 Allow Arbitrary Loads 类型Boolean, 值设为 YES

接口说明

初始化

调用初始化云端合成SDK，在调用其他接口前需先调用初始化。

    QVCloudEngineConfig *engineConfig = [[QVCloudEngineConfig alloc] init];
    engineConfig.userId = @"第三方用户唯一标示，如果没有可以传，广告Id等";
    engineConfig.appKey = @"申请的appKey ";
    engineConfig.appSecrect = @"申请的appSecrect";
    [QVCloudEngine initializeWithConfig:engineConfig];

请求参数

engineConfig : 初始化配置

QVCloudEngineConfig：初始化参数

获取素材模版列表

调用以获取合成素材列表。

    //获取素材模版列表
    QVTemplateConfig *templateConfig = [[QVTemplateConfig alloc] init];
    templateConfig.pageNum = 1;
    templateConfig.pageSize = 10;
    [QVCloudEngine getTemplates:templateConfig success:^(QVTemplateResponse * _Nonnull responseObject) {
        //code
    } failure:^(QVErrorModel * _Nonnull errorModel) {
        //code
    }];

请求参数

QVTemplateConfig：获取素材请求参数

响应参数

QVTemplateResponse：素材详情列表参数

QVTemplateInfoModel：单个素材详情参数

QVErrorModel：获取素材错误参数

发起云端合成

传入合成PHAsset、获取到的素材信息以及其他可配置参数，调用以合成目标视频。

QVCompositeConfig *compositeConfig = [[QVCompositeConfig alloc] init];
compositeConfig.templateId = templateInfo.templateId;//素材模版的templateId
compositeConfig.resolution = resolution;//分辨率
NSMutableArray *mediaList = [NSMutableArray array];
QVCompositeMediaData *mediaDataModel = [[QVCompositeMediaData alloc] init];
mediaDataModel.asset = PHAsset;
[mediaList addObject:mediaDataModel];
compositeConfig.mediaDataList = mediaDataList;
    [QVCloudEngine composite:compositeConfig start:^(QVCompositeTask * _Nonnull task, QVCompositePreResponse * _Nonnull response) {
        
    } progress:^(QVCloudEngineCompositeState state) {
        
    } success:^(QVCompositeResponse * _Nonnull response) {
       
    } failure:^(QVCompositeTask * _Nonnull task, QVErrorModel * _Nonnull error, BOOL canForceComposite) {
       
    }];

请求参数

QVCompositeConfig：合成视频请求参数

QVCompositeMediaData：单个源文件参数

响应参数

QVCompositePreResponse：云端合成预处理

QVCompositeFileDataModel：云端合成完成

QVCompositeTask：云端合成任务

State：云端合成中间状态

查询视频列表

查询历史合成视频列表

[QVCloudEngine getVideosWithPageNum:1 pageSize:15 success:^(QVCompositeFileListResponse * _Nonnull response) {
      [QVCloudEngine report:[response fetchFileIds]];//上报
    } failure:^(QVErrorModel * _Nonnull errorModel) {
           
 }];

请求参数

VideoConfig：视频请求参数

响应参数

QVCompositeFileListResponse：视频列表参数

QVCompositeFileDataModel：单个视频参数

上报接口

当成功获取到视频后，调用上报接口，以统计有效合成。

[QVCloudEngine report:fileIds];

请求参数

问答

许可证

QVCloudEngine 遵循 MIT 许可协议。更多信息和许可证文件，请参阅 LICENSE 文件。