Home

iOS短视频解决方案Core版使用指南

功能及API拆分

• SDK鉴权：KSVSAuthService
• 视频上传：KSVSKS3UploadService
• 视频录制、编辑：直接使用金山云短视频SDK（KSYMediaEditorKit_iOS）
• 视频播放：直接使用金山云iOS播放SDK（KSYMediaPlayer_iOS）

API使用说明

• KSVSAuthService

/**
 * @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) {
    // 在这里查看鉴权出错的信息
}];

• KSVSKS3UploadService

/**
 * @abstract 初始化上传对象
 * @param userId 当前用户的id
 */
- (instancetype)initWithUserId:(NSString *)userId;

/**
 * @abstract 上传头像
 * @param headImage 相册或拍照选取的图片
 * @param success 上传成功的回调，headImageUrl为头像在ks3上的地址（例如，上传成功后修改headImageView.image为headImage）
 * @param failure 上传失败的回调
 */
- (void)uploadHeadImage:(UIImage *)headImage
                success:(void(^)(NSString *headImageUrl))success
                failure:(void(^)(KSVSError *ksvsError))failure;    

调用示例：
KSVSKS3UploadService *ks3Service = [[KSVSKS3UploadService alloc] initWithUserId:@"userId"];
[ks3Service uploadHeadImage:_selectedHeadImage success:^(NSString *headImageUrl) {
     // 在这里执行上传头像成功的操作（如：更新userModel头像地址为headImageUrl，修改headImageView.image为新头像等）            
} failure:^(KSVSError *ksvsError) {
     // 在这里查看上传头像失败的原因
}];    
    
/**
 * @abstract 上传视频
 * @param localVideoPath 本地视频地址
 * @param progress 上传视频的进度（0 ~ 1）
 * @param success 上传成功的回调，remoteVideoPath为所上传视频在ks3上的地址
 * @param failure 上传失败的回调
 */
- (void)uploadVideo:(NSString *)localVideoPath
           progress:(void(^)(float progressValue))progress
            success:(void(^)(NSString *remoteVideoPath))success
            failure:(void(^)(KSVSError *ksvsError))failure;    
    
调用示例：   
KSVSKS3UploadService *ks3Service = [[KSVSKS3UploadService alloc] initWithUserId:@"userId"];
[ks3Service uploadVideo:_concatedVideoPath.relativePath progress:^(float progressValue) {
        // 在这里更新上传进度
} success:^(NSString *remoteVideoPath) {
       // 在这里执行上传成功的回调
} failure:^(KSVSError *ksvsError) {
       // 在这里执行上传失败的回调
}];