cos-wx-sdk-v5

小程序前端 ──→ COS 存储桶
     ↑                    ↑
     │                    │
  STS 临时密钥 ←── 后端签名服务
     ↑
腾讯云 STS API

# 方式一：npm 安装（推荐）
npm install cos-wx-sdk-v5

# 方式二：直接引入 JS 文件
# 将 cos-wx-sdk-v5.js 复制到项目 lib/ 目录

const COS = require('cos-wx-sdk-v5')

// 初始化 COS 实例
const cos = new COS({
  // 通过后端获取临时密钥（安全方案）
  getAuthorization: function (options, callback) {
    wx.request({
      url: 'https://your-server.com/sts',
      data: {
        bucket: options.Bucket,
        region: options.Region,
      },
      dataType: 'json',
      success: function (result) {
        const credentials = result.data.credentials
        callback({
          TmpSecretId: credentials.tmpSecretId,
          TmpSecretKey: credentials.tmpSecretKey,
          SecurityToken: credentials.sessionToken,
          ExpiredTime: result.data.expiredTime,
        })
      },
    })
  },
})

const Bucket = 'your-bucket-1250000000'
const Region = 'ap-guangzhou'

// 上传图片
wx.chooseImage({
  count: 1,
  success(res) {
    const filePath = res.tempFilePaths[0]
    const fileName = `uploads/${Date.now()}-${Math.random().toString(36).slice(2)}.jpg`

    cos.uploadFile({
      Bucket,
      Region,
      Key: fileName,
      FilePath: filePath,
      SliceSize: 1024 * 1024 * 5, // 超过 5MB 启用分片上传
    }, function (err, data) {
      if (err) {
        console.error('上传失败', err)
      } else {
        const url = `https://${data.Location}`
        console.log('上传成功', url)
      }
    })
  },
})

cos.getObject({
  Bucket,
  Region,
  Key: 'uploads/example.jpg',
  DataType: 'blob',
}, function (err, data) {
  if (err) {
    console.error('下载失败', err)
  } else {
    // data.Body 为文件内容（ArrayBuffer）
    const fs = wx.getFileSystemManager()
    const filePath = `${wx.env.USER_DATA_PATH}/downloaded.jpg`
    fs.writeFile({
      filePath,
      data: data.Body,
      encoding: 'binary',
      success() {
        wx.previewImage({ urls: [filePath] })
      },
    })
  }
})

cos.uploadFiles({
  Bucket,
  Region,
  files: [
    { FilePath: 'file1.jpg', Key: 'uploads/file1.jpg' },
    { FilePath: 'file2.jpg', Key: 'uploads/file2.jpg' },
  ],
  SliceSize: 1024 * 1024 * 5,
}, function (err, data) {
  if (err) {
    console.error('批量上传出错', err)
  } else {
    console.log('全部上传完成', data.files)
  }
})