跳到主要内容

合规接口(必接)

1、接口说明​

主要用于国内合规时调用的协议接口，包括：用户协议、隐私协议、儿童隐私保护指引、第三方SDK目录共享清单、个人信息收集清单、个人信息和隐私保护。

其中，第三方SDK目录共享清单、个人信息收集清单和个人信息和隐私保护，必须在产品的二级目录增加入口以进行调用。

2、接口调用​

2.1、账号注销接口（海外必接）​

危险
  • 国内选接，海外必接，SDK的个人信息和隐私保护界面已包含注销入口，游戏可以不单独调用接口进行注销**。
  • 该接口用于游戏定制注销按钮时使用，账号注销接口并非退出登录接口，但回调结果和退出登录一致。游戏调用此接口后，SDK会弹出注销确认界面，一旦注销成功，将无法再找回账号。

调用示例如下：

import { DHSDKHelper } from 'DHSDKHelper'

let info: ESObject = {
      plugin_type: 'tools', // 固定值不许修改
      unionsdk_type: 'platform', // 固定值不许修改
      event_type: 'destroyAccount' // 固定值不许修改
}
/**
 * @param context    上下文
 * @param param       接口参数
 */
DHSDKHelper.exec(getContext(this), JSON.stringify(info))

调用后在初始化设置的SDK回调中将收到如下回调码：

...
//账号注销结果
case DHRequestCode.REQ_LOGOUT:
if (resultCode == DHResultCode.OK) {
 //账号注销成功，清理场景回到登录页面
} else {
 //账号注销失败，继续游戏
}
break
...

回调数据为文本提示或其他结构，接入方无需解析

2.2、协议政策接口​

用户协议、隐私政策、儿童隐私保护指引和第三方SDK目录共享清单

调用示例如下：

import { DHSDKHelper } from 'DHSDKHelper'

//以下所有字段值皆为固定值，不能修改
let info: ESObject = {
      plugin_type: 'tools',// 固定值不许修改
      unionsdk_type: 'platform',// 固定值不许修改
      event_type: 'showPolicyDialogByKey',// 固定值不许修改
      event_key: 'other_sdk_menu'//不同协议政策传入下表不同值
}

/**
 * @param context    上下文
 * @param param       接口参数
 */
DHSDKHelper.exec(getContext(this), JSON.stringify(info))

分类信息，主要参数说明如下：

分类参数值
网络用户服务协议dh_user_server
网络用户隐私政策dh_user_private
儿童隐私保护指引dh_child_private
第三方SDK目录共享清单other_sdk_menu

2.3、信息清单接口​

个人信息与隐私保护、个人信息收集清单

::: tip 个人信息和隐私保护中包含账号注销功能，需要游戏开发人员针对账号注销回调进行处理，并在登出账号后返回登录页面。请参考账号注销接口的返回结果。 :::

调用示例如下：

import com.dh.DHSDKHelper;
import com.dh.callback.IDHSDKCallback;
import com.dh.framework.utils.DHPluginParam;

//以下所有字段值皆为示例，研发接入时需替换为游戏的真实值
let gameUserInfo: ESObject = {
      areaId: '1', // 大区ID。纯数字，若无值则传入"1"
      roleId: '10086', // 角色ID
      serverId: '22'// 大区下的服务器ID，纯数字
}
let info: ESObject = {
      plugin_type: 'tools', //固定值，不能修改
      unionsdk_type: 'platform', //固定值，不能修改
      event_type: 'showWebviewByKey', //固定值，不能修改
      event_key: 'personalInformation', //固定值，不同协议政策传入下表不同值
      jsonstring: JSON.stringify(gameUserInfo)//游戏角色信息json字符串，传入真实值
}

/**
 * @param context    上下文
 * @param param       接口参数
 */
DHSDKHelper.exec(getContext(this), JSON.stringify(info))

分类信息，主要参数说明如下：

分类参数值
个人信息收集清单serviceCenter
个人信息与隐私保护personalInformation

其他信息，主要参数说明如下：

参数类型必传字段统一字段说明
areaIdstring是是大区ID。纯数字，若无值则传入"1"
roleIdstring是是角色ID
serverIdstring是是大区下的服务器ID，纯数字