云点播 Android 上传 SDK

一、集成上传库和源码

1. 拷贝上传源码目录Demo/ugcupload，即 ugcupload module 到你的工程目录中，如需要，可手动修改一下 package 名。

2. 如需要手动集成，可参考Demo/ugcupload/build.gradle在你的工程中添加依赖：

implementation 'com.qcloud.cos:cos-android-nobeacon:5.9.46'

注意：说明：

注意：你也可以参考 手动集成 文档集成对应版本的依赖库。

3. 如需使用 quic 能力，需要将module ugcquic 复制到你的工程目录中，并依赖到ugcupload module，如果需要手动集成可集成如下依赖：

implementation 'com.qcloud.cos:quic:1.5.46'

4. 使用视频上传需要网络、存储等相关访问权限，可在AndroidManifest.xml中增加如下权限声明：

<uses-permission android:name="android.permission.INTERNET"/><uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/><uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/><uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>

5. 视频上传需要根据网络变化来刷新上传 IP，可按照业务需要动态注册广播，示例如下：

@Overrideprotected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); // your code…… registerNetReceiver();}private void registerNetReceiver() { if (null == mNetWorkStateReceiver) { mNetWorkStateReceiver = new TVCNetWorkStateReceiver(); IntentFilter intentFilter = new IntentFilter(ConnectivityManager.CONNECTIVITY_ACTION); registerReceiver(mNetWorkStateReceiver, intentFilter); }}private void unRegisterNetReceiver() { if (null != mNetWorkStateReceiver) { unregisterReceiver(mNetWorkStateReceiver); }}@Overrideprotected void onDestroy() { super.onDestroy(); // your code…… unRegisterNetReceiver();}

三、初始化上传对象

TXUGCPublish mVideoPublish = new TXUGCPublish(this.getApplicationContext(), "independence_android")

四、设置上传对象回调

mVideoPublish.setListener(new TXUGCPublishTypeDef.ITXVideoPublishListener() { @Override public void onPublishProgress(long uploadBytes, long totalBytes) { mProgress.setProgress((int) (100*uploadBytes/totalBytes)); } @Override public void onPublishComplete(TXUGCPublishTypeDef.TXPublishResult result) { mResultMsg.setText(result.retCode + " Msg:" + (result.retCode == 0 ? result.videoURL : result.descMsg)); }});

五、构造上传参数

TXUGCPublishTypeDef.TXPublishParam param = new TXUGCPublishTypeDef.TXPublishParam();param.signature = "xxx";param.videoPath = "xxx";

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

六、调用上传

int publishCode = mVideoPublish.publishVideo(param);

八、初始化上传对象

TXUGCPublish mVideoPublish = new TXUGCPublish(this.getApplicationContext(), "independence_android")

九、设置上传对象回调

mVideoPublish.setListener(new TXUGCPublishTypeDef.ITXMediaPublishListener() { @Override public void onMediaPublishProgress(long uploadBytes, long totalBytes) { mProgress.setProgress((int) (100*uploadBytes/totalBytes)); } @Override public void onMediaPublishComplete(TXUGCPublishTypeDef.TXMediaPublishResult mediaResult) { mResultMsg.setText(result.retCode + " Msg:" + (result.retCode == 0 ? result.videoURL : result.descMsg)); }});

十、构造上传参数

TXUGCPublishTypeDef.TXMediaPublishParam param = new TXUGCPublishTypeDef.TXMediaPublishParam();param.signature = "xxx";param.mediaPath = "xxx";

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

十一、调用上传

int publishCode = mVideoPublish.publishMedia(param);

注意：说明：

十三、携带封面

在上传参数中带上封面路径即可。

TXUGCPublishTypeDef.TXPublishParam param = new TXUGCPublishTypeDef.TXPublishParam();param.signature = "xxx";param.videoPath = "xxx";param.coverPath = "xxx";

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

十四、取消和恢复上传

取消上传，调用TXUGCPublish的cancleublish()接口。

mVideoPublish.canclePublish();

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

十五、断点续传

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

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

十六、预上传

在实际上传过程中，很大部分的错误是由于网络连接失败或超时导致的，为优化此类问题，我们增加了预上传优化逻辑。预上传包含：HTTPDNS 解析、获取建议上传地域、探测最优上传地域。

建议你在 App 启动的时候调用TXUGCPublishOptCenter.getInstance().prepareUpload(signature)，预上传模块会把<域名，IP>映射表和最优上传地域缓存在本地，如果此前动态注册了网络广播，订阅到网络切换时，清空缓存并自动刷新。

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

十七、开启 https 上传

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

TXUGCPublishTypeDef.TXPublishParam param = new TXUGCPublishTypeDef.TXPublishParam();param.enableHttps = true;

十八、关闭日志

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

// false 关闭日志mTXUGCPublish.setIsDebug(false);

十九、视频上传接口描述

初始化上传对象：TXUGCPublish

设置点播 appId：TXUGCPublish.setAppId

上传视频：TXUGCPublish.publishVideo

上传参数：TXUGCPublishTypeDef.TXPublishParam

设置上传回调：TXUGCPublish.setListener

进度回调：TXUGCPublishTypeDef.ITXVideoPublishListener.onPublishProgress

结果回调：TXUGCPublishTypeDef.ITXVideoPublishListener.onPublishComplete

上传结果：TXUGCPublishTypeDef.TXPublishResult

预上传：TXUGCPublishOptCenter.prepareUpload

20、图片上传接口描述

初始化上传对象：TXUGCPublish

设置点播 appId：TXUGCPublish.setAppId

上传图片：TXUGCPublish.publishMedia

上传参数：TXUGCPublishTypeDef.TXMediaPublishParam

设置上传回调：TXUGCPublish.setListener

进度回调：TXUGCPublishTypeDef.ITXMediaPublishListener.onPublishProgress

结果回调：TXUGCPublishTypeDef.ITXMediaPublishListener.onPublishComplete

上传结果：TXUGCPublishTypeDef.TXMediaPublishResult

预上传：TXUGCPublishOptCenter.prepareUpload

21、错误码

SDK 通过TXUGCPublishTypeDef.ITXVideoPublishListener\\ITXMediaPublishListener接口来订阅视频上传相关的状态。因此，可以用TXUGCPublishTypeDef.TXPublishResult\\TXMediaPublishResult中的retCode来确认视频上传的情况。