用途:为 iOS/macOS 推送通知开发提供集中式 API 参考,涵盖 APNs HTTP/2 传输、UserNotifications 框架,以及 Live Activities、广播推送等推送驱动特性。
主要能力:
- APNs 传输:开发/生产端点(api.sandbox.push.apple.com、api.push.apple.com,端口 443 或 2197),POST /3/device/{device_token} 请求格式,apns-push-type、apns-topic、apns-priority、apns-expiration、apns-collapse-id 等请求头,以及 200/400/403/404/405/410/413/429/500/503 响应码含义。
- JWT 鉴权:ES256(P-256)算法、.p8 签名密钥、iss/iat 声明、令牌最长 1 小时、建议 20–60 分钟刷新,authorization: bearer {JWT} 头格式。
- Payload 参考:aps 字典键(alert、badge、sound、thread-id、category、content-available、mutable-content、interruption-level、relevance-score、stale-date、content-state、event 等)、alert 子键、critical 声音字典、interruption-level 取值,以及基础、本地化、静默、富媒体、critical、time-sensitive 等示例 payload。
- UNUserNotificationCenter:授权请求、设置检查、调度与取消、已送达通知管理、分类注册、角标更新;UNAuthorizationOptions 与 UNAuthorizationStatus 取值;前台展示与响应处理等代理方法。
- 分类与操作:UNNotificationCategory、UNNotificationAction、UNTextInputNotificationAction、操作与分类选项、UNNotificationActionIcon(iOS 15+)。
- 服务扩展:UNNotificationServiceExtension 生命周期、didReceive 与 serviceExtensionTimeWillExpire 实现、附件类型与大小限制,需 payload 含 mutable-content: 1。
- 本地通知:时间间隔、日历、位置三类触发器及示例,最小重复间隔 60 秒,位置触发需定位授权。
使用方式:作为开发参考查阅,按需复制示例代码到 AppDelegate、通知服务扩展或本地通知调度逻辑中。
限制:资料未提供安装命令、收费、价格、平台支持范围与效果数据;本地通知部分内容在资料中未完整给出。