文章目录
一、Android接入
1. 简介
Unity 官方本地Push解决方案，支持一次性或重复通知
最新版本：2.1.1，支持Unity 2020.3及以上版本，支持Android5（API 21）和iOS 10.0+
官方文档地址
2.环境
Unity：2020.3
MobileNotification:：2.0.2
测试设备：Android12
3.接入Push
- 导入Package
Unity-Windows-PackageManaget，Packages选择Unity Registry，搜索Mobile Notifications，右下角点击"Install"。（本地已经安装过了，故显示Remove）
- 引入命名空间
using Unity.Notifications.Android;
- 创建通知渠道Channel
var channel = new AndroidNotificationChannel()
{
Id = m_ChannelID,
Name = m_ChannelName,
Importance = Importance.High,
Description = m_ChannelDescription
};
AndroidNotificationCenter.RegisterNotificationChannel(channel);
通知渠道(Channel)：Android引入了通知渠道notificationchannels以提供统一的系统来帮助用户管理通知如果是针对androido为目标平台时必须实现一个或者多个通知渠道以向用户显示通知 。
public AndroidNotificationChannel(string id, string name, string description, Importance importance)
| Type | Name | Description |
|---|---|---|
| string | id | Channel ID （记住ID） |
| string | name | Channel名称 |
| string | description | Channel 描述 |
| Importance | id | Channel重要程度，一般默认Importance.Default |
- 创建通知
var notification = new AndroidNotification();
notification.Title = "Title";
notification.Text = "Content";
notification.FireTime = dateTime;
notification.ShouldAutoCancel = true;
notification.SmallIcon = "icon_48";
notification.LargeIcon = "logo2";
notification.IntentData = "{\"data\":1}"; //通知传递的信息
notification.Color = Color.red;
AndroidNotificationCenter.SendNotification(notification, m_ChannelID);
图标说明：
只有添加到此列表或手动添加到“res/drawable”文件夹的图标才能用于通知。
注意，并非所有设备都支持彩色图标。
小图标必须至少为48x48px，并且只由透明背景上的白色像素组成。
大图标必须不小于192x192px，并且可以包含颜色。
| Type | Name | Description |
|---|---|---|
| string | Title | 通知标题 |
| string | Text | Channel通知内容 |
| DateTime | FireTime | 发送时间 |
| string | SmallIcon | 通知左上角小图标 |
| Color | Color | 通知左上角小图标背景颜色 |
| string | LargeIcon | 通知右上角大图标 |
| string | IntentData | 通知传递的信息 |
| bool | ShouldAutoCancel | 是否自动取消通知（点击通知后，自动删除） |
- 通知图标设置
（1）MobileNotification设置管理图片，如图所示，可以生成若干大图和小图，并设置图标标识，在生成通知时，通过该标识设置图标
（2）Assets-Plugin-Android-res-drawable文件夹下，放入图标，创建通知时，通过名称设置图标
- 发送通知
AndroidNotificationCenter.SendNotification(notification, m_ChannelID)
- 取消通知
//取消指定ID通知
AndroidNotificationCenter.CancelNotification(data.Id);
//取消全部通知
AndroidNotificationCenter.CancelAllNotifications();
//取消所有未完成的通知
AndroidNotificationCenter.CancelAllScheduledNotifications();
//取消所有已经显示的通知
AndroidNotificationCenter.CancelAllDisplayedNotifications();
- 获取通知状态
AndroidNotificationCenter.CheckScheduledNotificationStatus(notificationId);
- 注册通知点击回调
AndroidNotificationCenter.OnNotificationReceived += OnReceivedNotificationHandler;
/// <summary>
/// 通知点击回调
/// </summary>
/// <param name="data"></param>
private void OnReceivedNotificationHandler(AndroidNotificationIntentData data)
{
var msg = "Notification received : " + data.Id + "\n";
msg += "\n Notification received: ";
msg += "\n .Title: " + data.Notification.Title;
msg += "\n .Body: " + data.Notification.Text;
msg += "\n .Channel: " + data.Channel;
Debug.Log("[MobileNotification] msg: " + msg);
var notificationIntentData = AndroidNotificationCenter.GetLastNotificationIntent();
if (notificationIntentData != null)
{
var id = notificationIntentData.Id;
var channel = notificationIntentData.Channel;
var notification = notificationIntentData.Notification;
Debug.Log("[MobileNotification] IntentData: " + notification.IntentData);
Debug.Log("[MobileNotification] CancelNotification: " + id);
}
else
{
Debug.Log("[MobileNotification] GetLastNotificationIntent failed");
}
Debug.Log("[MobileNotification] Status：" + AndroidNotificationCenter.CheckScheduledNotificationStatus(data.Id));
//AndroidNotificationCenter.CancelNotification(data.Id);
//ToDo
}
- 替换通知
AndroidNotificationCenter.UpdateScheduledNotification(id, newNotification, "channel_id");
- 通知展示
二、Q&A
- “Sending contentIntent failed: android.app.PendingIntent$CanceledException”
（1）现象： 点击通知栏，没有启动APP，错误信息如图
（2）原因： 项目为了遮挡游戏启动黑屏，扩展Unity的Activity，Plugin/Android/AndroidManifest.xml中配置的并不是默认的"com.unity3d.player.UnityPlayerActivity"，导致找不到要启动的Activity
（3）方法： “Editor-Project Settings-Mobile Notigficationd”，勾选"Use Custom Activity"，并将扩展后的Activity名称填入即可
