@amplitude/plugin-session-replay-react-native

中文文档
0.5.13发布于 2026/11/07MITTypeScriptESM + CJS构建来源已验证近 30 天下载 27.7万

原生反射的振幅会话重放插件

中文使用文档
文档目录6 节
  1. 安装
  2. 使用量
  3. 遮罩级别
  4. 遮掩视图
  5. 解密视图
  6. 跟踪网页视图 (Beta)

@amplitude/plugin-session-replay- react-native (英语)

原生反射的振幅会话重放插件

安装

npm install @amplitude/plugin-session-replay-react-native

使用量

将会话重放插件添加到您的振幅实例如下

import { SessionReplayPlugin } from '@amplitude/plugin-session-replay-react-native';

// ...

const config: SessionReplayConfig = {
    enableRemoteConfig: true, // default true
    sampleRate: 1, // default 0
    logLevel: LogLevel.Warn, // default LogLevel.Warn
    privacyConfig: { maskLevel: 'medium' }, // 'medium' is the default
};
await init('YOUR_API_KEY').promise;
await add(new SessionReplayPlugin(config)).promise;

遮罩级别

控制会话如何激烈地通过 privacyConfig.maskLevel 配置选项 :

数值被蒙上面具的东西
'light'密码和电话号码 <TextInput> 仅字段
'medium' (默认)全体 <TextInput> 字段
'conservative'全体 <TextInput> 字段 财务报告和审定财务报表 全部 <Text> 要素
import { SessionReplayPlugin } from '@amplitude/plugin-session-replay-react-native';

const config: SessionReplayConfig = {
    privacyConfig: { maskLevel: 'conservative' }, // mask all text and inputs
};

说明: 绕过 UIKit/ Android 标准文本视图的第三方文本渲染器( 例如) react-native-svg, (中文(简体) ), @shopify/react-native-skia)不通过自动蒙面检测出. 将内容包入 <AmpMaskView mask="amp-mask"> 手动遮住.

遮掩视图

要掩盖某些观点,请添加 AmpMaskView 带有口罩属性的标签 amp-mask 被蒙上面具的部分

import { AmpMaskView } from '@amplitude/plugin-session-replay-react-native';

// ...

<AmpMaskView mask="amp-mask">
    <Text
    style={[
        styles.sectionTitle,
        {
        color: isDarkMode ? Colors.white : Colors.black,
        },
    ]}
    >
    {title}
    </Text>
</AmpMaskView>

解密视图

要解析视图,请添加 AmpMaskView 带有口罩属性的标签 amp-unmask 在区域周围被解开

import { AmpMaskView } from '@amplitude/plugin-session-replay-react-native';

// ...

<AmpMaskView mask="amp-unmask">
    <Text
    style={[
        styles.sectionTitle,
        {
        color: isDarkMode ? Colors.white : Colors.black,
        },
    ]}
    >
    {title}
    </Text>
</AmpMaskView>

跟踪网页视图 (Beta)

网页视图默认被屏蔽,不会被跟踪. 如果你想跟踪网页视图,你可以通过下列操作手动解析它们

<AmpMaskView mask="amp-unmask" style={{ flex: 1 }}>
    <WebView source={{ uri: 'https://reactnative.dev/' }} style={{ flex: 1 }} />
</AmpMaskView>

版本与发布记录

@amplitude/plugin-session-replay-react-native 共发布 55 个版本,首次发布于 2024/10/31;过去 12 个月发布了 34 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.5.13latest2026/11/071 天前
0.5.13-sr-bfcache-pageshow-snapshot.02026/11/052 天前
0.5.122026/10/317 天前
0.5.12-video-analytics-8.02026/10/2811 天前
0.5.12-video-analytics-7.02026/10/2712 天前
0.5.12-codexsemantic-review-integration.02026/10/2315 天前

其他发布通道:prereleasenetworkcapture → 0.4.2-prereleasenetworkcapture.0,networkcaptureprerelease → 0.4.2-networkcaptureprerelease.0,networktrackingprereleasemay → 0.4.2-networktrackingprereleasemay.0,pnpm-migration → 0.4.6-pnpm-migration.0,fake-branch-1141 → 0.4.6-fake-branch-1141.0,SR-2360 → 0.4.6-SR-2360.0。

关于 @amplitude/plugin-session-replay-react-native 的常见问题

@amplitude/plugin-session-replay-react-native 是什么?

原生反射的振幅会话重放插件

如何安装 @amplitude/plugin-session-replay-react-native?

在项目目录运行 npm install @amplitude/plugin-session-replay-react-native,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(*)、react-native(*)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@amplitude/plugin-session-replay-react-native 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@amplitude/plugin-session-replay-react-native 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@amplitude/plugin-session-replay-react-native 可以商用吗?

@amplitude/plugin-session-replay-react-native 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@amplitude/plugin-session-replay-react-native 的下载量有多少?

根据 npm 官方下载统计,@amplitude/plugin-session-replay-react-native 在 2026/10/06 – 2026/11/04 这 30 天内被下载 276,671 次,日均约 9,222 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@amplitude/plugin-session-replay-react-native 还在维护吗?

最新版本 0.5.13 发布于 2026/11/07(1 天前);至今共发布 55 个版本,其中过去 12 个月发布了 34 个;首次发布于 2024/10/31。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。