Live Activity機能

ActivityKit連携・ロック画面とDynamic Island

v1.0機能ID: SS-FEAT-LA

概要

ActivityKitを使用してロック画面・Dynamic Islandにタイマー経過時間を表示する機能。 本体タイマーと1秒同期、終了時のクリーンアップ含む安全な実装。

LiveActivityService API

final class LiveActivityService {
    static let shared: LiveActivityService

    func startActivity(subject: Subject) async
    func updateActivity(elapsedSeconds: Int) async
    func endActivity() async
    func cleanupOrphanedActivities() async  // 起動時に呼出
}

処理フロー

1. タイマー開始 → Activity.request(attributes:contentState:)
2. 1秒ごと → activity.update(.init(state:))
3. タイマー停止 → activity.end(.init(state:))
4. アプリ起動時 → cleanupOrphanedActivities() で残骸検出・削除

ビジネスルール

• NSSupportsLiveActivities = true（Info.plist）
• 同時に1つのActivityのみ（既存があれば終了してから新規作成）
• 失敗時はサイレント（タイマー本体は正常動作）

外部連携

連携先	用途
ActivityKit	Live Activity起動・更新・終了
WidgetKit	Activity拡張のUI実装

変更履歴

バージョン	日付	変更内容
1.0	2026-05-09	初版作成