07/16/2026 14:52:20

海外未保接入功能

一、功能描述

应对出海业务需求，规划海外未保能力，与中控合作共建，MSDK 对接游戏建立通道，中控负责未成年数据判断和策略下发，分为设置语言、设置地区和拉起未成年保护设置自定义参数三个接口（中控文档： https://iwiki.woa.com/pages/viewpage.action?pageId=4008184830 ）。

二、前置条件

1、MSDK5.31（GCloud V2.2.13）及以后版本

2、拉起未成年保护设置自定义参数（SetHopeExtData）：仅移动端 MSDK5.45.100（GCloud V2.3.6）及以后版本支持，PC 端暂不支持

3、飞鹰需要在接入的海外登录渠道中打开海外未成年认证的开关

三、接口代码

调用时机：MSDK 初始化后，登录之前。

1、设置语言

填写规范为 BCP 47 Code 字符串，例如：zh-CN

public static void SetLanguage (string lang);

static void SetLanguage(const String &lang);

2、设置地区

第一个参数必填，第二、三参数选填 填写规范为首个元素固定为 ISO_3166-1 规范地区编码，示例："region":["US","NY","NYC"] 代表 美国->纽约州->纽约

public static void SetRegion (string country, string province = "", string city = "");

static void SetRegion(const String &country, const String &province = "", const String &city = "");

3、拉起未成年保护设置自定义参数

SetHopeExtData 接口用于业务将自定义数据传递给中控。channelId 具体值联系中控侧约定，由中控侧配置生效；字段名和字段值均为字符串类型，符合 JSON 字符串规范，长度不超过 32 个字符，且透传的字段名和字段值在 MSDK 后台有白名单配置控制（未配置不生效）。

public static void SetHopeExtData (string configsJson);

static void SetHopeExtData(const String &configsJson);

四、示例代码

1、设置语言

MSDKTools.SetLanguage(lang);

MSDKConfig::SetLanguage(lang);

2、设置地区

MSDKTools.SetRegion(country, province, city);

MSDKConfig::SetRegion(country, province, city);

3、拉起未成年保护设置自定义参数

MSDKTools.SetHopeExtData("{\"channelId\":\"100001\"}");

MSDKConfig::SetHopeExtData("{\"channelId\":\"100001\"}");