首先逊拍，我們先簡(jiǎn)單了解下靈動(dòng)島
緊湊視圖.png
拓展視圖.png
鎖屏視圖.png
Live Activities 依賴于 Widget 實(shí)現(xiàn) 函數(shù)和頁(yè)面上鞠，而與Widget不同，Live Activities無(wú)法訪問(wèn)網(wǎng)絡(luò)或接收位置更新芯丧，更新Live Activities可以使用ActivityKit和遠(yuǎn)程推送芍阎，同時(shí)ActivityKit可以控制Live Activities的開(kāi)始，更新和結(jié)束缨恒。
靈動(dòng)島的啟用由我們進(jìn)行控制谴咸，且一個(gè)程序可以實(shí)現(xiàn)多個(gè)靈動(dòng)島轮听，但啟用最多展示兩個(gè)
靈動(dòng)島一共有三種樣式展示：
1. 只有一個(gè)Live Activities活動(dòng)時(shí)，如下圖岭佳，將在靈動(dòng)島的左右兩個(gè)部分顯示信息（緊湊級(jí)）血巍，點(diǎn)擊打開(kāi)App查看詳細(xì)信息
image
2. 而同時(shí)有多個(gè)Live Activities活動(dòng)時(shí)，系統(tǒng)最多展示只兩個(gè)（最小級(jí)）Live Activities活動(dòng)珊随，一個(gè)將緊貼靈動(dòng)島述寡，一個(gè)單獨(dú)展示在圓圈內(nèi)，如下圖：
image
3. 手指按中其中任何一個(gè)叶洞，系統(tǒng)將展示（拓展視圖）鲫凶，如下圖：
image
靈動(dòng)島拓展區(qū)域劃分見(jiàn)下圖：
image
一個(gè)Live Activities可以運(yùn)行12小時(shí)，靈動(dòng)到運(yùn)行8小時(shí)京办，到達(dá)8小時(shí)系統(tǒng)將自動(dòng)結(jié)束并移到鎖屏界面，在鎖屏界面可以保持4小時(shí)帆焕，這是涌用戶可以移除或達(dá)到4小時(shí)系統(tǒng)自動(dòng)移除惭婿。
下面是手把手實(shí)現(xiàn)靈動(dòng)島功能
1. 創(chuàng)建Live Activities,如下圖步驟
image
image
image
2. 完成創(chuàng)建Live Activities后，在主項(xiàng)目的Info.plist中添加NSSupportsLiveActivities = YES叶雹。
image
3. 下一步财饥，根據(jù)[ActivityAttributes] 結(jié)構(gòu)代碼定義Live Activities所需的靜態(tài)和動(dòng)態(tài)數(shù)據(jù)，如圖折晦，在主項(xiàng)目創(chuàng)建：
image
4. 根據(jù)剛才創(chuàng)建的[ActivityAttributes]來(lái)創(chuàng)建靈動(dòng)島頁(yè)面钥星，如下圖：
image
靈動(dòng)島頁(yè)面需要實(shí)現(xiàn)的部分有4個(gè)
- 不支持靈動(dòng)島的機(jī)型 或 鎖屏?xí)r的 顯示
- 緊湊級(jí)展示（即左右貼合靈動(dòng)島的展示）
- 多Live activity時(shí)的展示（即極小視圖，左貼合满着，右分離）
- 拓展視圖（長(zhǎng)按時(shí)觸發(fā)）
5. 完成上面步驟谦炒，Live activity 已經(jīng)創(chuàng)建好了，下面是啟動(dòng)：
image
靈動(dòng)島的活動(dòng)狀態(tài)一共有3種：
- active 處于活動(dòng)中
- ended 已經(jīng)終止且不會(huì)有任何更新风喇，但依舊在鎖屏界面展示
- dismissed 結(jié)束且不再展示
6. 更新靈動(dòng)島數(shù)據(jù)（更新的就是在ActivityAttributes中聲明的動(dòng)態(tài)數(shù)據(jù)）：
image
Live activity也支持遠(yuǎn)程推送更新宁改，根據(jù)文檔以下9點(diǎn)要求實(shí)現(xiàn)（Activity遠(yuǎn)程通知每小時(shí)有通知預(yù)算<數(shù)量未明確>，超出后系統(tǒng)將關(guān)閉通知）
- 確保主程序已經(jīng)開(kāi)通了遠(yuǎn)程推送功能
- 確保啟動(dòng)activity時(shí)[
request(attributes:contentState:pushType:)傳入pushType參數(shù)（.token） - 獲取啟動(dòng)后的activity的推送令牌pushToken魂莫，傳給服務(wù)端用來(lái)推送更新activity
- 服務(wù)端推送的更新內(nèi)容字段需要和ActivityAttributes的
ContentState中定義的動(dòng)態(tài)數(shù)據(jù)字段對(duì)應(yīng) - 設(shè)置推送的報(bào)頭apns-push-type的值為liveactivity
- 設(shè)置推送的報(bào)頭apns-topic的值為<your bundleID>.push-type.liveactivity
- 正確的推送對(duì)應(yīng)的內(nèi)容和狀態(tài)
- 使用
pushTokenUpdates監(jiān)聽(tīng)pushToken變化还蹲，如有變化，就令牌失效耙考，需要將新的令牌傳給服務(wù)器 - 當(dāng)Activity結(jié)束時(shí)谜喊，服務(wù)器端的pushToken將失效
下面是官方提供的示例：
{
"aps": {
"timestamp": 1168364460,
"event": "update",
"content-state": {
"driverName": "Anne Johnson",
"estimatedDeliveryTime": 1659416400
},
"alert": {
"title": "Delivery Update",
"body": "Your pizza order will arrive soon.",
"sound": "example.aiff"
}
}
}
可以在aps內(nèi)設(shè)置dissall -date 字段來(lái)告訴系統(tǒng)在什么時(shí)候移除activity ，eg: “dismissal-date”: 1663177260
*** 不用為推送提供聲音 , 如果推送延遲倦始，在activity結(jié)束后收到時(shí)將被忽略斗遏，avtivity每小時(shí)有通知預(yù)算(數(shù)量未明確)，超出后系統(tǒng)將關(guān)閉通知***
7. 結(jié)束Activity:
image
結(jié)束分為兩種:
- .default 系統(tǒng)默認(rèn)鞋邑，結(jié)束后在鎖屏界面保留4小時(shí)
- .immediate 立即結(jié)束最易，不會(huì)在鎖屏界面停留
項(xiàng)目鏈接：點(diǎn)擊跳轉(zhuǎn)示例查看
界面實(shí)現(xiàn)參照:界面參照
