iOS Live Activity横幅在无Dynamic Island设备解锁屏不显示问题

问题现状 #

我开发了一款仅显示固定停车剩余时间的Live Activity，要求在锁屏和解锁屏上都显示计时器。目前的实现能让带/不带Dynamic Island的设备在锁屏上正常显示，但解锁屏上只有带Dynamic Island的设备能显示，无Dynamic Island的设备做不到。

根据Apple官方文档说明：

在不支持Dynamic Island的设备上，系统会将Live Activity的锁屏展示形式作为横幅短暂覆盖在主屏幕或其他应用之上。只有当你使用alert configuration告知用户Live Activity有更新时，才会出现这种覆盖。

触发解锁屏横幅的条件：

• 设备处于解锁状态且对应的应用未在前台运行
• 调用update(_:alertConfiguration:)方法时传入AlertConfiguration

我当前的实现代码如下：

struct ParkWidgetAttributes: ActivityAttributes {
    
    var startDate: Date
    var endDate: Date

    // 'ContentState' represents the dynamic content of the Live Activity.
    public struct ContentState: Codable, Hashable {
        // Dynamic stateful properties about your activity go here!
        var parkingTimer: ClosedRange<Date>
    }
}

func startLiveActivity() {

    let now = Date.now
    let future = Calendar.current.date(byAdding: .minute, value: minutes, to: now)!
    let dateRange = now...future

    // (1) Fixed Attributes
    let activityAttributes = ParkWidgetAttributes(startDate: now, endDate: future)

    // (2) Content State
    let initialContentState = ParkWidgetAttributes.ContentState(parkingTimer: dateRange)

    let activityContent = ActivityContent(
        state: initialContentState,
        staleDate: future
    )

    do {
        let activity = try Activity.request(attributes: activityAttributes,
                                 content: activityContent)
        
        // Pass an AlertConfiguration to the update(_:alertConfiguration:) function
        Task {
            let alertConfig = AlertConfiguration(
                title: "Alert title",
                body: "Alert body",
                sound: .default
            )
            await activity.update(activityContent, alertConfiguration: alertConfig)
        }

    } catch (let error) {
        print("Error requesting Parking Live Activity \(error.localizedDescription).")
    }
}

核心原因 #

无Dynamic Island的设备（比如iPhone 14及更早机型）在解锁状态下，Live Activity没有常驻显示的系统UI容器——Dynamic Island是专门为解锁状态下常驻Live Activity设计的UI区域，而旧机型没有这个区域。官方文档里的横幅只是更新时的临时通知，不是常驻计时器。

当前代码只在Live Activity启动时触发了一次更新，所以只会弹出一次横幅，之后解锁屏上就看不到计时器了。

可行解决方案 #

1. 接受系统限制，优化用户提示

   • 在App内明确告知无Dynamic Island设备的用户：解锁状态下可通过锁屏查看完整停车计时器，解锁屏仅会在剩余时间关键节点（如剩余5分钟、1分钟）弹出提醒横幅。

2. 触发关键节点的更新提醒

   • 不要只在启动时触发一次更新，而是在停车时间的关键节点（比如剩余5分钟、1分钟）调用update(_:alertConfiguration:)，让用户在解锁状态下能及时收到剩余时间提醒。示例代码调整如下：

     // 假设已经持有activity实例，在剩余5分钟时触发更新
     func triggerTimeAlert(activity: Activity<ParkWidgetAttributes>, remainingMinutes: Int) {
         Task {
             guard let currentState = activity.contentState else { return }
             let updatedContent = ActivityContent(
                 state: currentState,
                 staleDate: currentState.parkingTimer.upperBound
             )
             let alertConfig = AlertConfiguration(
                 title: "停车时间提醒",
                 body: "剩余\(remainingMinutes)分钟",
                 sound: .default
             )
             await activity.update(updatedContent, alertConfiguration: alertConfig)
         }
     }
     

3. 利用App内UI补充展示

   • 如果用户在解锁状态下打开你的App，可以在App内显示和Live Activity同步的停车计时器，作为解锁屏无常驻UI的补充。

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