IOS 本地通知 UILocalNotification

【本文章第四部分中的代码逻辑来自网上的借鉴，并非我自己原创】

大概一个月前，我开始跟着做IOS项目了。学习C++，了解Objective-C，等等。这两天做了游戏的本地通知，当然是从网上查了很多资料。

但资料有很多的偏差，不过最终还是解决了问题，很幸运。所以总结了一下下。

用到的重点就是Objective-C 的UILocalNotification对象。其实加入通知的代码很简单，但重要的是你要理顺Notification的逻辑。

首先我要声明的是我的开发环境：

首先在windows下面用Visual studio开发，调试，编译通过了以后。再在Mac下面用Xcode编译，导到Ipad4上面运行的。所以我的混编文件是Objective-C和C++的混合。

 

 1 UILocalNotification *notification=[[UILocalNotification alloc] init];

 2         if (notification!=nil) {

 3             NSDate *now = [NSDate date];

 4             //从现在开始，10秒以后通知

 5             notification.fireDate=[now dateByAddingTimeInterval:10];

 6             //使用本地时区

 7             notification.timeZone=[NSTimeZone defaultTimeZone];

 8             notification.alertBody=@"顶部提示内容，通知时间到啦";

 9             //通知提示音 使用默认的

10             notification.soundName= UILocalNotificationDefaultSoundName;

11             notification.alertAction=NSLocalizedString(@"你锁屏啦，通知时间到啦", nil);

12             //这个通知到时间时，你的应用程序右上角显示的数字。

13             notification.applicationIconBadgeNumber = 1;

14             //add key  给这个通知增加key 便于半路取消。nfkey这个key是我自己随便起的。

15             // 假如你的通知不会在还没到时间的时候手动取消 那下面的两行代码你可以不用写了。

16             NSDictionary *dict =[NSDictionary dictionaryWithObjectsAndKeys:[NSNumber numberWithInt:notificationtag],@"nfkey",nil];

17             [notification setUserInfo:dict];

18             //启动这个通知

19             [[UIApplication sharedApplication]   scheduleLocalNotification:notification];

20             //这句真的特别特别重要。如果不加这一句，通知到时间了，发现顶部通知栏提示的地方有了，然后你通过通知栏进去，然后你发现通知栏里边还有这个提示

21             //除非你手动清除，这当然不是我们希望的。加上这一句就好了。网上很多代码都没有，就比较郁闷了。

22             [notification release];

23         }

首先，这是一段Objective-C的代码，所以这段代码肯定也必须处在一个混编文件中，也就是后缀为.mm的文件里边。里面的内容我已经注释的很清楚，太详细的大家去查文档就可以了。
其中要特别注意的是第13行和22。

这段代码是从现在开始，多长时间后触发，并且只触发一次，这是我的需求，如果你需要固定时间触发，循环触发，也可以实现，google一下就可以了。

就这么简单，你调用了这段代码后，将app切到后台或者直接Kill掉，10秒后，就会看到顶部通知栏的通知，并且图标右上角显示红色的1。然后你通过通知栏点进去，会启动app，然后你再看，通知栏没有这个通知了，但是，app图标的右上角的那个1还是在的。

所以，这段代码很简单，但是你重要的还是逻辑。我介绍一下我的逻辑，当然我只是一个菜鸟，你取其中自认为有价值的地方即可。

1 创建一个基类CCNotificationUtil，便于在C++代码中调用。这个我是放在cocos2d命名空间下的。这样在C++代码里面，需要增加通知的地方，比如你的建筑开始升级了，你收到服务器传来的升级时间，你只需要调用

cocos2d::CCNotificationUtil::shareNotificationUtil()->addNotification(str_Alert,notificatioTag,timesec);*/

