qin.scanCode(OBJECT)

调起客户端扫码界面，扫码成功后返回对应的结果。

平台差异说明

H5	微信小程序	小红书小程序	抖音小程序	快手小程序
x	√	√	√	√

OBJECT 参数说明

参数名	类型	必填	说明	平台差异说明
onlyFromCamera	Boolean	否	是否只能从相机扫码，不允许从相册选择图片	抖音小程序、支付宝小程序不支持此参数
scanType	Array	否	扫码类型，参考下方 scanType 的合法值	抖音小程序不支持此参数
autoDecodeCharset	Boolean	否	是否启用自动识别字符编码功能，默认为否	App
barCodeInput	Boolean	否	是否支持手动输入条形码	仅飞书小程序（V3.14.0）支持
hideAlbum	Boolean	否	是否隐藏相册（不允许从相册选择图片），只能从相机扫码。默认值为 false。	仅支付宝小程序支持
success	Function	否	接口调用成功的回调，返回内容详见返回参数说明。
fail	Function	否	接口调用失败的回调函数（识别失败、用户取消等情况下触发）
complete	Function	否	接口调用结束的回调函数（调用成功、失败都会执行）

scanType的合法值

值	说明
barCode	一维码
qrCode	二维码
datamatrix	Data Matrix 码
pdf417	PDF417 条码

success 返回参数说明

参数	说明	平台差异说明
result	所扫码的内容
scanType	所扫码的类型	微信小程序、小红书小程序
charSet	所扫码的字符集	微信小程序、小红书小程序
path	当所扫的码为当前应用的合法二维码时，会返回此字段，内容为二维码携带的 path。	微信小程序
rawData	原始数据，base64 编码	微信小程序
code	扫码所得数据	支付宝小程序
qrCode	扫描二维码时返回二维码数据	支付宝小程序
barCode	扫描条形码时返回条形码数据	支付宝小程序
imageChannel	来源	支付宝小程序

示例

// 允许从相机和相册扫码
qin.scanCode({
  success: (theRes) => {
    console.log('条码类型：' + theRes.scanType);
    console.log('条码内容：' + theRes.result);
  },
});

// 只允许通过相机扫码
qin.scanCode({
  onlyFromCamera: true,
  success: (theRes) => {
    console.log('条码类型：' + theRes.scanType);
    console.log('条码内容：' + theRes.result);
  },
});

// 调起条码扫描
qin.scanCode({
  scanType: ['barCode'],
  success: (theRes) => {
    console.log('条码类型：' + theRes.scanType);
    console.log('条码内容：' + theRes.result);
  },
});

// 允许从相机和相册扫码
qin.scanCode({
  success: (theRes) => {
    console.log('条码类型：' + theRes.scanType);
    console.log('条码内容：' + theRes.result);
  },
});

// 只允许通过相机扫码
qin.scanCode({
  onlyFromCamera: true,
  success: (theRes) => {
    console.log('条码类型：' + theRes.scanType);
    console.log('条码内容：' + theRes.result);
  },
});

// 调起条码扫描
qin.scanCode({
  scanType: ['barCode'],
  success: (theRes) => {
    console.log('条码类型：' + theRes.scanType);
    console.log('条码内容：' + theRes.result);
  },
});

注意

• 微信小程序自定义扫码界面，可使用camera组件。详见
• 微信内嵌浏览器运行H5版时，可通过js sdk实现扫码，需要引入一个单独的 js ，详见
• 在扫码界面点击返回也会进入 fail 回调中
• 支付宝小程序不支持 success 回调中的 charSet ， path