带你走进灵动岛

freeflydom

2023年12月26日 9:25 本文热度 361

一、简介

实时活动 (Live Activity)，是 iOS16 新增的扩展组件功能，可以在灵动岛和锁定屏幕上显示应用程序的实时数据。用于追踪事件和任务进度实时活动的开始和结束都是离散的，具体画面场景如下：苹果

苹果在 iPhone 14 Pro 及 iPhone 14 Pro MAX 上推出了灵动岛。灵动岛将 iPhone 前置镜头和软件通知结合在一起的全新设计，用出色的交互设计掩盖硬件的缺陷，是一次交互玩法的革新。灵动岛可以通过点按、长按、轻扫来进行交互，最多支持两个应用同时 “登岛”。

灵动岛全称 Dynamic Island，作为 iOS 中实时活动（Live Activities）功能的一部分，用来展示需要实时更新的消息。例如外卖配送信息，地图实时导航信息等。灵动岛有 3 种展现形式。

1.1 展现形式

1.1.1 紧凑（Compact）

当系统只有 1 个实时活动的内容时，灵动岛默认使用紧凑模式。紧凑模式下 UI 由头部（Leading side）和尾部（Trailing side）组成，如图所示。用户可以点击灵动岛打开 App 查看实时活动的内容

1.1.2 最小化 (Minimal)

当系统有多个实时活动的内容时，灵动岛自动切换使用最小化模式。最小化模式下由附着的头部（Leading（attached））和分割开的尾部（Trailing（detached））组成，如图所示。和紧凑模式一样，最小化模式也支持用户点击打开 App。

1.1.3 扩展（Expanded）

当用户在紧凑或最小化模式轻扫或长按灵动岛时，灵动岛可以切换成扩展模式。用于向用户展示更多信息。扩展模式的 UI

设计尽量保持和紧凑模式一致，用户从紧凑模式切换到扩展模式会有一个平滑的体验。

当我们向 App Store 提交了适配灵动岛的 App 版本时，以上 3 种模式都需要适配。

二、场景限制

2.1 样式限制

1、实时活动针对锁定屏幕和灵动岛提供了不同的视图。锁定屏幕可以出现在所有支持 iOS 16 的设备上。而灵动岛在支持设备上，使用以下视图显示实时活动：紧凑前视图、紧凑尾视图、最小视图和扩展视图。

2、当用户触摸灵动岛，且灵动岛中有紧凑或最小视图，同时实时活动更新时，会出现扩展视图。在不支持灵动岛的设备上，扩展视图显示为实时活动更新的横幅。

3、为确保系统可以在每个位置显示 App 的实时活动，开发者必须支持所有视图。

建议：同场景多卡片由于样式趋同且折叠，不建议同时创建多卡片

灵动岛页面需要实现的部分有 4 个：

a、不支持灵动岛的机型或锁屏时的显示

b、紧凑级展示（即左右贴合灵动岛的展示）

c、多 Live activity 时的展示（即极小视图，左贴合，右分离）

d、扩展视图（长按灵动岛时触发）

备注：还有一个 App 同时存在的实时活动面板最多只能创建 5 个，这也是一个场景约束条件。Error requesting delivery Live Activity The operation couldn’t be completed. Maximum number of activities for target already exists

2.2 时间限制

实时活动最多可以保持八小时的活动状态，除非其应用程序或人员在此限制之前结束活动。超过八小时限制后，系统自动结束直播活动，并立即将其移出动态岛。但是，实时活动会保留在锁定屏幕上，直到有人将其删除，或者在系统将其删除之前最多再保留四个小时（以先到者为准）。因此，实时活动在锁定屏幕上保留最多 12 小时。

官方表述：https://developer.apple.com/documentation/activitykit/displaying-live-data-with-live-activities

A Live Activity can be active for up to eight hours unless your app or a person ends it before this limit. After the 8-hour limit, the system automatically ends it. When a Live Activity ends, the system immediately removes it from the Dynamic Island. However, the Live Activity remains on the Lock Screen until a person removes it or for up to four additional hours before the system removes it — whichever comes first. As a result, a Live Activity remains on the Lock Screen for a maximum of twelve hours.

2.3 数据更新

每个实时活动运行在自己的沙盒中，与小组件不同的是，它无法访问网络或接收位置更新。若要更新实时活动的动态数据，少量 (不能超过 4KB) 数据可通过远程推送通知发送，或通过 ActivityKit 框架后台活动刷新数据。

ActivityKit 更新和 ActivityKit 推送通知的更新动态数据大小不能超过 4 KB。

2.4 网络限制

a、卡片本身禁止定位以及网络请求，数据刷新依赖本地刷新，实施活动推送刷新，同 2) 所述；

b、Live Activity 内部禁用网络图片，传统的服务端传图片 URL 的方式无法满足实际使用，但是希望传入订单图片来个性化地表达并且区分不同订单。

iOS 16 beta 版创建时可以通过将图片转为 Data 格式传入卡片，但是 iOS16.1 该方案仅限传入 4KB 左右的图片（API 限制），因此暂时不考虑非本地图片方案，采用内置图片方式实现。

2.5 埋点限制

** 场景情况：** 由于默认情况点击是回主程序，而并不是固定页面，因此有必要自定义 widgetUrl (如用于回到订单页面)，也可以通过 Link 实现分区域的跳转，Link 和 widgetUrl 共存时，点击 Link 区域会响应 Link，因此两者同时使用即可。

无法在 widget 内部直接添加埋点，并且灵动岛收起时，仅支持添加同一个 widgetUrl，对于收起状态添加 Link 并没有响应。

** 埋点方式：** 因为点击直接跳转到主 App，因此考虑将埋点参数加入 URL 参数即可，主 App 解析时埋点。但是无法记录包括用户查看、用户关闭（关闭卡片继续发送推送也没有报错因此无法判断）等行为的埋点。

对于灵动岛的区分，实际测试发现，在展开模式下，可以加入 Link 并且可以正常响应，这与官方文档中的描述一致。

三、适配

3.1 UI 适配

1、尺寸：

目前只有 iPhone 14 Pro 及 iPhone 14 Pro MAX 具有灵动岛功能。在两种机型上，灵动岛的圆角半径都为 44Points，这个数值和前置深感摄像头的半径是一样的。按照前述的 3 种模式，灵动岛的具体参数如下表格所示（表格涉及的数值表示 Points）。

机型	屏幕尺寸	紧凑模式（头部）	紧凑模式（尾部）	最小化模式	展开模式
iPhone 14 Pro	393*852	52.33*36.67	52.33*36.67	36.67*36.67	371*(84-160)
iPhone 14 Pro Max	430*932	62.33*36.67	62.33*36.67	36.67*36.67	408*(84-160)

2、颜色

开发者无法更改灵动岛的背景颜色，只能更改文字颜色、素材颜色、灵动岛边框颜色等。UI 适配需要考虑系统的深色模式，必要情况可以使用两套 UI。

3.2 开发适配

3.2.1 开发框架简介

苹果在 iOS 16.1 正式对外开放了灵动岛适配框架 ActivityKit，第三方 App 可以使用这些 ActivityKit 完成灵动岛适配工作。注意 ActivityKit 的 API 目前仅适用于 iPhone。灵动岛使用 WidgetKit 和 SwiftUI 完成 UI 开发工作，ActivityKit 在其中扮演创建 Activity，请求数据，更新数据，结束 Activity 的角色。