uni-app App端半屏连续扫码

本文简介

点赞 + 关注 + 收藏 = 学会了

本文用一个简单的 demo 讲解 App端 半屏连续扫码 的实现方式，包括（条形码、二维码等各种各样的码）。

我会从实现思路讲起，如果你比较急可以直接跳到 动手实现 章节获取代码。

开发和运行环境

• 开发工具：HBuilderX
• 前端框架：uni-app 我用了 vue3 的模式开发
• 前端延伸能力：HTML5+
• 运行环境：一加8（安卓手机）

需求收集

看到论坛上有人想在 App端 实现 连续扫码 功能。

认真看了下图，还是个 半屏 的扫码框。

只是看到提了下需求，并没搜到多少解决方案。

于是我去 uni-app官网 看了下，找到相关的内容：

• <camera> 组件
• uni.scanCode 扫码的API

但 <camera> 组件不支持 App 端使用（至少在写本文时不支持）；

uni.scanCode 可以扫码，但会跳到另一个界面，并在全屏的模式下扫码，也不支持连续扫码。

当然，用 uni.scanCode 可以在扫码成功后再重新执行一次，这样就能实现连续扫码的功能，但界面会跳来跳去（跳到扫码界面，成功后又跳回app的界面，再执行又跳到扫码界面......）。

提炼需求

根据上面的信息，提炼出3个关键词：

• App端
• 半屏
• 连续扫码

我采用了 DCLOUD社区 《uni-app怎么自定义扫码和连续扫》 里的需求。粗略的写了下布局（我没有精细写样式）

最终实现的效果如下图所示

我用在线工具生成了2个二维码，内容分别为 “雷猴” 和 “鲨鱼辣椒”。

通过扫描二维码，把内容添加到页面中。

实现思路

查文档

既然 uni-app 的组件和API 都没有提供这方面的帮助，我就去 插件市场 看了下，要么只支持小程序，要么是收费的。

收费的？🤔🤔🤔 算了，大家都是打工人。

现在 uni-app 官方文档 和 插件市场 两条路都走不通(主要是我穷)，那还有一条路：html5+

node.js 可以理解为前端向服务端的延展， html5+ 可以理解为前端向 App 的延展。

为了不浪费大家时间，我整理出本文要用到的 API 和 模块。

打开 html5+ 可以找到 barcode 扫码模块，该模块有个 create 方法 用来创建扫码识别控件。

但 plus.barcode.create() 方法又需要用到 plus.webview ，也就是会涉及到 webview 模块 。

webview 模块 是用来管理应用窗口界面的，也就可以弄一个半屏的窗口出来。

整理

相关方法都找到七七八八了，只需把逻辑整理好就可以编码了。

1. 【步骤1】弄一个窗口出来（半屏，或者你自己定个尺寸和定位吧）
2. 【步骤2】弄一个扫码控件对象出来
3. 【步骤3】将扫码控件添加到窗口
4. 【步骤4】扫码成功后将结果添加到页面上
5. 【步骤5】重新调用扫码方法

动手实现

我将上面5个步骤都在代码注释里标记出来了。

<template>
  <view class="page">
    <view class="title">扫码结果</view>
    <view class="result_list">
      <view v-for="item in list" :key="item" class="result_li">
        {{ item }}
      </view>
    </view>
  </view>
</template>

<script setup>
import { onReady } from '@dcloudio/uni-app'
import { ref } from 'vue'

let webView = null // webview容器
let barcode = null // 扫码框

const list = ref([]) // 扫码结果 - 列表

// 扫码成功回调
function onmarked(type, result) {
  // 【步骤4】将扫码结果添加到 list 里
  list.value.push(result)

  // 【步骤5】1秒后再重新开启扫码
  setTimeout(() => {
    barcode.start()
  }, 1000)
}

// 创建窗口和扫码控件
function createBarcode() {
  // 【步骤1】判断有没有创建过 webview 容器，如果没有就执行创建操作
  if (!webView) {
    webView = plus.webview.open(
      '',
      'barCodeBox',
      {
        top: '60px',
        width: '100%',
        height: '200px'
      }
    )
  }

  // 【步骤2】判断有没有创建过 扫码框，如果没有就执行创建操作
  if(!barcode){
    barcode = plus.barcode.create(
      'barcode',
      [plus.barcode.QR], // 只扫二维码
      {
        top:'0px',
        left:'0px',
        width: '100%',
        height: '200px',
        position: 'static',
        scanbarColor: '#f1c01f',
        frameColor: '#c0ff01'
      }
    )

    barcode.onmarked = onmarked // 扫码结果回调函数

    // 【步骤3】将扫码框添加到 webview 里
    plus.webview.getWebviewById('barCodeBox').append(barcode)
  }

  barcode.start() // 开始扫码
}

// 在页面加载时，延迟300毫秒执行创建扫码框函数
onReady(() => {
  setTimeout(() => {
    createBarcode()
  }, 300)
})
</script>

<style>
.page {
  height: 100vh;
  display: flex;
  flex-direction: column;
  box-sizing: border-box;
  padding: 200px 20rpx 0;
}

.title {
  font-size: 50rpx;
  color: #333;
}

.result_list {
  flex: 1;
  overflow-y: auto;
  box-sizing: border-box;
  padding-top: 20rpx;
}

.result_li {
  box-sizing: border-box;
  margin-bottom: 20rpx;
  padding: 10rpx 20rpx;
  border: 1px solid #7298c8;
  border-radius: 10rpx;
  font-size: 40rpx;
}
</style>

样式我没写得很精细，只是做了个粗糙的布局。

相关文档

前端佬使用 uni-app 开发 App端 ，建议粗略过一遍 HTML5+ 文档，然后抽几个自己感兴趣的功能做个demo出来（这样能省钱，插件市场的东西也不便宜）。

扫码相关

barcode 模块文档

plus.barcode.create 的第二个参数是一个数组，里面可以设置需要识别的条码类型，可以同时支持多种条码。

barcode 支持多种条码：

• QR: QR二维码，数值为0
• EAN13: EAN条形码标准版，数值为1
• EAN8: ENA条形码简版，数值为2
• AZTEC: Aztec二维码，数值为3
• DATAMATRIX: Data Matrix二维码，数值为4
• UPCA: UPC条形码标准版，数值为5
• UPCE: UPC条形码缩短版，数值为6
• CODABAR: Codabar条形码，数值为7
• CODE39: Code39条形码，数值为8
• CODE93: Code93条形码，数值为9
• CODE128: Code128条形码，数值为10
• ITF: ITF条形码，数值为11
• PDF417: PDF 417二维条码，数值为13

我们在本例中主要用到 barcode.create 方法创建扫码控件。

本文只用了 扫码成功的回调 ，在你的业务中可能还需要用到 扫码失败的回调 。

更多的配置和样式设置，建议自行查阅官方文档。本文的案例也有对扫码框做了颜色的调整（随便选了个颜色）。

创建窗口

webview 模块文档

推荐阅读

👍《执行vue create时到底做了什么》

👍《Vue3 过10种组件通讯方式》

👍《Vite 搭建 Vue2 项目（Vue2 + vue-router + vuex）》

👍《前端需要的免费在线api接口》

如果本文对你有帮助，也希望你可以 点赞 关注 收藏 ~ 这对我很有用 ~

点赞 + 关注 + 收藏 = 学会了