1. 项目概述为什么Unity开发者需要关注Android通知如果你正在用Unity开发一款面向Android平台的游戏或应用那么“通知”功能大概率是你绕不开的一个需求。无论是提醒玩家“体力已恢复”还是推送一条“限时活动开启”的消息一个稳定、可靠且体验良好的通知系统都是提升用户留存和活跃度的关键。然而Unity引擎本身在早期版本中并未内置对移动平台通知的原生支持这让很多开发者尤其是独立开发者或小团队感到头疼。我自己在几年前的一个休闲游戏项目里就踩过坑。当时为了赶进度直接用了一个网上找的第三方插件结果在部分华为、小米机型上通知要么不显示要么点了没反应用户反馈很差最后不得不回炉重造。这件事让我明白通知功能看似简单背后却涉及Android系统版本差异、厂商定制ROM如MIUI、EMUI的权限管理、后台保活策略等一系列复杂问题。一个处理不当核心功能就可能失效。好在Unity官方意识到了这个问题并推出了Unity Mobile Notifications官方插件包。这个插件旨在为iOS和Android提供一套统一、稳定且持续维护的通知API。对于Android平台它封装了原生NotificationCompatAPI并处理了许多兼容性细节让我们可以用C#脚本相对轻松地实现通知功能。本教程将聚焦于Android平台带你从零开始深入理解并掌握这个官方插件的使用避开我当年踩过的那些坑打造出健壮的通知系统。2. 环境准备与插件集成在开始写代码之前我们需要确保开发环境就绪并正确集成通知插件。这一步是基础但细节决定成败。2.1 环境要求检查首先明确你的开发环境需要满足以下条件Unity版本官方Mobile Notifications插件对Unity版本有要求。根据官方文档例如1.4.2版本要求Unity Editor 2021.2或更高。建议使用2021 LTS或更新版本以获得最佳兼容性和支持。你可以在Unity Hub中查看或安装对应版本。Android SDK与JDK确保已通过Unity Hub安装或正确配置了Android SDK、NDK和JDK推荐OpenJDK 11或17。路径通常在Edit - Preferences - External Tools中设置。一个常见的坑是路径中有中文或空格这可能导致Gradle构建失败。目标API级别插件要求Android 4.4 (API level 19) 以上。但为了符合Google Play商店的要求并确保更好的兼容性建议将Minimum API Level设置为至少21Target API Level设置为当前主流的API级别如34。你可以在Player Settings - Android - Other Settings中配置。2.2 通过Package Manager安装插件这是官方推荐的安装方式能方便地管理版本和更新。在Unity编辑器中打开Window - Package Manager。在Package Manager窗口左上角点击下拉菜单选择“Unity Registry”。在列表中找到“Mobile Notifications”包点击它右侧会显示详情。点击右下角的“Install”按钮。安装完成后你可以在Packages目录下看到com.unity.mobile.notifications。这种方式能确保你获取的是经过Unity测试的稳定版本并且依赖管理由Package Manager自动处理比手动导入.unitypackage文件要可靠得多。2.3 Android项目配置关键步骤插件安装后需要对Android项目进行一些必要配置这些配置直接影响通知能否正常显示和交互。设置通知图标 Android通知需要一个小图标Small Icon显示在状态栏和通知缩略图中。这个图标必须是纯Alpha通道的位图即只有透明度信息颜色由系统决定通常为白色或灰色。你需要准备一个PNG图片例如notification_icon.png将其放入项目的Assets/Plugins/Android/res/drawable-xxxhdpi/目录下如果目录不存在就手动创建。然后在Player Settings - Android - Icon中指定这个图标或者通过代码设置后续会讲。切记使用彩色图标会导致在某些系统上显示为灰色方块。配置通知通道Notification Channels API 26 从Android 8.0API 26开始所有通知都必须归属于一个“通道”。用户可以对不同通道的通知行为如声音、振动、重要性进行单独管理。因此我们必须至少创建一个通道。通道ID一个唯一的字符串标识符如“game_news”。通道名称展示给用户的通道名称如“游戏动态”。重要性决定通知如何提示用户Importance.High会发出声音并弹出Importance.Low则只在通知栏静默显示。修改AndroidManifest.xml 虽然插件会尝试自动合并必要的权限但为了确保万无一失特别是处理自定义通知点击行为时我习惯手动检查或补充。你需要确保Assets/Plugins/Android/AndroidManifest.xml文件中包含以下权限uses-permission android:nameandroid.permission.POST_NOTIFICATIONS / !-- Android 13 (API 33) 及以上需要动态申请 -- uses-permission android:nameandroid.permission.VIBRATE / !-- 如果需要振动 --此外为了处理通知点击后跳转到特定游戏场景通常需要配置一个广播接收器Broadcast Receiver或Activity。插件通常已经内置了处理但了解其原理很重要。你可能会看到类似以下的配置除非你有特殊需求否则不要随意修改插件生成的这部分内容receiver android:namecom.unity.androidnotifications.UnityNotificationReceiver intent-filter action android:namecom.unity.androidnotifications.ACTION_CLICK_NOTIFICATION / /intent-filter meta-data android:namecom.unity.androidnotifications.default_activity android:valuecom.unity3d.player.UnityPlayerActivity / /receiver注意从Android 13API 33开始POST_NOTIFICATIONS权限被列为“危险权限”需要像访问相机、位置一样在运行时动态向用户申请。插件的新版本如2.x应该已经包含了相关的API来协助申请但你需要在自己的代码中调用。这是适配新系统的重要一步遗漏会导致在Android 13及以上设备上无法发送通知。3. 核心API详解与基础通知发送环境配置妥当后我们来深入核心代码部分。Unity Mobile Notifications插件的API设计得比较直观主要围绕AndroidNotificationCenter这个静态类展开。3.1 初始化与权限申请在游戏启动初期例如在第一个场景的Awake或Start方法中就应该进行通知模块的初始化。using UnityEngine; using Unity.Notifications.Android; // 引入命名空间 public class NotificationManager : MonoBehaviour { void Start() { InitializeNotificationChannel(); RequestNotificationPermission(); // Android 13 必需 } void InitializeNotificationChannel() { // 创建一个通知通道针对Android 8.0 var channel new AndroidNotificationChannel() { Id channel_game_news, // 唯一ID Name 游戏动态, // 用户可见的名称 Description 接收游戏更新和活动通知, // 用户可见的描述 Importance Importance.High, // 重要性级别 }; // 向系统注册这个通道 AndroidNotificationCenter.RegisterNotificationChannel(channel); } void RequestNotificationPermission() { // 检查是否为Android 13及以上 if (CheckSdkVersionForPermissionRequest()) { // 使用插件提供的API请求权限假设插件版本支持 // 注意具体API可能随插件版本更新请查阅对应版本文档 // 例如可能是AndroidNotificationCenter.RequestPermission(); // 这里是一个通用思路调用原生Android API或插件封装的方法 Debug.Log(Requesting notification permission for Android 13); // 实际调用代码需根据插件API调整 } } bool CheckSdkVersionForPermissionRequest() { // 简易的API级别检查 #if UNITY_ANDROID !UNITY_EDITOR using (var version new AndroidJavaClass(android.os.Build$VERSION)) { int sdkInt version.GetStaticint(SDK_INT); return sdkInt 33; // Android 13 (API 33) } #else return false; #endif } }实操心得通道的Id一旦创建并注册就无法通过代码修改其核心属性如重要性。如果你在后续更新中想改变某个通道的行为可能需要创建新的通道ID并引导用户迁移。因此初期设计通道时就要考虑周全。3.2 构建并发送一个简单通知发送通知的核心是构建一个AndroidNotification对象然后通过AndroidNotificationCenter发送。public void SendSimpleNotification(string title, string text, int fireTimeInSeconds) { // 1. 构建通知内容 var notification new AndroidNotification { Title title, // 通知标题 Text text, // 通知正文 SmallIcon notification_icon, // 对应res/drawable中的资源名不带扩展名 LargeIcon app_icon_large, // 大图标可选同样放在drawable目录 FireTime System.DateTime.Now.AddSeconds(fireTimeInSeconds), // 触发时间 }; // 2. 发送通知 // 第一个参数通道ID必须与注册的通道匹配 // 第二个参数构建好的通知对象 // 返回一个唯一的通知ID可用于后续取消通知 int notificationId AndroidNotificationCenter.SendNotification(notification, channel_game_news); Debug.Log($Notification scheduled with ID: {notificationId}); }你可以调用这个方法例如SendSimpleNotification(“每日奖励” “登录即可领取100金币” 3600)来安排一个一小时后触发的通知。关键参数解析FireTime指定通知触发的时间。如果你想立即显示可以设置为DateTime.Now。注意设备重启后所有未触发的定时通知会丢失这是Android系统的限制。对于需要持久化的提醒如每日签到需要在应用启动后重新安排。SmallIcon字符串对应你放在res/drawable目录下的图片文件名不含.png。这是强制要求的。LargeIcon可选的大图标通常用于显示应用Logo或相关大图。3.3 通知的点击处理用户点击通知后我们通常希望跳回游戏甚至打开某个特定界面如活动页面。这需要通过通知的Intent数据来实现。首先在发送通知时我们需要附加额外的数据public void SendNotificationWithData(string title, string text, string activityType) { var notification new AndroidNotification { Title title, Text text, SmallIcon notification_icon, FireTime System.DateTime.Now.AddSeconds(5), // 5秒后发送方便测试 }; // 添加自定义数据 notification.IntentData $type{activityType}id12345; // 或者使用更结构化的方式比如JSON字符串 // notification.IntentData ${{\type\:\{activityType}\, \id\:12345}}; AndroidNotificationCenter.SendNotification(notification, channel_game_news); }然后在游戏启动脚本如NotificationManager中我们需要检查是否有因点击通知而启动的情况void Start() { InitializeNotificationChannel(); RequestNotificationPermission(); // 检查是否有从通知点击启动时传递的数据 var notificationIntentData AndroidNotificationCenter.GetLastNotificationIntent(); if (notificationIntentData ! null) { // 获取我们之前附加的数据 string customData notificationIntentData.Notification.IntentData; Debug.Log($App launched from notification with data: {customData}); // 解析数据并处理例如跳转到特定场景 if (!string.IsNullOrEmpty(customData)) { // 简单解析示例 if (customData.Contains(typedaily_reward)) { // 跳转到每日奖励场景或UI SceneManager.LoadScene(DailyRewardScene); // 或者触发一个事件让UI管理器打开对应面板 // EventSystem.Instance.TriggerEvent(OpenDailyReward); } } // 可选清除这个Intent数据避免下次启动重复处理 // AndroidNotificationCenter.CancelNotification(notificationIntentData.Id); } }重要提示GetLastNotificationIntent()方法只会在应用因点击通知而启动时返回有效数据。如果应用已经在后台运行点击通知只是将应用带到前台则不会触发此路径。对于后台唤醒的情况插件通常通过一个广播接收器来处理并将数据传递给一个活动的Unity游戏对象。你需要查阅插件文档看是否支持以及如何设置这种回调例如通过AndroidNotificationCenter.OnNotificationReceived事件。4. 高级功能与实战技巧掌握了基础发送和点击处理我们来看看一些提升通知体验的高级功能和实战中总结的技巧。4.1 定时通知、重复通知与取消通知定时通知如上例所示设置FireTime即可。重复通知可以设置RepeatInterval属性来实现周期性通知例如每日提醒。var dailyNotification new AndroidNotification { Title “每日登录提醒” Text “今天还没登录哦快来拿奖励” SmallIcon “notification_icon” FireTime GetNextDailyTime(20, 0), // 计算下一个晚上8点的时间 RepeatInterval TimeSpan.FromDays(1) // 每隔一天重复 };注意如前所述设备重启后重复通知会失效。一个健壮的方案是在游戏每次启动时检查并重新安排所有必要的重复通知例如检查本地存储的标志位。取消通知每个发送的通知都会返回一个唯一的notificationId。你可以用它来取消特定通知或者取消所有通知。// 取消单个通知 AndroidNotificationCenter.CancelNotification(notificationId); // 取消所有已安排的通知 AndroidNotificationCenter.CancelAllNotifications(); // 取消特定通道的所有通知 AndroidNotificationCenter.CancelAllNotifications(“channel_game_news”);在玩家领取了奖励后及时取消对应的提醒通知是良好的用户体验。4.2 自定义通知样式与行为大图样式可以设置BigPicture属性当用户下拉通知栏时会展开显示一张大图。这对于新闻、活动海报类推送非常有用。notification.BigPicture “big_picture_post”; // drawable资源名 notification.Style NotificationStyle.BigPictureStyle; // 设置样式进度条样式对于下载、任务进度可以使用Progress、ProgressMax和ProgressIndeterminate属性。自定义声音与振动可以指定Sound属性对应res/raw目录下的音频文件名和VibrationPattern长整型数组表示振动、暂停的毫秒数。但要注意从Android 8.0开始声音和振动很大程度上由通知通道的“重要性”和用户对通道的设置控制代码指定的行为可能被系统覆盖。4.3 多通道管理与用户控制对于功能复杂的游戏建议创建多个通知通道让用户自己决定哪些通知重要。重要公告通道重要性为Importance.High默认开启声音和振动。普通活动通道重要性为Importance.Default可能只有提示音。后台日志通道重要性为Importance.Low或Min完全静默仅用于记录。在应用设置界面可以提供入口引导用户跳转到系统的通知设置页面public void OpenNotificationSettings() { #if UNITY_ANDROID !UNITY_EDITOR using (var unityClass new AndroidJavaClass(“com.unity3d.player.UnityPlayer”)) using (var currentActivity unityClass.GetStaticAndroidJavaObject(“currentActivity”)) { var intent new AndroidJavaObject(“android.content.Intent”); intent.CallAndroidJavaObject(“setAction” “android.settings.APP_NOTIFICATION_SETTINGS”); // 为你的应用添加参数 intent.CallAndroidJavaObject(“putExtra” “android.provider.extra.APP_PACKAGE” currentActivity.Callstring(“getPackageName”)); currentActivity.Call(“startActivity” intent); } #endif }4.4 后台限制与保活策略重要避坑点现代Android系统尤其是国内定制ROM对后台应用的限制非常严格。你的应用在后台一段时间后可能会被“休眠”或“杀死”导致定时通知无法触发。这不是Unity插件的问题而是Android系统行为。应对策略使用精确的闹钟AlarmManager对于对时间要求非常精确的提醒如定点活动可以考虑使用Android原生的AlarmManager。但这需要编写Android原生插件Java/Kotlin并与Unity交互复杂度较高。一些更强大的第三方通知插件会集成此功能。利用WorkManager或JobScheduler这是Google推荐的后台任务调度方式更省电能更好地适应系统限制。同样需要原生开发。前台服务Foreground Service如果你的游戏需要长时间在后台执行任务如播放音乐、持续定位可以启动一个前台服务并在状态栏显示一个持续的通知。但这会消耗更多电量且需要向用户明确说明。务实的设计对于大多数游戏通知接受“设备重启后通知丢失”和“严格后台限制下可能延迟”的现实。将通知设计为“锦上添花”的功能而非核心玩法依赖。例如在玩家每次上线时检查本地记录如果错过了某个基于时间的通知事件直接在游戏内给予补偿或提示。实操心得在小米、华为等设备上务必引导用户将你的应用加入“自启动管理”白名单和“电池优化”的无限制列表。可以在应用内用友好的弹窗提示用户如何操作。虽然这不是编程能完全解决的但能极大提升通知的到达率。5. 调试、测试与常见问题排查通知功能的调试相对特殊因为它涉及系统级别的交互。以下是我常用的方法和问题排查清单。5.1 在Unity编辑器中调试Unity编辑器本身无法模拟Android通知。你通常会在编辑器运行时看到日志输出例如“Notification scheduled”但实际发送逻辑不会执行。为了调试通知的构建和序列化逻辑可以编写模拟代码void ScheduleNotificationInEditor(AndroidNotification notification, string channelId) { #if UNITY_EDITOR Debug.Log($“[Editor] Would schedule notification on channel ‘{channelId}’ at {notification.FireTime}”); Debug.Log($“Title: {notification.Title}, Text: {notification.Text}, Data: {notification.IntentData}”); // 在这里可以模拟点击事件触发你的数据解析和场景跳转逻辑方便测试流程 #endif }5.2 在真机上测试真机测试是必不可少的步骤。构建APK并安装使用Development Build并勾选Autoconnect Profiler和Deep Profiling有助于初期调试。使用ADB Logcat查看日志这是最重要的调试工具。在命令行中运行adb logcat -s “Unity” // 只看Unity标签的日志或者使用Android Studio的Logcat工具。过滤你的应用包名或相关关键字查看插件输出的日志例如通知是否成功安排、点击事件是否被接收等。测试不同场景应用在前台通知可能不会显示在状态栏取决于系统设置但应该能收到回调。应用在后台通知应正常显示。应用被杀死点击通知应能启动应用并传递数据。设备重启后检查定时通知是否丢失。5.3 常见问题排查速查表问题现象可能原因排查步骤与解决方案通知完全不显示1. 未配置通知图标。2. 未创建通知通道Android 8.0。3. 用户手动关闭了应用通知权限。4. 系统电池优化限制了后台活动。1. 检查SmallIcon设置确保图片资源存在且格式正确纯Alpha。2. 确保在发送通知前调用了RegisterNotificationChannel。3. 引导用户去系统设置开启通知权限。4. 引导用户将应用加入电池优化白名单。通知无声音/振动1. 通道重要性设置过低。2. 用户在该通道设置中关闭了声音/振动。3. 设备处于静音/勿扰模式。1. 检查通道的Importance级别至少Default以上。2. 尊重用户设置或引导用户修改通道行为。3. 这是正常系统行为。点击通知无反应1.IntentData未正确设置或解析。2. 用于处理点击的Activity配置错误。3. 应用启动模式LaunchMode可能导致Activity重建问题。1. 在GetLastNotificationIntent()后打印并检查IntentData。2. 检查AndroidManifest.xml中广播接收器的配置确保default_activity指向正确的主Activity。3. 尝试在AndroidManifest.xml的主Activity标签内添加android:launchMode”singleTask”。定时通知不触发1. 设备重启后定时任务丢失。2. 应用被系统强制停止或深度休眠。3.FireTime设置的时间已过去。1. 应用启动时重新安排关键定时通知。2. 这是Android系统限制需优化应用保活或调整功能设计。3. 检查代码逻辑确保FireTime是未来时间。在特定厂商设备上异常小米、华为、OPPO等厂商的自启动管理和省电策略。1. 在应用内增加引导页图文并茂地教用户如何将应用加入各厂商的“自启动”、“关联启动”、“电池优化无限制”等白名单。2. 考虑接入各厂商的推送SDK如小米推送、华为推送它们有更高的系统级送达率但集成复杂度也更高。最后一点个人体会Unity Mobile Notifications插件是处理Android通知一个非常不错的起点它解决了跨平台API统一和基础兼容性问题。但对于追求更高送达率、更丰富样式如自定义布局或需要应对国内特殊生态环境的项目你可能需要在此基础上进行扩展或者评估像Firebase Cloud Messaging (FCM) 这样的云推送服务以及国内厂商的推送联盟。对于大多数中小型游戏和独立开发者而言先利用好这个官方插件把基础体验做扎实再根据实际需求和用户反馈决定是否引入更复杂的方案是一个更稳妥高效的开发路径。
Unity Android通知开发全攻略：从官方插件使用到实战避坑
发布时间：2026/7/8 17:52:34
1. 项目概述为什么Unity开发者需要关注Android通知如果你正在用Unity开发一款面向Android平台的游戏或应用那么“通知”功能大概率是你绕不开的一个需求。无论是提醒玩家“体力已恢复”还是推送一条“限时活动开启”的消息一个稳定、可靠且体验良好的通知系统都是提升用户留存和活跃度的关键。然而Unity引擎本身在早期版本中并未内置对移动平台通知的原生支持这让很多开发者尤其是独立开发者或小团队感到头疼。我自己在几年前的一个休闲游戏项目里就踩过坑。当时为了赶进度直接用了一个网上找的第三方插件结果在部分华为、小米机型上通知要么不显示要么点了没反应用户反馈很差最后不得不回炉重造。这件事让我明白通知功能看似简单背后却涉及Android系统版本差异、厂商定制ROM如MIUI、EMUI的权限管理、后台保活策略等一系列复杂问题。一个处理不当核心功能就可能失效。好在Unity官方意识到了这个问题并推出了Unity Mobile Notifications官方插件包。这个插件旨在为iOS和Android提供一套统一、稳定且持续维护的通知API。对于Android平台它封装了原生NotificationCompatAPI并处理了许多兼容性细节让我们可以用C#脚本相对轻松地实现通知功能。本教程将聚焦于Android平台带你从零开始深入理解并掌握这个官方插件的使用避开我当年踩过的那些坑打造出健壮的通知系统。2. 环境准备与插件集成在开始写代码之前我们需要确保开发环境就绪并正确集成通知插件。这一步是基础但细节决定成败。2.1 环境要求检查首先明确你的开发环境需要满足以下条件Unity版本官方Mobile Notifications插件对Unity版本有要求。根据官方文档例如1.4.2版本要求Unity Editor 2021.2或更高。建议使用2021 LTS或更新版本以获得最佳兼容性和支持。你可以在Unity Hub中查看或安装对应版本。Android SDK与JDK确保已通过Unity Hub安装或正确配置了Android SDK、NDK和JDK推荐OpenJDK 11或17。路径通常在Edit - Preferences - External Tools中设置。一个常见的坑是路径中有中文或空格这可能导致Gradle构建失败。目标API级别插件要求Android 4.4 (API level 19) 以上。但为了符合Google Play商店的要求并确保更好的兼容性建议将Minimum API Level设置为至少21Target API Level设置为当前主流的API级别如34。你可以在Player Settings - Android - Other Settings中配置。2.2 通过Package Manager安装插件这是官方推荐的安装方式能方便地管理版本和更新。在Unity编辑器中打开Window - Package Manager。在Package Manager窗口左上角点击下拉菜单选择“Unity Registry”。在列表中找到“Mobile Notifications”包点击它右侧会显示详情。点击右下角的“Install”按钮。安装完成后你可以在Packages目录下看到com.unity.mobile.notifications。这种方式能确保你获取的是经过Unity测试的稳定版本并且依赖管理由Package Manager自动处理比手动导入.unitypackage文件要可靠得多。2.3 Android项目配置关键步骤插件安装后需要对Android项目进行一些必要配置这些配置直接影响通知能否正常显示和交互。设置通知图标 Android通知需要一个小图标Small Icon显示在状态栏和通知缩略图中。这个图标必须是纯Alpha通道的位图即只有透明度信息颜色由系统决定通常为白色或灰色。你需要准备一个PNG图片例如notification_icon.png将其放入项目的Assets/Plugins/Android/res/drawable-xxxhdpi/目录下如果目录不存在就手动创建。然后在Player Settings - Android - Icon中指定这个图标或者通过代码设置后续会讲。切记使用彩色图标会导致在某些系统上显示为灰色方块。配置通知通道Notification Channels API 26 从Android 8.0API 26开始所有通知都必须归属于一个“通道”。用户可以对不同通道的通知行为如声音、振动、重要性进行单独管理。因此我们必须至少创建一个通道。通道ID一个唯一的字符串标识符如“game_news”。通道名称展示给用户的通道名称如“游戏动态”。重要性决定通知如何提示用户Importance.High会发出声音并弹出Importance.Low则只在通知栏静默显示。修改AndroidManifest.xml 虽然插件会尝试自动合并必要的权限但为了确保万无一失特别是处理自定义通知点击行为时我习惯手动检查或补充。你需要确保Assets/Plugins/Android/AndroidManifest.xml文件中包含以下权限uses-permission android:nameandroid.permission.POST_NOTIFICATIONS / !-- Android 13 (API 33) 及以上需要动态申请 -- uses-permission android:nameandroid.permission.VIBRATE / !-- 如果需要振动 --此外为了处理通知点击后跳转到特定游戏场景通常需要配置一个广播接收器Broadcast Receiver或Activity。插件通常已经内置了处理但了解其原理很重要。你可能会看到类似以下的配置除非你有特殊需求否则不要随意修改插件生成的这部分内容receiver android:namecom.unity.androidnotifications.UnityNotificationReceiver intent-filter action android:namecom.unity.androidnotifications.ACTION_CLICK_NOTIFICATION / /intent-filter meta-data android:namecom.unity.androidnotifications.default_activity android:valuecom.unity3d.player.UnityPlayerActivity / /receiver注意从Android 13API 33开始POST_NOTIFICATIONS权限被列为“危险权限”需要像访问相机、位置一样在运行时动态向用户申请。插件的新版本如2.x应该已经包含了相关的API来协助申请但你需要在自己的代码中调用。这是适配新系统的重要一步遗漏会导致在Android 13及以上设备上无法发送通知。3. 核心API详解与基础通知发送环境配置妥当后我们来深入核心代码部分。Unity Mobile Notifications插件的API设计得比较直观主要围绕AndroidNotificationCenter这个静态类展开。3.1 初始化与权限申请在游戏启动初期例如在第一个场景的Awake或Start方法中就应该进行通知模块的初始化。using UnityEngine; using Unity.Notifications.Android; // 引入命名空间 public class NotificationManager : MonoBehaviour { void Start() { InitializeNotificationChannel(); RequestNotificationPermission(); // Android 13 必需 } void InitializeNotificationChannel() { // 创建一个通知通道针对Android 8.0 var channel new AndroidNotificationChannel() { Id channel_game_news, // 唯一ID Name 游戏动态, // 用户可见的名称 Description 接收游戏更新和活动通知, // 用户可见的描述 Importance Importance.High, // 重要性级别 }; // 向系统注册这个通道 AndroidNotificationCenter.RegisterNotificationChannel(channel); } void RequestNotificationPermission() { // 检查是否为Android 13及以上 if (CheckSdkVersionForPermissionRequest()) { // 使用插件提供的API请求权限假设插件版本支持 // 注意具体API可能随插件版本更新请查阅对应版本文档 // 例如可能是AndroidNotificationCenter.RequestPermission(); // 这里是一个通用思路调用原生Android API或插件封装的方法 Debug.Log(Requesting notification permission for Android 13); // 实际调用代码需根据插件API调整 } } bool CheckSdkVersionForPermissionRequest() { // 简易的API级别检查 #if UNITY_ANDROID !UNITY_EDITOR using (var version new AndroidJavaClass(android.os.Build$VERSION)) { int sdkInt version.GetStaticint(SDK_INT); return sdkInt 33; // Android 13 (API 33) } #else return false; #endif } }实操心得通道的Id一旦创建并注册就无法通过代码修改其核心属性如重要性。如果你在后续更新中想改变某个通道的行为可能需要创建新的通道ID并引导用户迁移。因此初期设计通道时就要考虑周全。3.2 构建并发送一个简单通知发送通知的核心是构建一个AndroidNotification对象然后通过AndroidNotificationCenter发送。public void SendSimpleNotification(string title, string text, int fireTimeInSeconds) { // 1. 构建通知内容 var notification new AndroidNotification { Title title, // 通知标题 Text text, // 通知正文 SmallIcon notification_icon, // 对应res/drawable中的资源名不带扩展名 LargeIcon app_icon_large, // 大图标可选同样放在drawable目录 FireTime System.DateTime.Now.AddSeconds(fireTimeInSeconds), // 触发时间 }; // 2. 发送通知 // 第一个参数通道ID必须与注册的通道匹配 // 第二个参数构建好的通知对象 // 返回一个唯一的通知ID可用于后续取消通知 int notificationId AndroidNotificationCenter.SendNotification(notification, channel_game_news); Debug.Log($Notification scheduled with ID: {notificationId}); }你可以调用这个方法例如SendSimpleNotification(“每日奖励” “登录即可领取100金币” 3600)来安排一个一小时后触发的通知。关键参数解析FireTime指定通知触发的时间。如果你想立即显示可以设置为DateTime.Now。注意设备重启后所有未触发的定时通知会丢失这是Android系统的限制。对于需要持久化的提醒如每日签到需要在应用启动后重新安排。SmallIcon字符串对应你放在res/drawable目录下的图片文件名不含.png。这是强制要求的。LargeIcon可选的大图标通常用于显示应用Logo或相关大图。3.3 通知的点击处理用户点击通知后我们通常希望跳回游戏甚至打开某个特定界面如活动页面。这需要通过通知的Intent数据来实现。首先在发送通知时我们需要附加额外的数据public void SendNotificationWithData(string title, string text, string activityType) { var notification new AndroidNotification { Title title, Text text, SmallIcon notification_icon, FireTime System.DateTime.Now.AddSeconds(5), // 5秒后发送方便测试 }; // 添加自定义数据 notification.IntentData $type{activityType}id12345; // 或者使用更结构化的方式比如JSON字符串 // notification.IntentData ${{\type\:\{activityType}\, \id\:12345}}; AndroidNotificationCenter.SendNotification(notification, channel_game_news); }然后在游戏启动脚本如NotificationManager中我们需要检查是否有因点击通知而启动的情况void Start() { InitializeNotificationChannel(); RequestNotificationPermission(); // 检查是否有从通知点击启动时传递的数据 var notificationIntentData AndroidNotificationCenter.GetLastNotificationIntent(); if (notificationIntentData ! null) { // 获取我们之前附加的数据 string customData notificationIntentData.Notification.IntentData; Debug.Log($App launched from notification with data: {customData}); // 解析数据并处理例如跳转到特定场景 if (!string.IsNullOrEmpty(customData)) { // 简单解析示例 if (customData.Contains(typedaily_reward)) { // 跳转到每日奖励场景或UI SceneManager.LoadScene(DailyRewardScene); // 或者触发一个事件让UI管理器打开对应面板 // EventSystem.Instance.TriggerEvent(OpenDailyReward); } } // 可选清除这个Intent数据避免下次启动重复处理 // AndroidNotificationCenter.CancelNotification(notificationIntentData.Id); } }重要提示GetLastNotificationIntent()方法只会在应用因点击通知而启动时返回有效数据。如果应用已经在后台运行点击通知只是将应用带到前台则不会触发此路径。对于后台唤醒的情况插件通常通过一个广播接收器来处理并将数据传递给一个活动的Unity游戏对象。你需要查阅插件文档看是否支持以及如何设置这种回调例如通过AndroidNotificationCenter.OnNotificationReceived事件。4. 高级功能与实战技巧掌握了基础发送和点击处理我们来看看一些提升通知体验的高级功能和实战中总结的技巧。4.1 定时通知、重复通知与取消通知定时通知如上例所示设置FireTime即可。重复通知可以设置RepeatInterval属性来实现周期性通知例如每日提醒。var dailyNotification new AndroidNotification { Title “每日登录提醒” Text “今天还没登录哦快来拿奖励” SmallIcon “notification_icon” FireTime GetNextDailyTime(20, 0), // 计算下一个晚上8点的时间 RepeatInterval TimeSpan.FromDays(1) // 每隔一天重复 };注意如前所述设备重启后重复通知会失效。一个健壮的方案是在游戏每次启动时检查并重新安排所有必要的重复通知例如检查本地存储的标志位。取消通知每个发送的通知都会返回一个唯一的notificationId。你可以用它来取消特定通知或者取消所有通知。// 取消单个通知 AndroidNotificationCenter.CancelNotification(notificationId); // 取消所有已安排的通知 AndroidNotificationCenter.CancelAllNotifications(); // 取消特定通道的所有通知 AndroidNotificationCenter.CancelAllNotifications(“channel_game_news”);在玩家领取了奖励后及时取消对应的提醒通知是良好的用户体验。4.2 自定义通知样式与行为大图样式可以设置BigPicture属性当用户下拉通知栏时会展开显示一张大图。这对于新闻、活动海报类推送非常有用。notification.BigPicture “big_picture_post”; // drawable资源名 notification.Style NotificationStyle.BigPictureStyle; // 设置样式进度条样式对于下载、任务进度可以使用Progress、ProgressMax和ProgressIndeterminate属性。自定义声音与振动可以指定Sound属性对应res/raw目录下的音频文件名和VibrationPattern长整型数组表示振动、暂停的毫秒数。但要注意从Android 8.0开始声音和振动很大程度上由通知通道的“重要性”和用户对通道的设置控制代码指定的行为可能被系统覆盖。4.3 多通道管理与用户控制对于功能复杂的游戏建议创建多个通知通道让用户自己决定哪些通知重要。重要公告通道重要性为Importance.High默认开启声音和振动。普通活动通道重要性为Importance.Default可能只有提示音。后台日志通道重要性为Importance.Low或Min完全静默仅用于记录。在应用设置界面可以提供入口引导用户跳转到系统的通知设置页面public void OpenNotificationSettings() { #if UNITY_ANDROID !UNITY_EDITOR using (var unityClass new AndroidJavaClass(“com.unity3d.player.UnityPlayer”)) using (var currentActivity unityClass.GetStaticAndroidJavaObject(“currentActivity”)) { var intent new AndroidJavaObject(“android.content.Intent”); intent.CallAndroidJavaObject(“setAction” “android.settings.APP_NOTIFICATION_SETTINGS”); // 为你的应用添加参数 intent.CallAndroidJavaObject(“putExtra” “android.provider.extra.APP_PACKAGE” currentActivity.Callstring(“getPackageName”)); currentActivity.Call(“startActivity” intent); } #endif }4.4 后台限制与保活策略重要避坑点现代Android系统尤其是国内定制ROM对后台应用的限制非常严格。你的应用在后台一段时间后可能会被“休眠”或“杀死”导致定时通知无法触发。这不是Unity插件的问题而是Android系统行为。应对策略使用精确的闹钟AlarmManager对于对时间要求非常精确的提醒如定点活动可以考虑使用Android原生的AlarmManager。但这需要编写Android原生插件Java/Kotlin并与Unity交互复杂度较高。一些更强大的第三方通知插件会集成此功能。利用WorkManager或JobScheduler这是Google推荐的后台任务调度方式更省电能更好地适应系统限制。同样需要原生开发。前台服务Foreground Service如果你的游戏需要长时间在后台执行任务如播放音乐、持续定位可以启动一个前台服务并在状态栏显示一个持续的通知。但这会消耗更多电量且需要向用户明确说明。务实的设计对于大多数游戏通知接受“设备重启后通知丢失”和“严格后台限制下可能延迟”的现实。将通知设计为“锦上添花”的功能而非核心玩法依赖。例如在玩家每次上线时检查本地记录如果错过了某个基于时间的通知事件直接在游戏内给予补偿或提示。实操心得在小米、华为等设备上务必引导用户将你的应用加入“自启动管理”白名单和“电池优化”的无限制列表。可以在应用内用友好的弹窗提示用户如何操作。虽然这不是编程能完全解决的但能极大提升通知的到达率。5. 调试、测试与常见问题排查通知功能的调试相对特殊因为它涉及系统级别的交互。以下是我常用的方法和问题排查清单。5.1 在Unity编辑器中调试Unity编辑器本身无法模拟Android通知。你通常会在编辑器运行时看到日志输出例如“Notification scheduled”但实际发送逻辑不会执行。为了调试通知的构建和序列化逻辑可以编写模拟代码void ScheduleNotificationInEditor(AndroidNotification notification, string channelId) { #if UNITY_EDITOR Debug.Log($“[Editor] Would schedule notification on channel ‘{channelId}’ at {notification.FireTime}”); Debug.Log($“Title: {notification.Title}, Text: {notification.Text}, Data: {notification.IntentData}”); // 在这里可以模拟点击事件触发你的数据解析和场景跳转逻辑方便测试流程 #endif }5.2 在真机上测试真机测试是必不可少的步骤。构建APK并安装使用Development Build并勾选Autoconnect Profiler和Deep Profiling有助于初期调试。使用ADB Logcat查看日志这是最重要的调试工具。在命令行中运行adb logcat -s “Unity” // 只看Unity标签的日志或者使用Android Studio的Logcat工具。过滤你的应用包名或相关关键字查看插件输出的日志例如通知是否成功安排、点击事件是否被接收等。测试不同场景应用在前台通知可能不会显示在状态栏取决于系统设置但应该能收到回调。应用在后台通知应正常显示。应用被杀死点击通知应能启动应用并传递数据。设备重启后检查定时通知是否丢失。5.3 常见问题排查速查表问题现象可能原因排查步骤与解决方案通知完全不显示1. 未配置通知图标。2. 未创建通知通道Android 8.0。3. 用户手动关闭了应用通知权限。4. 系统电池优化限制了后台活动。1. 检查SmallIcon设置确保图片资源存在且格式正确纯Alpha。2. 确保在发送通知前调用了RegisterNotificationChannel。3. 引导用户去系统设置开启通知权限。4. 引导用户将应用加入电池优化白名单。通知无声音/振动1. 通道重要性设置过低。2. 用户在该通道设置中关闭了声音/振动。3. 设备处于静音/勿扰模式。1. 检查通道的Importance级别至少Default以上。2. 尊重用户设置或引导用户修改通道行为。3. 这是正常系统行为。点击通知无反应1.IntentData未正确设置或解析。2. 用于处理点击的Activity配置错误。3. 应用启动模式LaunchMode可能导致Activity重建问题。1. 在GetLastNotificationIntent()后打印并检查IntentData。2. 检查AndroidManifest.xml中广播接收器的配置确保default_activity指向正确的主Activity。3. 尝试在AndroidManifest.xml的主Activity标签内添加android:launchMode”singleTask”。定时通知不触发1. 设备重启后定时任务丢失。2. 应用被系统强制停止或深度休眠。3.FireTime设置的时间已过去。1. 应用启动时重新安排关键定时通知。2. 这是Android系统限制需优化应用保活或调整功能设计。3. 检查代码逻辑确保FireTime是未来时间。在特定厂商设备上异常小米、华为、OPPO等厂商的自启动管理和省电策略。1. 在应用内增加引导页图文并茂地教用户如何将应用加入各厂商的“自启动”、“关联启动”、“电池优化无限制”等白名单。2. 考虑接入各厂商的推送SDK如小米推送、华为推送它们有更高的系统级送达率但集成复杂度也更高。最后一点个人体会Unity Mobile Notifications插件是处理Android通知一个非常不错的起点它解决了跨平台API统一和基础兼容性问题。但对于追求更高送达率、更丰富样式如自定义布局或需要应对国内特殊生态环境的项目你可能需要在此基础上进行扩展或者评估像Firebase Cloud Messaging (FCM) 这样的云推送服务以及国内厂商的推送联盟。对于大多数中小型游戏和独立开发者而言先利用好这个官方插件把基础体验做扎实再根据实际需求和用户反馈决定是否引入更复杂的方案是一个更稳妥高效的开发路径。
