本文为您介绍小程序版本上传 SDK。

适用版本

此文档适用于 TTSDK 1.x.x 版本。如果您使用的是 TTSDK 2.0.0 及之后的版本，请查看小程序上传 SDK。

马上开始

引入 SDK

• 方式1：下载小程序 SDK，并导入小程序工程，下载地址。
• 方式2：npm 安装。

npm install tt-uploader-miniprogram@1.0.1

初始化上传配置

import TTUploader from './lib/tt-uploader-miniprogram.js';

let uploader = new TTUploader({

    // 必填，视频上传相关配置

    videoConfig: {

         // 必填，申请的视频空间

         spaceName: 'your spacename'

    }

});

获取上传签名

上传前需要从服务端获取上传 sts2 签名，签名算法服务端接入，接入方法请参考：服务端SDK>生成上传凭证>生成临时上传密钥。

添加域名白名单

把网关地址和上传地址添加到小程序的访问白名单中。

开始上传

uploader.start({

  // 必填，把 chooseVideo 回调的参数(filePath)传进来

  path: res.tempFilePath,

  // 必填，把 chooseVideo 回调的参数(size)传进来

  size: res.size,

  // 必填，指定上传类型为视频

  type: 'video',

  // 必填，从服务端拿到的token，token为一个对象类型，见下方说明

  fileName:'demo'

  // 选填，文件路径，文件在点播存储中的存储位置。最大不超过 2048 字节。您可根据业务需求自定义文件路径。

  fileExtension:'.mp4'

  // 选填，文件后缀，点播存储中文件的类型。

  storageClass: 1

  // 选填，存储类型。默认为 1。支持的取值：1：标准存储；2：归档存储。
  
  stsToken: token,

  // 上传成功回调

  success: function(data) {

    console.log('upload success');

    console.log(data);

  },

  // 上传失败回调

  fail: function(data) {

    console.log('upload fail');

    console.log(data);

  },

  // 上传进度回调

  progress: function(data) {

    console.log('progress: ', data);

  }

});

初始化配置

通用配置

配置属性可在实例化时传入，代码示例如下所示。

const ttUploader = new TTUploader({

    userId: "xxx",

    appId: xxx,

    videoConfig: {

        spaceName: 'your spacename',

    }

});

各个配置及其对应作用如下表所示。

视频专用配置

代码示例如下所示。

videoConfig: {

    spaceName: "xxx"

}

回调

success 回调

progress 回调

error 回调

错误码对照表

功能 list

小程序版本只包含基础的上传功能，无分片上传，暂停等功能。

Demo

import TTUploader from '../utils/tt-uploader-miniprogram.js';

let uploader = new TTUploader({
    // 必填，视频上传相关配置
    videoConfig: {
        // 必填，申请的视频空间
        spaceName: 'your spacename'
    }
});

wx.chooseVideo({
    sourceType: ['album'],
    count: 1, 
    success: (res) => { 
      this.uploaderV5.start({
        path: res.tempFilePath,
        size: res.size,
        type: 'video',
        stsToken: token,
        success: function(data) {
          console.log('upload success');
          console.log(data.Vid);
        },
        fail: function(data) {
          console.log('upload fail');
          console.log(data);
        },
        progress: function(data) {
          console.log('progress: ', data);
        }
     },
     fail: (res) => { 
       console.log('chooseVideo调用失败:', res); 
     } 
});