登录设置

登录设置配置应用 ID 使用的登录信息。

登录设置主屏幕¶

• 选择项目：仅显示在开发或上线状态的项目，如应用中心所设定。
• 应用 ID：列出与项目关联的应用 ID，显示状态，如开发中、上线、未使用或服务终止。感叹号 (!) 表示具有未注册或待处理登录设置的应用 ID。
• 重置：恢复到现有设置。如果设置已保存在服务器上，则回滚到保存的版本。
• 更改历史：显示登录设置菜单的更改历史。

登录设置步骤¶

登录设置包括三个步骤：选择登录类型、安排登录顺序和注册认证密钥。

1. 选择登录方式
   • 支持的登录类型会根据在应用中心中注册的应用 ID 所对应的操作系统自动显示。选择您想要激活的登录类型。
2. 安排登录顺序
   • 根据项目需求拖动并调整所选登录类型的顺序。
3. 注册认证密钥
   • 复制各个商店提供的认证密钥，并将其粘贴到登录设置页面。请注意，并非所有登录方式都需要在登录设置菜单中注册认证密钥；某些必须直接在 Hive SDK 中注册。以下提供了各个商店注册认证密钥的详细说明。

支持的登录类型¶

登录设置必须为每个与 App ID 关联的项目单独配置，配置取决于在 App Center 注册的操作系统。

移动设备（Android，iOS）¶

移动设备（Android，iOS）：支持的身份提供者包括 Google Play、Hive、Google、Facebook 等。

• 安卓 : Google Play, Hive, Facebook, Apple, Google, QQ, VK, WeChat, LINE, Weverse, Huawei, Steam, X, Telegram, XIAOMI

• iOS : 游戏中心, Hive, Facebook, Apple, Google, QQ, VK, 微信, LINE, Weverse, Steam, X, Telegram

PC (Windows, MacOS)¶

PC (Windows, MacOS)：支持的身份提供者包括 Hive、Google、Facebook、Apple、Line、X 和 Telegram。如果在应用中心将应用 ID 设置为 Steam 市场，则“使用 Steam 登录”是强制性的。

• 一般
• Steam 市场
  

网络¶

网络：支持的身份提供者包括 Hive、Google、Facebook、Apple、LINE、X、Google Play、和 Steam。

如果您使用网络登录，您必须在注册身份验证密钥时设置重定向 URI。

重定向 URI 是用户在完成网页登录认证后被重定向到的页面地址，您可以注册最多五 (5) 个重定向 URI。

存储密钥发放和登录身份验证密钥注册¶

要使用 IdP（身份提供者）登录，您需要每个 IdP 提供的身份验证密钥。并非所有这些密钥都在登录设置菜单中注册；某些 IdP 密钥必须在 SDK 中注册。 有关 SDK 集成，请参阅 SDK 身份验证指南 有关网页登录，请参阅 网页登录指南

使用 Google Play 登录¶

登录身份验证密钥输入界面¶

要使用 Google Play 登录，请参考以下说明以获取客户端 ID 和客户端密钥，并将其注册到登录设置菜单中。

Google Play 控制台密钥发放和注册流程¶

• Google Play 控制台：配置 Play 游戏服务
  • 访问 Google Play 控制台并使用您的 Google 帐户登录。导航到 Play 游戏服务 > 设置与管理 > 配置。
  • 选择一个 Play 游戏服务项目。
    • 创建新项目：生成一个新的 Play 游戏项目和云项目。
    • 使用现有项目：重用现有项目。
  • 选择一个云项目。如果没有云项目，请点击创建一个新的云项目。
  • 点击 Google Cloud 控制台以在创建 Google Cloud 项目的弹出窗口中打开 Google Cloud 控制台页面。
• 在 Google Cloud 控制台中创建项目
  • 在 Google Cloud 控制台中创建一个新项目。
• 在 Google Cloud 控制台中设置 OAuth 同意屏幕
  • 转到 API 和服务 > OAuth 同意屏幕。选择使用类型为“外部”，然后点击创建。
  • 在应用注册修改中，输入应用名称、用户支持电子邮件和开发者联系信息，然后点击保存并继续。
  • 点击保存并继续，无需额外的范围设置。
  • 点击保存并继续，无需额外的测试用户设置。
  • 在摘要屏幕中查看设置，然后点击返回仪表板。

