?????♀? 編者按：本文作者是螞蟻集團(tuán)客戶端工程師博歡，介紹了支付寶如何基于 HarmonyOS 4.0 實(shí)況窗實(shí)現(xiàn)醫(yī)療場景履約智能提醒，歡迎查閱～

1. 話題背景

8 月 4 日，華為在?HDC（華為 2023 開發(fā)者大會(huì)）上推出了新版本操作系統(tǒng)-鴻蒙 4.0，主打個(gè)性化與多元化的的口號(hào)。在功能介紹環(huán)節(jié)，支付寶依托鴻蒙系統(tǒng) 4.0 能力提供的一項(xiàng)新功能出現(xiàn)在了大會(huì)的介紹 ppt 上。

這個(gè)功能乍一看就像一個(gè)系統(tǒng)的通知，實(shí)際上也確實(shí)是一個(gè)通知，只不過與通知有很大的區(qū)別。在華為的官方文檔里，這個(gè)被稱之為實(shí)時(shí)活動(dòng)或者是實(shí)況通知。實(shí)時(shí)活動(dòng)是最開始的名稱，現(xiàn)在官方文檔稱之為實(shí)況通知或者是實(shí)況窗。

為什么說它是國產(chǎn)靈動(dòng)島呢？因?yàn)檫@個(gè)實(shí)時(shí)活動(dòng)具備多種形態(tài)，其中的膠囊態(tài)與 ios 的靈動(dòng)島在 UI 展示上幾乎就是"如出一轍"。除此之外，實(shí)時(shí)活動(dòng)具有更加豐富的展示位置，從息屏，鎖屏，到桌面，通知欄，通知中心，都會(huì)其身影。我們首先來看一下官方的效果展示：

依次分別是通知欄卡片，桌面膠囊態(tài)，桌面膠囊態(tài)展開形態(tài)，鎖屏卡片，息屏膠囊態(tài)

在上方官方的 UI 展示效果圖上，膠囊態(tài)不光展示在桌面上，支持點(diǎn)擊擴(kuò)展為通知卡進(jìn)行操作，同時(shí)出現(xiàn)在息屏界面。息屏頁面的膠囊態(tài)文案不支持點(diǎn)擊擴(kuò)展為實(shí)時(shí)卡片。點(diǎn)擊息屏膠囊態(tài)，會(huì)進(jìn)入鎖屏卡片頁面查看詳情。

實(shí)時(shí)活動(dòng)本質(zhì)上是履約類消息的推送展示。華為的官方定義為：幫助用戶聚焦任務(wù)，進(jìn)行快速查看和及時(shí)處理的通知形體。實(shí)時(shí)活動(dòng)具有實(shí)效性，階段性和變化性的特點(diǎn)。實(shí)效性是指，整個(gè)通知服務(wù)會(huì)持續(xù)一段時(shí)間，在用戶不主動(dòng)關(guān)閉的前提下，具備自動(dòng)展示和結(jié)束的能力。實(shí)效性是指，通知的消息在一段時(shí)間內(nèi)有效。通知具有變化性，它是支持內(nèi)容動(dòng)態(tài)刷新。

?2. 成果展示

在了解了華為實(shí)時(shí)活動(dòng)的背景和能力之后，我們回到發(fā)布會(huì)上所展示的支付寶實(shí)時(shí)活動(dòng)通知。目前支付寶在最新 10.5.10 版本已經(jīng)具備了華為實(shí)時(shí)活動(dòng)能力，目前主要接入應(yīng)用場景在醫(yī)療方面，后續(xù)會(huì)開放更多的應(yīng)用場景。那我們先來欣賞一下支付寶上的"國產(chǎn)靈動(dòng)島"的真實(shí)上機(jī)形態(tài)。

• 通知欄狀態(tài)：

• 左側(cè)展示正常創(chuàng)建實(shí)時(shí)活動(dòng)卡片；

• 右側(cè)展示支持用戶對(duì)卡片進(jìn)行更多操作，包括設(shè)置和刪除卡片；

• 桌面膠囊態(tài)：

• 左側(cè)展示手機(jī)桌面左上角的膠囊文案；

• 中間側(cè)展示點(diǎn)擊膠囊態(tài)可展開通知卡片；

• 右側(cè)展示在膠囊態(tài)展開卡片后支持用戶更多操作，包括設(shè)置和刪除卡片；

• 鎖屏狀態(tài)：

