跳转至

登录设置

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

Note
  • 要设置登录设置,项目和应用 ID 必须已经注册。您可以在应用中心注册项目和应用 ID。有关更多详细信息,请参阅 App Center

登录设置主屏幕

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

登录设置步骤

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

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

请检查您想要使用的 IdP 是否支持所应用的 Hive SDK 版本。

支持的登录类型

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

移动设备(Android,iOS)

移动设备(Android,iOS):支持的身份提供者包括 Google Play、Hive、Google、Facebook 等。

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

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

PC (Windows, MacOS)

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

  • 一般
  • Steam 市场

网络

网络:支持的身份提供者包括 Hive、Google、Facebook 和 Apple。对于网络登录,必须在身份验证密钥设置期间注册重定向 URI。

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

在登录设置菜单中注册的身份验证密钥不包括 Hive 提供的所有用于登录的密钥。对于未在登录设置菜单中注册的身份提供者,请在 SDK 中注册它们。

Note
  • 在登录设置菜单中注册密钥时,请确保同一项目的商店密钥在移动设备、PC和网页上保持一致。

使用 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。
Note

Facebook 登录在您的 iOS 应用上无法正常工作吗?
如果在 Facebook 控制台中启用了“应用密钥是否嵌入客户端?”选项,则在 iOS 上拒绝跟踪权限的用户可能无法使用 Facebook 登录。
确保禁用此选项以避免登录问题。

使用 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登录”,然后点击“继续”。
    • 在配置密钥页面中,在主应用ID字段中选择要与“使用Apple登录”一起使用的应用ID,然后点击“保存”。
    • 在注册新密钥页面中,点击“注册”。
    • 在下载您的密钥页面中,找到密钥ID并点击“下载”以生成并下载密钥。
  • 下载私钥
    • 私钥文件将为.p8格式,只能下载一次,因此请安全存储。
    • 在设置中注册私钥时,请确保包含整个内容,包括行:-----BEGIN PRIVATE KEY-----和-----END PRIVATE KEY-----。

使用 HUAWEI ID 登录

登录认证密钥输入界面

要配置 HUAWEI 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。
Note
  • 对于移动设备,应用程序 ID 不使用。

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 与机器人进行通信。