• 在 Google Cloud 控制台中创建用户凭据

  • 导航到 API 和服务 > 凭据，点击创建凭据 > OAuth 客户端 ID。
  • 应用类型：Android
    • 输入应用类型、名称和 SHA-1 证书指纹，然后点击创建。参考 Google Play 服务指南
      • 包名可以在 AndroidManifest.xml 文件中找到。
      • 在命令提示符下使用 keytool 命令，路径为 C:\Users\%USERPROFILE%.android> 来验证 SHA-1 证书指纹。
    • 在 OAuth 客户端创建窗口中，确认客户端 ID。
  • 应用类型：Web 应用程序
    • 选择 OAuth 客户端 ID，并为 Web 应用程序类型创建额外条目。
    • 输入应用名称并点击创建。
    • 在 OAuth 客户端创建窗口中，确认客户端 ID 和客户端密钥。
  Note

  • 要使用 Google Play 进行登录，在创建用户凭据时生成 Android 和 Web 应用程序类型。Android 应用程序类型是 Hive SDK 配置所需的，而 Web 应用程序类型用于在登录设置菜单中注册身份验证密钥。

• 在 Google Play 控制台的 Play 游戏服务设置中设置云项目

  • 选择一个云项目，点击创建新云项目，并检查生成的项目 ID。

使用 Google 登录¶

登录身份验证密钥输入界面¶

要配置 Google 登录，请按照以下步骤检索您的客户端 ID 和客户端密钥，并将其注册在登录设置菜单中。

Google Cloud Console 密钥发行和注册流程¶

• 在 Google Cloud Console 中创建项目
  • 在 Google Cloud Console 中创建一个新项目。
• 在 Google Cloud Console 中设置 OAuth 同意屏幕
  • 转到 API 和服务 > OAuth 同意屏幕。选择使用类型为“外部”，然后单击创建。
  • 在应用注册修改中，输入应用名称、用户支持电子邮件和开发者联系信息，然后单击保存并继续。
  • 在没有额外范围设置的情况下单击保存并继续。
  • 在没有额外测试用户设置的情况下单击保存并继续。
  • 在摘要屏幕中查看设置，然后单击返回仪表板。

• 在 Google Cloud Console 中创建用户凭据

  • 导航到 API 和服务 > 凭据，单击创建凭据 > OAuth 客户端 ID。
  • 应用类型：Android
    • 输入应用类型、名称和 SHA-1 证书指纹，然后单击创建。 参考 Google Play 服务指南
      • 包名称可以在 AndroidManifest.xml 文件中找到。
      • 在命令提示符下使用 keytool 命令，位于 C:\Users\%USERPROFILE%.android> 以验证 SHA-1 证书指纹。
    • 在 OAuth 客户端创建窗口中，确认客户端 ID。
  • 应用类型：Web 应用程序
    • 选择 OAuth 客户端 ID，并为 Web 应用程序类型创建一个额外条目。
    • 输入应用名称并单击创建。
    • 在 OAuth 客户端创建窗口中，确认客户端 ID 和客户端密钥。
  Note

  • 要使用 Google 登录，您需要配置以下两个 OAuth 2.0 客户端 ID。
    • Web 应用程序类型客户端 ID：用于在服务器上验证 ID 令牌
    • Android 类型客户端 ID：需要应用程序的包名和 SHA-1 证书指纹

使用 Facebook 登录¶

登录认证密钥输入界面¶

要使用 Facebook 登录，请参考以下步骤获取应用程序 ID 和应用程序密钥，并将它们注册在登录设置菜单中。

Facebook 开发者网站密钥发放和注册流程¶

• 访问并登录 Facebook 开发者网站
  • 访问 Facebook 开发者网站并使用您的 Facebook 账户登录。
  • 点击“我的应用”，然后选择一个现有的应用或注册一个新的应用。
• 在应用设置页面检查应用 ID 和应用密钥
  • 在应用仪表板中，前往设置 > 基本，找到应用 ID 和应用密钥。
  • 出于安全原因，应用密钥是隐藏的，需要密码才能显示。
  • 应用密钥仅在控制台输入时需要，并不包含在应用构建中。
