SuperAPI AI 工具集

push-notifications

通用与其它

查看项目

更新于 10-15 23:44

技能介绍

用途:为 iOS/tvOS 推送通知提供决策框架,而非 API 教学。Claude 已了解 UNUserNotificationCenter 与 APNs,本技能补充权限时机、投递策略与架构取舍的判断依据。

主要能力:以决策树形式覆盖四类问题。权限请求时机:用户主动点击启用按钮时接受率最高(70-80%),展示价值后请求约 50-60%,引导流程后约 30-40%,App 启动时最低(15-20%)应避免。静默与可见通知取舍:后台数据同步用静默(content-available: 1),需即时知晓用可见提醒,非紧急信息用角标加静默,需用户操作用带操作按钮的可见通知。通知扩展策略:下载媒体或解密端到端加密内容用 Notification Service Extension(mutable-content: 1),自定义 UI 用 Notification Content Extension,标准文本与角标无需扩展。令牌管理:单设备替换令牌,多设备注册全部令牌,重装或恢复后服务端去重,登出时解绑令牌。

必要用法与关键约束:不要在启动时无上下文请求权限;不要忽略已拒绝状态,应引导至系统设置;不要长期缓存设备令牌,始终使用注册回调中的新令牌;不要用 String(data:encoding:) 转换令牌,应转为十六进制;不要依赖静默通知做时间敏感投递;不要在静默处理中做重活,应快速取元数据并转 BGProcessingTask;Service Extension 必须实现 serviceExtensionTimeWillExpire,约 30 秒内交付已有内容。

适用场景:设计推送权限流程、选择通知类型、规划扩展架构、处理多设备令牌与富通知媒体时。

限制:资料未提供具体平台版本要求、tvOS 差异细节、服务端实现方案及收费信息。