跳到主要内容

合规接口（必接）

1、接口说明​

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

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

2、接口调用​

2.1、账号注销接口(国内选接，海外必接，sdk的个人信息和隐私保护界面已包含注销入口，游戏可以不单独调用接口注销，该接口给游戏定制注销按钮时使用)​

警告

国内选接，海外必接

账号注销接口并非退出登录接口，但回调结果和退出登录一致。游戏调用此接口，SDK会弹出注销确认界面，注销成功后无法再找回账号。

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

String param = DHPluginParam.Builder()
    .put("plugin_type", "tools")
    .put("unionsdk_type", "platform")
    .put("event_type", "destroyAccount")
    .toString();

/**
 * @param activity    上下文
 * @param param       事件参数
 * @param sdkCallback 回调对象
 */
DHSDKHelper.getInstance().exec(activity, param, new IDHSDKCallback() {
    @Override
    public void onDHSDKResult(int requestCode, int resultCode, String resultData) {
        switch (requestCode) {
            // 若要区分退出登录还是账号注销
            // 调用注销接口时单独创建回调对象来区分！
            case DHSDKConst.REQ_LOGIN_OUT:
                if (resultCode == DHSDKConst.RET_OK) {
                    // 注销成功，需要退出登录
                } else if (resultCode == DHSDKConst.RET_FAIL) {
                    // 注销失败，用户放弃注销
                }
                break;
            default:
                // 其他结果
                break;
        }
    }
});
信息

回调结果：请参考帐号退出登录回调，游戏收到回调后返回登录页面

2.2、协议政策接口​

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

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

/**
 event_key
 网络用户服务协议："dh_user_server"
 网络用户隐私政策："dh_user_private"
 儿童隐私保护指引："dh_child_private"
 第三方SDK目录共享清单："other_sdk_menu"
 */
String param = DHPluginParam.Builder()
    .put("plugin_type", "tools")                     // 固定字段
    .put("unionsdk_type", "platform")                // 固定字段
    .put("event_type", "showPolicyDialogByKey")      // 固定字段
    .put("event_key", "dh_user_server")
    .toString();

/**
 * @param activity    上下文
 * @param param       事件参数
 * @param sdkCallback 回调对象
 */
DHSDKHelper.getInstance().exec(activity, param, new IDHSDKCallback() {
    @Override
    public void onDHSDKResult(int requestCode, int resultCode, String resultData) {
    }
});
信息

回调结果：无

特别注意：对应的event_key分别表示的内容

2.3、信息清单接口​

个人信息与隐私保护、个人信息收集清单调用示例：

警告

示例参数areaId、roleId、serverId必须全部替换为游戏自己的大区ID、角色ID、服务器ID。

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

String jsonstring = DHPluginParam.Builder()
    .put("areaId", "100")                         // 大区ID   
    .put("roleId", "1000010000")                  // 角色ID 
    .put("serverId", "1")                         // 服务器ID
    .toString();

/** 
 event_key
 个人信息收集清单："serviceCenter"
 个人信息与隐私保护："personalInformation"
 */
String param = DHPluginParam.Builder()
    .put("plugin_type", "tools")                  // 固定字段
    .put("unionsdk_type", "platform")             // 固定字段
    .put("event_type", "showWebviewByKey")        // 固定字段
    .put("event_key", "personalInformation")
    .put("jsonstring", jsonstring)
    .toString();

/**
 * @param activity    上下文
 * @param param       事件参数
 * @param sdkCallback 回调对象
 */
DHSDKHelper.getInstance().exec(activity, param, new IDHSDKCallback() {
    @Override
    public void onDHSDKResult(int requestCode, int resultCode, String resultData) {
    }
});
信息

回调结果：无

特别注意：对应的event_key分别表示的内容

个人信息和隐私保护中有账号注销功能，需要游戏开发针对账号注销回调，登出账号返回登录页面。请参考账号注销接口返回结果。