鴻蒙OS IAbilityContinuation

啟用在分布式系統(tǒng)中實施遷移的 Ability。

您可以使用Ability提供的遷移功能在分布式系統(tǒng)中的本地設(shè)備和遠程設(shè)備之間遷移數(shù)據(jù)。實現(xiàn)此接口的能力或能力切片具有遷移能力。您可以通過在本地設(shè)備上調(diào)用 Ability＃continueAbility（）或 AbilitySlice＃continueAbility（）來發(fā)起遷移請求，然后實施此接口中提供的方法來保存或還原應(yīng)用程序數(shù)據(jù)。保存的數(shù)據(jù)由分布式數(shù)據(jù)管理模塊管理。啟動功能后，遠程設(shè)備可以獲取并恢復(fù)已保存的數(shù)據(jù)。通過這種方式，本地設(shè)備上的功能將遷移到遠程設(shè)備上。

方法總結(jié)

方法細節(jié)

在開始繼續(xù)

boolean onStartContinuation（）

詢問用戶是否開始遷移。

當本地能力發(fā)起遷移請求時，將調(diào)用此方法。

如果該能力未實現(xiàn)此方法，則無法遷移此能力，并返回 false。如果 AbilitySlice 沒有實現(xiàn)此方法，則不會影響其宿主功能是否可以遷移，并且默認情況下返回 true。

返回值：

如果用戶允許遷移，則返回 true；否則，返回 false。

關(guān)于保存數(shù)據(jù)

boolean onSaveData（IntentParams saveData）

保存在運行時生成的本地功能的用戶數(shù)據(jù)（carried in the IntentParams object）。觸發(fā)遷移并準備好本地功能后，當分布式計劃程序服務(wù)從本地功能請求數(shù)據(jù)時，將調(diào)用此方法。

參數(shù)：

返回值：

如果成功保存數(shù)據(jù)，則返回 true；否則，返回 true。否則返回 false。

關(guān)于還原數(shù)據(jù)

布爾值 onRestoreData（IntentParams restoreData）

在遠程設(shè)備上創(chuàng)建功能后，立即恢復(fù)在該功能上的遷移過程中保存的用戶數(shù)據(jù)。僅在還原用戶數(shù)據(jù)之后，才開始對該功能進行生命周期調(diào)度。

參數(shù)：

返回值：

如果數(shù)據(jù)已成功還原，則返回 true；否則，返回 false。否則返回 false。

完全延續(xù)

onCompleteContinuation（int 結(jié)果）無效

本地能力遷移完成后回叫。

您可以在遷移完成后定義處理邏輯。例如，您可以顯示提示，通知用戶遷移成功，然后退出本地功能。

參數(shù)：

在遠程終端上

默認void onRemoteTerminated（）

在針對從本地設(shè)備到遠程設(shè)備的能力執(zhí)行了可逆遷移之后，當遠程設(shè)備上的運行能力被破壞時調(diào)用，以通知本地設(shè)備。通過調(diào)用Ability＃continueAbilityReversible（）或 Ability＃continueAbilityReversible（String）觸發(fā)可逆遷移 。