iOS中Live Activity倒计时归零时（后台/终止）如何更新文本？

核心结论 #

要实现倒计时归零时，无论APP处于前台、后台还是终止状态都能可靠更新Live Activity，远程推送通知是最优解；本地后台任务仅能覆盖APP后台未终止的场景，无法处理APP被杀死的情况。另外，staleTime并非用于触发倒计时结束的逻辑，它只是标记内容过时的时间，系统不会自动执行更新或终止操作。

1. 远程推送触发更新/终止（全场景覆盖） #

实现步骤 #

1. 配置权限：在Info.plist中添加NSSupportsLiveActivities并设置为YES；请求推送权限时需包含provisional或alert权限，同时请求ActivityKit权限。
2. 获取推送Token：创建Live Activity时，获取其pushToken并上传至后端，后端在倒计时结束时间点触发推送。
3. 推送Payload格式：根据需求选择更新UI或直接终止Live Activity的Payload。

代码示例 #

创建Live Activity并获取推送Token

import ActivityKit

// 定义Activity属性和状态
struct VehicleActivityAttributes: ActivityAttributes {
    public struct ContentState: Codable, Hashable {
        var endTime: Date
        var isFinished: Bool
    }
    var vehicleName: String
    var color: String
}

func startVehicleLiveActivity(vehicleName: String, color: String, endTime: Date) {
    let attributes = VehicleActivityAttributes(vehicleName: vehicleName, color: color)
    let initialState = VehicleActivityAttributes.ContentState(endTime: endTime, isFinished: false)
    
    do {
        let activity = try Activity.request(
            attributes: attributes,
            contentState: initialState,
            pushType: .token
        )
        // 将推送Token转换为字符串并上传至后端
        if let token = activity.pushToken {
            let tokenString = token.map { String(format: "%02x", $0) }.joined()
            sendPushTokenToBackend(token: tokenString, endTime: endTime)
        }
    } catch {
        print("启动Live Activity失败：\(error)")
    }
}

// 模拟上传Token到后端的方法
func sendPushTokenToBackend(token: String, endTime: Date) {
    // 调用你的后端API完成上传
}

后端推送Payload示例

• 更新UI为"session finished"：

{
  "aps": {
    "timestamp": 1699999999,
    "event": "update",
    "content-state": {
      "endTime": 1699999999,
      "isFinished": true
    }
  }
}

• 直接终止Live Activity：

{
  "aps": {
    "timestamp": 1699999999,
    "event": "end"
  }
}

2. 本地后台任务（仅后台未终止场景） #

如果无法依赖后端，可使用BGAppRefreshTask实现后台触发更新，但APP被终止时该任务不会执行，仅作为补充方案。

代码示例 #

注册与调度后台任务

import BackgroundTasks

func registerLiveActivityUpdateTask() {
    BGTaskScheduler.shared.register(
        forTaskWithIdentifier: "com.yourdomain.updateVehicleActivity",
        using: nil
    ) { task in
        handleUpdateTask(task: task as! BGAppRefreshTask)
    }
}

func scheduleUpdateTask(endTime: Date) {
    let request = BGAppRefreshTaskRequest(identifier: "com.yourdomain.updateVehicleActivity")
    // 提前1分钟调度，避免系统延迟导致错过时间点
    request.earliestBeginDate = endTime.addingTimeInterval(-60)
    
    do {
        try BGTaskScheduler.shared.submit(request)
    } catch {
        print("调度后台任务失败：\(error)")
    }
}

func handleUpdateTask(task: BGAppRefreshTask) {
    // 找到目标Live Activity并更新状态
    if let activity = Activity<VehicleActivityAttributes>.activities.first {
        Task {
            let updatedState = VehicleActivityAttributes.ContentState(
                endTime: activity.contentState.endTime,
                isFinished: true
            )
            await activity.update(using: updatedState)
            // 或直接终止：await activity.end(dismissalPolicy: .immediate)
        }
    }
    task.setTaskCompleted(success: true)
}

3. Widget视图状态切换 #

在Live Activity的Widget视图中，根据isFinished状态切换UI展示：

struct VehicleLiveActivityWidget: Widget {
    var body: some WidgetConfiguration {
        ActivityConfiguration(for: VehicleActivityAttributes.self) { context in
            VStack(spacing: 8) {
                Text(context.attributes.vehicleName)
                    .font(.headline)
                Text("颜色：\(context.attributes.color)")
                    .font(.subheadline)
                if context.state.isFinished {
                    Text("session finished")
                        .font(.title)
                        .foregroundColor(.green)
                } else {
                    Text(countdownString(to: context.state.endTime))
                        .font(.title)
                }
            }
            .padding()
        } dynamicIsland: { context in
            DynamicIsland {
                DynamicIslandExpandedRegion(.leading) {
                    if context.state.isFinished {
                        Text("已完成")
                    } else {
                        Text(countdownString(to: context.state.endTime))
                    }
                }
            } compactLeading: {
                context.state.isFinished ? Text("✓") : Text(countdownString(to: context.state.endTime))
            } compactTrailing: {
                Text(context.attributes.vehicleName.prefix(2))
            } minimal: {
                context.state.isFinished ? Text("✓") : Text(countdownString(to: context.state.endTime))
            }
        }
    }
    
    // 生成倒计时字符串
    private func countdownString(to endTime: Date) -> String {
        let remaining = endTime.timeIntervalSinceNow
        guard remaining > 0 else { return "" }
        let hours = Int(remaining / 3600)
        let minutes = Int((remaining.truncatingRemainder(dividingBy: 3600)) / 60)
        let seconds = Int(remaining.truncatingRemainder(dividingBy: 60))
        return String(format: "%02d:%02d:%02d", hours, minutes, seconds)
    }
}

关键注意事项 #

• 推送权限：必须确保APP已请求推送权限，且Live Activity创建时pushType设置为.token才能获取推送Token。
• 精准性：远程推送的精准度远高于本地后台任务，后者的触发时间由系统调度，可能存在延迟。
• 资源限制：Live Activity的更新频率受系统限制，避免频繁发送推送，防止被限流。
• 终止状态支持：仅远程推送能在APP被终止时触发Live Activity的更新/终止，本地机制无法覆盖该场景。

内容的提问来源于stack exchange，提问作者Say0