ActivityAttributesとは?

この記事は約2分で読めます。

ActivityAttributesは、Live Activitiesに関連するデータを管理するためのプロトコルで、リアルタイムの情報をユーザーに提供するために使用されます。

これにより、データの構造を定義し、アプリとLive Activity間のデータのやり取りを簡潔に行うことができます。

  • iOS:16.0以上
  • XCode(当サイトの環境):15.0.1

ActivityAttributesの構成要素

  1. ActivityAttributes: Live Activity全体に関連する属性を定義します。
  2. ContentState: 具体的な状態や進行状況など、リアルタイムで変化するデータを表します。
  3. Codable, Hashable: ContentStateは通常、CodableおよびHashableに準拠しており、これによりデータの保存や一意性が保証されます。

活用例

たとえば、配送ステータスを表示するアプリで、ActivityAttributesには「配送番号」や「顧客名」などの情報を含め、ContentStateには「現在の配送ステータス」や「残りの配達時間」を含めることができます。

サンプルコード

struct MyActivityAttributes: ActivityAttributes {
    public struct ContentState: Codable, Hashable {
        var status: String
        var timeRemaining: Int
    }

    var deliveryNumber: String
    var customerName: String
}

使い方のポイント

  • 状態管理: ContentStateはリアルタイムで変更されるデータを反映するため、頻繁に更新が必要な情報に適しています。
  • 汎用性: ActivityAttributesはアプリ全体の属性を定義するため、さまざまなタイプのLive Activityに応用できます。

Live Activityと組み合わせることで、動的でユーザーにとって有益な情報をリアルタイムに提供することが可能になります。

タイトルとURLをコピーしました