Windows

本文旨在介绍如何设置 Garena 身份验证，让您的游戏可以使用 Player Network 登录鉴权服务通过 Garena 渠道登录。

前提条件

1. 设置 Garena 应用

请联系 Garena 团队来：

1. 激活应用并获取 app ID 和其他相关信息。
2. 在开发者平台配置 Garena 登录的回调 URL：
   • https://test-common-web.intlgame.com/jssdk/garenalogincallback.html
   • https://common-web.intlgame.com/jssdk/garenalogincallback.html
3. （可选）开启 APP_PLATFORM_BIND，启用 Garena 的平台账号绑定。

2. 获取 Player Network 控制台登录账号。
3. 为游戏创建新项目，或加入已有项目。
4. 下载 SDK。
5. 接入 SDK。
6. 在 Player Network 控制台添加 Garena 为业务的登录鉴权方式。

步骤1：为 Garena 登录配置 SDK

打开项目的 INTLConfig.ini 文件：

INTLConfig.ini

[INTL environment]
# WARNING: You should change this URL to the production environment when you release your game.
INTL_URL = https://intlsdk-new-test.iegg.garena.com
GAME_ID = {INTL_GAME_ID}
SDK_KEY = {INTL_SDK_KEY}
[INTL Log]
LOG_LEVEL = 1
LOG_CONSOLE_OUTPUT_ENABLE = 1
LOG_FILE_OUTPUT_ENABLE = 1
LOG_ENCRYPT_ENABLE = 0
LOG_COMPRESS_ENABLE = 0
[Garena Channel Configurations]
GARENA_WEBVIEW_LOGIN_ENABLE = 1

• 将 Player Network SDK 鉴权域名设置为 INTL_URL = https://intlsdk-new-test.iegg.garena.com （请联系 Garena 团队提供）。
• 将 {INTL_GAME_ID} 和 {INTL_SDK_KEY} 替换为 Player Network 控制台 分配的 GAME_ID 和 SDK_KEY 的值。
• 设置 LOG_LEVEL = 1、LOG_CONSOLE_OUTPUT_ENABLE = 1、LOG_FILE_OUTPUT_ENABLE = 1、LOG_ENCRYPT_ENABLE = 0 和 LOG_COMPRESS_ENABLE = 0，以便在不加密或压缩输出的情况下输出控制台日志和日志文件。
• 设置 GARENA_WEBVIEW_LOGIN_ENABLE 的值。默认值为 1，表示 Windows 平台使用 WebView 登录。如果用户将该值设置为 0，Windows 平台将使用系统浏览器登录。

caution

如果 INTLConfig 中的 GARENA_WEBVIEW_LOGIN_ENABLE 设置为 1，则需要集成 INTLWebView 插件，否则登录将无法成功。

步骤2：添加 Garena 登录

1. 注册登录相关回调。

Unity

// Add callbacks
public void AddAuthObserver()
{
    INTLAPI.AddAuthResultObserver(OnAuthResultEvent);
}

// Remove callbacks
public void RemoveAuthObserver()
{
    INTLAPI.RemoveAuthResultObserver(OnAuthResultEvent);
}

// Process the INTLAuthResult callback
public void OnAuthResultEvent(INTLAuthResult AuthResult)
{
    Debug.Log($"MethodID: {AuthResult.MethodId}");
    
    string methodTag = "";
    switch (AuthResult.MethodId)
    {
        case (int)INTLMethodID.INTL_AUTH_LOGIN:
            methodTag = "Login";
            break;
        case (int)INTLMethodID.INTL_AUTH_BIND:
            methodTag = "Bind";
            break;
        case (int)INTLMethodID.INTL_AUTH_AUTOLOGIN:
            methodTag = "AutoLogin";
            break;
        case (int)INTLMethodID.INTL_AUTH_QUERY_USER_INFO:
            methodTag = "QueryUserInfo";
            break;
        case (int)INTLMethodID.INTL_AUTH_GET_AUTH_RESULT:
            methodTag = "GetAuthResult";
            break;
    }
}

Unreal Engine

C++ Event Handling (above v1.15)

//configure callback
FINTLAuthEvent authEvent;
authEvent.AddUObject(this, &OnAuthResult_Implementation);
UINTLSDKAPI::SetAuthResultObserver(authEvent);
// Remove callbacks
UINTLSDKAPI::GetAuthResultObserver().Clear();

void OnAuthResult_Implementation(FINTLAuthResult ret)
{ 
    UE_LOG(LogTemp, Warning, TEXT("MethodID: %d"), ret.MethodId);
}

Unreal Event Handling

void OnAuthResult_Implementation(FINTLAuthResult ret)
{ 
    UE_LOG(LogTemp, Warning, TEXT("MethodID: %d"), ret.MethodId);
}

2. 调用 AutoLogin 接口自动登录。

Unity

INTLAPI.AutoLogin();

Unreal Engine

UINTLSDKAPI::AutoLogin();

3. 在自动登录失败时调用 Login 接口使玩家手动登录。

note

Windows 支持传入子渠道，ExtraJson 不传子渠道，会默认跳转到 Garena 官网登录，并支持所有 Garena 开发者后台配置的子渠道。
多端入参是不一样的，如下示例。

Unity

INTLAPI.Login(INTLChannel.Garena, "", "{\"appendix\":\"platform=1\"}");// 登录 Garena - Garena (1)
INTLAPI.Login(INTLChannel.Garena, "", "{\"appendix\":\"platform=3\"}");// 登录 Garena - Facebook (3)
INTLAPI.Login(INTLChannel.Garena, "", "{\"appendix\":\"platform=8\"}");// 登录 Garena - Google (8)
INTLAPI.Login(INTLChannel.Garena, "", "{\"appendix\":\"platform=10\"}");// 登录 Garena - Apple (10)
INTLAPI.Login(INTLChannel.Garena, "", "{\"appendix\":\"all_platforms=1\"}");// 登录 Garena - 所有平台
INTLAPI.Login(INTLChannel.Garena, "", "");// 登录 Garena - 所有平台

Unreal Engine

UINTLSDKAPI::Login(EINTLLoginChannel::kChannelGarena, "", "{\"appendix\":\"platform=1\"}");// 登录 Garena - Garena (1)
UINTLSDKAPI::Login(EINTLLoginChannel::kChannelGarena, "", "{\"appendix\":\"platform=3\"}");// 登录 Garena - Facebook (3)
UINTLSDKAPI::Login(EINTLLoginChannel::kChannelGarena, "", "{\"appendix\":\"platform=8\"}");// 登录 Garena - Google (8)
UINTLSDKAPI::Login(EINTLLoginChannel::kChannelGarena, "", "{\"appendix\":\"platform=10\"}");// 登录 Garena - Apple (10)
UINTLSDKAPI::Login(EINTLLoginChannel::kChannelGarena, "", "{\"appendix\":\"all_platforms=1\"}");// 登录 Garena - 所有平台
UINTLSDKAPI::Login(EINTLLoginChannel::kChannelGarena, "", "");// 登录 Garena - 所有平台

Garena 登录 permission 参数与其他渠道不同。用户需要输入字符串格式的数字。例如，"2" 或 "4"。权限定义如下：

4. 与游戏后台同步客户端身份验证状态，等待最终验证结果。

步骤3：验收登录功能

在 Player Network SDK 日志中搜索关键字 "AuthResult" 确认渠道名称和 OpenID 是否正确返回。如果正确，则表明集成配置成功，登录功能已成功添加。

如果接入过程中遇到问题，请参见 常见问题。