帶你走進(jìn)靈動(dòng)島

當(dāng)前位置：點(diǎn)晴教程→知識(shí)管理交流 →『技術(shù)文檔交流』

freeflydom

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

一、簡(jiǎn)介

實(shí)時(shí)活動(dòng) (Live Activity)，是 iOS16 新增的擴(kuò)展組件功能，可以在靈動(dòng)島和鎖定屏幕上顯示應(yīng)用程序的實(shí)時(shí)數(shù)據(jù)。用于追蹤事件和任務(wù)進(jìn)度實(shí)時(shí)活動(dòng)的開(kāi)始和結(jié)束都是離散的，具體畫(huà)面場(chǎng)景如下：蘋(píng)果

蘋(píng)果在 iPhone 14 Pro 及 iPhone 14 Pro MAX 上推出了靈動(dòng)島。靈動(dòng)島將 iPhone 前置鏡頭和軟件通知結(jié)合在一起的全新設(shè)計(jì)，用出色的交互設(shè)計(jì)掩蓋硬件的缺陷，是一次交互玩法的革新。靈動(dòng)島可以通過(guò)點(diǎn)按、長(zhǎng)按、輕掃來(lái)進(jìn)行交互，最多支持兩個(gè)應(yīng)用同時(shí) “登島”。

靈動(dòng)島全稱 Dynamic Island，作為 iOS 中實(shí)時(shí)活動(dòng)（Live Activities）功能的一部分，用來(lái)展示需要實(shí)時(shí)更新的消息。例如外賣配送信息，地圖實(shí)時(shí)導(dǎo)航信息等。靈動(dòng)島有 3 種展現(xiàn)形式。

1.1 展現(xiàn)形式

1.1.1 緊湊（Compact）

當(dāng)系統(tǒng)只有 1 個(gè)實(shí)時(shí)活動(dòng)的內(nèi)容時(shí)，靈動(dòng)島默認(rèn)使用緊湊模式。緊湊模式下 UI 由頭部（Leading side）和尾部（Trailing side）組成，如圖所示。用戶可以點(diǎn)擊靈動(dòng)島打開(kāi) App 查看實(shí)時(shí)活動(dòng)的內(nèi)容

1.1.2 最小化 (Minimal)

當(dāng)系統(tǒng)有多個(gè)實(shí)時(shí)活動(dòng)的內(nèi)容時(shí)，靈動(dòng)島自動(dòng)切換使用最小化模式。最小化模式下由附著的頭部（Leading（attached））和分割開(kāi)的尾部（Trailing（detached））組成，如圖所示。和緊湊模式一樣，最小化模式也支持用戶點(diǎn)擊打開(kāi) App。

1.1.3 擴(kuò)展（Expanded）

當(dāng)用戶在緊湊或最小化模式輕掃或長(zhǎng)按靈動(dòng)島時(shí)，靈動(dòng)島可以切換成擴(kuò)展模式。用于向用戶展示更多信息。擴(kuò)展模式的 UI

設(shè)計(jì)盡量保持和緊湊模式一致，用戶從緊湊模式切換到擴(kuò)展模式會(huì)有一個(gè)平滑的體驗(yàn)。

當(dāng)我們向 App Store 提交了適配靈動(dòng)島的 App 版本時(shí)，以上 3 種模式都需要適配。

二、場(chǎng)景限制

2.1 樣式限制

1、實(shí)時(shí)活動(dòng)針對(duì)鎖定屏幕和靈動(dòng)島提供了不同的視圖。鎖定屏幕可以出現(xiàn)在所有支持 iOS 16 的設(shè)備上。而靈動(dòng)島在支持設(shè)備上，使用以下視圖顯示實(shí)時(shí)活動(dòng)：緊湊前視圖、緊湊尾視圖、最小視圖和擴(kuò)展視圖。

2、當(dāng)用戶觸摸靈動(dòng)島，且靈動(dòng)島中有緊湊或最小視圖，同時(shí)實(shí)時(shí)活動(dòng)更新時(shí)，會(huì)出現(xiàn)擴(kuò)展視圖。在不支持靈動(dòng)島的設(shè)備上，擴(kuò)展視圖顯示為實(shí)時(shí)活動(dòng)更新的橫幅。

3、為確保系統(tǒng)可以在每個(gè)位置顯示 App 的實(shí)時(shí)活動(dòng)，開(kāi)發(fā)者必須支持所有視圖。

建議：同場(chǎng)景多卡片由于樣式趨同且折疊，不建議同時(shí)創(chuàng)建多卡片

靈動(dòng)島頁(yè)面需要實(shí)現(xiàn)的部分有 4 個(gè)：

a、不支持靈動(dòng)島的機(jī)型或鎖屏?xí)r的顯示

b、緊湊級(jí)展示（即左右貼合靈動(dòng)島的展示）

c、多 Live activity 時(shí)的展示（即極小視圖，左貼合，右分離）

d、擴(kuò)展視圖（長(zhǎng)按靈動(dòng)島時(shí)觸發(fā)）

