Extension Qr Code

作者 caffeinelabs362f51ae96f0无许可证2 个星标收录于 2026年10月8日更新于 2026年10月8日仓库今天更新

QR code scanner using the camera.

AI 生成的概览

通过预制 React hook 为 Caffeine AI 应用添加基于摄像头的二维码扫描功能。

功能
该技能说明如何为 Caffeine AI 应用添加使用设备摄像头的二维码扫描功能。它介绍了一个预制 React hook useQRScanner,该 hook 封装摄像头组件并使用 jsQR 进行解码,对外提供扫描结果、摄像头状态以及启动、停止、切换摄像头、清除和重试等控制方法。它还给出使用示例,展示视频与画布引用、结果渲染和错误显示。
适用场景
适用于需要借助设备摄像头读取二维码的 Caffeine AI 应用开发。适合需要摄像头预览、扫描历史、摄像头切换以及扫描错误处理的前端场景。
运行要求
需要 npm 包 @caffeineai/qr-code 和 @caffeineai/camera、React 前端以及浏览器摄像头权限;jsQR 默认从 CDN 加载。不附带脚本,仅为说明文档。

QR Code Scanner

QR code scanner extension for Caffeine AI.

Overview

This skill adds QR code scanning using the device camera. Built on top of the camera component with jsQR for decoding.

Frontend

For QR code scanner support:

There is a prefabricated React hook imported from @caffeinelabs/qr-code that cannot be modified.

typescript
import { RefObject } from 'react';import { CameraConfig, CameraError } from '@caffeineai/camera';
export interface QRResult {  // The decoded QR code data  data: string;  // Timestamp when the QR code was scanned  timestamp: number;}
export interface QRScannerConfig extends CameraConfig {  // How often to scan for QR codes in milliseconds (default: 100)  scanInterval?: number;  // Maximum number of results to keep in history (default: 10)  maxResults?: number;  // URL to load jsQR library from (default: jsdelivr CDN)  jsQRUrl?: string;}
export interface UseQRScannerReturn {  // Array of scanned QR codes (newest first)  qrResults: QRResult[];  // Whether currently scanning for QR codes  isScanning: boolean;  // Whether jsQR library has been loaded  jsQRLoaded: boolean;    // Camera state (pass-through from useCamera)  isActive: boolean;  isSupported: boolean | null;  error: CameraError | null;  isLoading: boolean;  currentFacingMode: 'user' | 'environment';    // Start camera and begin scanning - returns true on success  startScanning: () => Promise<boolean>;  // Stop scanning and camera  stopScanning: () => Promise<void>;  // Switch camera facing mode - returns true on success  switchCamera: () => Promise<boolean>;  // Clear all scan results  clearResults: () => void;  // Reset scanner state (stop scanning and clear results)  reset: () => void;  // Retry camera initialization after error - returns true on success  retry: () => Promise<boolean>;    // Ref to attach to video element for camera preview  videoRef: RefObject<HTMLVideoElement>;  // Ref to attach to canvas element used for QR processing (can be hidden)  canvasRef: RefObject<HTMLCanvasElement>;    // Computed state  // Whether scanner is ready to use (jsQR loaded and camera supported)  isReady: boolean;  // Whether scanning can be started (ready + not loading)  canStartScanning: boolean;}
export declare function useQRScanner(config?: QRScannerConfig): UseQRScannerReturn;

Usage example:

typescript
import { useQRScanner } from '@caffeineai/qr-code';
function QRScannerComponent() {    const {         qrResults,        isScanning,        isActive,        isSupported,        error,        isLoading,        canStartScanning,        startScanning,        stopScanning,        switchCamera,        clearResults,        videoRef,        canvasRef     } = useQRScanner({         facingMode: 'environment',        scanInterval: 100,        maxResults: 5    });
    if (isSupported === false) {        return <div>Camera not supported</div>;    }
    return (        <div>            <video                 ref={videoRef}                 style={{ width: '100%', height: 'auto' }}                playsInline                muted            />            <canvas ref={canvasRef} style={{ display: 'none' }} />                        {error && <div>Error: {error.message}</div>}                        <div>                <button onClick={startScanning} disabled={!canStartScanning}>                    Start Scanning                </button>                <button onClick={stopScanning} disabled={isLoading || !isActive}>                    Stop Scanning                </button>                {/* Only show switch camera on mobile */}                {/Android|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(navigator.userAgent) && (                    <button onClick={switchCamera} disabled={isLoading || !isActive}>                        Switch Camera                    </button>                )}            </div>                        <div>                <h3>Results {qrResults.length > 0 && <button onClick={clearResults}>Clear</button>}</h3>                {qrResults.map(result => (                    <div key={result.timestamp}>                        <small>{new Date(result.timestamp).toLocaleTimeString()}</small>                        <p>{result.data}</p>                    </div>                ))}            </div>        </div>    );}

Properly display QR scanner error messages in the app.

来源与署名

来源:caffeinelabs/skills位于skills/extension-qr-code提交362f51a

许可证: 无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架