第一步

要开始使用,您需要:

  • 注册 UGS,包括 Analytics。
  • 将您的面板项目链接到 Unity 编辑器项目。
  • 在您的游戏代码中初始化 UGS。

注册

要使用推送通知,您需要注册 Unity Analytics,它是 Unity 游戏服务 (UGS) 的一部分。有关 Analytics 定价的更多信息,请参阅此处。要详细了解推送通知的合理使用,请访问此处

如果您没有 Unity 帐户,请创建一个创建一个新项目以注册 Unity 游戏服务。

Important: Only Organization Owners can sign up for Analytics.

  1. 登录Unity 服务面板
  2. 在侧面板中选择“浏览服务”。
  3. 选择顶部横幅中的“注册”并按照说明操作。
  4. 查看Analytics 文档

要使用 Unity 推送通知服务,您需要通过项目 ID 将您的项目链接到 Unity 编辑器中的云项目。请按照以下步骤获取您的项目 ID。

  1. 在 Unity 编辑器菜单中,转到“编辑”->“项目设置”以打开“服务”选项卡。
  2. 如果您尚未使用 Unity ID 登录,请创建一个新的 Unity ID 或登录。
  3. 如果您要创建一个新项目,请选择您的组织并选择“创建”。如果您要链接到现有项目,请选择“我已经有 Unity 项目 ID”。
  4. 从下拉列表中选择您的组织和项目,然后选择“链接”。

您可以在“服务”窗口的“设置”选项卡中找到您的项目 ID。

集成

The Push Notifications SDK supports both iOS 10+ and Android SDK >= 26 (Oreo).

集成步骤摘要

  1. **集成 SDK**:集成软件包,注册推送通知,并输入设置/密钥。
  2. **上传密钥**:找到私钥(Firebase 和 Apple)并将其上传到 Unity 面板。
  3. **测试集成**:向您的设备发送测试通知,以确保集成正确。
  4. **创建通知活动**:在 Unity 面板上创建并安排您的第一个通知。

1. 集成推送通知 SDK

安装推送通知 SDK

The Push Notifications SDK might not be visible by default inside the Package Manager in your Unity Editor version.

您可以通过以下三种方式之一在您的 Unity 项目中安装推送通知 SDK

1. 使用 Unity Registry 导入
  1. 从“编辑”->“项目设置”打开您的“项目设置”。
  2. 从“包管理器”->“高级设置”->“启用预发布包”启用预发布包。
  3. 从“组件”->“包管理器”打开包管理器。
  4. 在“包”下拉菜单下,选择“Unity Registry”。
  5. 在右上角的搜索栏中搜索“推送通知”以查看推送通知包。
  6. 选择右上角的“安装”。
2. 按名称导入
  1. 通过“组件”->“包管理器”打开包管理器。
  2. 选择左上角的“添加”(+)按钮以添加新的包,然后选择“按名称添加包”。
  3. 键入 com.unity.services.push-notifications 作为 Git URL 并添加。
3. 使用“manifest.json”文件导入
  1. 复制以下代码片段并调整包版本

    "com.unity.services.push-notifications": "4.0.0-pre.1"
  2. 在文件资源管理器中转到您的项目文件夹的根目录,然后转到包文件夹“Packages/manifest.json”。

  3. 将复制的代码添加到“manifest.json”文件的末尾,如果需要,请在末尾附加一个“,”。

注册推送通知

要接收推送通知,您的应用需要注册推送通知。有关详细信息,请参阅注册推送通知

2. 上传您的服务密钥

要从 Unity 游戏服务面板发送通知,您需要从**Firebase**(适用于 Android)和您的**Apple 开发者帐户**(适用于 iOS)上传服务密钥。

Google

在向 Android 设备发送通知之前,您需要将 Firebase 服务帐户密钥添加到您的 Unity 项目设置中。您需要为预期测试或使用通知的**每个**游戏 UGS 环境执行此操作。

  1. 转到您的Firebase 控制台并选择您的项目。
  2. 转到“项目设置”并在顶部选择“服务帐户”。
  3. 选择“创建服务帐户”。
  4. 选择“生成新的私钥”。
  5. 选择“生成密钥”以下载密钥文件。
  6. 在 Unity 面板中返回到“实时运营”>“推送通知”>“设置”(适用于您的项目),然后转到“Google 密钥”并选择“Google 密钥”行中的“添加密钥”或“编辑”图标。
  7. 系统会要求您返回编辑器以完成“配置 SDK”步骤。
  8. 在编辑器中,导航到“项目设置”>“服务”>“推送通知”并配置您的 Android (Firebase) 设置。
    然后返回面板并单击“下一步”按钮以移动到 Google 密钥配置向导中的下一步。
  9. 上传在先前步骤中创建的私钥并选择完成

For security reasons this file won’t be visible if you re-enter the edit settings page.

Apple

在向 Apple 设备发送通知之前,您需要在 Unity 项目设置中添加 Apple 密钥、项目和帐户详细信息。您可以在 Unity Dashboard 中的游戏、环境以及开发和生产版本之间重复使用同一个 Apple 密钥(如果您已经有一个,请转到步骤 8)。这需要对您希望测试或使用通知的每个UGS 游戏环境执行。

  1. 登录您的 Apple 开发者 控制台。

  2. 转到“证书、标识符和配置文件”页面,然后选择密钥

  3. 选择+创建新密钥。

  4. 命名您的密钥并启用“Apple 推送通知服务 (APNs)”选项以启用通知,然后选择继续。请注意,每个帐户只能在两个密钥上启用此功能。

  5. 在下一页上选择注册进行确认。

  6. 下载生成的密钥并记下提供的密钥 ID,稍后您将需要它。您只能下载密钥文件一次;如果丢失,则需要撤销并重新生成。

  7. 在 Unity Dashboard 中,转到您项目的玩家互动 > 通知 > 设置,单击顶部设置横幅中的设置密钥链接,然后选择添加密钥或“Apple 密钥”行中的编辑图标。

  8. 需要填写五个字段

  • 密钥:上传在先前步骤中创建的密钥。
  • 密钥 ID:这是在您注册密钥时提供的,也可以通过在 Apple 开发者控制台中选择密钥来检索。
  • 团队 ID:这是 Apple 开发者控制台上您的帐户名下显示的团队 ID。
  • 主题 ID:填写您游戏的软件包标识符。它需要与 Apple 开发者控制台的“证书、标识符和配置文件”页面中的“标识符”完全匹配。
  • 沙盒:如果您想从游戏的开发/调试版本向玩家发送消息,请将沙盒值设置为True。如果您想向生产版本的用户发送消息,请设置为False
  1. 选择完成。出于安全原因,如果您重新进入编辑设置页面,则此文件将不可见。

  2. “移动通知”包已作为“推送通知”的依赖项导入到您的项目中。在编辑器中,导航到项目设置 > 移动通知,然后选择iOS 部分。确保选中请求授权启用推送通知在应用程序启动时注册推送通知选项。
    有关配置和此软件包提供的其他功能的更多信息,请参阅移动通知文档。

  3. 在 XCODE 中构建应用程序时,请确保为应用程序授予“远程通知”功能,以便它可以接收通知。

    如果未能执行此操作,您将在运行时收到以下错误消息
    无法注册远程通知:在应用程序中找不到有效的“aps-environment”授权字符串

3. 测试您的集成

按照测试指南测试您应用内的推送通知集成。

如果您在测试时遇到任何问题,请按照故障排除指南调试常见问题。

4. 创建通知活动

您现在可以创建您的第一个通知活动以开始使用推送通知。