微信小程序

1.1 小程序管理后台添加插件#

1. 登录微信公众平台，点击左侧下方设置菜单
2. 进入设置页面，点击第三方设置标签页
3. 在插件管理模块中，点击添加插件按钮
4. 搜索 wxfp ，选择插件，然后完成添加（若较紧急，可联系开发人员快速通过审批）

🤖 AI Prompt#

复制 AI 提示词，粘贴到 Codex、Copilot、Claude Code 等AI 编码工具，即可自动生成代码，完成 TD SDK 集成

1.2 小程序代码集成#

1.小程序app.json 里声明插件

{
  "plugins": {
    "tdfp-plugin": {
      "version": "2.1.5",
      "provider": "wxc3b909c3d24c5417"
    }
  }
}

• 注意 ：三方框架可对应添加。如 uni-app，可在 manifest.json 文件的 mp-weixin 模块中添加上述声明

2.引用插件 &&必要的配置

在 app.js 中partnerCode 为必要参数，appname和channel为可选字段：

const plugin = requirePlugin('tdfp-plugin')
App({
  ......
  globalData: {
    ......
    _fmOpt: {
      partnerCode: "", // 请填入您的partner code
      appName: "", // 请填入您的app name 同一个公司的不同小程序请填入不同的AppName
      channel: "", // 请填入您的channel
    }
  },
  onLaunch(){
    let fmagent

3.获取 blackBox
设备指纹 SDK 采用类微信 API 的调用模式，支持传入 success、fail、complete 三个回调及其它配置字段。

在第一个页面加载时调用getInfo方法，进行数据异步更新，更新后可以在success回调内获取到blackBox

const plugin = requirePlugin("tdfp-plugin");
var that = this;
var fmagent = new plugin.FMAgent(app.globalData._fmOpt);
fmagent.getInfo({
  page: that, // 请传入 FMAgent 所在的 Page 或 Component 对象
  mode: "plugin",
  openid: ""

在需要同步获取blackBox的节点调用getInfoSync来获取blackBox。

说明：首次生成blackBox直接调用同步方法会生成降级的blackBox

var blackbox = fmagent.getInfoSync({
  openid: "",
  unionid: "",
});

注意：方法没有强制入参，openid和unionid强烈建议提供

设备指纹参数说明#

注意：

• blackbox存在有效期，所以请不要自行对blackbox做缓存，在我们SDK内部有缓存机制，所以请在需要blackbox的地方，调用getInfo接口即可
• 降级blackbox的长度在3000-5000字节，建议上报blackbox放在body中
• 如果需要sdk版本对接方式，请联系运营支持