• 展示用戶按下電源鍵進(jìn)入鎖屏頁面展通知卡片（手機(jī)拍攝）；

• 息屏膠囊態(tài)：

• 手機(jī)界面進(jìn)入息屏界面展示膠囊文案（手機(jī)拍攝）；

上述所展示的僅為強(qiáng)調(diào)文案類模板在支付寶醫(yī)療場景下的 UI 效果，除了強(qiáng)調(diào)文案類模板外，華為還提供了多種展示模板應(yīng)用于不同的場景，比如說針對(duì)打車或者外賣場景下的進(jìn)度可視化類模板，針對(duì)體育賽事的賽事比分模板。

實(shí)時(shí)活動(dòng)可以作為一個(gè)強(qiáng)提醒通知渠道，對(duì)于重要信息可以多方位展示。如果考慮到對(duì)于部分用戶出現(xiàn)過度打擾，實(shí)時(shí)活動(dòng)同樣支持減少膠囊態(tài)文案透出，只出現(xiàn)通知欄中。

??3. 實(shí)現(xiàn)細(xì)節(jié)

展示了這么多狀態(tài)的實(shí)時(shí)活動(dòng) UI，大家會(huì)比較好奇怎么實(shí)現(xiàn)這樣一套實(shí)時(shí)活動(dòng)通知呢？

剛才在開頭已經(jīng)介紹了實(shí)時(shí)活動(dòng)其實(shí)是一個(gè)通知，本質(zhì)上是 Android 通知功能的擴(kuò)展。鴻蒙系統(tǒng)通過解析通知的擴(kuò)展參數(shù)，創(chuàng)建對(duì)應(yīng)的模板并填充數(shù)據(jù)。對(duì)于接入功能的第三方應(yīng)用而言，不需要繪制UI，只需要定制接口協(xié)議與模版參數(shù)，即可實(shí)現(xiàn)通知活動(dòng)卡片的創(chuàng)建與展示。另外我們所看到的膠囊態(tài)其實(shí)不是一種獨(dú)立的形態(tài)，它是卡片形態(tài)的擴(kuò)展形式，依附于具體的卡片模板，這就是為什么在桌面通過點(diǎn)擊膠囊態(tài)可以展開卡片。

以支付寶接入醫(yī)療場景的實(shí)時(shí)活動(dòng)為例，簡單介紹一下實(shí)現(xiàn)細(xì)節(jié)。

3.1 處理鏈路

在支付寶端內(nèi)，實(shí)現(xiàn)一個(gè)實(shí)時(shí)活動(dòng)通知，涉及到三個(gè)業(yè)務(wù)團(tuán)隊(duì)的合作，包括客戶端團(tuán)隊(duì)，消息平臺(tái)服務(wù)端團(tuán)隊(duì)以及消息 Push 團(tuán)隊(duì)，這三個(gè)團(tuán)隊(duì)的分工如下：

• 客戶端團(tuán)隊(duì)：接收消息平臺(tái)下發(fā)的 sync 消息(服務(wù)端與客戶端之間的雙向可靠數(shù)據(jù)同步服務(wù)，包括 sync 上行和下行)，創(chuàng)建實(shí)況通知，也就是通知“上島”，并將卡片信息與 token 信息發(fā)送至消息平臺(tái)團(tuán)隊(duì)和 Push 團(tuán)隊(duì)；

• 消息平臺(tái)服務(wù)端團(tuán)隊(duì)：查詢用戶在服務(wù)場景下創(chuàng)建的履約訂單，按照通信協(xié)議通過sync下行通知到客戶端，接收客戶端 sync 上行的卡片信息；

• Push 團(tuán)隊(duì)：接收客戶端 Rpc 上報(bào)的 token 信息，并且作為下游，接收上游消息平臺(tái)傳遞來的卡片通知更新信息。將更新參數(shù)發(fā)送至廠商云端，由廠商完成通知卡片的更新以及刪除操作；

詳細(xì)的流程通過甬道圖表示：

對(duì)于三方應(yīng)用而言，不需要關(guān)心UI繪制。對(duì)于客戶端團(tuán)隊(duì)而言，完成通知卡片的創(chuàng)建之后，無感后續(xù)的更新操作。由三方應(yīng)用云端直接對(duì)接廠商云端，廠商平臺(tái)接收更新數(shù)據(jù)后直接下發(fā)到對(duì)應(yīng)的通知卡片，完成狀態(tài)與數(shù)據(jù)更新。下圖展示的是通知卡片更新狀態(tài)下的數(shù)據(jù)流轉(zhuǎn)：