備注：還有一個(gè) App 同時(shí)存在的實(shí)時(shí)活動(dòng)面板最多只能創(chuàng)建 5 個(gè)，這也是一個(gè)場(chǎng)景約束條件。Error requesting delivery Live Activity The operation couldn’t be completed. Maximum number of activities for target already exists

2.2 時(shí)間限制

實(shí)時(shí)活動(dòng)最多可以保持八小時(shí)的活動(dòng)狀態(tài)，除非其應(yīng)用程序或人員在此限制之前結(jié)束活動(dòng)。超過(guò)八小時(shí)限制后，系統(tǒng)自動(dòng)結(jié)束直播活動(dòng)，并立即將其移出動(dòng)態(tài)島。但是，實(shí)時(shí)活動(dòng)會(huì)保留在鎖定屏幕上，直到有人將其刪除，或者在系統(tǒng)將其刪除之前最多再保留四個(gè)小時(shí)（以先到者為準(zhǔn)）。因此，實(shí)時(shí)活動(dòng)在鎖定屏幕上保留最多 12 小時(shí)。

官方表述：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 數(shù)據(jù)更新

每個(gè)實(shí)時(shí)活動(dòng)運(yùn)行在自己的沙盒中，與小組件不同的是，它無(wú)法訪問(wèn)網(wǎng)絡(luò)或接收位置更新。若要更新實(shí)時(shí)活動(dòng)的動(dòng)態(tài)數(shù)據(jù)，少量 (不能超過(guò) 4KB) 數(shù)據(jù)可通過(guò)遠(yuǎn)程推送通知發(fā)送，或通過(guò) ActivityKit 框架后臺(tái)活動(dòng)刷新數(shù)據(jù)。

ActivityKit 更新和 ActivityKit 推送通知的更新動(dòng)態(tài)數(shù)據(jù)大小不能超過(guò) 4 KB。

2.4 網(wǎng)絡(luò)限制

a、卡片本身禁止定位以及網(wǎng)絡(luò)請(qǐng)求，數(shù)據(jù)刷新依賴本地刷新，實(shí)施活動(dòng)推送刷新，同 2) 所述；

b、Live Activity 內(nèi)部禁用網(wǎng)絡(luò)圖片，傳統(tǒng)的服務(wù)端傳圖片 URL 的方式無(wú)法滿足實(shí)際使用，但是希望傳入訂單圖片來(lái)個(gè)性化地表達(dá)并且區(qū)分不同訂單。

iOS 16 beta 版創(chuàng)建時(shí)可以通過(guò)將圖片轉(zhuǎn)為 Data 格式傳入卡片，但是 iOS16.1 該方案僅限傳入 4KB 左右的圖片（API 限制），因此暫時(shí)不考慮非本地圖片方案，采用內(nèi)置圖片方式實(shí)現(xiàn)。

2.5 埋點(diǎn)限制

** 場(chǎng)景情況：** 由于默認(rèn)情況點(diǎn)擊是回主程序，而并不是固定頁(yè)面，因此有必要自定義 widgetUrl (如用于回到訂單頁(yè)面)，也可以通過(guò) Link 實(shí)現(xiàn)分區(qū)域的跳轉(zhuǎn)，Link 和 widgetUrl 共存時(shí)，點(diǎn)擊 Link 區(qū)域會(huì)響應(yīng) Link，因此兩者同時(shí)使用即可。

無(wú)法在 widget 內(nèi)部直接添加埋點(diǎn)，并且靈動(dòng)島收起時(shí)，僅支持添加同一個(gè) widgetUrl，對(duì)于收起狀態(tài)添加 Link 并沒(méi)有響應(yīng)。

** 埋點(diǎn)方式：** 因?yàn)辄c(diǎn)擊直接跳轉(zhuǎn)到主 App，因此考慮將埋點(diǎn)參數(shù)加入 URL 參數(shù)即可，主 App 解析時(shí)埋點(diǎn)。但是無(wú)法記錄包括用戶查看、用戶關(guān)閉（關(guān)閉卡片繼續(xù)發(fā)送推送也沒(méi)有報(bào)錯(cuò) 因此無(wú)法判斷）等行為的埋點(diǎn)。

對(duì)于靈動(dòng)島的區(qū)分，實(shí)際測(cè)試發(fā)現(xiàn)，在展開(kāi)模式下，可以加入 Link 并且可以正常響應(yīng)，這與官方文檔中的描述一致。

三、適配

3.1 UI 適配

1、尺寸：

目前只有 iPhone 14 Pro 及 iPhone 14 Pro MAX 具有靈動(dòng)島功能。在兩種機(jī)型上，靈動(dòng)島的圓角半徑都為 44Points，這個(gè)數(shù)值和前置深感攝像頭的半徑是一樣的。按照前述的 3 種模式，靈動(dòng)島的具體參數(shù)如下表格所示（表格涉及的數(shù)值表示 Points）。

