【Unity】跨平台本地推送 Mobile Notifications 实战指南

1. 为什么需要跨平台本地推送在移动应用开发中推送通知是最直接的触达用户方式之一。想象一下你正在开发一款健身应用需要提醒用户该运动了或者是一款游戏想要告诉玩家限时活动开始了。这些场景下本地推送都是最轻量、最高效的解决方案。Unity的Mobile Notifications包完美解决了跨平台推送的痛点。我去年开发的一款跨平台应用就遇到过这样的问题Android和iOS的推送API完全不同维护两套代码简直让人崩溃。直到发现了这个官方解决方案开发效率直接翻倍。这个包的优势很明显一次编写双平台运行同一套C#代码就能搞定Android和iOS无需服务器所有逻辑在客户端完成适合定时提醒类功能低功耗相比远程推送本地推送更省电官方维护不用担心兼容性问题2. 环境准备与基础配置2.1 必备环境清单在开始之前确保你的开发环境满足这些要求Unity版本2020.3或更新我实测2021 LTS最稳定Android SDKAPI Level 21Android 5.0iOS支持Xcode 12建议用最新稳定版测试设备至少准备一台Android和一台iOS真机模拟器通知功能不完整注意如果你用的是Unity 2019可能需要手动导入旧版插件。建议直接升级到2020.3避免兼容性问题。2.2 安装Mobile Notifications包打开Unity后按照这个步骤操作点击Window Package Manager左上角选择Unity Registry搜索Mobile Notifications选择最新版本目前是2.1.1点击Install安装完成后你会在Packages目录下看到MobileNotifications的文件夹。这里有个小技巧我习惯在安装后立即备份manifest.json文件防止后续误操作导致包丢失。3. Android推送全流程实现3.1 创建通知渠道ChannelAndroid 8.0强制要求通知渠道这个设计让用户能分类管理通知。下面是创建健身应用提醒渠道的完整代码using Unity.Notifications.Android; void CreateNotificationChannel() { var channel new AndroidNotificationChannel() { Id fitness_reminder, Name 健身提醒, Importance Importance.High, // 高优先级会发出声音 Description 运动时间和喝水提醒, EnableLights true, // 呼吸灯效果 EnableVibration true // 震动 }; AndroidNotificationCenter.RegisterNotificationChannel(channel); }重要参数说明Id后续发送通知必须用相同的IDImportance有5个等级Default/High/Max等EnableVibration实测发现部分国产机型需要额外配置振动模式3.2 发送你的第一条通知让我们实现一个下午3点的喝水提醒void SendWaterReminder() { var notification new AndroidNotification() { Title 该喝水啦, Text 您已经2小时没有喝水了, FireTime DateTime.Now.AddHours(2), // 2小时后触发 SmallIcon icon_drop, // 必须提前配置 LargeIcon logo_large, Color Color.blue, // 通知底色 ShouldAutoCancel true // 点击后自动消失 }; AndroidNotificationCenter.SendNotification(notification, fitness_reminder); }图标配置的坑我踩过小图标必须是纯白透明背景的PNG尺寸严格48x48像素通过Mobile Notifications设置界面添加Window Mobile Notifications3.3 处理通知点击事件当用户点击通知时我们需要执行特定操作void Start() { AndroidNotificationCenter.OnNotificationReceived OnNotificationClick; } void OnNotificationClick(AndroidNotificationIntentData data) { Debug.Log($用户点击了通知{data.Id}); // 解析自定义数据 if(!string.IsNullOrEmpty(data.Notification.IntentData)) { var json JsonUtility.FromJsonDictionarystring, string(data.Notification.IntentData); // 处理业务逻辑... } // 跳转到特定场景 SceneManager.LoadScene(WaterReminderScene); }4. iOS推送的特殊处理4.1 权限请求差异iOS需要显式请求通知权限且必须在真机测试using Unity.Notifications.iOS; IEnumerator RequestAuthorization() { var authorizationOption AuthorizationOption.Alert | AuthorizationOption.Badge; using (var req new AuthorizationRequest(authorizationOption, true)) { while (!req.IsFinished) { yield return null; } Debug.Log(req.Granted ? 权限获取成功 : 用户拒绝了通知权限); } }4.2 发送iOS通知的注意事项iOS通知API与Android略有不同void SendIOSNotification() { var timeTrigger new iOSNotificationTimeIntervalTrigger() { TimeInterval TimeSpan.FromHours(2), Repeats false }; var notification new iOSNotification() { Identifier water_reminder, Title Hydration Time, Body Dont forget to drink water!, Subtitle Health Reminder, ShowInForeground true, // 前台是否显示 ForegroundPresentationOption (PresentationOption.Alert | PresentationOption.Sound), CategoryIdentifier reminder, ThreadIdentifier health, Trigger timeTrigger }; iOSNotificationCenter.ScheduleNotification(notification); }特别要注意Identifier取消通知时的唯一标识ShowInForeground默认后台才显示通知TriggeriOS支持更多触发类型日历、位置等5. 跨平台兼容方案5.1 通用接口封装为了避免平台判断代码散落各处我推荐这样封装public class NotificationManager : MonoBehaviour { public static void SendNotification(string title, string content, DateTime fireTime) { #if UNITY_ANDROID var androidNotif new AndroidNotification() { Title title, Text content, FireTime fireTime }; AndroidNotificationCenter.SendNotification(androidNotif, default_channel); #elif UNITY_IOS var trigger new iOSNotificationTimeIntervalTrigger() { TimeInterval fireTime - DateTime.Now }; var iosNotif new iOSNotification() { Title title, Body content, Trigger trigger }; iOSNotificationCenter.ScheduleNotification(iosNotif); #endif } }5.2 图标资源管理双平台图标处理方案Android通过Mobile Notifications设置界面添加或者放入Assets/Plugins/Android/res/drawableiOS需要Xcode工程中配置推荐使用Asset Catalog管理6. 实战中的常见问题6.1 Android通知不显示可能原因及解决方案没有创建ChannelAndroid 8必须创建图标配置错误小图标必须是纯白透明省电模式限制引导用户关闭应用电池优化通知权限关闭代码检测并跳转设置页6.2 iOS真机收不到通知排查步骤检查Capabilities是否开启Push Notifications确认Provisioning Profile包含推送权限首次必须授权不能模拟器测试检查是否开启了勿扰模式6.3 点击通知无响应典型解决方案Android检查AndroidManifest.xml中的Activity配置iOS需要实现AppDelegate的推送回调双平台都要确保应用未处于强制退出状态7. 高级功能拓展7.1 周期性重复通知实现每天固定时间的提醒// Android var notification new AndroidNotification() { RepeatInterval TimeSpan.FromDays(1) // 每24小时重复 }; // iOS var trigger new iOSNotificationCalendarTrigger() { // 每天上午9点 Hour 9, Repeats true };7.2 带操作按钮的通知Android 7.0支持通知操作var action new AndroidNotificationAction() { Id drink, Title 已喝水, Icon icon_done }; notification.Actions new ListAndroidNotificationAction { action };7.3 本地化通知内容根据系统语言显示不同文案notification.Text Application.systemLanguage SystemLanguage.Chinese ? 该喝水了 : Time to drink water;8. 性能优化建议减少唤醒次数合并多个提醒为单个通知合理设置优先级非紧急通知用Default及时清理过期通知避免通知栏堆积使用分组通知Android 7.0iOS后台刷新配合减少重复通知我在实际项目中发现过度使用高优先级通知会导致用户禁用应用通知权限。建议非必要不使用声音和振动特别是游戏类应用。