Products
96SEO 2026-08-09 09:30 17
Live Activity 是 Apple 在 iOS 16 引入的程序级能力。其实，它让 App 能在锁屏和灵动岛上持续展示「正在进行中」的任务状态——外卖配送进度、比赛比分、打车 ETA 等。
User Pain Point: 传统通知只能一次性弹出，无法持续展示实时变化；者需要一种更贴近使用者使用习惯的交互方式。
和传统通知的区别：
| 维度 | 普通推送通知 | Live Activity |
|---|---|---|
| 展示时长弹出后很快消失最长在灵动岛保留 小时锁屏最长 小时信息密度标题 + 正文自定义 SwiftUI 布局，可展示结构化数据更新方式每次一条新通知同一条活动原地刷新。程序做过渡动画使用者操作点开进 App可点击灵动岛/锁屏卡片直接跳转 | ||
| 更新时间方式 每次更新 / APNs 推送 / 本地 update / end | ||
| 可交互 仅限点击进入 App | ||
| # |
Live Activity 横跨两个 Target，理解这个分工是避免「改了代码但界面不变」的第一步先。
| 关键认知： |
|---|
| 最低版本 iOS | iOS + 支持 push-to-start设备iPhone；灵动岛仅 iPhone Pro 及以上「药丸屏」机型证书远程推送更新必须使用 APNs Auth Key ,不支持旧式 push 证书 | . | |
|---|---|---|
| 限制说明： | 详情： | ||
|---|---|---|---|
| // 数据大小 每次传给 LA 的 payload 不超过 $\le$ $4KB$ | // 网络 Extension 进程 不能发网络请求 | // 动画开发者|
**请检查**: | . |
swift // 检查使用者是否允许 Live Activity ActivityAuthorizationInfo.areActivitiesEnabled // true 或 false
// 监听权限变化 for await enabled in ActivityAuthorizationInfo.activityEnablementUpdates { // 当 enabled 改变后执行相应逻辑 }
User Pain Point: 很多开发者忽视了这一层权限检查，一旦使用者关闭实时活动，则所有请求都会 silently fail，没有任何错误提示。建议在 app launch 时即检查并弹窗引导使用者开启设置。
A 开发者往往先完成 UI，再想办法把业务连上。下面给出一个完整 Checklist。让你按顺序做基本不会走弯路，也能快速定位问题所在。
mermaid
flowchart LR
A --> B
B --> C
C --> D
D --> E
E --> F
F --> G
xml
swift public struct MyWidgetAttributes: ActivityAttributes { public struct ContentState: Codable,Hashable { public var homeScore:Int // 比分变更会更新此字段 public var awayScore:Int // 同上 public var minuteText:String // 如 "′" 或 "23′" public var aggregateLine:String // 如 "首回合 -" 或 "第十轮" }
/* 固定属性 */
public var appName:String // 应用名，用于统一样式或跳转逻辑
public var matchStageTitle:String // 比赛阶段。如 "半决赛"
public var homeTeamName:String // 主队名
public var awayTeamName:String // 客队名
public var homeTeamLogoURL:String // 队徽 URL，仅传字符串，不传 Data，避免超过 4KB 限制
public var awayTeamLogoURL:String
}
Design Principle:
ContentState 用来存放高频变化的数据，每一次 update 或 APNs event:update 都只修改这一部分。这样可以保证 payload <= {content-state} ≤ 400 bytes。
Attributes 用来存放一次性信息。例如队名、赛事标题等，只在 start 时发送一次。不过，该字段不可通过 APNs
修改。因为 event:start 必须包含所有固定字段，否则推送会失败。说起来，
注意 字段名称必须与 APNs JSON 中 content-state 的 key 完全一致。包括大小写，按理说，
swift ActivityConfiguration { context in lockScreenView // 锁屏大卡片 UI } dynamicIsland:{ context in // 灵动岛布局区块 DynamicIsland {
DynamicIslandExpandedRegion{ ... } // 长按展开左侧区域
DynamicIslandExpandedRegion{ ... } // 底部全宽区域
DynamicIslandExpandedRegion{ ... }
} compactLeading:{ ... } // 紧凑态左侧小区域
compactTrailing:{ ... } // 紧凑态右侧小区域
minimal:{ ... } // 最小态多 LA 共存时只显示关键数字
.environment 或 .containerBackground 会导致亮色模式下白底白字甚至崩溃。compactLeading 和 compactTrailing 合并成一个整体，以减少视觉干扰。老实说，.supportsDynamicContent 来让程序根据 CPU 使用率自动降低刷新速率，以免耗电过快。| 方法 | 调用场景 |
|---|---|
| observePushToStartTokens | app 启动后监听 token 更新 |
| observeNewActivities | app 启动后监测程序新建 LA |
| reconcile | silent push 唤醒后将多余 LA 合并为单个 active |
| request | 使用者点击开启实时活动按钮 |
| update | 本地比分刷新 |
| end | 使用者点击结束 |
原则用时打开，不用就关。按理说，在业务结束前务必调用 end
项目根目录下包含两套独立工具： * Dashboard Server – 一键发送 start/update/end 请求；适用于真机快速迭代测试，* push.sh 脚本 – 无需服务器即可手工发送各种类型 APNs 消息；适合单机测试或 CI 环境。
bash shell script code snippet:
cd demo-tools/server && ./run.sh # 浏览器打开 http://IP地址:
接下来在真机里打开 LiveActivityDemo 并切换到 Settings → Notifications → YourApp → Real-time Activities 开启即可看到 token 自动上传到 Dashboard，接下来使用按钮就能模拟 start/update/end 流程。
bash shell script code snippet:
./push.sh DEVICE_TOKEN silent-create "′"
./push.sh ACTIVITY_PUSH_TOKEN update "′"
./push.sh ACTIVITY_PUSH_TOKEN tick "′"
./push.sh ACTIVITY_PUSH_TOKEN end ""
脚本内部已内嵌 JWT 签名、Topic 设置等，你只需要替换对应 token 即可。
| 问题 | 原因 | 对策 | |
|---|---|---|---|
| 创建失败无 UI | 使用者未授权 Real-time Activities 权限 | 弹窗引导开启设置 | |
| 报错 APP 不在前台 | request 必须在前台调用 | 调整调用位置或者改为 silent-push 后端创建 | |
| UI 没变化但代码已改好 | 改的是主 App 而非 Widget Extension | 确认修改位置为 里编写 SwiftUI 模板 | |
| 锁屏背景缺失警告出现 | 没有 .containerBackground | 加入修饰符即可解决 |
| 问题描述 | 常见原因 & 排查方向 | 推荐操作 | ||
|---|---|---|---|---|
| Token 换了但是仍然收到旧消息或没有消息投递成功？ | 每个 token 有生命周期。需要主动上报最新 token 给服务器，并确保服务器已同步删除旧 token。 | 刷新 Token 后确认 server 收录的新值并重新发送测试消息 | ||
| start 后无法立即 Update？不过， | 确认已经拿到 activitypushtoken。如果没有，则无法通过 APNs 更新。 | 看日志中是否有 “reconcile:” 输出，再检查 server 是否已同步最新 token | ||
| TopicDisallowed 错误？ | apns-topic 写错，需要加 .push-type.liveactivity 后缀。例如 |
检查 headers 是否正确且服务端环境匹配 | ||
| BadDeviceToken？ | 开发环境和生产环境混用导致签名错误或者 bundle ID mismatch | 重复获取 device_token 并上传至对应环境 |
LiveActivityDemodemo-tools/README.mdREADME.md
mermaid
flowchart TD
Q1{App 是否在前台？}
Q1 -- 是 --> Local
Q1 -- 否 --> Q2{LA 已创建？}
Q2 -- 是 --> PushUpdate
Q2 -- 否 --> Q3{需要 APP 未安装也能创建？}
Q3 -- 是 --> PushStart
Q3 -- 否 --> SilentCreate
The above guide is based on practical experience of live‑activity‑demo project and aims to help developers quickly understand,implement and debug real‑time activities on iOS.
作为专业的SEO优化服务提供商，我们致力于通过科学、系统的搜索引擎优化策略，帮助企业在百度、Google等搜索引擎中获得更高的排名和流量。我们的服务涵盖网站结构优化、内容优化、技术SEO和链接建设等多个维度。
| 服务项目 | 基础套餐 | 标准套餐 | 高级定制 |
|---|---|---|---|
| 关键词优化数量 | 10-20个核心词 | 30-50个核心词+长尾词 | 80-150个全方位覆盖 |
| 内容优化 | 基础页面优化 | 全站内容优化+每月5篇原创 | 个性化内容策略+每月15篇原创 |
| 技术SEO | 基本技术检查 | 全面技术优化+移动适配 | 深度技术重构+性能优化 |
| 外链建设 | 每月5-10条 | 每月20-30条高质量外链 | 每月50+条多渠道外链 |
| 数据报告 | 月度基础报告 | 双周详细报告+分析 | 每周深度报告+策略调整 |
| 效果保障 | 3-6个月见效 | 2-4个月见效 | 1-3个月快速见效 |
我们的SEO优化服务遵循科学严谨的流程，确保每一步都基于数据分析和行业最佳实践：
全面检测网站技术问题、内容质量、竞争对手情况，制定个性化优化方案。
基于用户搜索意图和商业目标，制定全面的关键词矩阵和布局策略。
解决网站技术问题，优化网站结构，提升页面速度和移动端体验。
创作高质量原创内容，优化现有页面，建立内容更新机制。
获取高质量外部链接，建立品牌在线影响力，提升网站权威度。
持续监控排名、流量和转化数据，根据效果调整优化策略。
基于我们服务的客户数据统计，平均优化效果如下：
我们坚信，真正的SEO优化不仅仅是追求排名，而是通过提供优质内容、优化用户体验、建立网站权威，最终实现可持续的业务增长。我们的目标是与客户建立长期合作关系，共同成长。
Demand feedback
