概要

AppCard は、OEM によってスタイル設定が管理され、アプリから提供された情報で入力される UI 要素のグループです。AppCard は、アプリの最も関連性の高いデータと機能を、いつでもアクセスできる方法でユーザーに表示します。

AppCard コンポーネント

図 1. AppCard コンポーネント。

サードパーティのデベロッパーは、AppCard を使用して次のことができます。

  • 配達中のドライバーに、テイクアウト注文のステータスを表示します。
  • 車内の乗客に写真を表示して、心地よい雰囲気を演出します。
  • 投資家向けに暗号通貨の価格を追跡し、定期的に更新します。

次に例を示します。

AppCard の例

図 2. AppCard の例。

AppCard

ソース: AppCard.kt

AppCard は、データを保持するオブジェクトです。2 つの状態を持つ ImageAppCard がサポートされています。どのタイプの AppCard を定義する場合でも、各コンポーネントに一意の ID が必要です。

図 3. テキスト付きの画像。

図 4. 進行状況バーとテキスト付きのボタン。

AppCard ContentProvider

ソース: AppCardContentProvider.kt

アプリに存在するコンテンツ プロバイダは、AppCard を作成し、インスタンス化され、AppCardHost と通信します。詳しくは、AppCardContentProviderExtension をご覧ください。

AppCard ホスト

ソース: AppCardHost.kt

AppCardContentProvider に接続してアプリカードを表示、管理するシステムアプリ。詳細については、AppCard ホストを構成するをご覧ください。

AppCard コンテキスト

ソース: AppCardContext.kt

AppCardHost が AppCard を表示する方法に関するヒントを AppCardContentProvider に提供するオブジェクト。AppCardContext には次の情報が含まれます。

  • API レベル

  • 更新期間:

    • AppCard の更新を完了する
    • EnforceFastUpdateRate のタグが付いた AppCard コンポーネント

  • ホストは AppCard とのやり取りをサポートしていますか？

  • 最大画像サイズ:

    • 画像を中央に配置する
    • ボタンの画像
    • ヘッダー画像

  • 表示されるボタンの最小数。

この情報により、AppCard デベロッパーはホストに送信される情報を最適化できます。