iOS10 Notification Service Extension(实现后台语音播报功能)以及IOS 12.1之后,语音播报失效情况处理

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

一:Notification Service Extension通知服务扩展

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


iOS10 Notification Service Extension(实现后台语音播报功能)以及IOS 12.1之后,语音播报失效情况处理_第1张图片
1.png

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


iOS10 Notification Service Extension(实现后台语音播报功能)以及IOS 12.1之后,语音播报失效情况处理_第2张图片
2.png

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


iOS10 Notification Service Extension(实现后台语音播报功能)以及IOS 12.1之后,语音播报失效情况处理_第3张图片
3.png

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

二:

主工程需要如下配置:


iOS10 Notification Service Extension(实现后台语音播报功能)以及IOS 12.1之后,语音播报失效情况处理_第4张图片
Capabilities1.png

iOS10 Notification Service Extension(实现后台语音播报功能)以及IOS 12.1之后,语音播报失效情况处理_第5张图片
Capabilities2.png
创建Service Extension

1:
iOS10 Notification Service Extension(实现后台语音播报功能)以及IOS 12.1之后,语音播报失效情况处理_第6张图片
4.png

2:
iOS10 Notification Service Extension(实现后台语音播报功能)以及IOS 12.1之后,语音播报失效情况处理_第7张图片
5.png

3: 点击上图右下角的Next
iOS10 Notification Service Extension(实现后台语音播报功能)以及IOS 12.1之后,语音播报失效情况处理_第8张图片
6.png

4: 点击上图右下角的Finish
iOS10 Notification Service Extension(实现后台语音播报功能)以及IOS 12.1之后,语音播报失效情况处理_第9张图片
7.png

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

三:

经过上面的步骤之后,会出现如下的截图显示
iOS10 Notification Service Extension(实现后台语音播报功能)以及IOS 12.1之后,语音播报失效情况处理_第10张图片
8.png

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

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


iOS10 Notification Service Extension(实现后台语音播报功能)以及IOS 12.1之后,语音播报失效情况处理_第11张图片
9.png

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

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

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

四:

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

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

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


iOS10 Notification Service Extension(实现后台语音播报功能)以及IOS 12.1之后,语音播报失效情况处理_第12张图片
极光推送1.png

iOS10 Notification Service Extension(实现后台语音播报功能)以及IOS 12.1之后,语音播报失效情况处理_第13张图片
极光推送2.png

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


iOS10 Notification Service Extension(实现后台语音播报功能)以及IOS 12.1之后,语音播报失效情况处理_第14张图片
10.png

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

#import "NotificationService.h"
#import 

@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进行断点操作


iOS10 Notification Service Extension(实现后台语音播报功能)以及IOS 12.1之后,语音播报失效情况处理_第15张图片
断点.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就失效了.


iOS10 Notification Service Extension(实现后台语音播报功能)以及IOS 12.1之后,语音播报失效情况处理_第16张图片
官方说明.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);
}

你可能感兴趣的:(iOS10 Notification Service Extension(实现后台语音播报功能)以及IOS 12.1之后,语音播报失效情况处理)