跳到主要内容
版本：v3

Unity 推送指南

本文介绍了如何在 Unity 中使用推送通知功能。建议先阅读 推送通知服务总览 了解相关概念。

由于 Android 系统对于第三方推送管控越来越严格，所以目前只支持 iOS 及 FCM 推送。

准备工作​

iOS​

请参考 iOS 推送设置指南申请 iOS 推送证书。

Android​

请参考 Android 混合推送开发指南申请 FCM Android 推送权限。

注意：这里只需要参考混合推送指南申请 FCM 的推送权限，不需要 参考混合推送指南中 Android 相关配置的内容。

接入推送服务​

安装​

在 SDK Releases 下载最新版本的 unity-push.unitypackage 或 unity-push-without-gradle.unitypackage。

如果项目中没有使用其他 Android Gradle 配置，可以直接下载 unity-push.unitypackage，其中包括了完整的 iOS/Android 配置，开发者只需配置各厂商参数即可。

如果项目中有其他 Android Gradle 配置，则需要下载 unity-push-without-gradle.unitypackage，这个包中不包含推送相关的 Android Gradle 配置，需要开发者自行补充。

因为涉及到 Android Gradle 配置，目前不提供 UPM 方式安装。

导入 LeanCloud-SDK-Realtime-Unity 包：​

方法一：使用 Unity Package Manager​

在项目的 Packages/manifest.json 文件中添加以下依赖：

"dependencies":{
  "com.leancloud.realtime": "https://github.com/leancloud/csharp-sdk-upm.git#realtime-2.3.0"
}

在 Unity 顶部菜单中选择 Window > Package Manager 可查看已经安装在项目中的包。

方法二：手动导入​

  1. 在 下载页 找到 LeanCloud C# SDK 下载地址，下载 LeanCloud-SDK-Realtime-Unity.zip。

  2. 解压后的 LeanCloud-SDK-Realtime-Unity.zip 为 Plugins 文件夹，拖拽至 Unity 即可。

配置​

iOS​

只需要在初始化时传入 iOS 开发者的 TeamId，见初始化。

Android​

初始化 FCM 进行推送：

LCFCMPushManager.RegisterFCMPush();

Installation​

SDK 提供默认的 Installation 对象，用来保存推送所需的 token 以及其他数据。

LCInstallation lcInstallation = await LCInstallation.GetCurrent();

推送消息​

开发者中心 > 你的游戏 > 游戏服务 > 云服务 > 推送通知 > 设置 中默认选中了 禁止从客户端进行消息推送，避免客户端可以不经限制地给应用内任意目标设备推送消息。 我们建议开发者都勾选此项，通过 REST API 或云服务控制台发送推送消息。

如果有从客户端发推送的需求，需要先取消勾选此项。

推送给所有设备​

try {
    LCPush push = new LCPush {
        Data = new Dictionary<string, object> {
            { "alert", pushData }
        }
    };
    await push.Send();
} catch (Exception e) {
    Debug.LogError(e);
}

发送给特定的用户​

下面是一个从客户端推送的例子，给某一台测试环境的 iOS 设备发推送：

try {
    LCPush push = new LCPush {
        Data = new Dictionary<string, object> {
            { "alert", pushData }
        },
        IOSEnvironment = LCPush.IOSEnvironmentDev,
    };
    LCInstallation installation = await LCInstallation.GetCurrent();
    push.Query.WhereEqualTo("objectId", installation.ObjectId);
    await push.Send();
} catch (Exception e) {
    Debug.LogError(e);
}

深入阅读：如何响应推送消息​

消息格式​

具体的消息格式，可参考推送 REST API 使用指南的推送消息一节。 对于 Android 设备，默认的消息内容参数支持下列属性：

{
  "alert":      "消息内容",
  "title":      "显示在通知栏的标题",
  "custom-key": "由用户添加的自定义属性，custom-key 仅是举例，可随意替换"
}

通知栏消息如何响应用户点击事件​

Unity 环境有别于 iOS/Android 环境，当点击通知时，Unity 场景不一定能初始化完成，所以从 Native 到 Unity 的通知可能无法到达。

SDK 为了能够将通知参数顺利的发送到 Unity，会在通知时将参数缓存在 Native 层，提供一个统一获取启动参数的 C# 接口：

Dictionary<string, object> launchData = await LCPushBridge.Instance.GetLaunchData();

推送验证​

初始化 SDK 后，在 iOS/Android 真机运行项目，_Installation 表会生成一条设备信息的数据。

在开发者中心 > 你的游戏 > 游戏服务 > 云服务 > 推送通知 > 在线发送可以自定义推送条件发送一条推送，测试当前设备能否正常收到推送。 这里可以根据 Installation 的 objectId 推送，iOS 设备也可以根据 deviceToken 推送，Android 设备可以根据 registrationId 推送。

其他​

如何剔除某些厂商推送服务​

SDK 中包含了一些中国 Android 手机厂商的 SDK，国际版应用可以手动剔除以节省打包体积。

  • 删掉 Assets/LeanCloud/Push/Android/xx，xx 代表厂商，如 HuaWei、XiaoMi 等
  • 删除 Assets/Plugins/Android/mainTemplate.gradle 中的 dependencies 部分
  • 删掉 Assets/Plugins/Android/AndroidManifest.xml 中厂商 SDK 组件部分（有厂商相关的注释）