• 注意事项
  • 虽然以下设置在登录设置菜单中不是强制性的，但对于启用 Facebook 登录是必不可少的：
    • 导航到应用设置 > 高级设置，并激活应用身份验证。
    • 在应用设置 > 高级设置 > 安全中，获取客户端令牌并在 Hive SDK 中进行配置。
    • 前往 Facebook 登录 > 设置，并添加有效的 OAuth 重定向 URI。

使用 Apple 登录¶

登录认证密钥输入界面¶

要在 iOS 以外的平台上使用 Apple 登录，请按照以下步骤从 App Store 控制台检索服务 ID、团队 ID、密钥 ID 和私钥，并在登录设置菜单中注册它们。

Apple开发者网站密钥发行和注册流程¶

• 访问证书、标识符和配置文件
  • 前往Apple开发者网站，使用您的Apple ID登录，并在顶部菜单中点击“账户”。导航到证书、标识符和配置文件。
• 确认服务ID
  • 在标识符部分，前往注册新标识符页面，选择服务ID，然后点击继续。
  • 在注册服务ID页面，填写描述字段中的应用标题，并在标识符字段中输入信息，然后点击继续。
  • 对于标识符，根据Bundle ID输入信息以便于区分（例如，{Bundle ID}.siwa）。
  • 点击注册以完成服务ID的注册。
• 确认团队ID
  • 团队ID是您Apple开发者账户的唯一标识符，可以在会员部分找到。
• 确认密钥ID
  • 在证书、标识符和配置文件中，前往密钥部分。输入密钥名称，选择“使用Apple登录”，然后点击“继续”。
  • 在配置密钥页面，选择要与“使用Apple登录”一起使用的App ID，并在主App ID字段中点击“保存”。
  • 在注册新密钥页面，点击“注册”。
  • 在下载您的密钥页面，找到密钥ID并点击“下载”以生成并下载密钥。
• 下载私钥
  • 私钥文件将以.p8格式存在，并且只能下载一次，因此请安全存储。
  • 在设置中注册私钥时，请确保包含整个内容，包括行：-----BEGIN PRIVATE KEY-----和-----END PRIVATE KEY-----。

使用 Apple 登录的服务器到服务器通知 URL 注册程序（自 2026 年 1 月 1 日起生效）¶

自 2026 年 1 月 1 日起，使用 Apple 登录的应用必须 注册一个 URL 以接收服务器到服务器的通知。 这些通知允许 Apple 在用户更改邮件转发设置、删除应用内账户或永久删除其 Apple 账户时向您的服务器发送信息。

为服务器到服务器通知构建URL¶

• 在Hive控制台 > 应用中心 > 项目管理中，找到将接收服务器到服务器通知的项目的游戏索引。
• 使用识别的游戏索引，按照以下格式构建URL：
  • 注册URL : https://auth.qpyou.cn/callback/apple/Game Index
  • 示例 : https://auth.qpyou.cn/callback/apple/539

在 Apple 开发者网站注册¶

• 导航到证书、标识符和配置文件
  • 使用您的 Apple ID 登录 Apple 开发者网站。
  • 从顶部菜单中，点击帐户，然后转到证书、标识符和配置文件。
• 选择您的应用
  • 在标识符部分，点击要配置服务器到服务器通知功能的应用。
• 编辑“使用 Apple 登录”配置
  • 在“编辑您的应用 ID 配置”中，找到“使用 Apple 登录”，然后点击编辑按钮。
• 注册服务器到服务器通知 URL
  • 输入 URL 并点击保存按钮以完成注册。
  • 在“编辑您的应用 ID 配置”屏幕上，再次点击保存按钮以保存更改。

使用华为ID登录¶

登录认证密钥输入界面¶

要配置华为ID登录，请按照以下步骤检索华为的客户端ID和客户端密钥，并在登录设置菜单中注册它们。

华为开发者控制台密钥发放与注册流程¶

• 访问 AppGallery Connect
  • 使用您的华为账户登录华为开发者控制台并进入 AppGallery Connect。
  • 选择我的项目，然后在应用仪表板中点击项目设置。
• 在项目设置中确认应用 ID 和应用密钥
  • 点击项目设置 > 一般信息，并在应用信息 > OAuth 2.0 客户端 ID 部分检查客户端 ID 和客户端密钥。

