iOS10 Notification Service Exten

前言：
前段时间, 产品提出一个新的需求，要求实现外卖订单的语音播报功能, 之前的开发仅仅实现了前台的语音播报功能，我这边要实现的功能就是点击APP进入后台或者APP进程杀死之后，依旧能收到语音播报，于是先是考虑用IOS7支持的静默推送，不过没有达到要求，声音没有播放出来，又想到了VoIP，苹果推出的支持网络电话的那一套，看到网上的介绍，后台不好上线，就放弃了，在迷茫之时，想到了IOS 10之后
推出的新功能，就是苹果的推送扩展(Notification Service Extension), 网上也有不少教程，然后就按照教程一步一步的进行下去...... 在此过程中遇到不少问题，特此根据自己的实现过程(已上线)，总结分析，如有错误之处，请指出

一：Notification Service Extension通知服务扩展

解析： 通俗点说就是我们在收到推送且在弹框展示之前，对通知内容进行修改(只针对远程推送)，如图简易表示：

1.png

在实现功能之前，我也查阅不少资料，刚开始看的时候，有点晕，因为涉及到了重新配置证书的问题，不过，有的工程是直接自动适配证书，如下：

2.png

但是我们的工程关于证书这方面，是手动配置的，类似：

3.png

所以接下来，我所讲述的大多涉及手动配置证书方面，关于主工程的开发环境和生产环境的Provisioning Profile，具体的步骤，网上又不少讲解，我这边就直接省略了，上面废话居多，接下来讲述实现后台语音播报功能的具体步骤。

二：

主工程需要如下配置：

Capabilities1.png
Capabilities2.png

创建Service Extension

1: 4.png 2: 5.png 3: 点击上图右下角的Next 6.png 4: 点击上图右下角的Finish 7.png

点击上图右下角的Activate,这个时候最基本的操作就创建好了.

三：

经过上面的步骤之后，会出现如下的截图显示

8.png

在TARGETS里面会出现一个新的推送扩展工程，它的Bundle Identifier与主工程的有一定的关联性，这个时候涉及了Provisioning Profile，刚开始弄的时候，心情是万马奔腾的，心想，这难道还要再弄配置文件嘛？还要再制作推送证书吗？如果对这个推送扩展制作推送证书的之后，我的极光推送平台上配置的关于推送的p12证书可需要替换？总之，一些列问题涌向心头......

1: 关于是否需要制作新的Provisioning Profile，答案是肯定的，具体的制作方法和之前主工程制作推送证书的步骤是一致的，就是按部就班的从APP IDs 到 Provisioning Profiles(我这边也配置了推送证书，不过后期没用到), 配置好开发环境、生产环境的Provisioning Profile之后，按照下图选择好相对应的配置文件，即可

9.png

到了这一步，关于推送扩展的证书配置就完成了.

2: 关于是否制作推送证书，我制作了，但是没用到

3: 极光推送之前配置的P12证书，不需要改动，用之前的就行了

四：

1: 在设置推送的时候，一定要带上这个字段："mutable -content" ，只有将该字段设置为1，下面的方法才会有效(具体如何添加，和后台协商)。已极光推送为例,在测试环境下发推送的时候，可以打印出类似如下的数据(下面是我简单的写一下，方便参考)，

aps = {
         alert = ‘输入文字’;
         badge = 1;
         “mutable-content” = 1;
 }

2: 下面两个截图是测试时在极光推送后台配置的情况：

极光推送1.png
极光推送2.png

3: 此时打开推送扩展的.m文件，

10.png

语音播报就是在这个NotificationService.m文件里面实现的，

#import "NotificationService.h"
#import <AVFoundation/AVFAudio.h>

@interface NotificationService ()

@property (nonatomic, strong) void (^contentHandler)(UNNotificationContent *contentToDeliver);
@property (nonatomic, strong) UNMutableNotificationContent *bestAttemptContent;
@property (nonatomic, strong) AVSpeechSynthesizer *speechSynthesizer;

@end

@implementation NotificationService

- (void)didReceiveNotificationRequest:(UNNotificationRequest *)request withContentHandler:(void (^)(UNNotificationContent * _Nonnull))contentHandler {
    /**
     *  备注: 后台推送过来的数据要协商好格式，只要格式协商好，这部分就不会有问题
     */
    self.contentHandler = contentHandler;
    self.bestAttemptContent = [request.content mutableCopy];
    self.speechSynthesizer = [[AVSpeechSynthesizer alloc] init];
    /*语音播报的内容*/
    NSString* soundTitle = self.bestAttemptContent.userInfo[@"aps"][@"alert"];
    AVSpeechUtterance* speechUtterance = [[AVSpeechUtterance alloc] initWithString:soundTitle];
    /*设置语速*/
    speechUtterance.rate = 0.5;
    /*设置音量*/
    speechUtterance.volume = 1.0;
    /*设置语调*/
    speechUtterance.pitchMultiplier = 3.0;
    /*设置哪国语言*/
    speechUtterance.voice = [AVSpeechSynthesisVoice voiceWithLanguage:@"zh-CN"];
    [self.speechSynthesizer speakUtterance:speechUtterance];
    self.contentHandler(self.bestAttemptContent);
}

- (void)serviceExtensionTimeWillExpire {
    self.contentHandler(self.bestAttemptContent);
}
@end

按照上面的步骤，在极光平台测试推送，就可以实现简单的语音播报.

注意点：

1: Debug测试，如下图设置，可以对NotificationService.m进行断点操作

