Skip to main content

iOS

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

前提条件​

1. 在 QQ Connect 平台上设置您的游戏
1. 创建 QQ 应用

  1. 登录 QQ Connect。

  2. 在侧边栏中，点击 应用管理。

  3. 点击 创建应用。

    图片：创建应用

  4. 在 移动应用信息 下，输入 iOS 应用程序信息。

    • iOS UrlScheme：tencent{INTL_QQ_APP_ID}，替换 {INTL_QQ_APP_ID} 替换为 QQ 分配给游戏的 AppID。

    图片：Mobile App Information

2. 获取应用程序信息

  1. 登录 QQ Connect。

  2. 在侧边栏中，点击 应用管理。

  3. 在相应应用程序的 操作 栏中点击 编辑。

    图片：Edit Apps

  4. 在应用编辑页面，确认 QQ 应用程序的 AppID 和 AppKey。

    图片：App Information

3. 申请 QQ Connect OpenAPI 能力 is_login 权限

如果申请未通过，即使 QQ app 授权登录成功，Player Network SDK 后台将返回错误 app has no privilege to use this api。
请根据以下模板发送电子邮件申请权限：

更多信息，请参见 is_login。

  1. 进入 Player Network 控制台， 为游戏创建新项目，或加入已有项目。
  2. 下载 SDK。
  3. 接入 SDK。
  4. 在 Player Network 控制台添加 QQ 为业务的登录鉴权方式。

步骤1：为 QQ 登录配置 SDK​

  1. 打开项目的 INTLConfig.ini 文件：

    INTLConfig.ini
    [INTL environment]
    # WARNING: You should change this URL to the production environment when you release your game.
    INTL_URL = https://test.intlgame.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

    [QQ channel configuration]
    QQ_APP_ID = {INTL_QQ_APP_ID}
    • 将 SDK 后端环境设置为 INTL_URL = https://test.intlgame.com。
    • 将 {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，以便在不加密或压缩输出的情况下输出控制台日志和日志文件。
    • 将 {INTL_QQ_APP_ID} 替换为 QQ 分配的 AppID。

  2. 添加 QQ 配置。

    打开 INTLCoreKit.projmods，在从 Unity 导出 Xcode 工程之前，将 {INTL_QQ_APP_ID} 替换为QQ AppID。

    {
        "group": "INTL",
        "libs": [
            "libz.tbd",
            "libstdc++.tbd",
            "libiconv.tbd",
            "libsqlite3.tbd"
        ],
        "frameworks": [
            "Security.framework",
            "SystemConfiguration.framework",
            "CoreTelephony.framework",
            "CoreGraphics.framework"
        ],
        "files": [],
        "folders": [],
        "excludes": [
            "^.*.meta$",
            "^.*.mdown$",
            "^.*.pdf$"
        ],
        "headerpaths": [],
        "build_settings": {
            "OTHER_LDFLAGS": ["-ObjC"],
            "ENABLE_BITCODE": "NO"
        },
        "system_capabilities": {},
        "Info.plist": {
            "LSApplicationQueriesSchemes": [
                "tim",
                "mqq",
                "mqqapi",
                "mqqwpa",
                "mqqbrowser",
                "mttbrowser",
                "mqqOpensdkSSoLogin",
                "mqqopensdkapiV2",
                "mqqopensdkapiV3",
                "mqqopensdkapiV4",
                "wtloginmqq2",
                "mqzone",
                "mqzoneopensdk",
                "mqzoneopensdkapi",
                "mqzoneopensdkapi19",
                "mqzoneopensdkapiV2",
                "mqqapiwallet",
                "mqqopensdkfriend",
                "mqqopensdkdataline",
                "mqqgamebindinggroup",
                "mqqopensdkgrouptribeshare",
                "tencentapi.qq.reqContent",
                "tencentapi.qzone.reqContent"
            ],
            "NSAppTransportSecurity": {
                "NSAllowsArbitraryLoads": true
            },
            "CFBundleURLTypes": [
                {
                    "CFBundleTypeRole": "Editor",
                    "CFBundleURLName": "tencent",
                    "CFBundleURLSchemes": ["tencent{INTL_QQ_APP_ID}"]
                }
            ]
        }
    }

    将 {INTL_QQ_APP_ID} 替换为 QQ 分配的 AppID。

步骤2：添加 QQ 登录​

在调用 INTLAPI.Login 的时候传入权限。INTLAPI.Login 的时候传入权限。建议传入 "all"，表示具备已申请的平台侧所有权限。

权限说明
get_simple_userinfoQQ 登录权限（移动端获取 QQ 用户信息）

  1. 注册登录相关回调。

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

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

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

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

    INTLAPI.AutoLogin();

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

    INTLAPI.Login(INTLChannel.QQ, "all", "");

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

扫码登录​

Player Network SDK V1.26.00 开始支持 Android 和 iOS 平台的 QQ 扫码登录。

默认情况下手机如果安装了 QQ app，会直接拉起 QQ app 进行登录，如果手机未安装 QQ app，则自动切换为扫码登录。如需修改默认行为，可以在 extraJson 中指定 qrcode_mode 参数：

qrcode_mode说明
auto自动模式（默认）：
优先使用 QQ app 登录，未安装 QQ app 时则使用扫码登录
force_app强制 QQ app 登录：
未安装 QQ app 时登录会报错
force_qrcode强制扫码登录：
无论是否安装 QQ app，都会使用扫码进行登录
string permissions = "";
string extraJson = "{\"qrcode_mode\" : \"force_qrcode\"}";
INTLAPI.Login(INTLChannel.QQ, permissions, extraJson);

步骤3：验收登录功能​

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

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

隐私政策用户协议数据处理协议开源许可协议
©2025 Proxima Beta Pte. Ltd. All rights reserved.