更新日志

v1.2.0 · 2026-07

新增实例级服务端时钟与 getServerTime()：首屏、LAPS、营销 HTTP 统一校时；live.setRoomConfig 可重校时，签到校时前显示 00:00。 新增积分商品兑换券胶囊可选自动打开营销弹窗，保留点击事件；补齐错误重试、参数隔离缓存与并发防串写。

v1.2.0 · 2026-07

修复单播放器切流主链路：接通首次与回放转直播原子起播，完成门改为相对进度证据，并隔离候选错误、收紧健康采样与同源恢复。

v1.2.0 · 2026-07

遥测升级 v3：统一 Web/zan-mini 协议，落地聚合漏斗、SDK APM、诊断采样闸门、可靠 Transport 与 contract 门禁。

v1.2.0 · 2026-07

清晰度自适应升级为健康 episode 与单播放器 generation 切流事务；新增完整事务事件，首次选流和直播状态切换原子提交，成功提示以真实出帧为准。

v1.3.0 · 2026-07

商品营销满减/满赠摘要级渲染：GoodsCardItem 加 marketingActivities（直播间商品卡内联摘要），marketingApi 本地归一为 fullReduction section（不发请求）+ FullReductionSection 组件；普通商品满减也能出营销入口 chip。

v1.2.0 · 2026-07

商品橱窗入口数字 badge：FeatureItemOptions 加 badge（静态初值）+ 专用 API setBadge/getBadge（链式、emit badge.update，n<=0 清空，>99 显示 99+）+ 事件 badge.update；覆盖购物车·订单入口（goods.cart.open/goods.order.open）。新增 BadgeKey 类型 + badgeStore（sdk.stores.badge）。badge 动态只走 setBadge。

v1.1.0 · 2026-07

新增进场消息浮条：enterMsgSwitch 门控、IM user.join 驱动，独立队列与 3s 滑入动画，移除聊天流旧进场态。

v1.1.0 · 2026-06

业务功能配置系统：新增 SDKConfig.features（业务 UI 可见性，与 appModules 正交）+ 运行时方法 updateFeatures/setFeature/getFeatures（链式、mount 前可用）+ 事件 features.update；覆盖 5 个 FeatureKey（topbar.userCenter/topbar.businessInfo/goods.cart.open/goods.cart.add/goods.order.open，键 = 对应事件键）；三源优先级 runtime > 构造 > 服务端兜底，零配置 = 今日行为。

v1.0.1 · 2026-06

商品交互事件补齐：新增 goods.card.click（卡片整体点击，列表卡+浮窗卡）、goods.promotion.click（促销标签纯外抛）、goods.cart.add（加入购物车）、goods.cart.open/goods.order.open（橱窗标题栏购物车/订单入口）；浮窗卡购买按钮统一为 goods.buy（原 interact.cart，破坏性）。Drawer 新增 headerRight 槽。主题统一 shadcn token：移除 --live-*/--livesdk-* 前缀，全量 bg-primary/text-primary/bg-secondary（/10 透明生效）；--primary 珊瑚 10 100% 63%、--secondary 粉 330 81% 60%；SDKTheme 颜色字段→HSL 通道（hex 自动转）。破坏性：旧 --live-primary-color/--livesdk-* 与 applyTheme API 删除。

v1.0.0 · 2026-06

首个版本。播放（直播 + VOD 回放）、IM 聊天（敏感词/禁言/欢迎语）、互动（点赞飘心/礼物/分享）、商品列表与营销弹框、LAPS WebSocket 实时信令（断线降级轮询）、运行时主题与 i18n、命令式弹框、观看时长上报、横竖屏自适应。兼容 iOS 12 / Android 7。