12/25/2024 11:11:54

中控开放平台接入指引

接入概述

腾讯游戏中控系统与 MSDK 深度融合，目前 MSDK 提供如下两个重点问题解决方案 ：

• 登录时实名、中控要求
• 游戏内打开 WebView 网页指令

登录时实名要求

MSDK 在登录过程中，已经内置了中控实名的能力，一般情况下业务无需特殊处理

详细信息请参考部分请参考 实名认证

中控对应文档 ：https://hope.qq.com/wiki/htdocs/document/view.html?file=7/233

游戏内打开 WebView

根据中控指令，需要处理 【指令Instruction】中的【Type3: 打开网页窗口】

根据下面的要求：

有意义的字段：
url 打开的网页地址
modal 1表示模态窗口，关闭则会退出登录；默认为0，允许关闭

MSDK 在登录回调中，新增了用于标记该场景。

注意：需要 MSDK 版本 5.33.001 （Pix 5.33.101）及以上

业务在收到 Method ID == MSDK_REAL_NAME (138) 的错误回调后，需要在适当的时机进行登出操作，示例代码如下：

public void OnLoginRetEvent(MSDKLoginRet loginRet)
{
    ...
    if (loginRet.MethodNameId == (int)MSDKMethodNameID.MSDK_REAL_NAME)
    {
        if(loginRet.RetCode != MSDKError.SUCCESS) {
            //TODO :  MSDK Logout and goto login scence
        }

    }
    ...
}

void OnLoginRetNotify(const MSDKLoginRet &loginRet) {
    ...
    if (loginRet.methodNameID == kMethodNameRealName) {
        if (loginRet.retCode != MSDKError::SUCCESS) {
            //TODO :  MSDK Logout and goto login scence
        }
    }
    ...
};

中控对应文档 ： https://hope.qq.com/wiki/htdocs/document/view.html?file=7/194#Type3:%20%E6%89%93%E5%BC%80%E7%BD%91%E9%A1%B5%E7%AA%97%E5%8F%A3