其中的三个参数，分别是通知栏显示的内容，通知的key，从现在开始多长时间以后触发。再重复一下，只会触发一次。这个类里面还有一个removeNotification方法，这个就是你半路取消通知时需要调用的方法，参数是创建时传入的tag。比如你点了升级建筑，开始生了，一个小时后完成。过了半个小时，你觉得时间太长了，用钱加速吧，这个时候，就需要调用这个方法了，因为你之前已经加了通知，告诉IOS一个小时后提示，这个时候你就的从IOS的通知里面把它给去掉了，所以这个方法就是满足这个需求的。

 CCNotificationUtil.h代码：

 1 #ifndef _CC_NotificationUtil_H__

 2 #define _CC_NotificationUtil_H__

 3 

 4 #include "ccTypes.h"

 5 #include "ccTypeInfo.h"

 6 

 7 NS_CC_BEGIN

 8 class CC_DLL CCNotificationUtil : public TypeInfo

 9 {

10 protected:

11     CCNotificationUtil();

12     static CCNotificationUtil* s_sharedNotificationUtil;

13     int m_pIconBadgeNumber;

14 public:

15     virtual long getClassTypeInfo() {

16         static const long id = cocos2d::getHashCodeByString(typeid(cocos2d::CCNotificationUtil).name());

17         return id;

18     }

19     static CCNotificationUtil * shareNotificationUtil();

20     virtual ~CCNotificationUtil();

21     virtual bool addNotification(std::string alerttext,int notificationtag,int timeinterval);

22     virtual bool init();

23     virtual bool removeNotification(int notificationtag);

24 };

25 NS_CC_END

26 #endif // !_CC_NotificationUtil_H_

CCNotificationUtil.app代码

 1 #include "CCNotificationUtil.h"

 2 

 3 NS_CC_BEGIN

 4 

 5 CCNotificationUtil* CCNotificationUtil::s_sharedNotificationUtil = NULL;

 6 

 7 CCNotificationUtil::CCNotificationUtil()

 8     :m_pIconBadgeNumber(0)

 9 {

10 

11 }

12 CCNotificationUtil::~CCNotificationUtil()

13 {

14 

15 }

16 bool CCNotificationUtil::init()

17 {

18     return true;

19 }

20 bool CCNotificationUtil::addNotification(std::string alerttext,int notificationtag,int timeinterval)

21 {

22     return true;

23 }

24 bool CCNotificationUtil::removeNotification(int notificationtag)

25 {

26     return ( true );

27 }

28 

29 NS_CC_END

2 创建和IOS平台相关的子类。这个才是做实际操作的类，因为会使用Objective-C，所以这是个混编文件。在你的项目中和平台相关的文件夹platform/ios/下面创建CCNotificationUtilIOS类。其中传入的参数会有C++和Objective-C的相互转换。
CCNotificationUtilIOS.h

#ifndef _CC_NotificationUtilIOS_H__

#define _CC_NotificationUtilIOS_H__



#include "ccTypes.h"

#include "ccTypeInfo.h"

#include "CCNotificationUtil.h"

NS_CC_BEGIN

class CC_DLL CCNotificationUtilIOS: public CCNotificationUtil

{

public:

    // override function

    virtual bool addNotification(std::string alerttext,int notificationtag,int timeinterval);

    virtual bool init();

    virtual bool removeNotification(int notificationtag);

};

NS_CC_END

#endif //_CC_NotificationUtilIOS_H__

CCNotificationUtilIOS.mm

#import "cocos2d.h"





#include "CCNotificationUtil.h"

#include "CCNotificationUtilIOS.h"

NS_CC_BEGIN



CCNotificationUtil* CCNotificationUtil::shareNotificationUtil()

{

    if(s_sharedNotificationUtil== NULL)

    {

        s_sharedNotificationUtil = new CCNotificationUtilIOS();

        s_sharedNotificationUtil->init();

    }

    return s_sharedNotificationUtil;

}

bool CCNotificationUtilIOS::init()

{

    if(CCNotificationUtil::init()==true)

    {

        [[UIApplication sharedApplication] cancelAllLocalNotifications];

        return true;

    }

    return false;

}

bool CCNotificationUtilIOS::addNotification(std::string alerttext,int notificationtag,int mytimeinterval)

