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

重放原生反应的振幅会话

安装

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:

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 插件包 .

遮掩视图

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

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

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 在区域周围被解开

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)

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

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