# @amplitude/session-replay-react-native 中文文档

规范地址：https://npmcn.com/package/%40amplitude/session-replay-react-native/

版本：1\.1\.1
npm 元数据更新时间：2026-11-06T19:44:03.898Z
中文译文更新时间：2026-11-06T19:47:17.851Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40amplitude/session-replay-react-native
原文对照：https://npmcn.com/package/%40amplitude/session-replay-react-native/?lang=original
项目主页：https://github.com/amplitude/Amplitude-TypeScript
源码仓库：https://github.com/amplitude/Amplitude-TypeScript

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：167 kB，100 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：react \*，react-native \*
- 首次发布：2025-07-08T15:38:31.390Z
- 最新版本发布：2026-11-06T19:44:03.525Z
- 近 30 天下载量：14747（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：19（近 12 个月 18 个）

## 中文简介

重放原生反应的振幅会话

## 安装

```sh
npm install @amplitude/session-replay-react-native
```

也可以使用：`pnpm add @amplitude/session-replay-react-native`、`yarn add @amplitude/session-replay-react-native`、`bun add @amplitude/session-replay-react-native`

## README

# @ amplitude/session-replay- react-inative (英语)

重放原生反应的振幅会话

## 安装

```sh
npm install @amplitude/session-replay-react-native
```

## 反应原生新建筑

此 SDK 支持新架构( Bridgeless / TurboModules) 和 传统建筑。 在"新建筑"上,原生模块被曝光为一个 TurboModule;关于传统建筑,它继续作为标准桥梁运作 模块。 不需要配置——选择正确的执行 自动基于您的应用程序是如何构建的 .

`peerDependencies` (b) 故意不加以限制(`react-native: "*"`这样 sDK不断在遗产架构上研究更古老的React Industrial版本. TurboModule 代码路径仅在启用新架构时编译, 它本身需要回放土著0.74或更新.

## 使用量

### 会话重放重现原生独立 SDK

初始化 SDK , 以您的 Amplition API 密钥和会话标识符 匹配您分析事件的会话 ID:

```js
import { init, SessionReplayConfig } from '@amplitude/session-replay-react-native';

const config: SessionReplayConfig = {
  apiKey: 'YOUR_API_KEY',
  deviceId: 'YOUR_DEVICE_ID',
  sessionId: Date.now(),
};

await init(config);
```

会话重放在设置有效会话 ID 之前不抓取任何内容—— a 正数或非空字符串。 在那之前,SDK会保持配置,但是 空闲,即使之后 `start()`。 。 。 .

要使用振幅会话与振幅分析重放,请使用 [`@amplitude/plugin-session-replay-react-native`](https://www.npmjs.com/package/@amplitude/plugin-session-replay-react-native) 插件包 .

## 遮掩视图

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

`<AmpMaskView>` 铺得一模一样平地 `<View>` 并致力于两个 React Introduct 架构:在"新架构"上,它是一个原生的Fabric组件,在它使用经典取景管理器的旧架构上.

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

// ...

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

## 解密视图

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

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

// ...

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

## 跟踪网页视图 (Beta)

网页视图默认被屏蔽,不会被跟踪. 如果你想跟踪网页视图,你可以手动解密 他们采取以下行动:

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

## 常见问题

### @amplitude/session-replay-react-native 是什么？

重放原生反应的振幅会话

### 如何安装 @amplitude/session-replay-react-native？

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

### @amplitude/session-replay-react-native 支持 TypeScript 吗？

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

### @amplitude/session-replay-react-native 支持 ESM 还是 CommonJS？

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

### @amplitude/session-replay-react-native 可以商用吗？

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

### @amplitude/session-replay-react-native 的下载量有多少？

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

### @amplitude/session-replay-react-native 还在维护吗？

最新版本 1\.1\.1 发布于 2026/11/07（1 天前）；至今共发布 19 个版本，其中过去 12 个月发布了 18 个；首次发布于 2025/07/08。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。