获取设备id

WARNING

请注意，当前域名 https://dev.weixin.qq.com/docs/framework 文档已不维护，请前往微信文档中心open in new window 找到对应的新文档继续使用

为方便开发者获取系统的设备 id，并且考虑到获取设备 id 是属于用户的敏感信息，需开发者在应用的隐私政策中进行声明，因此平台将以官方插件的形式进行开发，开发者需按照下方指引进行引用。

SDK 要求

  • Android SDK 需 >= 1.3.3
  • iOS SDK >= 1.2.25

步骤 1，前往 project.miniapp.json 配置插件

  • 需将 project.miniapp.json 切换成 json 模式，然后填入下方内容
"mini-plugin": {
  "ios": [
    {
      "open": true,
      "pluginId": "wx033a6b34f2c7ea15", // 插件id
      "pluginVersion": "1.0.0", // 插件版本号
      "isFromLocal": false
    }
  ],
  "android": [
    {
      "open": true,
      "pluginId": "wx033a6b34f2c7ea15",
      "pluginVersion": "1.0.0"
    }
  ]
}

步骤 2，前往 project.miniapp.json 配置iOS隐私信息访问许可

  • 可将 project.miniapp.json 切换成可视化模式，iOS 端如果使用到了 IDFA 则需要配置访问许可 NSUserTrackingUsageDescription，需在此填写用途

步骤 3，加载插件

  • iOS 与 Android 的写法一样，参考如下：
wx.miniapp.loadNativePlugin({
  pluginId: "wx033a6b34f2c7ea15",
  success(myPlugin) {
    // 调用插件接口
  },
  fail(err) {
    // 启动插件失败
  }
})

步骤 4，iOS 端获取 IDFV

const IDFV = myPlugin.getIdentifierForVendor()

步骤 5，iOS 端获取 IDFA

const IDFA = myPlugin.getAdvertisingIdentifier()

补充，获取 IDFA 之前需要获取系统授权

  • 可参考下方方式通过 requestTrackingPermission 获得系统授权
myPlugin.requestTrackingPermission({}, (ret) => {
  /** 
   * ret status的枚举类型
   * ATTrackingManagerAuthorizationStatusNotDetermined
   * ATTrackingManagerAuthorizationStatusRestricted
   * ATTrackingManagerAuthorizationStatusDenied
   * ATTrackingManagerAuthorizationStatusAuthorized
   */
  if (ret && ret.status === 'ATTrackingManagerAuthorizationStatusAuthorized') {
    const IDFV = myPlugin.getIdentifierForVendor()
  }
})

步骤 6，Android 端获取 Android Id

const ret = myPlugin.getAndroidId({})