949      同花顺

android版本__上传SDK_SDK手册_视频点播-阿里云

• 环境要求

  Android系统版本：2.3 及以上

• 安装

  OSS Android SDK

  上传SDK下载

  • 直接引入jar包

    当您下载了VODUpload Android SDK的zip包后，进行以下步骤(对Android studio或者Eclipse都适用):

    • 解压后在libs目录下得到jar包，目前包括aliyun-oss-sdk-android-xxx.jar、okhttp-2.7.0.jar、okio-2.6.0.jar、aliyun-vod-upload-android-sdk-xxx.jar
    • 将以上4个jar包导入工程的libs目录

    • 权限设置

      以下是VODUpload Android SDK所需要的Android权限，请确保您的AndroidManifest.xml文件中已经配置了这些权限，否则，SDK将无法正常工作。

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

• 创建VODUpload实例

  并设置回调函数

  VODUploadCallback callback = new VODUploadCallback() {
      /**
      * 上传成功回调
      */
      void onUploadSucceed(UploadFileInfo info) {;}
      /**
      * 上传失败
      */
      void onUploadFailed(UploadFileInfo info, String code, String message) {;}
      /**
      * 回调上传进度
      * @param uploadedSize 已上传字节数
      * @param totalSize 总共需要上传字节数
      */
      void onUploadProgress(UploadFileInfo info, long uploadedSize, long totalSize) {;}
      /**
      * token过期后，会回调这个接口
      * 可在这个回调中获取新的token，然后调用resumeUploadWithToken继续上传
      */
      void onUploadTokenExpired() {;}
      /**
      * 上传过程中，状态由正常切换为异常时触发
      */
      void onUploadRetry(String code, String message) {;}
      /**
      * 上传过程中，从异常中恢复时触发
      */
      void onUploadRetryResume() {;}
  };
  VODUploadClient uploader = new VODUploadClientImpl(getContext());

• 初始化

  填写账号信息，有2种方式

  • AK方式

    简单但是不够安全，建议测试环境下使用。

     uploader.init("<accessKeyId>", "<accessKeySecret>", callback);

  • STS方式

    安全但是较为复杂，建议生产环境下使用。

     uploader.init("<accessKeyId>", "<accessKeySecret>", "<secretToken>", "<expireTime>", callback);

• 列表管理

  • 添加上传文件

    注意：支持的文件大小<=4G

    uploader.addFile("<uploadFilePath>",
                        "<endpoint>", // 例如杭州区域"https://oss-cn-hangzhou.aliyuncs.com"
                        "<bucketName>", // 按实际bucket名称填写
                        "<objectKey>");

  • 删除上传文件

    uploader.deleteFile("<uploadFilePath>");

  • 获取上传文件列表

    List<UploadFileInfo> list = uploader.listFiles();

  • 清除上传文件列表

    upload.clearFiles();

• 上传管理

  • 开始上传

     uploader.start();

  • 停止上传

     uploader.start();

  • 暂停上传

     uploader.pause();

  • 恢复上传

     uploader.resume();

  • STS方式下，Token超时恢复上传

     uploader.resumeWithToken("<accessKeyId>", "<accessKeySecret>", "<secretToken>", "<expireTime>");

  • 取消列表中的单个文件上传

     uploader.cancelFile("<uploadFilePath>");

  • 恢复列表中的单个文件上传

     uploader.resumeFile("<uploadFilePath>");

最后更新：2016-12-19 22:06:52

  上一篇： JavaScript版本__上传SDK_SDK手册_视频点播-阿里云

  下一篇： iOS版本__上传SDK_SDK手册_视频点播-阿里云