功能說明

iOS16.1 系統支持實時活動功能，可以在鎖定屏幕上實時獲知各種事情的進展，MobPushSDK iOS 4.0.3版本已完成適配，可根據文檔對應使用。

集成步驟

添加依賴庫

ActivityKit.farework
SwiftUI.farework

配置?程?持 LiveActivity

在主?程的 Info.plist ?件中添加?個鍵值對，key 為 NSSupportsLiveActivities，value 為 YES

添加實時活動擴展

添加擴展項目依賴庫

UI實現

實時活動UI需開發者自行實現，可參考Demo處理，注意需將擴展的UI組件引用到主項目上

實時活動API

上傳實時活動token registerLiveActivityWithID（）

示例代碼：

/*!
 * @abstract 注冊LiveActivity并上報PushToken
 * 在PushToken更新時，需同步調用該接口
 * 在LiveActivity結束時，需同步調用該接口，PushToken為nil
 *
 * @param liveActivityId 標識某一個LiveActivity
 * @param pushToken 對應LiveActivity的PushToken
 * @param handler 結果回調
 */
 [MobPush registerLiveActivityWithID:@"mpLiveActivity"
                                          pushToken:token
                                         completion:^(NSError *error) {
                    if (error) {
                        NSLog(@"Register LiveActivity Failed: %@", error.localizedDescription);
                    }
                }];
            }

活動開始startActivity（）

示例代碼：

static public func startActivity(pushTokenUpdate:@escaping (Bool, Data?)- >Void) {
        guard ActivityAuthorizationInfo().areActivitiesEnabled else {
            //不可用
            pushTokenUpdate(false, nil)
            //監聽可用狀態
//            for await enablment in ActivityAuthorizationInfo().activityEnablementUpdates {
//                print("Activity AuthorizationInfo change to (enablment)")
//            }
            return
        }

        endPreActivity()

        let state = HeartNoteLiveActivitsLiveAttributes.ContentState(prograssState: .Car)
        let attri = HeartNoteLiveActivitsLiveAttributes(name: "MPLiveActivities")
        do {
            let current = try Activity.request(attributes: attri, contentState: state, pushType: .token)
            Task {
                for await tokenData in current.pushTokenUpdates {
                    //監聽token更新 注意線程
                    pushTokenUpdate(true, tokenData)
                }
            }
            Task {
                for await state in current.contentStateUpdates {
                    //監聽state狀態 開發者可自行編寫回調監聽
                    print("1content state update: tip=(state.prograssState)")
                }
            }
            Task {
                //監聽activity狀態 開發者可自行編寫回調監聽
                for await state in current.activityStateUpdates {
                    print("activity state update: tip=(state) id:(current.id)")
                }
            }
        } catch(let error) {
            print("error=",error)
            pushTokenUpdate(false, nil)
        }
    }

更新Activity狀態updateActivityState（）

static public func updateActivityState(_ value: Int) {
        Task {
            guard let current = Activity< HeartNoteLiveActivitsLiveAttributes >.activities.first else {
                return
            }

            let state = HeartNoteLiveActivitsLiveAttributes.ContentState(prograssState: PrograssState(rawValue: value) ?? .Arrived)
            let alertConfiguration = AlertConfiguration(title: "Delivery Update ", body: "Delivery Update State to (state.prograssState.rawValue)", sound: .default)
            await current.update(using: state, alertConfiguration: alertConfiguration)
        }
    }

關閉Activity狀態endPreActivity（）

//建議關閉應用的時候要關閉 不然下次啟動就脫離控制了
    static public func endPreActivity() {
        let activities = Activity< HeartNoteLiveActivitsLiveAttributes >.activities.filter { act in
            return act.activityState == .active
        }
        guard activities.count  > 0 else { return }
        for item in activities {
            Task {
//                print("end activity (item.id)")
                await item.end(dismissalPolicy:.immediate)
            }
        }
    }