前言:
前段时间, 产品提出一个新的需求,要求实现外卖订单的语音播报功能, 之前的开发仅仅实现了前台的语音播报功能,我这边要实现的功能就是点击APP进入后台或者APP进程杀死之后,依旧能收到语音播报,于是先是考虑用IOS7支持的静默推送,不过没有达到要求,声音没有播放出来,又想到了VoIP,苹果推出的支持网络电话的那一套,看到网上的介绍,后台不好上线,就放弃了,在迷茫之时,想到了IOS 10之后
推出的新功能,就是苹果的推送扩展(Notification Service Extension), 网上也有不少教程,然后就按照教程一步一步的进行下去...... 在此过程中遇到不少问题,特此根据自己的实现过程(已上线),总结分析,如有错误之处,请指出
一:Notification Service Extension通知服务扩展
解析: 通俗点说就是我们在收到推送且在弹框展示之前,对通知内容进行修改(只针对远程推送),如图简易表示:
在实现功能之前,我也查阅不少资料,刚开始看的时候,有点晕,因为涉及到了重新配置证书的问题,不过,有的工程是直接自动适配证书,如下:
但是我们的工程关于证书这方面,是手动配置的,类似:
所以接下来,我所讲述的大多涉及手动配置证书方面,关于主工程的开发环境和生产环境的Provisioning Profile,具体的步骤,网上又不少讲解,我这边就直接省略了,上面废话居多,接下来讲述实现后台语音播报功能的具体步骤。
二:
主工程需要如下配置:
创建Service Extension
1:点击上图右下角的Activate,这个时候最基本的操作就创建好了.
三:
经过上面的步骤之后,会出现如下的截图显示
在TARGETS里面会出现一个新的推送扩展工程,它的Bundle Identifier与主工程的有一定的关联性,这个时候涉及了Provisioning Profile,刚开始弄的时候,心情是万马奔腾的,心想,这难道还要再弄配置文件嘛?还要再制作推送证书吗?如果对这个推送扩展制作推送证书的之后,我的极光推送平台上配置的关于推送的p12证书可需要替换?总之,一些列问题涌向心头......
1: 关于是否需要制作新的Provisioning Profile,答案是肯定的,具体的制作方法和之前主工程制作推送证书的步骤是一致的,就是按部就班的从APP IDs 到 Provisioning Profiles(我这边也配置了推送证书,不过后期没用到), 配置好开发环境、生产环境的Provisioning Profile之后,按照下图选择好相对应的配置文件,即可
到了这一步,关于推送扩展的证书配置就完成了.
2: 关于是否制作推送证书,我制作了,但是没用到
3: 极光推送之前配置的P12证书,不需要改动,用之前的就行了
四:
1: 在设置推送的时候,一定要带上这个字段:"mutable -content" ,只有将该字段设置为1,下面的方法才会有效(具体如何添加,和后台协商)。已极光推送为例,在测试环境下发推送的时候,可以打印出类似如下的数据(下面是我简单的写一下,方便参考),
aps = {
alert = ‘输入文字’;
badge = 1;
“mutable-content” = 1;
}
2: 下面两个截图是测试时在极光推送后台配置的情况:
3: 此时打开推送扩展的.m文件,
语音播报就是在这个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进行断点操作
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就失效了.
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);
}