如何配置Quagga.js扫描首尾带有矩形标识的条形码

1. 补全支持的码制配置 #

Quagga.js默认不会启用全部码制，你所说的首尾带类矩形符号的条码多为Code 128、GS1系列、EAN/UPC变体码，需要在初始化的decoder配置中主动声明启用对应码制，不要依赖默认值：

// 初始化配置示例
Quagga.init({
  inputStream : {
    name : "Live",
    type : "LiveStream",
    target: document.querySelector('#scanner-container')
  },
  decoder : {
    // 按需添加你需要支持的码制，不要缺漏
    readers : ["code_128_reader", "ean_reader", "ean_8_reader", "upc_reader", "upc_e_reader", "gs1_128_reader"]
  }
}, (err) => {
  if (err) return console.error("初始化失败：", err);
  Quagga.start();
});

2. 调整定位器匹配阈值 #

首尾矩形特殊标记容易被默认边缘过滤逻辑判定为非条码区域，可修改locator配置降低过滤阈值，扩大识别匹配范围：

Quagga.init({
  // 上方inputStream配置保持不变
  locate: true,
  locator: {
    patchSize: "large", // 可选值：x-small/small/medium/large/x-large，尺寸越大越容易识别带大边界标记的条码
    halfSample: false,
    threshold: 0.7 // 默认值为0.9，可根据识别效果下调至0.5~0.8区间
  },
  decoder: {
    // 码制配置同上
  }
})

3. 关闭严格校验规则 #

默认开启的严格校验会过滤不符合标准长宽比、首尾特征的条码区域，首尾带额外标记的条码不符合通用标准校验规则，需主动关闭严格校验：

Quagga.init({
  // 其余配置保持不变
  decoder: {
    readers: [/* 你的码制列表 */],
    strict: false, // 关闭严格格式校验
    multiple: false
  }
})

如果完成上述调整后仍无法识别，可先使用Quagga.decodeSingle()接口对条码静态图片做离线识别，确认是否是该码制本身不被Quagga.js支持。

内容的提问来源于stack exchange，提问作者Sebastian