ライブ活動
ライブ活動には、あなたのアプリからの最新情報が表示され、人々がイベントやタスクの進行状況を一目で確認できます。
ライブ活動は、人々が関心のあるタスクやイベントを追跡するのに役立ち、頻繁に更新される情報を表示する永続的な場所を提供します。たとえば、食品配達アプリでは食品の注文が届くまでの残り時間を表示したり、スポーツアプリでは進行中のゲームのスコアを表示したりできます。
ライブ活動をサポートするデバイスは、ロックスクリーンにライブ活動を表示するだけでなく、デバイスがダイナミックアイランド (Dynamic Island)もサポートしているかどうかに応じて、さまざまな方法であなたのアプリ情報を表示できます。
ライブ活動を表示するために、システムは以下の提示を使用します。
ライブ活動をサポートできるすべてのデバイス、およびシステムによって決定されるすべての提示でライブ活動が適切に機能するようにするには、ロックスクリーンの提示に加えて、Dynamic Island の 3 つの提示型すべてをサポートする必要があります。
開発者向けガイダンスについては、ActivityKit (ActivityKit) を参照してください。
ベストプラクティス
開始と終了が定義されているタスクとライブイベントのライブ活動を提供します。 人々はライブ活動を使用して、頻繁に更新されるデータでイベントを追跡したり、進行中のタスクのステータスを監視したりします。8 時間を超えるタスクのライブ活動を提供しないでください。また、タスクが完了した後、またはイベントが終了した直後にライブ活動を常に終了してください。
最も重要なコンテンツのみを提示します。 人々は、進行中のタスクやイベントに関する要約や重要な情報を入手できることを高く評価します。多くの詳細を受け取ったり、ライブ活動でアクションを実行したりすることは期待していません。ライブ活動をタップして、人々があなたのアプリ内の追加の詳細や機能にアクセスできるようにします。
新しいコンテンツが利用可能になったときにのみライブ活動を更新し、注意を引くことが不可欠な場合にのみ人々に警告します。 ライブ活動の更新を人々に警告することは混乱を招き、あまりにも頻繁に警告を発したり、不可欠ではない更新を警告したりすると、人々を苛立たせ、あなたのライブ活動の使用をやめるよう促します。システムは、デバイスと Dynamic Island をサポートしているかどうかに応じて、さまざまな方法でライブ活動の更新を人々に警告することに注意してください。
ライブ活動で機密情報を表示しないようにします。 ライブ活動は視覚的に際立っており、何気ない観察者が見ることができます。提供するべき情報が機密項目に関するものの場合は、無難な概要を表示し、人々がライブ活動をタップしてあなたのアプリ内の詳細情報を取得できるようにします。
ライブ活動を使用して広告や販売促進を表示することは避けてください。 ライブ活動は、進行中のイベントやタスクに関する情報を人々に提供するのに役立ちます。そのため、それらのイベントやタスクに関連する情報のみを表示することが重要です。
ライブ活動の開始と終了を人々が制御できるようにします。 たとえば、タスクやイベントが終了する前にライブ活動を人々が終了できるようにするには、あなたのアプリのリンクビューにライブ活動を停止またはキャンセルするためのボタンを用意します。あなたのアプリ内からライブ活動を開始するために使用できるボタンを提供することも良い考えですが、ライブ活動が自動的に開始されることを期待する状況がいくつかあります。たとえば、人々があなたのアプリを使用してタスクやイベントを開始する場合 (配達用の食べ物を注文したり、ライドシェアをリクエストしたりするなど)、人が注文またはリクエストを行うとすぐにライブ活動を自動的に開始することは理にかなっています。人々は [設定] であなたのアプリのライブ活動をオフにすることができるため、予期しないライブ活動を開始して人々を驚かせないようにすることが重要です。
ライブ活動をタップすると、正しい場所であなたのアプリが開くことを確認してください。 人々がライブ活動をタップしてあなたのアプリを開いたときには、関連する詳細とアクションに直接移動させます。関連するスクリーンに移動させる必要はありません。あなたのアプリ内の特定のスクリーンに深くリンクできる SwiftUI ビューに関する開発者向けガイダンスについては、Link (Link)と widgetURL(_:) (widgetURL(_:)) を参照してください。
ライブ活動が終了したら、ロックスクリーンから削除することを検討してください。 Dynamic Island では、ライブ活動が終了すると、システムはすぐにそれを削除します。デフォルトでは、ライブ活動が終了してから最大 4 時間、システムはロックスクリーンにライブ活動が表示し、最後のコンテンツの更新を表示する時間が人々に与えられます。ライブ活動の結果が短時間しか関係がない場合は、4 時間以内の特定の時間または終了直後に終了するようにシステムに指示します。たとえば、ライドシェアアプリでは、乗車が終了してから 15 分間、ロックスクリーンのライブ活動に乗車の概要を表示して、人々が最終運賃を確認できるようにすることを選択できます。
便利なライブ活動の設計
Dynamic Island でのコンパクトな提示の統一された情報とデザインを確保します。 TrueDepth カメラは、ライブ活動のコンパクトな先行提示とコンパクトな後続提示を分離しますが、両方のコンテンツは 1 つの情報として読み取られる必要があり、いずれかの提示をタップすると、人々はあなたのアプリ内の同じスクリーンに移動する必要があります。2 つのコンパクトな提示で、テキストやアイコンなどのコンテンツの関係を強化するために色を使用することを検討してください。
コンパクトな提示と展開された提示の間で一貫したレイアウトを作成します。 展開した提示は、コンパクトな提示の拡大版です。ライブ活動がコンパクトな提示から拡張した提示に移行するときに、情報とレイアウトが予測どおりに拡張されるようにします。
ロックスクリーンと展開した提示の両方で一貫したデザインを使用することを検討してください。 両方の提示で一貫したデザインアプローチを使用すると、人々はあなたのコンテンツに慣れ、さまざまな場所でイベントやタスクの進行状況を追跡する方法を学ぶのに役立ちます。
さまざまなスクリーンサイズとライブ活動の提示に適応します。 ライブ活動は、さまざまなデバイスのスクリーンサイズに合わせて調整されます。適切なサイズのコンテンツを提供することで、ライブ活動はすべてのデバイス上で適切に表示されるようにします。さまざまなデバイスや縮尺係数のレイアウトとアセットを作成するときは、仕様 に記載されている値をガイダンスとして使用してください。
ロックスクリーンでカスタムの背景色と不透明度を使用する前に、慎重に検討してください。 ロックスクリーンに表示されるライブ活動の背景色やイメージを設定する場合は、色をテストして十分なコントラストが得られることを確認します。特に、輝度が低下した常時表示ディスプレイのチント色の時に。Dynamic Island に表示されるライブ活動提示のカスタム背景色を選択できないことに注意してください。ただし、Dynamic Island を囲むテキスト、シンボル、境界線にカスタムのチント色を適用することはできます。開発者向けガイダンスについては、ライブ活動を使用したライブデータの表示 (Displaying live data with Live Activities) を参照してください。
コンテンツの角の半径をライブ活動の角の半径に合わせます。 コンテンツのアイテムとライブ活動のエッジの間のマージンは一貫している必要があります。ライブ活動の丸みを帯びたコーナー内であなたのコンテンツが適切に表示されるようにするには、SwiftUI コンテナを使用して正しいコーナー半径を適用します。開発者向けガイダンスについては、ContainerRelativeShape (ContainerRelativeShape) を参照してください。
一般に、標準の余白を使用して、あなたのコンテンツが読みやすいようにします。 拡張提示とロックスクリーン提示の場合、標準の余白幅は 20 ポイントです。グラフィックやボタンの場合など、場合によっては、端が密集したり、雑然とした外観になったりしないように、より狭いマージンを使用する必要があります。開発者向けガイダンスについては、padding(_:_:) (padding(_:_:)) を参照してください。
パーソナライズされたロックスクリーンに適した色を選択してください。 人々は壁紙、カスタムのチント色、ウィジェットでロックスクリーンをカスタマイズします。ライブ活動をカスタムのロックスクリーンの美学に合わせて読みやすくするには、カスタムのチント色と不透明度を控えめに適用します。
ダークモードと常時表示ディスプレイをサポートします。 ライブ活動は、ライトな外観とダークな外観の両方、および輝度を下げた常時表示ディスプレイで見栄えがするように色を調整します。ガイダンスについては、ダークモード と 常にオン を参照してください。開発者向けガイダンスについては、アセット カタログについて を参照してください。
アニメーションは控えめに使用し、コンテンツの更新に注意を向けさせるためだけに使用してください。 ライブ活動はシステムアニメーションのサブセットを使用しますが、システムは輝度を下げた常時表示ディスプレイではアニメーションを実行しません。利用可能なアニメーションについては、コンテンツの更新をアニメーション化する ( Animate content updates) を参照してください。
プラットフォームの考慮事項
iPadOS、macOS、tvOS、watchOS ではサポートされていません。
仕様
Dynamic Island
Dynamic Island は 44 ポイントのコーナー半径を使用し、その丸みを帯びたコーナー形状は TrueDepth カメラと一致します。
提示型 | デバイス | Dynamic Island 幅 (Pt) |
コンパクトまたは最小 | iPhone 14 Pro Max | 250 |
iPhone 14 Pro | 230 | |
拡張 | iPhone 14 Pro Max | 408 |
iPhone 14 Pro | 371 |
ライブ活動サイズ
以下の表に記載されているすべての値はポイント単位です。
画面の寸法(縦) | コンパクトの先頭 | コンパクトの後続 | 最小(幅は範囲で指定) | 拡張(高さは範囲で指定) | ロック画面 |
430x932 | 62.33x36.67 | 62.33x36.67 | 36.67–45x36.67 | 408x84–160 | 408x84–160 |
393x852 | 52.33x36.67 | 52.33x36.67 | 36.67–45x36.67 | 371x84–160 | 371x84–160 |
リソース
開発者用文書
ActivityKit (ActivityKit)
SwiftUI (SwiftUI)
WidgetKit (WidgetKit)
変更記録
2022 年 11 月 3 日 アートワークと仕様を更新しました。
2022 年 9 月 23 日 新規ページ。