让开源，少一点语言距离。
npm包中文文档

@alexpuertasr/react-qr-scanner

中文文档
1.2.10发布于 2024/03/11MITTypeScriptESM + CJS近 30 天下载 6441

在反应中扫描 qr 代码的库 .

中文使用文档
中文原文
文档目录7 节
  1. 特征
  2. 演示
  3. 安装
  4. 使用量
  5. 支持的格式
  6. 限制
  7. API 密码

特征

  • 使用智能手机相机或网络相机扫描Qr代码.

演示

检查 演示。 。 。 .

安装

yarn add @yudiel/react-qr-scanner

npm install @yudiel/react-qr-scanner

使用量

import {QrScanner} from '@yudiel/react-qr-scanner';

const App = () => {
  return (
      <QrScanner
          onDecode={(result) => console.log(result)}
          onError={(error) => console.log(error?.message)}
      />
  );
}

支持的格式

1D产品1D 工业二维
刚果爱国者联盟- A 类代码 39QR 代码
欧安-8代码 128数据矩阵
欧安-13简易新闻聚合14阿兹特克
PDF 417 (中文(简体) )

限制

  • 由于浏览器执行,相机只能通过https或localhost访问.
  • 服务器侧渲染不会起作用,所以在浏览器环境中渲染时只需要组件.

API 密码

属性类型默认值说明
约束介质跟踪约束{ facingMode: 'environment' }指定应该使用哪个相机(如果有的话) .
容器样式object无容器元素的样式对象.
视频Styleobject无视频元素的样式对象 .
扫描延迟number500QR钩的扫描期.
视频stringvideoId视频元素的ID.
报告function无为结果对象扫描事件处理器 .
十进制时function无扫描事件处理器解码值 .
错误function无为错误对象扫描事件处理器 .
查看窗口component无查看Finder 组件以在视频元素中覆盖渲染
隐藏booleantrue将扫描数隐藏在视频元素中
停止解析booleanfalse停止解码进程

版本与发布记录

@alexpuertasr/react-qr-scanner 共发布 1 个版本，首次发布于 2024/03/11；过去 12 个月发布了 0 个版本。

版本发布日期距今
1.2.10latest2024/03/112 年前

关于 @alexpuertasr/react-qr-scanner 的常见问题

@alexpuertasr/react-qr-scanner 是什么？

在反应中扫描 qr 代码的库 .

如何安装 @alexpuertasr/react-qr-scanner？

在项目目录运行 npm install @alexpuertasr/react-qr-scanner，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^17.0.2 || ^18.0.0）、react-dom（^17.0.2 || ^18.0.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

@alexpuertasr/react-qr-scanner 支持 TypeScript 吗？

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

@alexpuertasr/react-qr-scanner 支持 ESM 还是 CommonJS？

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

@alexpuertasr/react-qr-scanner 可以商用吗？

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

@alexpuertasr/react-qr-scanner 的下载量有多少？

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

@alexpuertasr/react-qr-scanner 还在维护吗？

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