Repository navigation
Haiyue 0.2.0
本次统一发布 @haiyue/engine、@haiyue/animation-spec、@haiyue/extensions、@haiyue/shader-language 四个 0.2.0 包。
新增能力
- 音频混音:
OwnerSafeAudioMixer,按 owner 管理声音、混音和资源释放(experimental)。 - 多玩家输入:
BrowserMultiplayerInput与玩家输入快照(experimental)。 - 字体:GUI 字体配置及动画文本样式。
- 动画交互:
InteractionRuntime、事件路由和动作契约。 - 虚拟摇杆:固定或浮动中心、死区、2D/3D 移动和输入清理。
渲染与发布改进
修复 AO 画面、灯光采样容量、反射视图可见性及 Volume 接线,统一 Live2D 示例资源。发布资格支持完整 Mac Chrome/Metal 或 Windows Chrome+Edge 原生 GPU 路径。示例站点通过 GitHub Actions 从 master 构建部署。
安装与兼容
npm install @haiyue/engine@0.2.0 @haiyue/animation-spec@0.2.0 @haiyue/extensions@0.2.0
npm install --save-dev @haiyue/shader-language@0.2.0Engine、animation-spec 和 extensions 应一起升级,避免混装 0.1.x。Engine 默认入口保持 30 个稳定符号;HYA 数据格式与 Shader artifact 版本独立管理。本次不包含 Rive、UI、Editor、Games 或 CalendarPuzzle。
验证记录
冻结提交:4563e8d6b1f5204af37dc98d5630c62918d02a84。采用 macOS Chrome/Metal 原生 GPU 发布资格路径,源码保持干净,正式基线未变更。
- 正式灯光、渲染与像素检查、55 个全量自动示例、1800 帧 readback 长跑、四包确定性打包与真实安装/消费、入口体积预算通过。
- 完整 CPU 基准覆盖 93 项,资源指标违规为 0。本机未纳入固定时延基线,7 项时延告警保留为诊断信息。
- 首轮全局门禁在跨引擎比较处因 Three、Babylon、PlayCanvas 采样噪声退出。保持源码、场景、三轮采样配置和阈值不变,完整复测全部五引擎后通过;两轮原始记录均保留。
- 正式复测的 WebGPU P50:HaiYue 1.525 ms、Three 2.045 ms、Babylon 2.070 ms、PlayCanvas 3.105 ms。此结果仅代表该机器和比较场景;Galacean WebGL2 单列。
- 生产依赖审计覆盖 64 个组件,已知漏洞为 0,许可证和凭据扫描通过。
- 发布演练及独立制品校验通过;五项发布制品已按最终字节内容验证 SHA-256,附带 SBOM 和来源记录。
GitHub hosted Fast 和 Pages 构建部署成功。hosted Slow 的 SwiftShader 平面反射大场景超时记录保留;同版本原生 Mac 的四项平面反射工作负载和像素检查通过。
在线示例已由 master 的同一提交部署,共 91 个已发布条目。发布归档中的全量自动验收示例为 55 个;两者统计范围不同。
版本标签采用普通带注释标签(未签名),本次例外已获发布负责人明确批准。