跳到主要内容

实名认证

应国家法律法规要求，上线运营的游戏必须接入国家层面的实名验证系统。为了确保游戏能正常运行和支付，此步骤必须接入。

SDK 方法名称​

XL_UserAuthentic 或 XL_UserAuthenticW（宽字符接口）

调用示例​

// 以下代码依赖 Windows API
#include <windows.h>

// 实名认证调用接口导出为 XL_UserAuthentic
HMODULE hModule = GetModuleHandle(L"XLGameLauncher.dll");
if (hModule || (hModule = LoadLibrary(L"XLGameLauncher.dll")))
{
    int(WINAPI * XL_UserAuthentic)(HWND, LPCSTR, LPCSTR);

    if ((PVOID &)XL_UserAuthentic = GetProcAddress(hModule, "XL_UserAuthentic"))
    {
        int nResult = XL_UserAuthentic(hwnd, gameId, userId); // hwnd 为游戏窗口句柄
        // 如 int nResult = XL_UserAuthentic(hwnd, "123", "123");
    }
}

// 实名认证调用宽字符接口导出为 XL_UserAuthenticW
HMODULE hModule = GetModuleHandle(L"XLGameLauncher.dll");
if (hModule || (hModule = LoadLibrary(L"XLGameLauncher.dll")))
{
    int(WINAPI * XL_UserAuthentic)(HWND, LPCWSTR, LPCWSTR);

    if ((PVOID &)XL_UserAuthentic = GetProcAddress(hModule, "XL_UserAuthenticW"))
    {
        int nResult = XL_UserAuthentic(hwnd, gameId, userId); // hwnd 为游戏窗口句柄
        // 如 int nResult = XL_UserAuthentic(hwnd, L"123", L"123");
    }
}

调用参数说明​

参数类型说明
hwndHWND游戏的窗口句柄
gameIdstring平台的游戏 ID
userIdstring平台的用户 ID

返回值说明​

返回值说明
0实名认证不通过，用户不能进行游戏
1实名认证通过，用户可以进行游戏
信息

实名认证不通过（返回值为 0）的原因包括：

  • 用户未实名。
  • 用户已实名但未成年。
  • 平台未查询到该用户的记录。
  • 用户未填写实名信息就关闭了实名弹窗。

此时，游戏方需要阻止用户进行游戏，并关闭游戏窗口，退出游戏。