帶你走進靈動島

freeflydom

2023年12月26日 9:25 本文熱度 767

一、簡介

實時活動 (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 的角色。