断点.png

2: 推送的过程中会对数据进行相应的处理，这个与极光推送后台API发送推送数据会有些误差，我当时也是踩了不少坑，我这边的处理方法如下：

格式(大致的数据)：
{ 
    "aps": {
        "alert": "您有一个新的商品订单，点击查看详情", 
        "extras": {
            "has_voice": true, 
            "type": "weixin_order"
        },
        "mutable-content": 1
    }
}

- (void)didReceiveNotificationRequest:(UNNotificationRequest *)request withContentHandler:(void (^)(UNNotificationContent * _Nonnull))contentHandler {
    self.bestAttemptContent = [request.content mutableCopy];
    NSMutableDictionary *extras = [NSMutableDictionary dictionaryWithDictionary: self.bestAttemptContent.userInfo]; 
    [extras removeObjectForKey:@"aps"];
    NSMutableDictionary *params = [NSMutableDictionary dictionary];
    [params setValue:extras forKey:@"extras"];
    NSString* type = params[@"extras"][@"type"];
    BOOL has_voice = [params[@"extras"][@"has_voice"] boolValue];
}

看到上面的方法，估计你会有点郁闷，我之前尝试过

NSString* type = self.attemptContent.userInfo[@"aps"][@"extras"][@"type"];

不过没有获取type的值.

3: 如果感觉系统自带的文字转语音, 播放的音质不太满意，可以尝试语音合成的方法，具体可参考这个链接(如果有不理解的，我这边也是用合成语音的方法实现语音播报的，可分享)：
自定义语音合成播报

下面是关于iOS12.1之后，语音播报失效的情况分析与处理.

1: 下图是官方给出的说明，之前给出这个拓展推送主要是为了丰富推送的UI样式，推送信息加密之类的，结果却被用做推送语音播报，所以就发了这个声明，在12.1之后，在这个推送扩展里面AVAudioPlayer就失效了.

官方说明.png

2: 解决方法:
既然我们可以修改推送内容的title、subtitle和body，那么由此类推，同样的话，我们也可以修改推送的sound，又因为推送扩展和主工程是相互隔离的状态，这点在外面debug的时候已经明确了，这个时候采用本地通送的方式，在推送扩展里面发出本地推送去调取主目录下的音频文件。

具体实现方法如下:

- (void)didReceiveNotificationRequest:(UNNotificationRequest *)request withContentHandler:(void (^)(UNNotificationContent * _Nonnull))contentHandler { 
      if (@available(iOS 12.1, *)) {
            [self registerNotificationServiceType:type completeHandler:^{
                weakSelf.contentHandler(weakSelf.attemptContent);
            }];
        } else {
          // 此处调用之前的语音播报的内容   
    }
}

// type: 后台推送过来的
- (void)registerNotificationServiceType:(NSString*) type completeHandler:(void(^)(void))completeHandler{
    [[UNUserNotificationCenter currentNotificationCenter] requestAuthorizationWithOptions:UNAuthorizationOptionBadge|UNAuthorizationOptionSound|UNAuthorizationOptionAlert completionHandler:^(BOOL granted, NSError * _Nullable error){
        
        if(granted) {
            UNMutableNotificationContent *content = [[UNMutableNotificationContent alloc]init];
            content.title = @"";
            content.subtitle = @"";
            content.body = @"";
            
            NSString* sound = @"";
            if ([type isEqualToString:@"take_order"]) {
                sound = @"外卖订单";
            }else if ([type isEqualToString:@"weixin_order"]) {
                sound = @"商品订单";
            }else if ([type isEqualToString:@"food_order"]) {
                sound = @"点餐订单";
            }else if ([type isEqualToString:@"online_yuyue"]) {
                sound = @"预约订单";
            }
            // mp3格式的也是可以的
            content.sound = [UNNotificationSound soundNamed:[NSString stringWithFormat:@"%@.m4a",sound]];
            content.categoryIdentifier = [NSString stringWithFormat:@"noti_%@",type];
            UNTimeIntervalNotificationTrigger *trigger = [UNTimeIntervalNotificationTrigger triggerWithTimeInterval:1 repeats:NO];
            UNNotificationRequest* notificationRequest =
            [UNNotificationRequest requestWithIdentifier:[NSString stringWithFormat:@"noti_%@",type] content:content trigger:trigger];
            [[UNUserNotificationCenter currentNotificationCenter]addNotificationRequest:notificationRequest withCompletionHandler:^(NSError * _Nullable error) {
                if(error == nil) {
                    completeHandler();
                }
            }];
        }
    }];
}

3: 其实上面的代码实现起来不难，但是我却碰到一个问题，就是刚开始的时候，我怎么推送都没声音，当时以为是不是音频格式的问题，最后发现是都不是，然后无意间点击home键让app进入后台状态，却有了推送声音，此时我想既然进入后台和杀死进程状态下都有语音播报声音，那么前台情况下就更好处理了，然后打开appdelegate.m文件下，看看能不能在

- (void)jpushNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(NSInteger))completionHandler{ 
    completionHandler(UNNotificationPresentationOptionAlert);
}

处理一番，结果发现，之前只写了 UNNotificationPresentationOptionAlert ，恍然大悟，然后做了如下处理就可以了.

- (void)jpushNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(NSInteger))completionHandler { 
    completionHandler(UNNotificationPresentationOptionAlert |UNNotificationPresentationOptionBadge| UNNotificationPresentationOptionSound);
}