在Unity3D中实现安卓平台的本地通知推送

2024-07-17 22:25| 来源: 网络整理| 查看: 265

【前言】

　　对于手游来说，什么时候需要推送呢？玩过一些带体力限制的游戏就会发现，我的体力在恢复满后，手机会收到一个通知告诉我体力已完全恢复了。这类通知通常是由本地的客户端发起的，没有经过服务端。

　　在安卓应用中，本地通知推送是通过调用系统级服务NotificationManager实现的。虽然U3D本身也有NotificationServices类可以进行通知推送，但仅限于iOS平台（这篇博文讲了怎么使用它在iOS平台发起本机推送）。

　　而现在我们的游戏是使用U3D开发的，并不能像安卓开发一样直接在代码中调用服务。为了实现本地定时推送效果，需要自己写一个插件来实现了。

　　由于推送通常发生在客户端关闭的状态，这个推送应该被放在一个延时服务中，否则玩游戏玩得好好的突然跳出来一条自己的推送，太诡异了。

　　于是我们需要完成一个提供三个功能的模块：1、设定X秒后显示一条推送通知；2、设定X秒后显示一条通知，之后每天再显示一次；3、清除本应用的所有推送。

【解决思路】

　　因为U3D引擎提供了调用jar包的方法，所以我们可以在jar包中调用安卓的类库，实现消息推送，然后在jar包中留出接口供U3D使用即可，没有必要走JNI层。

【所需工具】

　　● eclipse

　　● 安卓SDK（我使用的4.4）

　　● Unity编辑器（我使用的5.1.3）

【开工】

　　1、创建jar包工程

　　　　创建的时候要引入两个第三方jar包。

　　　　一个是Unity的包，地址： Unity安装目录\Editor\Data\PlaybackEngines\androidplayer\release\bin\classes.jar（貌似4.x的目录和5.x不太一样，但总之就是找到androidplayer里面的classes.jar）

　　　　还有一个是安卓SDK的包，地址：安卓SDK安装目录\platforms\安卓版本\android.jar

　　2、编码

　　　　思路就是使用AlarmManager服务，在一定时间后发起广播，然后通过接收器接受展示。如果你做过安卓开发，对这段代码肯定不会陌生。如果没做过也没关系，当成一个黑盒，在需要的时候调接口就行。

　　　　首先添加一个Java类，注意父类要设为BroadcastReceiver。

　　　　添加完成后，就可以开始写了：

