知 识 点 / 超 人
目录
- 背景
- UNNotificationServiceExtension 与 UNNotificationContentExtension的关系
- UNNotificationServiceExtension
- UNNotificationContentExtension
- 扩展知识点
- 示例代码
背景
iOS 10之前，iPhone手机中，通知栏仅能展示 标题和内容文本
iOS 10 之前的通知栏iOS 10 开始，苹果新增了UserNotifications.framework库用于对通知的扩展。通过UNNotificationService 与 UNNotificationContent来进行通知的 拦截 与 通知界面的自定义。让通知栏变得丰富多彩，既可以展示图文内容，也可以展示音视频。使得用户在不打开App的情况下也能进行App内容的交互。
图文推送长按推送推送后带有图文的自定义推送长按推送后带有交互的自定义推送长按推送后的带有聊天回复功能的自定义推送
iOS 12开始，新增了通知栏的分组，默认会根据Bundle Id自动区分不同应用的通知，也可以通过Thread identifier 精细化控制同一个应用里不同类型的通知。
设置App分组
自动：按照Thread identifier进行区分不同的消息，App如果未设置Thread identifier，则按照Bundle Id区分。
按App：按照App的 Bundle Id 区分通知消息
关：关闭App的通知分组
UNNotificationServiceExtension 与 UNNotificationContentExtension的关系
UNNotificationServiceExtension负责拦截通知，对通知内容做中间处理，而UNNotificationContentExtension负责自定义通知界面的。
如果只是想对通知内容进行解析或单纯的系统通知中有小图片，那么使用UNNotificationServiceExtension即可
如果想显示用户长按通知自定义后显示的通知界面，则需要使用UNNotificationContentExtension自定义通知界面
一般都是UNNotificationServiceExtension与UNNotificationContentExtension结合使用，由UNNotificationServiceExtension解密通知，将通知内容进行转换，并下载相关的通知资源文件。然后在UNNotificationContentExtension中拿到UNNotificationServiceExtension处理后的通知内容，将内容赋值在界面上进行展示。
UNNotificationServiceExtension
苹果官方关于UNNotificationServiceExtension的说明文档
UNNotificationServiceExtension是用于拦截远程通知的，在手机收到对应App的通知时，会触发UNNotificationServiceExtension，可以在UNNotificationServiceExtension中对通知内容进行修改，收到可以对通知添加附件，例如图片、音频、视频。
1、创建UNNotificationServiceExtension
在工程中的TARGETS中选择加号，然后在 iOS 模板中选择 Notification Service Extension
创建UNNotificationServiceExtension
创建后自动生成的文件
NotificationService是通知拦截响应的类，Info.plist是NotificationsServiceExtension的配置信息。
在NotificationService.m中，自动生成了contentHandler与bestAttemptContent两个属性。didReceiveNotificationRequest:withContentHandler与serviceExtensionTimeWillExpire方法。
bestAttemptContent
//通知消息的内容对象，里面包含了通知相关的所有信息。一般有title、body、subTitle。
//如果是服务端封装的扩展参数，则一般都在userInfo中。
@property (nonatomic, strong) UNMutableNotificationContent *bestAttemptContent;
contentHandler
//用于告知系统已经处理完成，可以将通知内容传给App的回调对象。
//该对象需要返回一个UNMutableNotificationContent对象。一般都是返回bestAttemptContent
@property (nonatomic, strong) void (^contentHandler)(UNNotificationContent *contentToDeliver);
didReceiveNotificationRequest:withContentHandler
//可以通过重写此方法来实现自定义推送通知修改。
//如果要使用修改后的通知内容，则需要在该方法中调用contentHandler传递修改后的通知内容。
//如果在服务时间(30秒)到期之前未调用处理程序contentHandler，则将传递未修改的通知。
//@param request 通知内容
//@param contentHandler 处理结果，需要返回一个UNNotificationContent的通知内容
- (void)didReceiveNotificationRequest:(UNNotificationRequest *)request withContentHandler:(void (^)(UNNotificationContent * _Nonnull))contentHandler {
//接收回调对象
self.contentHandler = contentHandler;
//copy通知内容
self.bestAttemptContent = [request.content mutableCopy];
//回调通知结果
self.contentHandler(self.bestAttemptContent);
}
serviceExtensionTimeWillExpire
//当didReceiveNotificationRequest的方法执行超过30秒未调用contentHandler时
//系统会自动调用serviceExtensionTimeWillExpire方法，给我们最后一次弥补处理的机会
//可以在serviceExtensionTimeWillExpire方法中设置didReceiveNotificationRequest方法中未完成数据的默认值
- (void)serviceExtensionTimeWillExpire {
self.contentHandler(self.bestAttemptContent);
}
UNNotificationRequest
远程通知发送给App的通知请求，其中包括通知的内容和交互的触发条件。
@interface UNNotificationRequest : NSObject <NSCopying, NSSecureCoding>
// 该属性为通知请求的唯一标识符。可以用它来替换或删除挂起的通知请求或已传递的通知。
@property (NS_NONATOMIC_IOSONLY, readonly, copy) NSString *identifier;
// 该属性是用于显示的通知内容
@property (NS_NONATOMIC_IOSONLY, readonly, copy) UNNotificationContent *content;
// 通知交互的触发器
@property (NS_NONATOMIC_IOSONLY, readonly, copy, nullable) UNNotificationTrigger *trigger;
UNNotificationTrigger
抽象类，用于表示触发通知传递的事件。不能直接创建此类的实例。具体的触发子类看下面的类
//抽象类，用于表示触发通知传递的事件。不能直接创建此类的实例。具体的触发子类看下面的类
@interface UNNotificationTrigger : NSObject <NSCopying, NSSecureCoding>
/// 通知的触发是否循环执行
@property (NS_NONATOMIC_IOSONLY, readonly) BOOL repeats;
- (instancetype)init NS_UNAVAILABLE;
@end
//远程推送
// 苹果远程推送服务时的推送对象.
API_AVAILABLE(macos(10.14), ios(10.0), watchos(3.0), tvos(10.0))
@interface UNPushNotificationTrigger : UNNotificationTrigger
@end
// 本地推送
// 基于时间间隔去触发的通知.
API_AVAILABLE(macos(10.14), ios(10.0), watchos(3.0), tvos(10.0))
@interface UNTimeIntervalNotificationTrigger : UNNotificationTrigger
/// 通知延迟触发的时间
@property (NS_NONATOMIC_IOSONLY, readonly) NSTimeInterval timeInterval;
/// 创建延迟触发的通知
/// @param timeInterval 延迟的时间
/// @param repeats 是否重复执行
+ (instancetype)triggerWithTimeInterval:(NSTimeInterval)timeInterval repeats:(BOOL)repeats;
/// 获取通知下一次触发的时间
- (nullable NSDate *)nextTriggerDate;
@end
// 本地推送
// 根据日期和时间触发的通知
API_AVAILABLE(macos(10.14), ios(10.0), watchos(3.0), tvos(10.0))
@interface UNCalendarNotificationTrigger : UNNotificationTrigger
/// 通知触发的时间
@property (NS_NONATOMIC_IOSONLY, readonly, copy) NSDateComponents *dateComponents;
// The next date is calculated using matching date components.
/// 创建基于时间触发的通知
/// @param dateComponents 日期
/// @param repeats 是否重复执行
+ (instancetype)triggerWithDateMatchingComponents:(NSDateComponents *)dateComponents repeats:(BOOL)repeats;
/// 获取通知下一次触发的时间
- (nullable NSDate *)nextTriggerDate;
@end
// 根据用户手机定位，当进入某个区域或者离开某个区域时触发通知
API_AVAILABLE(ios(10.0), watchos(3.0)) API_UNAVAILABLE(macos, tvos, macCatalyst)
@interface UNLocationNotificationTrigger : UNNotificationTrigger
/// 触发通知的地理位置信息
@property (NS_NONATOMIC_IOSONLY, readonly, copy) CLRegion *region;
/// 创建基于地理位置触发的通知
/// @param region 地理位置
/// @param repeats 是否重复触发
+ (instancetype)triggerWithRegion:(CLRegion *)region repeats:(BOOL)repeats API_AVAILABLE(watchos(8.0));
@end
UNNotificationContent
通知的具体内容，包括通知类型、自定义参数、附件信息等。不能直接创建该类，如果需要创建自定义的通知内容，应该创建UNMutableNotificationContent，并配置内容
// 附件数组，必须是UNNotificationAttachment对象
@property (NS_NONATOMIC_IOSONLY, readonly, copy) NSArray <UNNotificationAttachment *> *attachments API_UNAVAILABLE(tvos);
// 应用的认证号码，图标右上角的数字
@property (NS_NONATOMIC_IOSONLY, readonly, copy, nullable) NSNumber *badge;
// 通知的内容
@property (NS_NONATOMIC_IOSONLY, readonly, copy) NSString *body API_UNAVAILABLE(tvos);
// 已注册的UNNotificationCategory的标识符，用于确定显示哪一个自定义通知的UI。
//该标识是在UNNotificationContentExtension的info.plist中注册的
@property (NS_NONATOMIC_IOSONLY, readonly, copy) NSString *categoryIdentifier API_UNAVAILABLE(tvos);
// 通知栏中应用程序显示App图片，在App中通设置该属性来修改通知栏中的App Icon
@property (NS_NONATOMIC_IOSONLY, readonly, copy) NSString *launchImageName API_UNAVAILABLE(macos, tvos);
// 通知将播放的音频，在App中通过设置该属性来修改App的通知声音
@property (NS_NONATOMIC_IOSONLY, readonly, copy, nullable) UNNotificationSound *sound API_UNAVAILABLE(tvos);
// 通知的副标题
@property (NS_NONATOMIC_IOSONLY, readonly, copy) NSString *subtitle API_UNAVAILABLE(tvos);
// 与当前通知请求相关的线程或对话的唯一标识符。它是通知分组的标识
@property (NS_NONATOMIC_IOSONLY, readonly, copy) NSString *threadIdentifier API_UNAVAILABLE(tvos);
// 通知标题
@property (NS_NONATOMIC_IOSONLY, readonly, copy) NSString *title API_UNAVAILABLE(tvos);
// 通知的详细信息
@property (NS_NONATOMIC_IOSONLY, readonly, copy) NSDictionary *userInfo API_UNAVAILABLE(tvos);
// 通知摘要参数
@property (NS_NONATOMIC_IOSONLY, readonly, copy) NSString *summaryArgument API_DEPRECATED("summaryArgument is ignored", ios(12.0, 15.0), watchos(5.0, 8.0), tvos(12.0, 15.0));
// 摘要的数量
@property (NS_NONATOMIC_IOSONLY, readonly, assign) NSUInteger summaryArgumentCount API_DEPRECATED("summaryArgumentCount is ignored", ios(12.0, 15.0), watchos(5.0, 8.0), tvos(12.0, 15.0));
// 点击自定义通知是激活的场景唯一标识，默认为空
@property (NS_NONATOMIC_IOSONLY, readonly, copy, nullable) NSString *targetContentIdentifier API_AVAILABLE(ios(13.0));
// 通知的级别
//UNNotificationInterruptionLevelPassive,添加到通知列表中；不会点亮屏幕或播放声音
//UNNotificationInterruptionLevelActive,立即执行，点亮屏幕并可能播放声音
//UNNotificationInterruptionLevelTimeSensitive,立即执行，点亮屏幕并可能播放声音；在请勿打扰期间都会出现
// Presented immediately; Lights up screen and plays sound; Always presented during Do Not Disturb; Bypasses mute switch; Includes default critical alert sound if no sound provided
//立即执行,点亮屏幕并播放声音,如果处于“请勿打扰”状态会一直显示，不收静音开关影响，如果没有设置附件声音，则会使用默认的严重警报声音
//UNNotificationInterruptionLevelCritical,
@property (NS_NONATOMIC_IOSONLY, readonly, assign) UNNotificationInterruptionLevel interruptionLevel API_AVAILABLE(macos(12.0), ios(15.0), watchos(8.0), tvos(15.0));
// 关联系数，决定了通知在应用程序通知中的排序。其范围在0.0f和1.0f之间。
@property (NS_NONATOMIC_IOSONLY, readonly, assign) double relevanceScore API_AVAILABLE(macos(12.0), ios(15.0), watchos(8.0), tvos(15.0));
UNNotificationSound
通知发出时，通知的声音。如果想手机收到通知时播放特定声音，需要创建UNNotificationSound对象来设置特定的音频文件。UNNotificationSound对象仅读取以下位置文件：
应用程序容器目录的/Library/Sounds目录。
应用程序的共享组容器目录之一的/Library/Sounds目录。播放自定义声音，必须采用以下音频数据格式之一：Linear PCM、MA4 (IMA/ADPCM)、µLaw、aLaw
可以将音频数据打包为aiff、wav或caf文件。声音文件的长度必须小于30秒。如果声音文件超过30秒，系统将播放默认声音
可以使用afconvert命令行工具转换声音。例如，将系统声音转换为Submarine.aiff。aiff到IMA4音频在CAF文件中，在终端中使用以下命令：
afconvert /System/Library/Sounds/Submarine.aiff ~/Desktop/sub.caf -d ima4 -f caff -
//通知发出时，通知的声音。如果想手机收到通知时播放特定声音，需要创建UNNotificationSound对象来设置特定的音频文件。
//UNNotificationSound对象仅在以下位置显示：
//应用程序容器目录的/Library/Sounds目录。
//应用程序的共享组容器目录之一的/Library/Sounds目录。
//播放自定义声音，必须采用以下音频数据格式之一：Linear PCM、MA4 (IMA/ADPCM)、µLaw、aLaw
//可以将音频数据打包为aiff、wav或caf文件。声音文件的长度必须小于30秒。如果声音文件超过30秒，系统将播放默认声音
//可以使用afconvert命令行工具转换声音。例如，将系统声音转换为Submarine.aiff。aiff到IMA4音频在CAF文件中，在终端中使用以下命令：
//afconvert /System/Library/Sounds/Submarine.aiff ~/Desktop/sub.caf -d ima4 -f caff -
@interface UNNotificationSound : NSObject <NSCopying, NSSecureCoding>
// 默认的通知声音
@property(class, NS_NONATOMIC_IOSONLY, copy, readonly) UNNotificationSound *defaultSound;
// 用于来电通知的默认声音。播放设置中指定的铃声和触觉，持续30秒。
// 父UNNotificationContent对象必须通过-[UnnotificationContentByUpdateingWithProvider:error:]在通知服务扩展中创建
// 其中提供程序是InstartCallContent，其destinationType为INCallDestinationTypeNormal。
// 如果此用例可用，请使用CallKit而不是UserNotifications。
@property(class, NS_NONATOMIC_IOSONLY, copy, readonly) UNNotificationSound *defaultRingtoneSound API_AVAILABLE(ios(15.2)) API_UNAVAILABLE(macos, watchos, tvos, macCatalyst);
// 用于关键警报的默认声音。严重警报将绕过静音开关，且不会干扰
@property(class, NS_NONATOMIC_IOSONLY, copy, readonly) UNNotificationSound *defaultCriticalSound API_AVAILABLE(ios(12.0), watchos(5.0)) API_UNAVAILABLE(tvos);
// The default sound used for critical alerts with a custom audio volume level. Critical alerts will bypass the mute switch and Do Not Disturb. The audio volume is expected to be between 0.0f and 1.0f.
/// 严重警报将绕过静音开关，且不会干扰。
/// @param volume 音频音量预计在0.0f到1.0f之间。
+ (instancetype)defaultCriticalSoundWithAudioVolume:(float)volume API_AVAILABLE(ios(12.0), watchos(5.0)) API_UNAVAILABLE(tvos);
// 为通知播放的声音文件。声音必须位于应用程序数据容器的Library/Sounds文件夹或应用程序组数据容器的Library/Sounds文件夹中。
// 如果在容器中找不到该文件，系统将在应用程序包中查找。
+ (instancetype)soundNamed:(UNNotificationSoundName)name API_UNAVAILABLE(watchos, tvos);
+ (instancetype)ringtoneSoundNamed:(UNNotificationSoundName)name API_AVAILABLE(ios(15.2)) API_UNAVAILABLE(macos, watchos, tvos, macCatalyst);
+ (instancetype)criticalSoundNamed:(UNNotificationSoundName)name API_AVAILABLE(ios(12.0)) API_UNAVAILABLE(watchos, tvos);
+ (instancetype)criticalSoundNamed:(UNNotificationSoundName)name withAudioVolume:(float)volume API_AVAILABLE(ios(12.0)) API_UNAVAILABLE(watchos, tvos);
- (instancetype)init NS_UNAVAILABLE;
@end
UNNotificationAttachment
通知的附件，可以存放音频、图像或视频内容，创建UNNotificationAttachment对象时，指定的文件必须在磁盘上，并且文件格式必须是受支持的类型之一。不然会创建失败，返回nil。
系统会在显示相关通知之前验证附件。如果是本地通知，请求附加的文件已损坏、无效或文件类型不受支持，则系统不会执行请求。如果是远程通知，系统会在通知服务应用程序扩展完成后验证附件。验证后，系统会将附件移动到附件数据存储中，以便适当的流程可以访问这些文件。系统会复制应用包中的附件。
| 附件类型 | 支持的文件类型 | 文件的最大容量 |
|---|---|---|
| Audio | kUTTypeAudioInterchangeFileFormat kUTTypeWaveformAudio kUTTypeMP3 kUTTypeMPEG4Audio |
5MB |
| Image | kUTTypeJPEG kUTTypeGIF kUTTypePNG |
10MB |
| Movie | kUTTypeMPEG kUTTypeMPEG2Video kUTTypeMPEG4 kUTTypeAVIMovie |
50MB |
@interface UNNotificationAttachment : NSObject <NSCopying, NSSecureCoding>
// 附件的唯一标识
@property (NS_NONATOMIC_IOSONLY, readonly, copy) NSString *identifier;
// 附件文件的url
@property (NS_NONATOMIC_IOSONLY, readonly, copy) NSURL *URL;
// 附件的类型
@property (NS_NONATOMIC_IOSONLY, readonly, copy) NSString *type;
// 创建一个附件，附件的url必须是有效的文件路径，否则会返回nil。
/// @param identifier 附件唯一标识
/// @param URL 附件url
/// @param options 附件类型详情设置
/// UNNotificationAttachmentOptionsTypeHintKey:附件类型，传入一个string值，如果未设置，则会根据文件的扩展名设置文件类型
/// UNNotificationAttachmentOptionsThumbnailHiddenKey:是否隐藏此附件的缩略图，值是BOOL类型（NSNumber），默认为NO
/// UNNotificationAttachmentOptionsThumbnailClippingRectKey:指定用于附件缩略图的标准化剪裁矩形
/// (上)该值必须是使用CGRectCreateDictionaryRepresentation编码的CGRect
/// UNNotificationAttachmentOptionsThumbnailTimeKey:指定要用作缩略图的动画图像帧数或电影时间。
/// (上)该值动画图像帧编号必须是NSNumber类型
/// 该值电影时间必须是以秒为单位的NSNumber，或者是使用CMTimeCopyAsDictionary编码的CMTime。
/// @param error 创建附件的报错信息
+ (nullable instancetype)attachmentWithIdentifier:(NSString *)identifier URL:(NSURL *)URL options:(nullable NSDictionary *)options error:(NSError *__nullable *__nullable)error;
UNNotificationContentExtension
该扩展是为应用创建自定义的通知界面的。可以在UIViewController里设置界面，在didReceiveNotification方法中获得通知数据赋值界面。
创建NotificationContentExtension
UNNotificationContentExtension 的info.plist配置参数说明
| key | value |
|---|---|
| UNNotificationExtensionCategory(必填) | string值或Array值，自定义通知界面的标识符，系统会根据通知中category 的名称自动与该值匹配，匹配后会使用该自定义界面。设置为string则表示只有一个，设置为Array则表示有多个 |
| UNNotificationExtensionInitialContentSizeRatio(必填) | 浮点值，表示视图控制器视图的初始大小，表示为其高度与宽度的比率。加载自定义通知视图时，系统使用此值设置视图控制器的初始大小，以宽度为基数。例如，值为0.5时，表示 高度 = 宽度 * 0.5。值为2，表示 高度 = 宽度 * 2 |
| UNNotificationExtensionDefaultContentHidden | BOOL值，表示打开自定义通知界面的时候，是否隐藏默认通知的导航标题和内容，设置为YES时只显示自定义的内容，默认为NO |
| UNNotificationExtensionOverridesDefaultTitle | BOOL值，设置为YES时，系统将使用视图控制器的title属性作为通知的标题。设置为NO时，系统会将通知的标题设置为应用程序的名称。默认为NO |
| NSExtensionMainStoryboard | 自定义界面对应的SB文件名 |
| NSExtensionPointIdentifier | 是扩展的唯一标识，设置为com.apple.usernotifications.content-extension后会被系统识别为苹果通知的Content的扩展 |
| UNNotificationExtensionUserInteractionEnabledYES | BOOL类型，设置为YES后，自定义界面运行有交互行为，设置为NO的话点击自定义界面会直接打开App |
UNNotificationContentExtension
@protocol UNNotificationContentExtension <NSObject>
//接收即将显示的通知，在这里获取通知内容，然后根据通知信息处理显示通知界面
- (void)didReceiveNotification:(UNNotification *)notification;
@optional
/// 如果设置Action并实现了该方法，当用户点击了按钮的时候就会调用该方法，可以在该方法中处理点击事件
/// @param response 触发的事件响应体
/// @param completion 事件的处理结果，返回指示对通知的首选响应的常量。UNNotificationContentExtensionResponseOption枚举类型
/// UNNotificationContentExtensionResponseOptionDoNotDismiss:不要关闭通知界面
/// UNNotificationContentExtensionResponseOptionDismiss:关闭通知界面
/// UNNotificationContentExtensionResponseOptionDismissAndForwardAction:关闭通知界面，并将通知内容传递给App
- (void)didReceiveNotificationResponse:(UNNotificationResponse *)response completionHandler:(void (^)(UNNotificationContentExtensionResponseOption option))completion;
// Implementing this method and returning a button type other that "None" will
// make the notification attempt to draw a play/pause button correctly styled
// for that type.
//媒体播放按钮的类型
//UNNotificationContentExtensionMediaPlayPauseButtonTypeNone:没有播放按钮
//UNNotificationContentExtensionMediaPlayPauseButtonTypeDefault:播放和暂停的按钮
//部分透明的播放/暂停按钮，位于内容上方。该属性会导致mediaPlayPauseButtonTintColor属性无效。
//UNNotificationContentExtensionMediaPlayPauseButtonTypeOverlay
@property (nonatomic, readonly, assign) UNNotificationContentExtensionMediaPlayPauseButtonType mediaPlayPauseButtonType;
//设置媒体播放按钮的Frame，相对于媒体的尺寸
@property (nonatomic, readonly, assign) CGRect mediaPlayPauseButtonFrame;
// 设置媒体按钮的颜色
#if TARGET_OS_OSX
@property (nonatomic, readonly, copy) NSColor *mediaPlayPauseButtonTintColor;
#else
@property (nonatomic, readonly, copy) UIColor *mediaPlayPauseButtonTintColor;
#endif
// 播放
- (void)mediaPlay;
// 暂停
- (void)mediaPause;
@end
注意：因为UNNotificationServiceExtension与UNNotificationContentExtension是两个不同的target，沙盒路径不同。一般都是在UNNotificationServiceExtension中下载附件资源并保存在UNNotificationServiceExtension的沙盒路径，然后在UNNotificationContentExtension中接收附件的路径。因此要访问UNNotificationServiceExtension的路径需要使用startAccessingSecurityScopedResource与stopAccessingSecurityScopedResource
/* 例 */
- (void)didReceiveNotification:(UNNotification *)notification {
if (notification.request.content.attachments && notification.request.content.attachments.count > 0) {
UNNotificationAttachment *attachment = [notification.request.content.attachments firstObject];
//通过使用安全作用域解析创建的attachment数据而创建的NSURL，使url引用的资源可供进程访问。
//startAccessingSecurityScopedResource与stopAccessingSecurityScopedResource需成对出现
//当不再需要访问此资源时，客户端必须调用stopAccessingSecurityScopedResource
if ([attachment.URL startAccessingSecurityScopedResource]) {
NSData *imageData = [NSData dataWithContentsOfURL:attachment.URL];
self.imageView.image = [UIImage imageWithData:imageData];
[attachment.URL stopAccessingSecurityScopedResource];
}
}
}
UNNotificationAction
使用UNNotificationAction对象，可以定义在响应已发送通知时可以执行的操作。例如，会议App可能会定义会议邀请的接受或拒绝的操作，就可以用UNNotificationAction来设置接受和拒绝的按钮，直接在通知界面完成操作，而不用打开App进行操作，UNNotificationAction最多设置4个。
@interface UNNotificationAction : NSObject <NSCopying, NSSecureCoding>
// 事件的唯一标识
@property (NS_NONATOMIC_IOSONLY, copy, readonly) NSString *identifier;
// 事件的标题文本
@property (NS_NONATOMIC_IOSONLY, copy, readonly) NSString *title;
// 操作的配置
//UNNotificationActionOptionAuthenticationRequired:执行此操作前是否需要解锁
//UNNotificationActionOptionDestructive:该行为是否应被视为具有破坏性,文本会是红色
//UNNotificationActionOptionForeground:此操作是否应导致应用程序在前台启动
@property (NS_NONATOMIC_IOSONLY, readonly) UNNotificationActionOptions options;
// 事件的icon图片对象
@property (NS_NONATOMIC_IOSONLY, readonly, copy, nullable) UNNotificationActionIcon *icon API_AVAILABLE(macos(12.0), ios(15.0), watchos(8.0), tvos(15.0));
// 创建事件
+ (instancetype)actionWithIdentifier:(NSString *)identifier title:(NSString *)title options:(UNNotificationActionOptions)options;
+ (instancetype)actionWithIdentifier:(NSString *)identifier title:(NSString *)title options:(UNNotificationActionOptions)options icon:(nullable UNNotificationActionIcon *)icon API_AVAILABLE(macos(12.0), ios(15.0), watchos(8.0), tvos(15.0));
- (instancetype)init NS_UNAVAILABLE;
@end
UNNotificationActionIcon
//事件的关联图片
@interface UNNotificationActionIcon : NSObject <NSCopying, NSSecureCoding>
//使用应用里的图片作为事件的icon，图片需要放在asset中
+ (instancetype)iconWithTemplateImageName:(NSString *)templateImageName;
//使用系统图片作为icon
+ (instancetype)iconWithSystemImageName:(NSString *)systemImageName;
- (instancetype)init NS_UNAVAILABLE;
UNTextInputNotificationAction
//文本输入框
@interface UNTextInputNotificationAction : UNNotificationAction
// 事件中显示的文本输入按钮标题文本
@property (NS_NONATOMIC_IOSONLY, copy, readonly) NSString *textInputButtonTitle;
// 事件的文本输入框中的提示文本
@property (NS_NONATOMIC_IOSONLY, copy, readonly) NSString *textInputPlaceholder;
//创建文本输入框
+ (instancetype)actionWithIdentifier:(NSString *)identifier title:(NSString *)title options:(UNNotificationActionOptions)options textInputButtonTitle:(NSString *)textInputButtonTitle textInputPlaceholder:(NSString *)textInputPlaceholder;
+ (instancetype)actionWithIdentifier:(NSString *)identifier title:(NSString *)title options:(UNNotificationActionOptions)options icon:(nullable UNNotificationActionIcon *)icon textInputButtonTitle:(NSString *)textInputButtonTitle textInputPlaceholder:(NSString *)textInputPlaceholder API_AVAILABLE(macos(12.0), ios(15.0), watchos(8.0), tvos(15.0));
@end
UNNotificationCategory
@interface UNNotificationCategory : NSObject <NSCopying, NSSecureCoding>
// 当前category的唯一标识符。当UNNotificationCategory的标识符与UNNotificationRequest的categoryIdentifier匹配时，
//UNNotificationCategory的操作将显示在通知上。
@property (NS_NONATOMIC_IOSONLY, readonly, copy) NSString *identifier;
// 具体的操作数组，按数组里Action顺序显示操作
@property (NS_NONATOMIC_IOSONLY, readonly, copy) NSArray<UNNotificationAction *> *actions;
//支持的intents的类型
//详情可以查看<Intents/INIntentIdentifiers.h>
@property (NS_NONATOMIC_IOSONLY, readonly, copy) NSArray<NSString *> *intentIdentifiers;
//分配的配置，枚举
// 将关闭操作发送给通知代理
//UNNotificationCategoryOptionCustomDismissAction = (1 << 0),
// CarPlay是否支持此类通知，没用过
//UNNotificationCategoryOptionAllowInCarPlay API_UNAVAILABLE(macos) = (1 << 1),
// 如果用户已关闭预览，应显示标题
//UNNotificationCategoryOptionHiddenPreviewsShowTitle API_AVAILABLE(macos(10.14), ios(11.0)) API_UNAVAILABLE(watchos, tvos) = (1 << 2),
// 如果用户已关闭预览，应显示字幕
//UNNotificationCategoryOptionHiddenPreviewsShowSubtitle API_AVAILABLE(macos(10.14), ios(11.0)) API_UNAVAILABLE(watchos, tvos) = (1 << 3),
// 允许当前通知发布通知
//UNNotificationCategoryOptionAllowAnnouncement API_DEPRECATED("Announcement option is ignored", ios(13.0, 15.0), watchos(6.0, 7.0)) API_UNAVAILABLE(macos, tvos) = (1 << 4),
@property (NS_NONATOMIC_IOSONLY, readonly) UNNotificationCategoryOptions options;
// 当预览被隐藏时，会使用该字符串内容替换通知body进行显示
@property (NS_NONATOMIC_IOSONLY, readonly, copy) NSString *hiddenPreviewsBodyPlaceholder API_AVAILABLE(ios(11.0)) API_UNAVAILABLE(watchos, tvos);
///该属性是用于描述，来自此category的通知分组，它应该包含描述性文本和格式参数，这些参数将被替换为信息
///来自此分组的通知。将会把参数被替换为数字，以及通过在每个分组通知中加入参数而创建的列表。
///例如：“%u来自%@的新邮件”。
///参数列表是可选的，“%u条新消息”也被接受。
///格式化中的 %u和 %@,分别对应着NotificationService中的summaryArgumentCount与summaryArgument。
//summaryArgumentCount：该类型的通知摘要条数，一般由系统管理
//summaryArgument：通知摘要文本
@property (NS_NONATOMIC_IOSONLY, readonly, copy) NSString *categorySummaryFormat API_AVAILABLE(ios(12.0)) API_UNAVAILABLE(watchos, tvos);
// 创建通知分类
+ (instancetype)categoryWithIdentifier:(NSString *)identifier
actions:(NSArray<UNNotificationAction *> *)actions
intentIdentifiers:(NSArray<NSString *> *)intentIdentifiers
options:(UNNotificationCategoryOptions)options;
+ (instancetype)categoryWithIdentifier:(NSString *)identifier
actions:(NSArray<UNNotificationAction *> *)actions
intentIdentifiers:(NSArray<NSString *> *)intentIdentifiers
hiddenPreviewsBodyPlaceholder:(NSString *)hiddenPreviewsBodyPlaceholder
options:(UNNotificationCategoryOptions)options API_AVAILABLE(ios(11.0)) API_UNAVAILABLE(watchos, tvos);
+ (instancetype)categoryWithIdentifier:(NSString *)identifier
actions:(NSArray<UNNotificationAction *> *)actions
intentIdentifiers:(NSArray<NSString *> *)intentIdentifiers
hiddenPreviewsBodyPlaceholder:(nullable NSString *)hiddenPreviewsBodyPlaceholder
categorySummaryFormat:(nullable NSString *)categorySummaryFormat
options:(UNNotificationCategoryOptions)options API_AVAILABLE(ios(12.0)) API_UNAVAILABLE(watchos, tvos);
- (instancetype)init NS_UNAVAILABLE;
@end
扩展知识点
UNUserNotificationCenter
@interface UNUserNotificationCenter : NSObject
// 当前应用的通知代理对象
@property (NS_NONATOMIC_IOSONLY, nullable, weak) id <UNUserNotificationCenterDelegate> delegate;
// 当前设备是否支持内容扩展，YES表示支持
@property (NS_NONATOMIC_IOSONLY, readonly) BOOL supportsContentExtensions;
// 当前应用的通知
+ (UNUserNotificationCenter *)currentNotificationCenter;
- (instancetype)init NS_UNAVAILABLE;
// 应用需要用户授权才能通过本地和远程通知使用UNUserNotificationCenter通知用户
/// @param options 该值是用于想用户请求交互授权的配置
/// UNAuthorizationOptionBadge:授权更新App icon的能力,加角标
/// UNAuthorizationOptionSound:授权播放声音的能力
/// UNAuthorizationOptionAlert:授权显示报警的能力
/// UNAuthorizationOptionCarPlay:授权能在CarPlay中显示通知的能力
/// UNAuthorizationOptionCriticalAlert:授权能够播放警报声音的能力
/// UNAuthorizationOptionProvidesAppNotificationSettings:授权系统显示App通知设置按钮的能力
/// UNAuthorizationOptionProvisional:授权能够将无中断通知临时发布到通知中心的能力
/// UNAuthorizationOptionAnnouncement:不建议使用
/// UNAuthorizationOptionTimeSensitive :不建议使用
/// @param completionHandler granted 表示用户是否授权，error表示授权是发生的错误
- (void)requestAuthorizationWithOptions:(UNAuthorizationOptions)options completionHandler:(void (^)(BOOL granted, NSError *__nullable error))completionHandler;
// 设置当前通知的类别，用于显示哪些操作
- (void)setNotificationCategories:(NSSet<UNNotificationCategory *> *)categories API_UNAVAILABLE(tvos);
//获取通知类别信息
- (void)getNotificationCategoriesWithCompletionHandler:(void(^)(NSSet<UNNotificationCategory *> *categories))completionHandler API_UNAVAILABLE(tvos);
// 获取App通知设置
- (void)getNotificationSettingsWithCompletionHandler:(void(^)(UNNotificationSettings *settings))completionHandler;
// 添加一个通知请求对象，将用相同的标识符的通知请求替换未当前添加的通知请求。
// 如果标识符为现有已送达的通知，通知请求将针对新通知请求发出警报，并在触发时替换现有已送达通知
// app中未送达通知请求的数量受系统限制，具体的限制还未测试过
- (void)addNotificationRequest:(UNNotificationRequest *)request withCompletionHandler:(nullable void(^)(NSError *__nullable error))completionHandler;
// 获取未送达的通知请求
- (void)getPendingNotificationRequestsWithCompletionHandler:(void(^)(NSArray<UNNotificationRequest *> *requests))completionHandler;
// 根据通知请求的唯一标识移除未送达的通知
- (void)removePendingNotificationRequestsWithIdentifiers:(NSArray<NSString *> *)identifiers;
// 移除所有未送达的通知
- (void)removeAllPendingNotificationRequests;
// 获取已送达并保留在通知中心的通知
- (void)getDeliveredNotificationsWithCompletionHandler:(void(^)(NSArray<UNNotification *> *notifications))completionHandler API_UNAVAILABLE(tvos);
// 根据通知的唯一标识移除已送达的通知
- (void)removeDeliveredNotificationsWithIdentifiers:(NSArray<NSString *> *)identifiers API_UNAVAILABLE(tvos);
// 移除所有已送达的通知
- (void)removeAllDeliveredNotifications API_UNAVAILABLE(tvos);
@end
//当前app的通知代理
@protocol UNUserNotificationCenterDelegate <NSObject>
@optional
/// 只有App处于前台的时候才会调用该方法，如果为实现该方法或者为及时执行completionHandler，则不会显示该条通知。
/// App可以通过返回的options决定通知显示的方式。
/// @param center 当前App的通知管理对象
/// @param notification 通知
/// @param completionHandler options：指示如何在前台应用程序中显示通知的常量
/// UNNotificationPresentationOptionBadge:将通知的角标值应用于App的icon
/// UNNotificationPresentationOptionSound:播放与通知相关的声音
/// UNNotificationPresentationOptionAlert:不建议使用
/// UNNotificationPresentationOptionList:在通知中心显示通知
/// UNNotificationPresentationOptionBanner:以横幅形式显示通知
- (void)userNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(UNNotificationPresentationOptions options))completionHandler API_AVAILABLE(macos(10.14), ios(10.0), watchos(3.0), tvos(10.0));
// 当用户通过打开App、拒绝通知或选择不通知的操作来响应通知时
// 将对委托调用该方法。通知的代理必须在didFinishLaunchingWithOptions:之前设置
- (void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void(^)(void))completionHandler API_AVAILABLE(macos(10.14), ios(10.0), watchos(3.0)) API_UNAVAILABLE(tvos);
// 当App响应用户查看应用内通知设置的请求而启动时,代理将调用该方法
// 添加未授权选项将AppNotificationSettings作为requestAuthorizationWithOptions:completionHandler中的选项提供
// 将按钮添加到“设置”中的“内联通知设置”视图和“通知设置”视图中。从设置打开时，通知将为零。
- (void)userNotificationCenter:(UNUserNotificationCenter *)center openSettingsForNotification:(nullable UNNotification *)notification API_AVAILABLE(macos(10.14), ios(12.0)) API_UNAVAILABLE(watchos, tvos);
@end
通知消息体说明
{
aps = {//消息推送的主题内容
alert = {//推送的弹窗显示内容
body = "\U5b87\U4f73\U7684\U5185\U5bb9”;//显示的内容文本
title = "\U5b87\U4f73\U7684\U6807\U9898”;//显示的标题文本
};
sound = default;//通知的声音
category = myImageNotificationCategory；//通知对应的自定义Content标识
thread-id = 10923；//通知分组的id
mutable-content = 1；//通知是否走自定义内容的标记，只有该值设置为1的时候才会走扩展内容，否则走系统通知
};
}
后续会补充一下 如何在Service和Content里引用其他工程资源
示例代码
#import "NotificationService.h"
//语音播放需要
#import <AVFoundation/AVFoundation.h>
@interface NotificationService () <AVSpeechSynthesizerDelegate>
//用于告知系统已经处理完成，可以将通知内容传给App的回调对象。
//该对象需要返回一个UNMutableNotificationContent对象。一般都是返回bestAttemptContent
@property (nonatomic, strong) void (^contentHandler)(UNNotificationContent *contentToDeliver);
//通知消息的内容对象，里面包含了通知相关的所有信息。一般有title、body、subTitle。
//如果是服务端封装的扩展参数，则一般都在userInfo中。
@property (nonatomic, strong) UNMutableNotificationContent *bestAttemptContent;
@property (nonatomic, strong) AVSpeechSynthesisVoice *synthesisVoice;
@property (nonatomic, strong) AVSpeechSynthesizer *synthesizer;
//资源文件
@property (nonatomic, strong) NSMutableArray<UNNotificationAttachment *> *attachments;
@end
@implementation NotificationService
/// 可以通过重写此方法来实现自定义推送通知修改。
///如果要使用修改后的通知内容，则需要在该方法中调用contentHandler传递修改后的通知内容。如果在服务时间(30秒)到期之前未调用处理程序contentHandler，则将传递未修改的通知。
/// @param request 通知内容
/// @param contentHandler 处理结果，需要返回一个UNNotificationContent的通知内容
- (void)didReceiveNotificationRequest:(UNNotificationRequest *)request withContentHandler:(void (^)(UNNotificationContent * _Nonnull))contentHandler {
//接收回调对象
self.contentHandler = contentHandler;
//将收到的通知内容 copy并赋值到对象属性中，向下传递
self.bestAttemptContent = [request.content mutableCopy];
//获取通知信息
NSDictionary *userInfo = request.content.userInfo;
if (userInfo) {
//获取通知中aps信息
NSDictionary *aps = [userInfo objectForKey:@"aps"];
NSDictionary *params = [userInfo objectForKey:@"params"];
if (aps && params) {
NSString *type = [params objectForKey:@"myNotificationType"];
if (type) {
BOOL isActionContentHandler = YES;
if ([type isEqualToString:@"HYJFileTypeImage"]) {//下载图片
[self downFileWithUrl:[aps objectForKey:@"imageUrl"] withFileType:@"HYJFileTypeImage"];
} else if ([type isEqualToString:@"HYJFileTypeSound"]) {//下载音频文件
[self downFileWithUrl:[aps objectForKey:@"imageUrl"] withFileType:@"HYJFileTypeImage"];
[self downFileWithUrl:[params objectForKey:@"soundUrl"] withFileType:@"HYJFileTypeSound"];
} else if ([type isEqualToString:@"HYJFileTypeVideo"]) {//下载视频
[self downFileWithUrl:[params objectForKey:@"videoUrl"] withFileType:@"HYJFileTypeVideo"];
} else if ([type isEqualToString:@"pay"]) {//支付播报
if (@available(iOS 12.1,*)) {
//背景：12.1以后苹果不允许在Service中合成语音或文字转语音
//方案1，使用VOIP，唤醒App，由App完成语音的播报
//方案2，收到远程通知后，循环发送本地通知，通知中播放本地拆分开的音频文件，这样可以减少音频文件的数量
//方案3，本地预置大量的音频文件，例如：“支付宝收款100元.mp3”。包的体积会很大
//方案4，服务端生成tts文件，客户端在Service里下载，然后设置通知的声音为tts文件 (目前采用的方案)
NSURL *saveUrl = [self downFile:[params objectForKey:@"soundUrl"] withFileType:@"HYJFileTypeSound"];
UNNotificationSound *sound = [UNNotificationSound soundNamed:saveUrl.absoluteString];
self.bestAttemptContent.sound = sound;
} else {
isActionContentHandler = NO;
[self playPaySound:[params objectForKey:@"pay"] isPayments:NO];
}
} else if ([type isEqualToString:@"payments"]) {//收款播报
isActionContentHandler = NO;
[self playPaySound:[params objectForKey:@"payments"] isPayments:NO];
}
if (self.attachments.count > 0) {
self.bestAttemptContent.attachments = self.attachments;
}
if (isActionContentHandler) {
self.contentHandler(self.bestAttemptContent);
}
} else {
self.contentHandler(self.bestAttemptContent);
}
} else {
self.contentHandler(self.bestAttemptContent);
}
} else {
self.contentHandler(self.bestAttemptContent);
}
}
//当didReceiveNotificationRequest的方法执行超过30秒未调用contentHandler时
//系统会自动调用serviceExtensionTimeWillExpire方法，给我们最后一次弥补处理的机会
//可以在serviceExtensionTimeWillExpire方法中设置didReceiveNotificationRequest方法中未完成数据的默认值
- (void)serviceExtensionTimeWillExpire {
self.contentHandler(self.bestAttemptContent);
}
#pragma mark - Private Method
/// 下载文件
/// @param urlString 文件的url
/// @param type 文件的类型
- (void)downFileWithUrl:(NSString *)urlString withFileType:(NSString *)type
{
if (!urlString || urlString.length <= 0) {
return;
}
//传给自定义通知栏的URL
NSURL *saveUrl = [self downFile:urlString withFileType:type];
if (!saveUrl) {
return;
}
UNNotificationAttachment *attachment;
if ([type isEqualToString:@"HYJFileTypeVideo"]) {
NSDictionary *options = @{@"UNNotificationAttachmentOptionsTypeHintKey":@"kUTTypeMPEG",@"UNNotificationAttachmentOptionsThumbnailHiddenKey":[NSNumber numberWithBool:NO],@"UNNotificationAttachmentOptionsThumbnailTimeKey":[NSNumber numberWithInt:2]};
attachment = [UNNotificationAttachment attachmentWithIdentifier:@"attachment" URL:saveUrl options:options error:nil];
} else if ([type isEqualToString:@"HYJFileTypeSound"]) {
NSDictionary *options = @{@"UNNotificationAttachmentOptionsTypeHintKey":@"kUTTypeMP3"};
attachment = [UNNotificationAttachment attachmentWithIdentifier:@"attachment" URL:saveUrl options:options error:nil];
} else {//暂时未考虑动图
attachment = [UNNotificationAttachment attachmentWithIdentifier:@"attachment" URL:saveUrl options:nil error:nil];
}
if (attachment) {
[self.attachments addObject:attachment];
}
// });
}
/// 播放支付声音
/// @param money 价格
- (void)playPaySound:(NSString *)money isPayments:(BOOL)isPayments
{
if (!money || money.length <=0) {
self.contentHandler(self.bestAttemptContent);
return;
}
NSString *payStr = @"";
if (isPayments) {
payStr = [NSString stringWithFormat:@"您在App中收到了 %@ 元",money];
} else {
payStr = [NSString stringWithFormat:@"您在App中支付了 %@ 元",money];
}
[self playSoundText:payStr];
}
- (void)playSoundText:(NSString *)text
{
//文本内容不宜过长，超过30秒会播报不完整，具体的播报字数与播放速度需要自己计算
AVSpeechUtterance *utterance = [AVSpeechUtterance speechUtteranceWithString:text];
[self.synthesizer stopSpeakingAtBoundary:(AVSpeechBoundaryImmediate)];
utterance.rate = 1;
utterance.voice = self.synthesisVoice;
[self.synthesizer speakUtterance:utterance];
}
/// 下载文件
/// @param urlString 文件的url路径
/// @param type 文件的类型
- (NSURL *)downFile:(NSString *)urlString withFileType:(NSString *)type
{
//1. 下载
// dispatch_queue_t queue = dispatch_queue_create("yujia_notification_queue", DISPATCH_QUEUE_SERIAL);
// dispatch_async(queue, ^{
//下载图片数据
NSURL *url = [NSURL URLWithString:urlString];
NSError *error;
/**
注：
dataWithContentsOfURL方法是同步方法，一般不建议用来请求基于网络的URL。对于基于网络的URL，此方法可以在慢速网络上阻止当前线程数十秒，会导致用户体验不佳，并且可能会导致应用程序终止。
*/
NSData *fileData = [NSData dataWithContentsOfURL:url options:NSDataReadingMappedIfSafe error:&error];
if (error) {
return nil;
}
//确定文件保存路径，这里要注意文件是保存在NotificationService这个应用沙盒中，并不是保存在主应用中
NSString *userDocument = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) objectAtIndex:0];
//附件保存的路径
NSString *path = @"";
if ([type isEqualToString:@"HYJFileTypeImage"]) {
path = [NSString stringWithFormat:@"%@/notification.jpg", userDocument];
} else if ([type isEqualToString:@"HYJFileTypeSound"])
{
path = [NSString stringWithFormat:@"%@/notification.mp3", userDocument];
} else if ([type isEqualToString:@"pay"]){
path = [self getFilePath];
} else {
path = [NSString stringWithFormat:@"%@/notification.mp4", userDocument];
}
//先删除老的文件
[[NSFileManager defaultManager] removeItemAtPath:path error:nil];
//再保存新文件
[fileData writeToFile:path atomically:YES];
//传给自定义通知栏的URL
NSURL *saveUrl = [NSURL fileURLWithPath:path];
return saveUrl;
}
- (NSString *)getFilePath
{
NSString *filePath = @"";
//通过App组，获取主App沙盒路径l
NSURL *groupURL = [[NSFileManager defaultManager] containerURLForSecurityApplicationGroupIdentifier:@"group.com.yujia.mpaas.demo"];
NSString *groupPath = [groupURL path];
//获取的文件路径
filePath = [groupPath stringByAppendingPathComponent:@"Library/Sounds"];
NSFileManager *fileManager = [NSFileManager defaultManager];
if (![fileManager fileExistsAtPath:filePath])
{
NSError *error;
[fileManager createDirectoryAtPath:filePath withIntermediateDirectories:NO attributes:nil error:&error];
if (error) {
NSLog(@"error:%@",error);
}
}
NSString *pathFile = [NSString stringWithFormat:@"%@/%@",filePath,@"pay.wav"];
return pathFile;
}
#pragma mark - AVSpeechSynthesizerDelegate
// 新增语音播放代理函数，在语音播报完成的代理函数中，我们添加下面的一行代码
- (void)speechSynthesizer:(AVSpeechSynthesizer *)synthesizer didFinishSpeechUtterance:(AVSpeechUtterance *)utterance {
// 语音播放完成后调用
self.contentHandler(self.bestAttemptContent);
}
#pragma mark - LazyLoad
- (AVSpeechSynthesisVoice *)synthesisVoice {
if (!_synthesisVoice) {
_synthesisVoice = [AVSpeechSynthesisVoice voiceWithLanguage:@"zh-CN"];
}
return _synthesisVoice;
}
- (AVSpeechSynthesizer *)synthesizer {
if (!_synthesizer) {
_synthesizer = [[AVSpeechSynthesizer alloc] init];
_synthesizer.delegate = self;
}
return _synthesizer;
}
- (NSMutableArray<UNNotificationAttachment *> *)attachments
{
if (!_attachments) {
_attachments = [NSMutableArray new];
}
return _attachments;
}
@end
#import "NotificationViewController.h"
#import <UserNotifications/UserNotifications.h>
#import <UserNotificationsUI/UserNotificationsUI.h>
#import "HYJImageCell.h"
#import "HYJSoundCell.h"
#import "HYJVideoCell.h"
#import <Masonry/Masonry.h>
#import <AVFoundation/AVFoundation.h>
#define PRAISE @"myImageNotificationCategory_action_praise"
#define STARTAPP @"myImageNotificationCategory_action_startApp"
#define CANCEL @"myImageNotificationCategory_action_cancel"
#define InputText @"myImageNotificationCategory_action_inputText1"
@interface NotificationViewController () <UNNotificationContentExtension, UITableViewDelegate, UITableViewDataSource>
/** tableView */
@property (nonatomic, strong) UITableView *tableView;
/** 数据源 */
@property (nonatomic, strong) NSMutableArray *dataArray;
/** 当前数据类型 */
@property (nonatomic, copy) NSString *type;
//Action的回调
@property (nonatomic, strong) void (^completion)(UNNotificationContentExtensionResponseOption option);
//播放器
@property (nonatomic , strong) AVPlayer *avPlayer;
//
@property (nonatomic , strong) AVAudioSession *audioSession;
//播放器视图
@property (nonatomic , strong) AVPlayerLayer *playerLayer;
@end
@implementation NotificationViewController
- (void)viewDidLoad {
[super viewDidLoad];
// Do any required interface initialization here.
/** tableView */
self.tableView = [UITableView new];
[self.view addSubview:self.tableView];
// [self.tableView mas_makeConstraints:^(MASConstraintMaker *make) {
// make.edges.equalTo(self.view);
// }];
self.tableView.frame = self.view.frame;
self.tableView.backgroundColor = [UIColor clearColor];
self.tableView.delegate = self;
self.tableView.dataSource = self;
self.tableView.separatorStyle = UITableViewCellSeparatorStyleNone;
[self.tableView registerClass:[HYJImageCell class] forCellReuseIdentifier:@"HYJImageCell"];
[self.tableView registerClass:[HYJSoundCell class] forCellReuseIdentifier:@"HYJSoundCell"];
[self.tableView registerClass:[HYJVideoCell class] forCellReuseIdentifier:@"HYJVideoCell"];
}
#pragma mark - UNNotificationContentExtension
//当通知中category与当前推送扩展的UNNotificationExtensionCategory相同时
//该方法将被调用，用于接收通知的内容进行展示
- (void)didReceiveNotification:(UNNotification *)notification {
if (notification.request.content.attachments && notification.request.content.attachments.count > 0) {
//获取通知信息
NSDictionary *userInfo = notification.request.content.userInfo;
if (userInfo) {
//获取通知中aps信息
NSDictionary *aps = [userInfo objectForKey:@"aps"];
NSDictionary *params = [userInfo objectForKey:@"params"];
if (aps && params) {
UNNotificationAttachment *attachment = [notification.request.content.attachments firstObject];
NSString *type = [params objectForKey:@"myNotificationType"];
if (type) {
self.type = type;
if([type isEqualToString:@"HYJFileTypeImage"]) {
//通过使用安全作用域解析创建的attachment数据而创建的NSURL，使url引用的资源可供进程访问。
//startAccessingSecurityScopedResource与stopAccessingSecurityScopedResource需成对出现
//当不再需要访问此资源时，客户端必须调用stopAccessingSecurityScopedResource
[self setImageCategory];
if ([attachment.URL startAccessingSecurityScopedResource]) {
NSData *imageData = [NSData dataWithContentsOfURL:attachment.URL];
[self.dataArray removeAllObjects];
[self.dataArray addObject:[UIImage imageWithData:imageData]];
[attachment.URL stopAccessingSecurityScopedResource];
}
} else if ([type isEqualToString:@"HYJFileTypeSound"]) {
if (notification.request.content.attachments.count >= 2) {
[self setSoundCategory];
if ([attachment.URL startAccessingSecurityScopedResource]) {
NSData *imageData = [NSData dataWithContentsOfURL:attachment.URL];
[self.dataArray removeAllObjects];
[self.dataArray addObject:[UIImage imageWithData:imageData]];
[attachment.URL stopAccessingSecurityScopedResource];
}
UNNotificationAttachment *soundAttachment = [notification.request.content.attachments lastObject];
[self createrMediaPlay:YES withUlr:soundAttachment.URL];
}
} else if ([type isEqualToString:@"HYJFileTypeVideo"]) {
[self setSoundCategory];
[self createrMediaPlay:NO withUlr:attachment.URL];
[self.dataArray removeAllObjects];
[self.dataArray addObject:attachment.URL];
}
[self.tableView reloadData];
}
}
}
}
}
/// 当实现了Actions点击事件时，用户点击后将会回调该方法
- (void)didReceiveNotificationResponse:(UNNotificationResponse *)response completionHandler:(void (^)(UNNotificationContentExtensionResponseOption option))completion
{
self.completion = completion;
//获取通知信息
NSDictionary *userInfo = response.notification.request.content.userInfo;
if (userInfo) {
//获取通知中aps信息
NSDictionary *aps = [userInfo objectForKey:@"aps"];
if (aps && self.type) {
// NSString *type = [aps objectForKey:@"myNotificationType"];
NSString *identifier = response.actionIdentifier;
if ([self.type isEqualToString:@"HYJFileTypeImage"]) {
[self actionImageWithIdentifier:identifier];
} else if ([self.type isEqualToString:@"HYJFileTypeSound"]) {
[self actionSoundWithResponse:response];
} else if ([self.type isEqualToString:@"HYJFileTypeVideo"]) {
[self actionVideoWithIdentifier:identifier];
}
}
}
}
- (UNNotificationContentExtensionMediaPlayPauseButtonType)mediaPlayPauseButtonType
{
// return UNNotificationContentExtensionMediaPlayPauseButtonTypeDefault;
//该属性会导致mediaPlayPauseButtonTintColor无效
return UNNotificationContentExtensionMediaPlayPauseButtonTypeOverlay;
}
- (CGRect)mediaPlayPauseButtonFrame
{
CGFloat width = self.view.frame.size.width;
if (self.view.frame.size.width > self.view.frame.size.height) {
width = self.view.frame.size.height;
}
return CGRectMake((self.view.frame.size.width-width/2)/2, (self.view.frame.size.height-width/2)/2, width/2, width/2);
}
- (UIColor *)mediaPlayPauseButtonTintColor
{
return [UIColor orangeColor];
}
- (void)mediaPlay
{
if (self.avPlayer) {
[self.avPlayer play];
}
}
- (void)mediaPause
{
if (self.avPlayer) {
[self.avPlayer pause];
}
}
#pragma mark - UITableViewDelegate, UITableViewDataSource
- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath
{
if ([self.type isEqualToString:@"HYJFileTypeImage"])
{
HYJImageCell *cell = [tableView dequeueReusableCellWithIdentifier:@"HYJImageCell"];
if (!cell) {
cell = [[HYJImageCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:@"HYJImageCell"];
}
[cell setCellImage:[self.dataArray firstObject]];
return cell;
} else if ([self.type isEqualToString:@"HYJFileTypeSound"]) {
HYJSoundCell *cell = [tableView dequeueReusableCellWithIdentifier:@"HYJSoundCell"];
if (!cell) {
cell = [[HYJSoundCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:@"HYJSoundCell"];
}
// [cell setSoundUrl:[self.dataArray firstObject]];
cell.coverImageView.frame = CGRectMake(0, 0, self.view.frame.size.width, self.view.frame.size.height);
[cell setCellImage:[self.dataArray firstObject]];
return cell;
} else {
HYJVideoCell *cell = [tableView dequeueReusableCellWithIdentifier:@"HYJVideoCell"];
if (!cell) {
cell = [[HYJVideoCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:@"HYJVideoCell"];
}
if (self.playerLayer) {
[cell.layer addSublayer:self.playerLayer];
}
return cell;
}
}
- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView
{
return 1;
}
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section
{
return self.dataArray.count;
}
- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath
{
[tableView deselectRowAtIndexPath:indexPath animated:YES];
}
- (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath
{
if ([self.type isEqualToString:@"HYJFileTypeImage"]) {
UIImage *image = [self.dataArray firstObject];
if (image) {
CGSize imageSize = image.size;
if (imageSize.width > viewW) {
imageSize.height = imageSize.width/viewW*viewH;
}
return imageSize.height+10;
} else {
return 0;
}
} else if ([self.type isEqualToString:@"HYJFileTypeSound"]) {
return self.view.frame.size.height;
} else {
return 250;
}
}
#pragma mark - NSNotificationCenter
- (void)playDidEnd:(NSNotification*)notification
{
//重置播放
AVPlayerItem *item = [notification object];
//设置从0开始
[item seekToTime:kCMTimeZero];
//播放往后，状态设置为暂停
[self.extensionContext mediaPlayingPaused];
}
#pragma mark - Private Method
- (void)setImageCategory
{
UNNotificationAction *praiseAction = [UNNotificationAction actionWithIdentifier:PRAISE title:@"点赞" options:UNNotificationActionOptionAuthenticationRequired];
UNNotificationAction *startAppAction = [UNNotificationAction actionWithIdentifier:STARTAPP title:@"查看详情" options:UNNotificationActionOptionForeground];
UNNotificationAction *cancelAction = [UNNotificationAction actionWithIdentifier:CANCEL title:@"取消" options:UNNotificationActionOptionDestructive];
NSArray *actionArray = @[praiseAction,startAppAction,cancelAction];
UNNotificationCategory *category;
if (@available(iOS 12.0,*)) {
//myImageNotificationCategory_01
category = [UNNotificationCategory categoryWithIdentifier:@"myImageNotificationCategory" actions:actionArray intentIdentifiers:@[] hiddenPreviewsBodyPlaceholder:nil categorySummaryFormat:@"宇佳测试，您还有%u条来自%@的消息" options:UNNotificationCategoryOptionCustomDismissAction];
} else {
category = [UNNotificationCategory categoryWithIdentifier:@"myImageNotificationCategory_01" actions:actionArray intentIdentifiers:@[] options:UNNotificationCategoryOptionCustomDismissAction];
}
NSSet *sets = [NSSet setWithObject:category];
[[UNUserNotificationCenter currentNotificationCenter] setNotificationCategories:sets];
}
- (void)setSoundCategory
{
UNTextInputNotificationAction *inputTextAction = [UNTextInputNotificationAction actionWithIdentifier:InputText title:@"评论" options:UNNotificationActionOptionAuthenticationRequired textInputButtonTitle:@"发送" textInputPlaceholder:@"请输入评论内容"];
UNNotificationAction *playAction = [UNNotificationAction actionWithIdentifier:@"play" title:@"播放" options:UNNotificationActionOptionAuthenticationRequired];
UNNotificationAction *pausedAction = [UNNotificationAction actionWithIdentifier:@"paused" title:@"暂停" options:UNNotificationActionOptionForeground];
UNNotificationAction *cancelAction = [UNNotificationAction actionWithIdentifier:CANCEL title:@"取消" options:UNNotificationActionOptionDestructive];
NSArray *actionArray = @[inputTextAction,playAction,pausedAction,cancelAction];
UNNotificationCategory *category;
if (@available(iOS 12.0,*)) {
category = [UNNotificationCategory categoryWithIdentifier:@"myImageNotificationCategory" actions:actionArray intentIdentifiers:@[] hiddenPreviewsBodyPlaceholder:nil categorySummaryFormat:@"宇佳测试，您还有%u条来自%@的消息" options:UNNotificationCategoryOptionCustomDismissAction];
} else {
category = [UNNotificationCategory categoryWithIdentifier:@"myImageNotificationCategory_01" actions:actionArray intentIdentifiers:@[] options:UNNotificationCategoryOptionCustomDismissAction];
}
NSSet *sets = [NSSet setWithObject:category];
[[UNUserNotificationCenter currentNotificationCenter] setNotificationCategories:sets];
}
- (void)actionImageWithIdentifier:(NSString *)identifier
{
if ([identifier isEqualToString:PRAISE]) {
self.completion(UNNotificationContentExtensionResponseOptionDoNotDismiss);
//dosomething
} else if ([identifier isEqualToString:STARTAPP]) {
self.completion(UNNotificationContentExtensionResponseOptionDismissAndForwardAction);
if (@available(iOS 12.0,*)) {
[self.extensionContext performNotificationDefaultAction];
}
} else if ([identifier isEqualToString:CANCEL]) {
self.completion(UNNotificationContentExtensionResponseOptionDismiss);
if (@available(iOS 12.0,*)) {
[self.extensionContext dismissNotificationContentExtension];
}
}
}
- (void)actionSoundWithResponse:(UNNotificationResponse *)response
{
NSString *identifier = response.actionIdentifier;
if ([identifier isEqualToString:InputText]) {
UNTextInputNotificationResponse *inputAction = (UNTextInputNotificationResponse *)response;
NSLog(@"输入内容：%@",inputAction.userText);
self.completion(UNNotificationContentExtensionResponseOptionDismiss);
} else if ([identifier isEqualToString:@"play"]) {
self.completion(UNNotificationContentExtensionResponseOptionDoNotDismiss);
} else if ([identifier isEqualToString:@"paused"]) {
self.completion(UNNotificationContentExtensionResponseOptionDoNotDismiss);
} else if ([identifier isEqualToString:CANCEL]) {
self.completion(UNNotificationContentExtensionResponseOptionDismiss);
if (@available(iOS 12.0,*)) {
[self.extensionContext dismissNotificationContentExtension];
}
}
}
- (void)actionVideoWithIdentifier:(NSString *)identifier
{
self.completion(UNNotificationContentExtensionResponseOptionDismiss);
}
/*!
计算文本size
@param text 文本
@param size 最大size
@param font 字体大小
@return 文本size
*/
- (CGSize)autoLabelSize:(NSString *)text maxSize:(CGSize)size font:(CGFloat)font
{
CGRect rect = [text boundingRectWithSize:size options:NSStringDrawingUsesLineFragmentOrigin attributes:@{NSFontAttributeName:[UIFont systemFontOfSize:font]} context:nil];
CGSize lastSize = CGSizeMake(ceilf(rect.size.width), ceilf(rect.size.height));
return lastSize;
}
/// 创建媒体播放对象
/// @param isSound 是否创建音频播放 YES表示仅音频 NO表示播放音视频
/// @param url 资源文件的本地url
- (void)createrMediaPlay:(BOOL)isSound withUlr:(NSURL *)url
{
if ([url startAccessingSecurityScopedResource]) {
AVAsset *asset = [AVAsset assetWithURL:url];
AVPlayerItem *playerItem = [[AVPlayerItem alloc] initWithAsset:asset];
if (!self.avPlayer) {
self.avPlayer = [[AVPlayer alloc] initWithPlayerItem:playerItem];
} else {
[self.avPlayer replaceCurrentItemWithPlayerItem:playerItem];
}
self.audioSession = [AVAudioSession sharedInstance];
[self.audioSession setCategory:AVAudioSessionCategoryPlayback withOptions:(AVAudioSessionCategoryOptionDuckOthers) error:nil];
[self.audioSession setActive:YES error:nil];
if (!isSound) {
self.playerLayer = [AVPlayerLayer playerLayerWithPlayer:self.avPlayer];
self.playerLayer.frame = self.view.bounds;//放置播放器的视图
}
//监听音频播放完成
[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(playDidEnd:) name:AVPlayerItemDidPlayToEndTimeNotification object:self.avPlayer.currentItem];
[url stopAccessingSecurityScopedResource];
}
}
#pragma mark - LazyLoad
- (NSMutableArray *)dataArray
{
if (!_dataArray) {
_dataArray = [NSMutableArray new];
}
return _dataArray;
}
@end
