云点播 iOS 上传 SDK

一、集成上传库和源码

1. 拷贝上传源码目录TXVodUpload 和 TXVodUpload.podspec 到你的工程中。

2. 在你的 Podfile 中添加如下依赖：

pod 'TXVodUpload', :path => '/TXVodUpload.podspec所在位置的路径'

3. 如果需要手动集成，可在你的 Podfile 中添加如下依赖：

pod 'QCloudQuic','6.3.9'pod 'QCloudCOSXML/Slim','6.5.1'// 根据你的工程已经有该依赖可以不用额外添加pod 'AFNetworking','4.0.1'

4. 在 Build Settings 中设置 Other Linker Flags，加入参数-ObjC。

二、初始化上传对象

TXUGCPublish *_videoPublish = [[TXUGCPublish alloc] initWithUserID:@"upload_video_userid"];

三、设置上传对象回调

_videoPublish.delegate = self;

#pragma mark – TXVideoPublishListener- (void)onPublishProgress:(NSInteger)uploadBytes totalBytes:(NSInteger)totalBytes { self.progressView.progress = (float)uploadBytes/totalBytes; NSLog(@"onPublishProgress [%ld/%ld]", uploadBytes, totalBytes);}- (void)onPublishComplete:(TXPublishResult*)result { NSString *string = [NSString stringWithFormat:@"上传完成，错误码[%d]，信息[%@]", result.retCode, result.retCode == 0? result.videoURL: result.descMsg]; [self showErrorMessage:string]; NSLog(@"onPublishComplete [%d/%@]", result.retCode, result.retCode == 0? result.videoURL: result.descMsg);}

四、构造上传参数

TXPublishParam *publishParam = [[TXPublishParam alloc] init];publishParam.signature = @"由你业务后台产生的签名";publishParam.videoPath = @"视频文件路径";

signature计算规则请参见 客户端上传签名。

五、调用上传

[_videoPublish publishVideo:publishParam];

注意：说明：

六、携带封面

在上传参数中带上封面图片即可。

TXPublishParam *publishParam = [[TXPublishParam alloc] init];publishParam.signature = @"由你业务后台产生的签名";publishParam.coverPath = @"封面图片文件路径";publishParam.videoPath = @"视频文件路径";

七、取消和恢复上传

取消上传，调用cancelPublish接口。

[_videoPublish cancelPublish];

恢复上传，用相同的上传参数（视频路径和封面路径不变），再调用一次TXUGCPublish的publishVideo。

八、断点续传

在视频上传过程中，云点播支持断点续传，即当上传意外终止时，用户再次上传该文件，可以从中断处继续上传，减少重复上传时间。断点续传的有效时间是1天，即同一个视频上传被中断，那么1天内再次上传可以直接从断点处上传，超过1天默认会重新上传完整视频。

上传参数中的enableResume为断点续传开关，默认是开启的。

九、开启 https 上传

将上传参数中 TXPublishParam 中的 enableHTTPS 置为 true 即可，默认 false。

TXPublishParam *publishParam = [[TXPublishParam alloc] init];publishParam.enableHTTPS = true;

十、关闭日志

关闭日志需要通过 TXUGCPublish 的setIsDebug方法进行操作，默认开启。开启的情况下，会打印 logcat 日志，同时也会将 log 保存到 app 私有目录下。

// NO 关闭日志[_videoPublish setIsDebug:NO];

十一、图片和媒体上传

// 创建对象TXUGCPublish *_imagePublish = [[TXUGCPublish alloc] initWithUserID:@"upload_image_userid"];// 设置回调_imagePublish.mediaDelegate = self;// 构造上传参数TXMediaPublishParam *publishParam = [[TXMediaPublishParam alloc] init];publishParam.signature = @"由你业务后台产生的签名";publishParam.mediaPath = @"图片文件路径";// 上传图片或媒体文件[_imagePublish publishMedia:publishParam];

十二、视频上传接口描述

初始化上传对象：TXUGCPublish::initWithUserID

开始上传：TXUGCPublish.publishVideo

上传参数：TXPublishParam

设置上传回调：TXUGCPublish.delegate

上传进度回调：onPublishProgress

上传结果回调：onPublishComplete

上传事件回调：onPublishEvent

上传结果：TXPublishResult

预上传：TXUGCPublishOptCenter.prepareUpload

十三、错误码

SDK 通过TXVideoPublishListener接口来订阅视频上传相关的状态。因此，可以用TXPublishResult中的retCode来确认视频发布的情况。

十四、图片和媒体上传接口描述

初始化上传对象：TXUGCPublish::initWithUserID

开始上传：TXUGCPublish.publishMedia

上传参数：TXMediaPublishParam

设置上传回调：TXUGCPublish.TXMediaPublishListener

上传进度回调：onMediaPublishProgress

上传结果回调：onMediaPublishComplete

上传事件回调：onMediaPublishEvent

上传结果：TXMediaPublishResult

预上传：TXUGCPublishOptCenter.prepareUpload

十五、错误码

SDK 通过TXMediaPublishListener接口来订阅图片/媒体上传相关的状态。因此，可以用TXMediaPublishResult中的retCode来确认图片/媒体发布的情况。