package com.guyastudio.unityplugins; import java.util.Calendar; import android.app.Activity; import android.app.AlarmManager; import android.app.Notification; import android.app.NotificationManager; import android.app.PendingIntent; import android.content.BroadcastReceiver; import android.content.Context; import android.content.Intent; import android.content.pm.ApplicationInfo; import android.content.pm.PackageManager; import android.os.Bundle; import com.unity3d.player.UnityPlayer; /** * 用于生成 / 清除本地通知推送的插件 * 仅在安卓平台有效 * * @author Weiren * */ public class AndroidNotificator extends BroadcastReceiver { private static int m_nLastID = 0; /** * 显示数秒后的通知 * * @param pAppName 应用名 * @param pTitle 通知标题 * @param pContent 通知内容 * @param pDelaySecond 延迟时间 * @param pIsDailyLoop 是否每日自动推送 * @throws IllegalArgumentException */ public static void ShowNotification(String pAppName, String pTitle, String pContent, int pDelaySecond, boolean pIsDailyLoop) throws IllegalArgumentException { if(pDelaySecond < 0) { throw new IllegalArgumentException("The param: pDelaySecond < 0"); } Activity curActivity = UnityPlayer.currentActivity; Intent intent = new Intent("UNITY_NOTIFICATOR"); intent.putExtra("appname", pAppName); intent.putExtra("title", pTitle); intent.putExtra("content", pContent); PendingIntent pi = PendingIntent.getBroadcast(curActivity, 0, intent, 0); AlarmManager am = (AlarmManager)curActivity.getSystemService(Context.ALARM_SERVICE); Calendar calendar = Calendar.getInstance(); calendar.add(Calendar.SECOND, pDelaySecond); long alarmTime = calendar.getTimeInMillis(); if (pIsDailyLoop){ am.setRepeating( AlarmManager.RTC_WAKEUP, alarmTime, 86400, // 24 hours pi); } else { am.set( AlarmManager.RTC_WAKEUP, alarmTime, pi); } } /** * 清除所有通知，包括日常通知 */ public static void ClearNotification() { Activity act = UnityPlayer.currentActivity; NotificationManager nManager = (NotificationManager)act.getSystemService(Context.NOTIFICATION_SERVICE); for(int i = m_nLastID; i >= 0; i--) { nManager.cancel(i); } m_nLastID = 0; } @SuppressWarnings("deprecation") public void onReceive(Context pContext, Intent pIntent) { Class unityActivity = null; try { unityActivity = pContext.getClassLoader().loadClass("com.unity3d.player.UnityPlayerProxyActivity"); } catch (Exception ex) { ex.printStackTrace(); return; } ApplicationInfo applicationInfo = null; PackageManager pm = pContext.getPackageManager(); try { applicationInfo = pm.getApplicationInfo(pContext.getPackageName(), PackageManager.GET_META_DATA); } catch (Exception ex) { ex.printStackTrace(); return; } Bundle bundle = pIntent.getExtras(); Notification notification = new Notification( applicationInfo.icon, (String)bundle.get("appname"), System.currentTimeMillis()); PendingIntent contentIntent = PendingIntent.getActivity( pContext, m_nLastID, new Intent(pContext, unityActivity), 0); notification.setLatestEventInfo( pContext, (String)bundle.get("title"), (String)bundle.get("content"), contentIntent); NotificationManager nm = (NotificationManager)pContext.getSystemService(Context.NOTIFICATION_SERVICE); nm.notify(m_nLastID, notification); m_nLastID++; } }

　　3、导出jar包

　　　　在项目上右键——Export，导出为jar格式。

　　4、添加AndroidManifest.xml

　　　　安卓应用中如果要让应用收到广播，还需要在AndroidManifest.xml中加入receiver标签。我们创建的项目是一个Java项目，不会自动生成AndroidManifest，所以需要手动写一个：

　　● 注意“”这里名字要和前面Java代码中的一致。

　　4、在U3D项目中调用

　　　　创建一个新的U3D项目，在界面上放一个Text和两个Button（为节约时间我用的源生UI）：

　　　　然后将导出的jar文件和AndroidManifest.xml文件移动到 U3D项目目录\Assets\Plugins\Android下：

　　　　在几个UI的父节点上加一个脚本，内容如下：

using UnityEngine; using UnityEngine.UI; public class JARTest : MonoBehaviour { public Text Text_Message; #if UNITY_ANDROID private AndroidJavaObject m_ANObj = null; #endif // Use this for initialization void Start () { } // Update is called once per frame void Update () { } public void Button_1_Clicked() { #if UNITY_ANDROID if(InitNotificator()) { m_ANObj.CallStatic( "ShowNotification", Application.productName, "温馨提示", "你该食屎了", 10, false); this.Text_Message.text = "Notification will show in 10 sec."; } #endif } public void Button_2_Clicked() { #if UNITY_ANDROID if(InitNotificator()) { m_ANObj.CallStatic("ClearNotification"); this.Text_Message.text = "Notification has been cleaned"; } #endif } #if UNITY_ANDROID private bool InitNotificator() { if (m_ANObj == null) { try { m_ANObj = new AndroidJavaObject("com.guyastudio.unityplugins.AndroidNotificator"); } catch { this.Text_Message.text = "Init AndroidNotificator Fail"; return false; } } if (m_ANObj == null) { this.Text_Message.text = "AndroidNotificator Not Found."; return false; } return true; } #endif }

　　　　● 注意实例化AndroidJavaObject的参数名字要和Java工程的包名类名一致。

　　　　然后绑定控件和事件方法。绑定好后先编译一下，如果通过了，就可以导出一个apk包了。将这个包安装到安卓设备上。我手头没有安卓设备，就用模拟器来测试：

　　　　点击“Show”按钮，10秒后会收到通知（点击后可将应用至后台，或杀掉）：

　　　　而点击“Clean”按钮，通知都会被清除。

　　　　至此，这个通知插件就完成了。

【后记】

　　最近两个月经历了辞职，以休息的名义玩（主要是肝夏活，你懂的），苦逼地找工作，意外地入职这一系列过程，心情比较复杂，博客这一块也一直没上。直到今天在项目中搞了个这个模块，才意识到可以稍微更新一下。

　　我知道你们想要谱面编辑器教程（

　　好吧，完整的制作过程我看来是没时间写出来了，这周末讲一下核心部分的逻辑，核心搞懂了其他都很简单了。不发直播拆大和，我是认真的！

【本文地址】

公司简介

联系我们