SuperAPI AI 工具集

add-session-recording

前端与建站

查看项目

更新于 10-16 05:49

技能介绍

用途:为 React 应用接入隐私感知的会话录制与回放,捕获用户交互用于回放分析。

安装:npm install --ignore-scripts --save-exact @temps-sdk/react-analytics@0.0.4。资料称该版本已核验,并给出 integrity 值为 sha512-UMCA7nwvrUabu3Ro40zx0arhSsFhnYT41ddKChT8NebkBo+DjUK37UClujAzbE+1CIgRfYbP3VcHQwvzCvUlOw==,安装前会变更依赖与 lockfile,需确认。

两种录制方式(二选一): A)推荐:在 TempsAnalyticsProvider 上通过 enableSessionRecording 与 sessionRecordingConfig 开启,无需第二个 Provider。basePath="/api/_temps" 适用于部署在 Temps 的应用,数据经该路径上报。 B)可由用户开关的录制(同意流程):使用独立的 SessionRecordingProvider,其真实 props 仅 defaultEnabled 与 persistPreference;遮挡/屏蔽仍由 analytics provider 的 sessionRecordingConfig 配置。控制 hook 返回 { isEnabled, enable, disable, toggle }。资料提示:useSessionRecording()(不带 Control)返回 { isRecordingEnabled, enableRecording, disableRecording, toggleRecording, sessionId },早期文档中的 startRecording 等 API 并不存在。

隐私控制:通过 sessionRecordingConfig 中配置的 CSS 类进行遮挡与屏蔽,默认类为 rr-block(完全屏蔽并显示占位)、rr-mask(文本打码)、rr-ignore(忽略录制);maskAllInputs 默认 true。资料提示 data-rr-block / data-rr-mask 属性选择器默认未接通,应使用配置的 CSS 类或自定义选择器。

条件录制:可用 enableSessionRecording={process.env.NODE_ENV === 'production'} 仅生产环境开启;或用 SessionRecordingProvider defaultEnabled 按用户控制;排除页面用 sessionRecordingConfig.excludedPaths,而非按路由切换。

验证:在 DevTools Network 观察向 /api/_temps/session-replay 的 POST,交互生成事件后在 Temps 仪表盘打开回放,确认被遮挡/屏蔽元素不可见。资料特别说明上报端点是 /api/_temps/session-replay,而非 /api/_temps/recordings。

限制:API 具体行为依赖该 SDK 版本;定价、平台支持范围、回放存储与保留策略等资料暂未提供。