Android和iOS的本地通知

包含参考和指南的虚幻引擎4产品文档

Windows
MacOS
Linux
本页面的内容

本地通知是可在虚幻引擎4(UE4)应用程序之外显示的消息,用于告知用户已进行的更改或更新。在以下操作指南中,我们将介绍如何设置在Android和iOS设备上都有效的本地通知。

适用于Android和iOS的本地通知的当前实现设置和执行起来都极其简单。本系统也仅适用于本地通知,不适用于通过远程服务器发送的通知。

选择移动平台

Android

iOS

步骤

  1. 首先,新建具有下列选项集的基于 蓝图 的项目:

    • 空白(Blank)

    • 手机 / 平板电脑(Mobile/Tablet)

    • 可伸缩3D或2D(Scalable 3D or 2D)

    • 不包含初学者内容包(No Starter Content)

  2. 项目打开之后,打开 关卡蓝图,方法是单击 主工具栏 上的 蓝图(Blueprints) 按钮,然后从显示的列表中选择 打开关卡蓝图(Open Level Blueprint) 选项。

    单击查看大图。

    为了便于你按照本操作指南所述进行操作,我们使用了关卡蓝图来设置和调用所需的本地通知蓝图节点。尽管可以在关卡蓝图中设置本地通知,但是你应考虑将该逻辑添加在对你的项目来说最为合理的位置。

  3. 变量(Variables) 部分中,创建下列三个 文本变量,以便在本地通知显示时我们可以向用户显示消息:

    单击查看大图。

    变量名称

    标题(Title)

    Title:This is the Title!

    正文(Body)

    Body:This is the body!

    操作(Action)

    Action:I am taking this Action!

  4. 为确保在本地通知被调用(以显示)时用户能够看到本地通知,向 事件图表 中添加 Event Begin PlayRegister for Remote Notifications 节点。

    单击查看大图。

    向UE4项目中添加它时,请确保在项目首次加载时就调用“Register for Remote Notifications”节点。这样,你就不必在尝试显示通知时再次调用它。

  5. 为确保在通知触发时用户能够看到通知,你需要将 Event Begin Play输出Register for Remote Notifications 的输入相连接。此设置可确保用户授予操作系统(OS)显示通知的权限。

    单击查看大图。

  6. 我们已授予OS显示通知的权限,接下来,我们需要设置当用户单击通知时发生的事件。为处理此类型的交互,向 事件图表 中添加 Get Launch NotificationPrint StringBranch 节点。

    单击查看大图。

  7. Get Launch Notification 节点的输出与 Branch 节点的输入相连接,然后将“Branch”节点的 True 输出与 Print String 节点的输入相连接。

    单击查看大图。

  8. 现在,将 Notification Launched App 与“Branch”节点的 Condition 输入相连接,然后将 Activation EventPrint String 节点的 In String 相连接。

    单击查看大图。

    将它添加到项目中时可以省略 Print String 节点。添加它的目的是确保使用的Activation Event正确。

  9. 现在,我们需要设置通知内容以及通知应在多长时间之后显示。要做到这一点,我们首先需要向事件图表中添加下列蓝图节点:

    • Schedule Local Notifications from Now

    • Delay

    • 标题(Title)、正文(Body)和操作(Action)文本变量
      20OSLocalNotification_DelayVarsSchedule.png

      单击查看大图。

      10.在向事件图表中添加所需的节点之后,将“Delay”节点的 Completed 输出与 Schedule Local Notifications from Now 的输入相连接,然后分别将每个 文本 变量与它们在 Schedule Local Notifications from Now 节点上的相应输入相连接。完成后,事件图表应该如下图所示:

    单击查看大图。

    11.将“Delay”节点上的 时长(Duration) 设置为 五(5) 秒。这有助于确保在本地通知被调用和显示之前,用户有足够的时间关闭应用程序或使应用程序在后台中运行。

    添加 Delay 节点的目的只是为了确保在通知被触发之前有足够的时间可用来关闭应用程序或使它在后台运行。将它添加到项目时不必使用 Delay 节点。

    12.接下来,将“Schedule Local Notifications from Now”节点的 Seconds from Now 输入设置为 30 秒。此设置将使通知在此代码运行完的30秒之后显示。

    单击查看大图。

    13.将“Schedule Local Notifications from Now”的 Activation Event 的值设置为 42

    单击查看大图。

    借助Activation Event输入,你可以关联可用于调用特定通知的字符串值。它使你可以设置并使用在满足特定条件时可以被显示的不同通知。

    14.在使本地通知能够奏效所需的所有节点都已添加到事件图表中之后,需要做的最后一件事情是将 Branch 节点的 False 输出与 Delay 节点的输入相连接。完成后,事件图表应该如下图所示:

    单击查看大图。

    15.按“编译(Compile)”按钮编译关卡蓝图,然后按“保存(Save)”按钮保存关卡。 16.最后,在 主工具栏 上,单击 启动(Launch) 图标旁的 高级选项(Advanced Options) 下拉菜单,然后选择要在其上进行测试的设备。
    LocalNotifications_LaunchOneDevice.png

  1. 首先,新建具有下列选项集的基于C++的项目:

    • 空白(Blank)

    • 手机 / 平板电脑(Mobile/Tablet)

    • 可伸缩3D或2D(Scalable 3D or 2D)

    • 不包含初学者内容包(No Starter Content)

  2. 项目打开之后,转至 编辑(Edit),然后选择 项目设置(Project Settings)

  3. 项目设置(Project Settings) 菜单中,单击 全部设置(All Settings),然后在搜索框中输入 Enable Remote Notifications Support

    单击查看大图。

    “Enable Remote Notifications Support”仅在使用基于C++的项目时可用。如果使用基于蓝图的项目,该选项将显示为灰色。

  4. 项目打开之后,打开 关卡蓝图,方法是单击 主工具栏 上的 蓝图(Blueprints) 按钮,然后从显示的列表中选择 打开关卡蓝图(Open Level Blueprint) 选项。

    单击查看大图。

    为了便于你按照本操作指南所述进行操作,我们使用了关卡蓝图来设置和调用所需的本地通知蓝图节点。尽管可以在关卡蓝图中设置本地通知,但是你应考虑将该逻辑添加在对你的项目来说最为合理的位置。

  5. 变量(Variables) 部分中,创建下列三个 文本变量,以便在本地通知显示时我们可以向用户显示消息:

    单击查看大图。

    变量名称

    标题(Title)

    Title:This is the Title!

    正文(Body)

    Body:This is the body!

    操作(Action)

    Action:I am taking this Action!

  6. 为确保在本地通知被调用(以显示)时用户能够看到本地通知,向 事件图表 中添加 Event Begin PlayRegister for Remote Notifications 节点。

    单击查看大图。

    向UE4项目中添加它时,请确保在项目首次加载时就调用“Register for Remote Notifications”节点。这样,你就不必在尝试显示通知时再次调用它。

  7. 为确保在通知触发时用户能够看到通知,你需要将 Event Begin Play输出Register for Remote Notifications 的输入相连接。此设置可确保用户授予操作系统(OS)显示通知的权限。

    单击查看大图。

  8. 我们已授予OS显示通知的权限,接下来,我们需要设置当用户单击通知时发生的事件。为处理此类型的交互,向 事件图表 中添加 Get Launch NotificationPrint StringBranch 节点。

    单击查看大图。

    10.将 Get Launch Notification 节点的输出与 Branch 节点的输入相连接,然后将“Branch”节点的 True 输出与 Print String 节点的输入相连接。

    单击查看大图。

    11.现在,将 Notification Launched App 与“Branch”节点的 Condition 输入相连接,然后将 Activation EventPrint String 节点的 In String 相连接。

    单击查看大图。

    将它添加到项目中时可以省略 Print String 节点。添加它的目的是确保使用的Activation Event正确。

    12.现在,我们需要设置通知内容以及通知应在多长时间之后显示。要做到这一点,我们首先需要向事件图表中添加下列蓝图节点:

    • Schedule Local Notifications from Now

    • Delay

    • 标题(Title)、正文(Body)和操作(Action)文本变量
      20OSLocalNotification_DelayVarsSchedule.png

      单击查看大图。

      13.在向事件图表中添加所需的节点之后,将“Delay”节点的 Completed 输出与 Schedule Local Notifications from Now 的输入相连接,然后分别将每个 文本 变量与它们在 Schedule Local Notifications from Now 节点上的相应输入相连接。完成后,事件图表应该如下图所示:

    单击查看大图。

    14.将“Delay”节点上的 时长(Duration) 设置为 五(5) 秒。这有助于确保在本地通知被调用和显示之前,用户有足够的时间关闭应用程序或使应用程序在后台中运行。

    添加 Delay 节点的目的只是为了确保在通知被触发之前有足够的时间可用来关闭应用程序或使它在后台运行。将它添加到项目时不必使用 Delay 节点。

    15.接下来,将“Schedule Local Notifications from Now”节点的 Seconds from Now 输入设置为 30 秒。此设置将使通知在此代码运行完的30秒之后显示。

    单击查看大图。

    16.将“Schedule Local Notifications from Now”的 Activation Event 的值设置为 42

    单击查看大图。

    借助Activation Event输入,你可以关联可用于调用特定通知的字符串值。它使你可以设置并使用在满足特定条件时可以被显示的不同通知。

    17.在使本地通知能够奏效所需的所有节点都已添加到事件图表中之后,需要做的最后一件事情是将 Branch 节点的 False 输出与 Delay 节点的输入相连接。完成后,事件图表应该如下图所示:

    单击查看大图。

    18.按“编译(Compile)”按钮编译关卡蓝图,然后按“保存(Save)”按钮保存关卡。 19.最后,在 主工具栏 上,单击 启动(Launch) 图标旁的 高级选项(Advanced Options) 下拉菜单,然后选择要在其上进行测试的设备。
    LocalNotifications_LaunchOnIOS.png

最终结果

一旦将项目部署到移动设备,在打开应用程序的五秒之后,你将听到并看到通知弹出,如以下视频所示。

欢迎来到全新虚幻引擎4文档站!

我们正在努力开发新功能,包括反馈系统,以便您能对我们的工作作出评价。但它目前还未正式上线。如果您对此页面有任何意见与在使用中遭遇任何问题,请前往文档反馈论坛告知我们。

新系统上线运行后,我们会及时通知您的。

发表反馈意见