Unity 本地推送安卓篇

Thu, 06 Apr 2023 11:13:34 +0800

Unity Mobile Notifications 在Android和IOS平台上进行本地推送通知支持一次性和可重复的通知。安卓篇

Mobile Notifications 🔗

要求 🔗

兼容 Unity 2019.4 或以上版本。兼容 Android 4.4+ (API 19) 和 iOS 10.0+。

支持的功能 🔗

发布本地一次性或可重复的通知。取消已经显示和即将到来的（预定的）通知。

安装 🔗

在Unity中打开PackageManager(Window > Package Manager)，找到Mobile Notifications，然后Install。

安卓 🔗

权限 🔗

android.permission.SCHEDULE_EXACT_ALARM (Android 12.0起精确时间调度) android.permission.USE_EXACT_ALARM (Android 13.0起精确时间调度) 从Android13.0开始，需要征得用户许可才能显示通知。当应用程序API小于33时，操作系统会在应用程序启动时自动请求权限。当API33或更高版本为目标时，请求权限取决于应用程序本身，否则通知将不会显示在托盘中。

if (!Permission.HasUserAuthorizedPermission("android.permission.POST_NOTIFICATIONS"))
{
    Permission.RequestUserPermission("android.permission.POST_NOTIFICATIONS");
}

关键类 🔗

AndroidNotificationChannel对通知分配一个频道，可以设置设备收到通知后设备的表现，例如：是否闪光、是否开启震动、锁定屏幕显示位置、通知样式等等。

var channel = new AndroidNotificationChannel()
{
    Id = "Local_Notice",
    Name = "Local Channel",
    Importance = Importance.Default,
    Description = "Local Notifications",
};
AndroidNotificationCenter.RegisterNotificationChannel(channel);

AndroidNotificationCenter执行发送、更新和删除通知等操作。

发送通知

/**
**发送通知，同时返回通知Id，对该通知进行追踪。
*/
public static int SendNotification(AndroidNotification notification, string channelId)

删除通知

/**
**取消所有之前显示的通知。该应用程序显示的所有通知将从状态栏中删除。所有预定的通知仍将按预定时间显示。
*/
public static void CancelAllDisplayedNotifications()

/**
**取消应用程序安排或之前显示的所有通知。所有预定的通知将被取消。该应用程序显示的所有通知将从状态栏中删除。
*/
public static void CancelAllNotifications()

/**
**取消应用程序安排的所有通知。所有预定的通知将被取消。如果通知已经显示，它们将不会从状态栏中删除。
*/
public static void CancelAllScheduledNotifications()

/**
**取消之前显示的通知。通知将从状态栏中删除。
*/
public static void CancelDisplayedNotification(int id)

/**
**取消预定的或之前显示的通知。通知将不再在预定时间显示。如果它已经交付，它将从状态栏中删除。
*/
public static void CancelNotification(int id)

/**
**取消预定的通知。通知将不再在预定时间显示。如果它已经交付，它不会从状态栏中删除。
*/
public static void CancelScheduledNotification(int id)

消息频道注册

/**
**将创建的消息通道注册到消息中心。
*/
public static void RegisterNotificationChannel(AndroidNotificationChannel channel)

频道重要性级别对于您定义的每个频道，您将为其分配一个重要性级别，用来控制每个通道的行为（取代优先级）。重要性级别具有以下限制：您分配的重要性级别将是频道的默认值。用户可以在 Android 设置中更改频道的重要性级别。一旦你选择了一个重要性级别，你就可以限制你如何改变它：你只能降低重要性，并且只有在用户没有明确改变它的情况下。频道重要性的选择应考虑到用户的时间和注意力。当一个不重要的通知被伪装成紧急通知时，它会产生不必要的警报。

重要性	行为	用法	例子
高的	发出声音并出现在屏幕上	用户必须立即了解或采取行动的时间关键信息	短信、闹钟、电话
默认	发出声音	应该在用户方便的时候尽早看到的信息，但不会打断他们正在做的事情	路况提醒、任务提醒
低的	没有声音	不满足其他重要性级别要求的通知渠道	用户订阅的新内容、社交网络邀请
最小值	没有声音或视觉干扰	可以等待或与用户不特别相关的非必要信息	附近名胜、天气、宣传内容

检测打开应用的通知

/**
**允许检索用于打开应用程序的通知。当返回值!=Null时，意味着通过点击该通知打开的应用程序
*/
public static AndroidNotificationIntentData GetLastNotificationIntent()

收到事件

/**
**收到通知事件。
*/
public static event AndroidNotificationCenter.NotificationReceivedCallback OnNotificationReceived

其他关键类型，AndroidNotification用于安排本地通知，其中包括通知的内容等等。

/**
**创建一个通知，title通知标题，text通知内容，fireTime显示时间(DateTime.Now 立即显示)
*/
public AndroidNotification(string title, string text, DateTime fireTime)
/**
**创建一个可重复的通知结构，title通知标题，text通知内容，fireTime显示时间(DateTime.Now 立即显示),repeatInterval重复间隔
*/
public AndroidNotification(string title, string text, DateTime fireTime, TimeSpan repeatInterval)
/**
**存储数据字段，发送通知的时候设置了改值，则收到通知后同样可以取到该值，用于收发通知的数据传递
*/
public string IntentData { readonly get; set; }
public string LargeIcon { readonly get; set; }
public string SmallIcon { readonly get; set; }

通知Icon设置在Unity中的设置:Editor->Project Settings->Mobile Notigficationd，Small小图标、Large大图标。

通知展示 🔗

SmallIcon小图标
应用名称(系统提供)
收到时间(系统提供)
LargeIcon大图标
通知标题
通知内容

常见问题 🔗

为什么 Android 小图标在编辑器通知设置预览中是白色的？因为小通知图标是单色的，Android 会忽略图标图像中的所有非 alpha 通道，Unity 会自动去除所有 RGB 通道。解决方法:将它们放在\Assets\Plugins\Android\res\drawable-{scaleFactor}不会自动处理的文件夹中。但是，包含非 alpha 通道的图标将无法在 Android 5.0 及更高版本上正确显示。
为什么当我的应用程序关闭且不在后台运行时，某些华为和小米手机上没有发送通知？华为（包括荣耀）和小米似乎使用了激进的节电技术来限制应用程序后台活动，除非该应用程序已被用户在设备设置中列入白名单。这意味着如果应用程序关闭或未在后台运行，则不会发送预定的通知。目前，除了鼓励用户将您的应用列入白名单外，没有可用的解决方法。

结论 🔗

搬砖愉快！

Notifications on 陈巧倩

Unity 本地推送 安卓篇