卡片模板

根据应用内容选择卡片：消息提供回复，音乐提供播放控制，进度卡片显示下载或任务进度。

选择模板

通用

SDK

GenericCard

适用

无需特殊布局的提醒与状态说明。

结构

来源栏、主图、标题、副标题与正文；标题右侧可放大显示一个数值或走动的时间，数值可带颜色与前置图标；说明后可带一个小标签，标题后可带一个小图（例如完成时的对勾）。

按钮

仅有一个文字按钮时置于第一行右侧，多个时置于底部。

进度

SDK

ProgressCard

适用

有明确进度或阶段的事项，如配送、出行、下载。

结构

标题显示当前状态，右侧自动显示百分比，底部为进度条。进度条可分阶段：三个及以上阶段时各阶段名称标注在进度条下方，两个阶段时写在进度条两端；进度条上可显示随进度移动的图标。无具体进度时显示往返移动的高亮段。

按钮

右侧仅显示百分比且只有一个按钮时，百分比移至进度条右端，按钮置于第一行右侧。

强调

SDK

EmphasisCard

适用

最重要的信息是一串码或一个时间，如取件码、取餐码、倒计时与正计时。

结构

标题说明内容类型，下方以大字号显示码或时间，宽度不足时缩小字号并完整显示；副标题与正文位于其下。计时按实际时间走动，使用强调色。

按钮

计时的暂停、继续与停止以圆形按钮显示在右侧。

明细

SDK

DetailsCard

适用

需要并列展示多项信息的事项，如票务、预约、课程。

结构

底部并列 1 到 6 项信息，每项上方为名称、下方为数值，宽度不足时换行。

状态

SDK

StatusCard

适用

设备连接、电量、开关等简短状态。

结构

标题说明状态，右侧以大字号显示电量或时长；有电量时底部显示电量条。卡片高度较小。

大图

SDK

PictureCard

适用

以图片为主要内容的事项，如带图片的动态或预览。

结构

标题与一行正文位于上方，图片宽度与卡片一致，最大高度 140 dp，超出部分居中裁切。

按钮

仅有一个文字按钮时置于标题右侧。

音乐

SDK

MediaCard

适用

音频播放，如音乐、播客、有声书。

结构

左侧为封面，歌名后接歌手，下一行为当前歌词；底部为进度条，应用可声明进度条允许拖动。播放或暂停按键带玻璃质感的圆形底，图形使用强调色。

样式

用户可在星流「星河岛歌词」页选择「音乐卡片样式」，默认「按键在下面」：三个按键居中排在歌词下方，进度条位于卡片最下方；选择「按键在右边」时，上一首、播放或暂停、下一首并排在第一行右侧。开启「卡片显示喜欢与播放设备按钮」（默认开启）后，按键在下面的一排可增加喜欢与播放设备两颗按钮；这两颗按钮只用于星流自己显示的音乐卡片，第三方应用的音乐卡片不显示。

完整的星河岛歌词与音乐控制见星河岛歌词。

消息、短信与快捷回复

SDK

MessageCard

适用

即时消息、短信与可直接回复的会话。

结构

左侧为头像，标题为发送人，正文为最新一条消息；设置发送时间后，来源栏显示时间。底部为回复入口与应用提供的按钮。仅有一个「标为已读」按钮时，未输入状态下与回复入口并排；输入时，发送键位于输入条右端，「取消」与「标为已读」排列在下方。回复文字仅交给发送该卡片的应用，锁屏时不显示回复入口。

回复与发送状态

「标为已读」由应用提供并处理，星河岛不自动修改会话状态。输入或提交回复期间，其他消息不替换当前卡片；未交出的文字保留为草稿。应用不提供回复能力时，不显示回复入口。

接入方法见消息卡片示例与回复、发送与标为已读。

对称

SDK

MirrorCard

适用

两方对比的事项，如赛事比分。

结构

两侧为名称，名称上方可放置标志；中间以大字号显示两侧数值，下方一行显示赛事名称与阶段。尚无数值时，中间显示比赛信息，如「19:30 开赛」。