{

    if(CCNotificationUtil::addNotification(alerttext,notificationtag,mytimeinterval)==true)

    {

        UILocalNotification *notification=[[UILocalNotification alloc] init];

        if (notification!=nil) {

            NSDate *now = [NSDate date];

            notification.fireDate=[now dateByAddingTimeInterval:mytimeinterval];

            notification.timeZone=[NSTimeZone defaultTimeZone];

            notification.alertBody=[NSString stringWithUTF8String:alerttext.c_str()];

            notification.soundName= UILocalNotificationDefaultSoundName;

            notification.alertAction=NSLocalizedString([NSString stringWithUTF8String:alerttext.c_str()], nil);

            notification.applicationIconBadgeNumber = [[[UIApplication sharedApplication] scheduledLocalNotifications] count]+1;

            //add key

            NSDictionary *dict =[NSDictionary dictionaryWithObjectsAndKeys:[NSNumber numberWithInt:notificationtag],@"nfkey",nil];

            [notification setUserInfo:dict];

            [[UIApplication sharedApplication]   scheduleLocalNotification:notification];

            [notification release];

            return true;

        }

    }

    return false;

}

bool CCNotificationUtilIOS::removeNotification(int notificationtag)

{

    NSArray *narry=[[UIApplication sharedApplication] scheduledLocalNotifications];

    NSUInteger acount=[narry count];

    if (acount<1) {

        return false;

    }

    for (int i=0; i<acount; i++) {

        UILocalNotification *myUILocalNotification = [narry objectAtIndex:i];

        NSDictionary *userInfo = myUILocalNotification.userInfo;

        NSNumber *obj = [userInfo objectForKey:@"nfkey"];

        int mytag=[obj intValue];

        if (mytag==notificationtag) {

            [[UIApplication sharedApplication] cancelLocalNotification:myUILocalNotification];

            return true;

        }

    }

    return false;

}



NS_CC_END

特别注意的是设置右上角图标个数的代码，如下。就是说当我这个通知到时间时，显示的个数，应该是在我之前加入到通知schedule里面的数量，当然这个不是绝对的，比如你第一个通知是一个小时后提示，紧接这触发了第二个通知，而第二个是10分钟，显然10分钟通知提示时，右上角会显示2，但其实应该是1。这个问题需要考虑，后面第4步我会说我的解决方法。

 notification.applicationIconBadgeNumber = [[[UIApplication sharedApplication] scheduledLocalNotifications] count]+1;

 

 

3 因为我开的需求之前介绍过在Win32上调试的，所以需要一个win32平台实现的子类，保证编译通过，但实际上这个类什么也不做。如果你不需要在win32上调试，这步可以省略了。在ios平级目录win32下创建CCNotificationUtilWin32子类。

CCNotificationUtilWin32.h

#ifndef _CC_NotificationUtilWin32_H__

#define _CC_NotificationUtilWin32_H__

#include "platform/CCNotificationUtil.h"

#include "platform/CCPlatformMacros.h"

#include "ccTypes.h"

#include "ccTypeInfo.h"



NS_CC_BEGIN

    

/**

 * @addtogroup platform

 * @{

 */



//! @brief  Helper class to handle file operations

class CCNotificationUtilWin32 : public CCNotificationUtil

{

    friend class CCNotificationUtil;

    CCNotificationUtilWin32();

public:

    // override function

    virtual bool addNotification();

    virtual bool init();

    virtual bool removeNotification(int notificationtag);

};

NS_CC_END



    // end of platform group

    /// @}





#endif // !_CC_NotificationUtilWin32_H__

CCNotificationUtilWin32.app

#include "CCNotificationUtilWin32.h"

#include "platform/CCCommon.h"

#include <Shlobj.h>

NS_CC_BEGIN

CCNotificationUtil* CCNotificationUtil::shareNotificationUtil()

{

    if(s_sharedNotificationUtil== NULL)

    {

        s_sharedNotificationUtil = new CCNotificationUtilWin32();

        s_sharedNotificationUtil->init();

    }

    return s_sharedNotificationUtil;

}



CCNotificationUtilWin32::CCNotificationUtilWin32()

{

}



bool CCNotificationUtilWin32::init()

{

    return CCNotificationUtil::init();

}

bool CCNotificationUtilWin32::addNotification()

{

    return true;

}

bool CCNotificationUtilWin32::removeNotification(int notificationtag)

{

    return true;

}

NS_CC_END

