概览

AppCard 是一组由 OEM 控制样式的界面元素，其中填充了应用提供的信息。AppCard 以易于访问且始终可用的方式向用户显示应用最相关的数据和功能。

AppCard 组件

图 1. AppCard 组件。

第三方开发者可以使用 AppCard 执行以下操作：

  • 在送餐途中向司机显示外卖订单的状态。
  • 向车内乘客展示照片，营造愉悦的氛围。
  • 跟踪并定期更新加密币的价格，供投资者参考。

例如：

AppCard 示例

图 2. AppCard 示例。

AppCard

来源： AppCard.kt

AppCard 是一个用于保存数据的对象。我们支持具有两种状态的 ImageAppCard。定义任何类型的 AppCard 时，每个组件都必须具有唯一的 ID。

图 3. 包含文字的图片。

图 4. 包含文字的进度条和按钮。

AppCard ContentProvider

来源： AppCardContentProvider.kt

存在于应用中、创建 AppCard 并与 AppCardHost 进行实例化和通信的内容提供程序。如需了解详情，请参阅 AppCardContentProviderExtension。

AppCard Host

来源： AppCardHost.kt

一种连接到 AppCardContentProvider 的系统应用，用于显示和管理应用卡片。如需了解详情，请参阅配置 AppCard 主机。

AppCard 上下文

来源： AppCardContext.kt

一个对象，用于向 AppCardContentProvider 提供有关 AppCardHost 如何显示 AppCard 的提示。AppCardContext 包含以下信息：

  • API 级别

  • 以下内容的刷新周期：

    • 完成 AppCard 更新
    • 带有 EnforceFastUpdateRate 标记的 AppCard 组件

  • 是否为支持与 AppCard 互动的宿主？

  • 图片大小上限：

    • 居中放置图片
    • 按钮图片
    • 标题图片

  • 预期要显示的按钮的最小数量。

借助此信息，AppCard 开发者可以优化发送给主机的信息。