更新记录

1.0.2（2023-09-01）

细节更新

1.0.0（2023-09-01）

版本1.0.0

平台兼容性

云函数类插件通用教程

使用云函数类插件的前提是：使用HBuilderX 2.9+

概述

本云函数插件可通过前端uniCloud.callFunction的形式调用，完成抖音小程序的登陆，云函数会返回token信息，首次登陆会自动注册，注册信息会保存到uni-id-users表内。

准备工作

1、自行在抖音开放平台注册小程序后获取appid、appsecret备用。

2、确保你的项目已关联云空间，本插件支持uni_modules，在插件市场一键导入到你的项目中。

3、在目录uniCloud/cloudfunctions/common/uni-config-center下新建uni-id目录(有则忽略)，新建config.json配置文件(有则忽略)。建议使用官方文档提供的模板 地址为：https://uniapp.dcloud.net.cn/uniCloud/uni-id-summary.html#config

4、在config.json里添加如下配置：

"mp-tiktok": {
    "tokenExpiresIn": 259200,
    "tokenExpiresThreshold": 86400,
    "oauth": {
        "tiktok": {
            "appid": "",//自己的appid
            "appsecret": "",//自己的appsecret
        }
    }
}

5、确保云数据库里已有表uni-id-users,该表官方已提供，新增一个字段用于保存openid。字段如下：

"tiktok_openid": {
  "bsonType": "object",
  "description": "抖音平台openid",
  "properties": {
    "app": {
      "bsonType": "string",
      "description": "app的openid"
    },
    "mp": {
      "bsonType": "string",
      "description": "小程序的openid"
    }
  },
  "permission": {
    "read": "'READ_UNI_ID_USERS' in auth.permission",
    "write": "'CREATE_UNI_ID_USERS' in auth.permission || 'UPDATE_UNI_ID_USERS' in auth.permission"
  }
}

6、uniCloud/cloudfunctions目录下，右键user-tiktok，点击管理公共模块或拓展库依赖， 拓展库uni-cloud-jql勾选；公共模块uni-config-center和uni-id-common勾选

7、右键user-tiktok上传部署.

前端调用

uniCloud.callFunction调用user-tiktok云函数即可， params参数携带uni.login获取的code，将云函数返回的token信息缓存即可。 使用方式：

uniCloud.callFunction({
    name:'user-tiktok',
    data:{
        action:'login',
        params:{
            code:'',//uni.login获取到的code
        }
    }
})

建议

如果你的项目没有使用uni-id-pages来自动管理维护token，那么建议你在通过本插件获取到token信息后，按照官方标准，将token和有效期缓存起来。这样所有的请求都会自动带上token。

token缓存：uni.setStorageSync('uni_id_token','token的值')

token有效期缓存：uni.setStorageSync('uni_id_token_expired','token的有效期值')