4 一个右上角提示的问题。你触发了5个通知，后台运行的情况下，3个已经到了，所以你的app右上角此时显示3。那么你通过通知栏或者直接点app进去以后，app右上角应该变为0。按照之前在addNotification里面的设置，等到第4个通知到了以后，app右上角会显示4，第五个到了以后，会显示5，很明显这是不对的。所以我们需要在通过通知栏进去，或者直接点app进去以后，重新去设置第四个第五个通知到了以后，app右上角的数字。
这个当然也需要在混编文件中。我是在实现UIApplicationDelegate的混编文件中重写了两个方法didReceiveLocalNotification和applicationDidBecomeActive。

didReceiveLocalNotification是app在前台运行，通知时间到了，调用的方法。如果程序在后台运行，时间到了以后是不会走这个方法的。

applicationDidBecomeActive是app在后台运行，通知时间到了，你从通知栏进入，或者直接点app图标进入时，会走的方法。

里面的逻辑，就是找到所有加入schedule的通知，重新设置通知时间到时，app右上角的数字。

 

 1     - (void)applicationDidBecomeActive:(UIApplication *)application {

 2     /*

 3      Restart any tasks that were paused (or not yet started) while the application was inactive. If the application was previously in the background, optionally refresh the user interface.

 4      */

 5     //reset applicationIconBadgeNumber;

 6     application.applicationIconBadgeNumber=0;

 7     int count =[[[UIApplication sharedApplication] scheduledLocalNotifications] count];

 8     if(count>0)

 9     {

10         NSMutableArray *newarry= [NSMutableArray arrayWithCapacity:0];

11         for (int i=0; i<count; i++) {

12             UILocalNotification *notif=[[[UIApplication sharedApplication] scheduledLocalNotifications] objectAtIndex:i];

13             notif.applicationIconBadgeNumber=i+1;

14             [newarry addObject:notif];

15         }

16         [[UIApplication sharedApplication] cancelAllLocalNotifications];

17         if (newarry.count>0) {

18             for (int i=0; i<newarry.count; i++) {

19                 UILocalNotification *notif = [newarry objectAtIndex:i];

20                 [[UIApplication sharedApplication] scheduleLocalNotification:notif];

21             }

22         }

23     }

24     

25     cocos2d::CCDirector::sharedDirector()->resume();

26 }

27 - (void)application:(UIApplication *)application didReceiveLocalNotification:(UILocalNotification *)notification{

28     if (notification)

29     {

30         application.applicationIconBadgeNumber=0;

31         int count =[[[UIApplication sharedApplication] scheduledLocalNotifications] count];

32         if(count>0)

33         {

34             NSMutableArray *newarry= [NSMutableArray arrayWithCapacity:0];

35             for (int i=0; i<count; i++) {

36                 UILocalNotification *notif=[[[UIApplication sharedApplication] scheduledLocalNotifications] objectAtIndex:i];

37                 notif.applicationIconBadgeNumber=i+1;

38                 [newarry addObject:notif];

39             }

40             [[UIApplication sharedApplication] cancelAllLocalNotifications];

41             if (newarry.count>0) {

42                 for (int i=0; i<newarry.count; i++) {

43                     UILocalNotification *notif = [newarry objectAtIndex:i];

44                     [[UIApplication sharedApplication] scheduleLocalNotification:notif];

45                 }

46             }

47         }

48     }

49 }

5 我们在实现UIApplicationDelegate的混编文件中还要实现一个方法didFinishLaunchingWithOptions。这是程序首次启动时，会走的地方。在这里，我们需要设置app右上角的数字为0，并且要清空所有的本地通知。为什么？比如，还是你升那个1小时的建筑，你点了以后，然后kill掉app了，但是那个通知已经放到本地了。然后你重新启动了程序，你收到服务器来的数据，显示建筑还有30分钟才到，你又给本地加了一个Notification。这样的话，你在30分钟和一个小时后，都会收到通知，这个肯定不会的吧。所以，加入这两行代码就可以了。

当然也有一种解决方法时，你加入的时候根据tag判断一下，如果有了，删除，重加。只是这个个人感觉比较麻烦，也不通用。

   // about notification

    application.applicationIconBadgeNumber = 0;

    [[UIApplication sharedApplication] cancelAllLocalNotifications];

好了，这就大功告成了。