changShortVideoSDK

短视频SDK升级为短视频解决方案

下面介绍的是如何将工程中集成的短视频SDK替换成短视频解决方案SDK。

它们之间的关系请参考：https://github.com/ksvc/KSVSShortVideoCore_iOS/blob/master/README.md

一、 Token申请

短视频解决方案需要进行新的鉴权，在鉴权时需要进行Token的申请。申请步骤如下：

1. 若购买短视频解决方案套餐包，需进入金山云短视频解决方案官网，点击“购买套餐包”，确认购买，填写表单信息，授权token会以邮件的形式提供。
2. 若单独购买短视频SDK，联系金山云销售进行授权申请，或者直接拨打：62927777 转 5120

二、 集成

本文只说明pod集成方式下的替换，不推荐使用framework导入的方式集成

1. Podfile中去掉对短视频SDK的依赖

#pod 'KSYMediaEditorKit'

2. Podfile中新增对短视频解决方案SDK的依赖

pod 'KSVSShortVideoCore_iOS', '~>1.1.0'

3. 调整业务上的相关逻辑代码

三、 替换鉴权逻辑

3.1 短视频SDK的鉴权逻辑

短视频SDK的离线鉴权说明如下：https://github.com/ksvc/KSYMediaEditorKit_iOS/wiki/offlinesdkauth

使用短视频SDK时，需要购买短视频SDK的token并且调用短视频SDK的鉴权代码进行鉴权，API方法如下：

/**
 @abstract 短视频SDK鉴权函数
 
 @param token 联系商务获取
 @param complete 鉴权结果
 */
+ (void)sendClipSDKAuthRequestWithToken:(NSString *)token
                               complete:(void (^)(KSYStatusCode rc, NSError *error))complete;

替换新的SDK后，这一部分需要调用短视频解决方案鉴权流程，可在工程中删除原有短视频SDK鉴权的相关逻辑。

3.2 短视频解决方案SDK的鉴权逻辑

短视频解决方案SDK的鉴权流程如下：https://github.com/ksvc/KSVSShortVideoCore_iOS#22-鉴权流程

SDK鉴权、KS3上传鉴权的API使用说明参见：https://github.com/ksvc/KSVSShortVideoCore_iOS/wiki#api使用说明

API及调用示例代码如下，更详细的建议阅读demo和接口文件。

/**
 * @abstract 鉴权接口
 * @param bundleIdentifier App包名
 * @param ksvsToken KSVSDk鉴权所需的token(由金山云颁发)
 * @param accessToken App Server下发的token(登录App后，由App Server后返回的token，可参考KSVSDemo部分)
 * @param success 请求鉴权信息成功后的回调
 * @param failure 请求鉴权信息失败后的回调（KSVSError错误码参考KSVSErrorCodeDefines.h）
 */
+ (void)authWithBundleIdentifier:(NSString *)bundleIdentifier
                       ksvsToken:(NSString *)ksvsToken
                     accessToken:(NSString *)accessToken
                         success:(void(^)(void))success
                         failure:(void(^)(KSVSError *ksvsError))failure;

调用示例：
[KSVSAuthService authWithBundleIdentifier:bundleId ksvsToken:ksvsToken accessToken:kCurrUser.token success:^{
     // 在这里执行鉴权成功后的操作
} failure:^(KSVSError *ksvsError) {
    // 在这里查看鉴权出错的信息
}];

替换新的SDK后，需要在工程中新增短视频SDK鉴权的相关逻辑。