更新日志¶
0.1.0-alpha.4¶
新增功能¶
- Session Replay 隐私组件：为 Creator 2 和 Creator 3 新增
ReplayPrivacy编辑器组件，可在截取的重放画面中遮罩或隐藏节点及预制体。安装器会将组件复制到项目资源目录；代码覆盖规则优先，输入框仍默认遮罩。
优化¶
- Session Replay 截帧性能：将 Android 和 iOS 上的重放文件读写及原生图像编码移出游戏线程。更新 SDK 后需要重新构建原生工程，以包含异步 Bridge。
- Hybrid 隐私示例：在维护中的 Creator 2 和 Creator 3 Hybrid 示例中增加隐私组件示例及遮罩对齐测试控件。
修复¶
- Android Session Replay 播放：将原生依赖安装器中的
ft-session-replay:0.1.9-alpha02升级到0.1.9-alpha03，使分段压缩与 Browser SDK 格式一致，恢复受影响的多分段会话播放。已使用发布到 Maven 的产物，在原生页面与 Cocos 页面间通过旧版、新版、再回到旧版的对照方式验证。
0.1.0-alpha.3¶
优化¶
- Android SDK 依赖：在 Creator 2 和 Creator 3 的原生依赖安装器中，将 Android Agent SDK 从
1.7.6-alpha01升级到1.7.6-alpha02，将 Session Replay 从0.1.9-alpha01升级到0.1.9-alpha02。 - Hybrid 接入示例：每代 Creator 保留一个最小 Hybrid 接入工程。从维护中的示例移除旧诊断工程、复制的 SDK 安装目录和重放流量基准测试工具。
- SDK 与示例提示：移除不必要的品牌名称，简化 SDK 错误信息和示例文案。
修复¶
- npm 发布：发布前检查包元数据，检测版本是否已存在并验证其发布标识。在首个稳定版本发布前，将最新预发布版本发布到
latest标签。
0.1.0-alpha.2¶
修复¶
- Session Replay 隐私遮罩：修复 Creator 2 和 Creator 3 中 Camera 投影改变控件在截帧里的位置或尺寸时，输入框与自定义节点遮罩错位的问题。如果隐私边界无法可靠投影，则跳过该帧，避免采集遮罩位置不正确的画面。
0.1.0-alpha.1¶
基于提交 2bbeeb86270b666e5eeddc6f220586df66f10362 发布。
首个预发布版本，为运行于 Android 和 iOS 原生平台的 Cocos Creator 应用提供用户访问监测（RUM）、日志、分布式链路追踪和实验性 Session Replay。
新增功能¶
- RUM 自动采集与手动埋点：可按需采集场景切换、触摸交互，以及运行时支持的 JavaScript 错误和未处理的 Promise 拒绝。支持手动记录 View、Action、Error、Long Task 和网络 Resource，以监测关键业务流程。可配置原生崩溃、Android ANR、UI 卡顿及设备性能监测。
- 日志采集：支持上报自定义日志及按需采集 Console 输出。可配置日志级别过滤、采样和缓存策略，并关联当前 RUM 会话，结合用户行为排查问题。
- 网络监测与链路关联：自动采集运行时提供的
fetch和XMLHttpRequest的基本请求、响应信息及总耗时，并注入 Trace Header。支持手动 Resource 埋点和 Trace Header 生成，用于自定义网络接入。DNS、TCP 和 SSL 分阶段耗时需要手动埋点。 - Session Replay（实验性）：采集 Cocos 画面并关联 RUM 会话。可配置采样、错误会话额外采样、截帧频率和图像尺寸。支持遮罩和隐藏节点；默认遮罩输入框并隐藏触摸位置。
- 重放画质与流量控制：可配置画质预设、单帧大小限制和滚动窗口图像数据预算。自适应采集根据预算使用情况调整截帧频率、画质和尺寸，帮助平衡重放细节与数据用量。
- 原生宿主 Hybrid 接入：复用嵌入 Cocos 的原生应用已初始化的 SDK。通过
guanceSdk.attach()接入，并使用guanceSdk.enterCocos()和guanceSdk.leaveCocos()管理 Cocos 采集生命周期，避免重复初始化宿主 SDK。 - 用户与业务上下文：支持绑定和解绑用户、添加全局及事件级自定义属性，以按用户、环境和业务上下文筛选监测数据。支持通过 DataKit 或 DataWay 上报。
- 项目安装工具：提供包含独立 Creator 2 和 Creator 3 入口的 npm 包、安装命令及构建扩展，辅助配置 Android 和 iOS 原生 Bridge 与依赖。
接入要求¶
- 支持 Cocos Creator 2.4.5–2.4.15 和 3.6.3–3.8.x；3.0–3.6.2 为尽力支持。
- 要求 Android API 21+ 或 iOS 12+。当前不支持 Web、小游戏和桌面端目标。
- 独立 Cocos 应用使用
guanceSdk.start()初始化。Hybrid 应用先在原生宿主中初始化 SDK，再调用guanceSdk.attach()。两种初始化方式互斥。 - 按需配置 RUM、日志、链路追踪、Session Replay 和自动采集。生成 iOS 原生工程后，执行
pod install安装依赖。