3.2 通信協(xié)議

實(shí)時(shí)活動(dòng)的通信協(xié)議主要包括兩方面：

1. 三方應(yīng)用內(nèi)的通信協(xié)議：數(shù)據(jù)由消息平臺(tái)下行到客戶端，并在客戶端創(chuàng)建通知卡片后，將更新消息發(fā)送下游 Push 平臺(tái)。

2. 三方應(yīng)用外與廠商平臺(tái)的通信協(xié)議：Push 平臺(tái)接收上游消息平臺(tái)的更新消息后，將數(shù)據(jù)流轉(zhuǎn)對(duì)接到廠商平臺(tái)完成更新；

這兩個(gè)通信協(xié)議其實(shí)也是通知卡片生命周期流程。三方應(yīng)用內(nèi)的通信協(xié)議應(yīng)用于實(shí)時(shí)活動(dòng)通知卡片的創(chuàng)建，三方應(yīng)用與廠商平臺(tái)的通信協(xié)議是應(yīng)用于實(shí)時(shí)活動(dòng)通知卡片的更新。

3.2.1 應(yīng)用內(nèi)通信協(xié)議

應(yīng)用內(nèi)的通信協(xié)議并不是獨(dú)立的，而是繼承自 ios 靈動(dòng)島在支付寶端內(nèi)的通信協(xié)議。為什么說是繼承？為什么說是非獨(dú)立？

繼承是因?yàn)槿A為實(shí)時(shí)活動(dòng)的協(xié)議是 iOS 靈動(dòng)島在支付寶端內(nèi)通信協(xié)議的擴(kuò)展版本，及在原有的協(xié)議基礎(chǔ)上，擴(kuò)展創(chuàng)建華為實(shí)時(shí)活動(dòng)卡片的必須字段。整個(gè)協(xié)議的創(chuàng)建原則是：最大包容原則，即能復(fù)用現(xiàn)有字段則復(fù)用現(xiàn)有字段，缺少則通過團(tuán)隊(duì)協(xié)商后進(jìn)行擴(kuò)展。

非獨(dú)立是指，整個(gè)通信協(xié)議的確定必須具有前瞻性，包括能滿足未來支持華為更多種類模板的實(shí)時(shí)活動(dòng)，也能滿足后續(xù)其他國內(nèi)廠商跟進(jìn)同類“靈動(dòng)島”功能的需求。

這一套協(xié)議目前已經(jīng)支持 iOS 靈動(dòng)島以及華為實(shí)時(shí)活動(dòng)，由客戶端團(tuán)隊(duì)維護(hù)。

3.2.2 應(yīng)用外通信協(xié)議

應(yīng)用外的通信協(xié)議主要是用于 Push 團(tuán)隊(duì)對(duì)接廠商進(jìn)行通知卡片更新操作。這個(gè)的復(fù)雜在于，需要翻譯應(yīng)用內(nèi)的通信協(xié)議。將翻譯后的應(yīng)用內(nèi)的通信協(xié)議字段請(qǐng)求廠商接口，完成實(shí)時(shí)活動(dòng)通知卡片的更新。

如何翻譯應(yīng)用內(nèi)的協(xié)議，主要是將消息平臺(tái)，客戶端，Push 三個(gè)團(tuán)隊(duì)的對(duì)接字段關(guān)聯(lián)起來，做成一個(gè)三元組參數(shù)。

應(yīng)用外的通信協(xié)議目前依然由客戶端團(tuán)隊(duì)維護(hù)。

3.3 代碼接入

代碼接入主要是以客戶端的角度來描述。

3.3.1 創(chuàng)建卡片

實(shí)時(shí)活動(dòng)是在通知的基礎(chǔ)上附加了擴(kuò)展參數(shù)，若是在支持實(shí)時(shí)活動(dòng)的設(shè)備上發(fā)送，則系統(tǒng)會(huì)根據(jù)這些擴(kuò)展參數(shù)，將通知按照實(shí)時(shí)活動(dòng)的樣式進(jìn)行顯示。

3.3.2 擴(kuò)展膠囊

前文講過膠囊態(tài)是卡片的擴(kuò)展形態(tài)，在開發(fā)上，設(shè)計(jì)好膠囊的參數(shù)，然后添加至實(shí)時(shí)活動(dòng)通知卡片的擴(kuò)展參數(shù)上。

??4. 持續(xù)優(yōu)化