機(jī)型	屏幕尺寸	緊湊模式（頭部）	緊湊模式（尾部）	最小化模式	展開(kāi)模式
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、顏色

開(kāi)發(fā)者無(wú)法更改靈動(dòng)島的背景顏色，只能更改文字顏色、素材顏色、靈動(dòng)島邊框顏色等。UI 適配需要考慮系統(tǒng)的深色模式，必要情況可以使用兩套 UI。

3.2 開(kāi)發(fā)適配

3.2.1 開(kāi)發(fā)框架簡(jiǎn)介

蘋(píng)果在 iOS 16.1 正式對(duì)外開(kāi)放了靈動(dòng)島適配框架 ActivityKit，第三方 App 可以使用這些 ActivityKit 完成靈動(dòng)島適配工作。注意 ActivityKit 的 API 目前僅適用于 iPhone。靈動(dòng)島使用 WidgetKit 和 SwiftUI 完成 UI 開(kāi)發(fā)工作，ActivityKit 在其中扮演創(chuàng)建 Activity，請(qǐng)求數(shù)據(jù)，更新數(shù)據(jù)，結(jié)束 Activity 的角色。

3.2.2 權(quán)限管理

靈動(dòng)島作為實(shí)時(shí)活動(dòng)的一部分，需要實(shí)時(shí)活動(dòng)權(quán)限才能正常展示。和通知權(quán)限，相機(jī)權(quán)限等類似，實(shí)時(shí)活動(dòng)權(quán)限需要 App

3.2.3 生命周期

Request

Update

Observe avtivity state

End

四、遠(yuǎn)程通知更新數(shù)據(jù)

實(shí)時(shí)活動(dòng)也支持遠(yuǎn)程推送更新，根據(jù)文檔以下 9 點(diǎn)要求實(shí)現(xiàn) (avtivity 遠(yuǎn)程推送每小時(shí)有通知預(yù)算 (數(shù)量未明確)，超出后系統(tǒng)將關(guān)閉通知)

1、確保啟動(dòng) activity 時(shí) [request(attributes:contentState:pushType:) 傳入 pushType 參數(shù)（.token）；

2、獲取啟動(dòng)后的 activity 的推送令牌 pushToken，傳給服務(wù)端用來(lái)推送更新 activity；(實(shí)時(shí)活動(dòng)的 pushToken 不是消息通知的 token，這個(gè)是獨(dú)立出來(lái)的)

3、服務(wù)端推送的更新內(nèi)容字段需要和 ActivityAttributes 的 ContentState 中定義的動(dòng)態(tài)數(shù)據(jù)字段對(duì)應(yīng)；

4、設(shè)置推送的報(bào)頭 apns-push-type 的值為 liveactivity；

5、設(shè)置推送的報(bào)頭 apns-topic 的值為.push-type.liveactivity；

6、正確的推送對(duì)應(yīng)的內(nèi)容和狀態(tài)；

7、使用 pushTokenUpdates 監(jiān)聽(tīng) pushToken 變化，如有變化，就令牌失效，需要將新的令牌傳給服務(wù)器；

8、當(dāng) Activity 結(jié)束時(shí)，服務(wù)器端的 pushToken 將失效；

注意：

1、不用為推送提供聲音，如果推送延遲，在 activity 結(jié)束后收到時(shí)將被忽略，avtivity 每小時(shí)有通知預(yù)算 (數(shù)量未明確)，超出后系統(tǒng)將關(guān)閉通知；

2、實(shí)時(shí)活動(dòng)的 pushToken 不是消息通知的 token，這個(gè) token 上報(bào)到 JDPush 服務(wù)，需要單獨(dú)管理和歸類。

備注：

靈動(dòng)島的實(shí)時(shí)信息要有明確的開(kāi)始和結(jié)束時(shí)間點(diǎn)
當(dāng)一個(gè)實(shí)時(shí)信息持續(xù)超過(guò) 8 小時(shí)，系統(tǒng)會(huì)從靈動(dòng)島移除這個(gè) App 的信息
當(dāng)一個(gè)實(shí)時(shí)活動(dòng)結(jié)束時(shí)，靈動(dòng)島上的展示信息也會(huì)立即被系統(tǒng)移除
避免在靈動(dòng)島上顯示廣告，畢竟引起用戶反感可以被直接關(guān)閉
App 要能夠響應(yīng)靈動(dòng)島的點(diǎn)擊信息，跳轉(zhuǎn)到 App 中的正確子頁(yè)面，而不是停留在 App 的首頁(yè)

運(yùn)用場(chǎng)景

1、需在屏幕駐留的文字、圖像為主的信息：如地圖導(dǎo)航、airdrop 傳輸情況等；

2、后臺(tái)進(jìn)行的音頻類：如接電話、放音樂(lè)、錄音、倒計(jì)時(shí)等；

3、即時(shí)交互反饋：如充電、靜音、人臉識(shí)別等。超過(guò)這三類信息后，桌面可能會(huì)變得雜亂無(wú)章