使用Steam登录¶

移动设备（Android，iOS）¶

登录身份验证密钥输入屏幕¶

要配置Steam登录，请按照以下步骤获取您的Steam Web API密钥并在登录设置菜单中注册它。

Steamworks 合作伙伴网站密钥发行和注册流程¶

• 访问并登录 Steamworks 合作伙伴网站
  • 访问 Steamworks 合作伙伴网站并使用您的 Steam 账户登录。
• 验证 Web API 密钥
  • 在顶部菜单中，点击“用户与权限”下“管理组”列表中的组。如果没有组，请点击“创建新组”以创建一个组。
  • 验证所选组的 Web API。

PC (Windows, MacOS)¶

登录身份验证密钥输入屏幕¶

要配置Steam登录，请按照以下步骤检索您的Steam应用程序ID和Web API密钥，并在登录设置菜单中注册它们。

Steamworks 合作伙伴网站密钥发放和注册流程¶

• 确认应用程序 ID
  • 访问 Steamworks 合作伙伴网站，并使用您的 Steam 账户登录。从顶部菜单中，导航到应用程序和包 > 应用程序，并选择一个现有的应用程序。
  • 应用程序 ID 显示在应用程序的仪表板上，并唯一标识该应用程序。
• 在管理用户和权限中确认 Web API
  • 在顶部菜单中，点击“用户和权限”下的“管理组”列表中的组。如果没有组，请点击“创建新组”以创建一个组。
  • 验证所选组的 Web API。

使用 Telegram 登录¶

登录设置认证密钥输入界面¶

要使用 Telegram 登录，请参考以下说明以获取 Bot Token 并在设置菜单中注册。

Telegram 密钥发放和注册流程¶

• 创建机器人
  1. 启动 Telegram 应用，搜索 BotFather，方法是在搜索栏中输入 BotFather。
  2. 与 BotFather 开始聊天并输入 /start 命令。
  3. 输入 /newbot 命令以创建一个新的登录处理机器人。
  4. 按顺序输入机器人名称和用户名。
     • 机器人名称：用户识别机器人的名称（例如 MyLoginBot）。
     • 用户名：以 _bot 结尾的唯一名称（例如 my_login_bot）。
  5. 当机器人创建完成后，BotFather 会提供一个机器人令牌。此令牌用于通过 Telegram API 与机器人进行通信。

使用LINE登录¶

登录设置认证密钥输入界面¶

要使用LINE登录进行网页登录，请参考以下信息找到您的频道ID和频道密钥，然后在登录设置菜单中注册它们。

发放和注册 LINE 密钥的步骤¶

• 创建 LINE 登录频道
  • 登录 LINE 开发者控制台。
  • 在提供者页面，选择一个现有的提供者或创建一个新的提供者。
  • 在所选提供者下，创建一个 LINE 登录频道。
• 检查频道 ID 和频道密钥
  • 转到您创建的 LINE 登录频道的基本设置选项卡。
  • 检查频道 ID 和频道密钥值。
• 注册回调 URL
  • 在 LINE 登录选项卡上，启用 LINE 登录。
  • 在回调 URL 字段中，输入网页登录的重定向 URI。
  • 有关回调 URL 值，请参考 Hive 服务器 API > 网页登录集成 > 入门指南 指南。

使用 X 登录¶

登录设置身份验证密钥输入屏幕¶

要使用 X 登录进行网页登录，请参考以下信息找到您的客户端 ID 和客户端密钥，然后在登录设置菜单中注册它们。

发行和注册 X 密钥的步骤¶

• 在 X 开发者控制台中创建应用
  • 登录到 X 开发者控制台并转到应用页面。
  • 选择要集成的应用或创建新应用。
• 配置 OAuth 2.0
  • 在选定的应用中，点击用户身份验证设置（OAuth 2.0）的设置按钮。
  • 输入以下项目。
    • 应用权限
    • 应用类型
    • 回调 URI / 重定向 URL
      • 有关回调 URL 值，请参考 Hive 服务器 API > Web 登录集成 > 入门 指南。
• 检查应用中的客户端 ID 和客户端密钥
  • 保存 OAuth 2.0 设置后，将发放客户端 ID 和客户端密钥。