目前而言，華為實(shí)時(shí)活動(dòng)功能在支付寶端內(nèi)的的實(shí)現(xiàn)方案并非絕對(duì)完美，出現(xiàn)的問題主要是包含兩個(gè)方面：

1. 廠商推送更新能力并非百分之百：目前有數(shù)據(jù)表明華為在接收三方應(yīng)用的 Push 更新的過程中，達(dá)到率是92%，也就是說會(huì)有8%的數(shù)據(jù)會(huì)丟失在廠商更新用戶設(shè)備鏈路的通道上；

2. 用戶設(shè)備信息存在多業(yè)務(wù)團(tuán)隊(duì)的同時(shí)獲?。喝A為實(shí)時(shí)活動(dòng)卡片的更新依賴用戶設(shè)備的 PushToken 信息，在支付寶端內(nèi)目前至少存在兩個(gè)團(tuán)隊(duì)需要獲取 PushToken。但是華為對(duì) PushToken 的獲取頻次有限制，有概率會(huì)造成某個(gè)業(yè)務(wù) Token 信息的獲取失敗；

4.1 端側(cè)更新

對(duì)于第一個(gè)問題，廠商推送更新能力存在缺陷時(shí)，更新機(jī)制需要具有兜底措施，目前在支付寶內(nèi)部保留了端內(nèi)更新的能力，該能力與廠商更新有所區(qū)別，體現(xiàn)在更新時(shí)機(jī)以及更新字段協(xié)議。

廠商的更新時(shí)機(jī)主要是在接收到三方應(yīng)用發(fā)起更新接口請(qǐng)求時(shí)，端內(nèi)的的更新時(shí)機(jī)則是在指定時(shí)機(jī)內(nèi)主動(dòng)請(qǐng)求消息平臺(tái)數(shù)據(jù)，對(duì)于更新數(shù)據(jù)采用覆蓋更新，即將獲取到字段按照協(xié)議更新到對(duì)應(yīng)模板參數(shù)中。

4.2 PushToken 復(fù)用

對(duì)于第二個(gè)問題，是支付寶端內(nèi)復(fù)雜的業(yè)務(wù)場景導(dǎo)致，畢竟一個(gè)團(tuán)隊(duì)在需要 PushToken 時(shí)，沒辦法知曉哪些團(tuán)隊(duì)同樣需要 PushToken，在多個(gè)業(yè)務(wù)同時(shí)請(qǐng)求設(shè)備 PushToken 信息時(shí)，會(huì)存在失敗的可能。由于時(shí)間節(jié)奏比較緊，目前的方案由 Push 團(tuán)隊(duì)收攏，在實(shí)時(shí)活動(dòng)未上報(bào) PushToken 的情況下，獲取其他業(yè)務(wù)上傳的 PushToken。（在這里需要說明，華為的 PushToken 信息基本不變，所以區(qū)別于 Ios 靈動(dòng)島的 Token 信息上報(bào)）。

在后期的解決方案中，團(tuán)隊(duì)打算采用緩存方案，緩存 PushToken，做到端內(nèi)的業(yè)務(wù)推廣，維護(hù)一套數(shù)據(jù)。

??5. 場景覆蓋

整個(gè)實(shí)時(shí)活動(dòng)的功能已經(jīng)上線，只不過受限于華為鴻蒙 4.0 版本正式版本節(jié)奏，無法放開線上體驗(yàn)。目前也只接入了醫(yī)療場景。我們的業(yè)務(wù)后續(xù)會(huì)接入更多的場景。目前醫(yī)療場景覆蓋的內(nèi)容包括以下：

通知卡片可以透出：預(yù)約醫(yī)院，預(yù)約時(shí)間，當(dāng)前進(jìn)度等內(nèi)容；

??6. 未來可期

目前我們整體功能以及鏈路流程都是已經(jīng)存在的，可以支持快速接入業(yè)務(wù)完成上線。我們支持的能力包括不限于：

1. 針對(duì)音頻播放類，傳輸進(jìn)度類等業(yè)務(wù)場景的基礎(chǔ)類型模板：

2. 對(duì)于打車，外賣等業(yè)務(wù)場景的進(jìn)度可視化模板：

3. 針對(duì)高鐵，航班等業(yè)務(wù)場景的左右文本模板：

4. 針對(duì)體育賽事等業(yè)務(wù)場景的賽事分?jǐn)?shù)模板（尤其是支付寶接入了NBA賽事，這個(gè)可以有）：