# 合规接口(必接)

# 1、接口说明

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

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

# 2、接口调用

# 2.1、账号注销接口(海外必接)

DANGER

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

调用示例如下:

import { DHSDKHelper } from 'dhsdkhelper'

let info: ESObject = {
      pluginName: 'tools', // 固定值不许修改
      pluginType: 'platform', // 固定值不许修改
      methodName: '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 = {
      pluginName: 'tools',// 固定值不许修改
      pluginType: 'platform',// 固定值不许修改
      methodName: 'showPolicyDialogByKey',// 固定值不许修改
      methodEvent: '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。纯数字
      roleId: '10086', // 角色ID
}
let info: ESObject = {
      pluginName: 'tools', //固定值,不能修改
      pluginType: 'platform', //固定值,不能修改
      methodName: 'showWebviewByKey', //固定值,不能修改
      methodEvent: 'personalInformation', //固定值,不同协议政策传入下表不同值
      methodParam: JSON.stringify(gameUserInfo)//游戏角色信息json字符串,传入真实值
}

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

分类信息,主要参数说明如下:

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

其他信息,主要参数说明如下:

参数 类型 必传字段 统一字段 说明
areaId string 大区ID
roleId string 角色ID
Last Updated: 2024/11/6 09:22:16