集成要求

合规说明

请注意，在贵司的App中集成同盾提供的SDK产品时:

1.1 根据《网络安全法》《电信条例》《电信和互联网用户个人信息保护规定》等相关法律法规要求及监管实践中的标准，在贵司的最终用户首次启动App并在贵司开始采集信息之前，贵司应以交互界面或设计（如隐私政策弹窗等）向最终用户完整告知收集、使用、与第三方共享最终用户个人信息的目的、方式和范围，并征得最终用户的明示同意。

1.2 为向贵司提供业务安全和风控服务，同盾 SDK 将采集、处理、使用用户的手机终端唯一标志信息IDFA、Android ID、OAID(包含VAID、AAID)、MAC 地址、WIFI列表、无线路由器标识（BSSID、SSID）、设备类型、设备型号、系统类型、粗略位置信息、精准位置信息、应用程序列表、运行中进程信息、网络制式、设备软件版本号、传感器（光传感器、重力传感器、磁场传感器、加速度传感器、陀螺仪传感器、心率传感器）相关设备信息。为确保贵司使用相关服务的合规性，前述隐私政策应涵盖对同盾SDK提供服务并采集、处理、使用相关信息的授权，以上内容供贵司参考，具体表述可由贵司根据贵司隐私协议的整体框架和内容自行确定。

个人信息类处理规则(隐私政策)：https://www.tongdun.cn/other/privacy/id=4
使用说明：合规使用指导

注意事项

确保在用户同意隐私协议后，再进行插件配置初始化，避免出现用户未同意隐私协议就进行插件初始化采集，引发合规风险。

环境要求

集成步骤

安装配置

插件配置

1. 在 <https://ext.dcloud.net.cn/plugin?id=16592> 界面下载 TrustDeviceUniPlugin 插件
2. 把TrustDecision-TrustDeviceUniPlugin 文件夹放入 your_project/nativeplugins 目录
3. 在 HBuilderX 点击选中 manifest.json，选择 App原生插件配置
4. 点击本地插件 [选择本地插件]，勾选 TrustDeviceUniPlugin

Android权限申请

在工程目录下的 manifest.json ⽂件中声明以下权限

"android" : {
                "permissions" : [
                   <!--必选权限-->
                    "<uses-permission android:name=\"android.permission.INTERNET\"/>",
                    "<uses-permission android:name=\"android.permission.ACCESS_NETWORK_STATE\"/>",
                    "<uses-permission android:name=\"android.permission.ACCESS_WIFI_STATE\"/>",
                     <!--如果您的应用是面向海外市场，在google play 上发布，请添加此项-->
                    "<uses-permission android:name=\"com.google.android.gms.permission.AD_ID\",
                    
                    <!--以下权限是可选权限，不声明此部分权限将放弃部分设备信息的采集，对风险识别有一定影响-->
                    "<uses-permission android:name=\"android.permission.ACCESS_COARSE_LOCATION\"/>",
                    "<uses-permission android:name=\"android.permission.ACCESS_FINE_LOCATION\"/>",
                    "<uses-permission android:name=\"android.permission.READ_PHONE_STATE\"/>",
                    <!-- Android11及以上获取安装包列表需要该权限，采集安装包列表涉及到⻛险合规，是否需要该权限业务⽅⾃⾏选
择 -->
                    "<uses-permission android:name=\"android.permission.QUERY_ALL_PACKAGES\"/>"
                    />"
                ],
            ...
            },

权限说明

初始化

注意事项

• 确保在用户同意隐私协议后，再进行SDK初始化

最佳实践

1.获取 TrustDeviceSe 插件

  const TrustDeviceSe = uni.requireNativePlugin('TrustDecision-TrustDeviceUniPlugin-Se');

2.初始化

    var options = {
      "partner": "请输入您的合作方编码",
      "appKey": "请输入您的appKey",
      "appName": "请输入您的appName",
      "country": "请输入您所在的国家地区",
      "debug": false, 
    }

    const isDebugMode = __DEV__;
    // !!! DEBUG模式下若不设置此参数，app运行会闪退
    if (isDebugMode) {
      options["debug"] = true;
    }
     // 初始化
     TrustDeviceSe.initWithOptions(options);
     
     

3.在实际业务节点获取设备信息（需要保证已调用SDK初始化方法）

     // 获取设备信息
TrustDeviceSe.getDeviceInfo((result) => {
  if (result) {
       if (result["code"] == 0) {
             console.log(result);
       } else {
             console.log(result["msg"]);
       }
      
     }

});

响应结果

当 result["code"] == 0 时即代表获取设备信息成功，getDeviceInfo() 函数返回响应数据，包含以下信息。sealedResult 仅在启用了客户端密封结果时返回该信息。

code和msg对应值如下表：

其他说明

获取版本号

TrustDeviceSe.getSDKVersion();

混淆打包

如果 Android 需要使用 proguard 进行混淆打包，请在 proguard 配置文件添加如下代码：

-keep class com.trustdecision.**{*;}

全部配置