Extension Qr Code

作者 caffeinelabs362f51ae96f0無授權條款2 個星標收錄於 2026年10月8日更新於 2026年10月8日儲存庫今天更新

QR code scanner using the camera.

AI 產生的概覽

透過預製 React hook 為 Caffeine AI 應用程式加入以相機為基礎的 QR Code 掃描功能。

功能
此技能說明如何為 Caffeine AI 應用程式加入使用裝置相機的 QR Code 掃描功能。它介紹一個預製 React hook useQRScanner,該 hook 封裝相機元件並使用 jsQR 進行解碼,對外提供掃描結果、相機狀態,以及啟動、停止、切換相機、清除與重試等控制方法。它也提供使用範例,展示影片與畫布參照、結果呈現及錯誤顯示。
適用情境
適用於需要透過裝置相機讀取 QR Code 的 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 從公開儲存庫中收錄這些內容。

檢舉或申請下架