Firebase云消息配置

本指南假定你已经完成了如下任务:

  • 创建并配置你的游戏以接收deltaDNA平台的事件
  • 整合deltaDNA Android SDK到你的应用

较旧的应用可能需要使用Google云消息服务,而不是Firebase云消息。完成此配置的步骤可以从这里找到。

Firebase配置

在发送推送通知到Android设备之前,你首先需要设置Firebase云消息并获取三件东西:

  • Firebase使用的应用ID(Application ID)发送者ID(Sender ID)值(value)以识别你和你的应用
  • deltaDNA平台用于通过FCM发送消息的一个服务器API键值

在检索这些值之前,你需要访问到一个Firebase账户——这可以通过访问https://firebase.google.com然后按照提示登录或注册来实现。

之后,访问Firebase控制面板并添加一个新项目。一旦这个项目被创建,下一步是添加一个可以与你的Android应用相关联的新应用。

如果你已经配置了一个Firebase项目,并将其与你的Android应用关联,那么你可以使用这个项目并跳过上述步骤

在项目概述页面点击“添加Firebase到你的Android App(Add Firebase to your Android App)”并按步骤操作,进入合适的软件包名称并更新你的Gradle文件。除非整合其他Firebase功能到你的应用,google-services.json文件不需要下载并在你的项目中替换——deltaDNA SDK将从应用的manifest文件的metadata中提取这些信息。

取回配置值(Configuration Value)

应用ID(Application ID)可以从设置(Settings)>项目设置(Project Settings)>常规(General)>你的APP(Your Apps)>[你的APP名称(Your App Name)]找到。

Firebase应用ID

服务器键值发送者ID都可以从设置(Settings)>项目设置(Project Settings)>云消息(Cloud Messaging)找到。

Firebase服务器键值和发送者ID

注意:尽管在本文档发布时Legacy键值服务器键值都可以使用,但我们推荐使用服务器键值,因为Google正在弱化这部分功能

在取回服务器键值后,访问deltaDNA平台并从这里跳转至管理身份(Manage Identity)页面(设置(Setup)>管理身份(Manage Identity)>Android)。输入从Firebase获取的服务器键值到Google API键值(Google API Key)字段。

deltaDNA管理身份

Android实施和测试

应用ID和发送者ID将添加到你的Android项目,关于此的更多信息和在你的Android应用中实施推送通知(包括一个案例应用)可以从deltaDNA Android SDK通知(deltaDNA Android SDK Notifications)页面找到。

完成上述步骤并与你的Android项目整合后,可以使用deltaDNA消息测试工具以确保所有内容都已经被正确设置。这个工具可以在deltaDNA平台通过跳转到设置(Setup)>消息测试工具(Manage Test Tool)找到。下面可以看到一个示例测试消息:

deltaDNA消息测试工具

在提交一个测试消息后,你应当可以看到一条通知出现在你的设备上,如下所示:

设备通知

下一步

恭喜!你现在已经将Android推送通知整合到deltaDNA平台,你可以开始使用推送通知作为你的活动的一个游戏外行为。在完成本指南后,你可以找到我们文档网站中一组有用的页面: