更新日志

星河岛 SDK 的版本变更记录。正式版发布前，版本号以 0 开头，接口可能调整。

文档修订 · 2026-11-12

本次修订开发文档、示例工程与展示资料；工具包仍为 0.1.2，通信版本仍为 7，无需替换工具包。

• 补充「星河岛歌词」功能未开通时的行为：音乐卡片照常显示，歌词行不显示。
• 示例音乐信息使用虚构内容，同步修正示例工程下载包与校验值。
• 展示资料按当前实际界面更新。

0.1.2

通信版本 7 公开测试

按钮排法可配置的公开测试版本，通信版本仍为 7。

• 底部文字按钮默认每排三个（此前每排两个），四个时平均分两排，一排里只剩一个时占半排居中。
• 新增 ButtonLayout 与 setButtonLayout：可按卡设置每排 1 至 4 个、一排里的分宽方式（等分、主要或带自定义底色的按钮占两份、按文字长短），以及只剩一个时的占宽与对齐。
• 更新接口说明与示例工程，示例中加入三个文字按钮的排法。
• 从 0.1.1 升级时替换工具包文件与依赖文件名即可。旧版星河岛仍按每排两个排，不会报错。

文档修订 · 2026-10-18

本次仅更新开发文档；工具包仍为 0.1.1，通信版本仍为 7，无需替换工具包。

• 补充「显示应用来源」开关：默认关闭，关闭后不显示来源栏，卡片左侧没有内容图片时显示应用图标。
• 补充「长时间未操作时收起」与「停留后收起」，并说明自动收起不调用 onDismissed。
• 收紧用户收起后的恢复条件：仅真实的新消息或新的重要提醒恢复显示，普通进度刷新与换歌词不算。

消息模板文档修订 · 2026-10-08

• 更新回复入口、标为已读、输入中的发送与取消、文字提交后提示的配图。
• 补充短信与消息模板入口、已读操作、回复文字上限及实际发送结果说明。
• 示例工程仅展示操作回传；工具包仍为 0.1.1。

文档修订 · 2026-10-07

本次仅更新开发文档；工具包仍为 0.1.1，通信版本仍为 7，无需替换工具包。

• 修正编译要求：Kotlin 工程需 Kotlin 2.1 及以上，与现有示例工程一致。
• 更新横屏说明，保留完整数值与短状态，不截取卡片标题。
• 明确通知横幅屏蔽的用户开关、可见性与通知归属条件。
• 补充消息更新判定、音乐去重、内容隔离、组合表情保护与收尾显示规则。
• 补充通知、消息、横屏与连接生命周期的接入核对。

0.1.1

通信版本 7 公开测试

修订公开测试版本，公开接口保持不变。

• 连接前严格核对通信版本，不接受未知的高版本宿主。
• 更新示例与说明，明确回复期间保护、外部内容名额及连续更新的提醒行为。
• 从 0.1.0 升级时替换工具包文件与依赖文件名即可。

0.1.0

通信版本 7 公开测试

首个公开测试版本。

包含

• 类型化接口，位于 com.astraisland.sdk 包：IslandClient、IslandActivity、Capsule、IslandCard 及九个卡片子类、按钮类型与回调。
• 九套卡片模板：通用、进度、强调、明细、状态、大图、音乐、消息、对称。
• 按钮：文字按钮最多 4 个，圆形图标按钮、底部图标按钮与开关；文字按钮支持主要、破坏性样式与自定义底色。
• 进度卡片支持阶段名称（2 至 16 个）。
• 回调：onDismissed（用户收起内容）、onExpanded、onCollapsed、onEnded。
• 提交结果以枚举 IslandResult 返回。
• 写法错误在构造时抛出 IllegalArgumentException 并附中文说明。
• 锁屏仅显示标题时，码、明细、比分、标签与阶段名一并隐藏。

使用条件

用户设备需安装支持通信版本 7 的星流。