基于 AVFoundation 实现 iOS 扫码登录功能

胖虎1

已于 2025-02-12 09:26:05 修改

阅读量1.1k

点赞数 26

分类专栏： # 媒体捕捉文章标签： ios 扫码登录二维码扫描 AVFoundation

于 2025-01-21 09:30:45 首次发布

本文链接：https://blog.csdn.net/weixin_39339407/article/details/145130076

版权

媒体捕捉专栏收录该内容

9 篇文章

订阅专栏

引言

在移动互联网的时代，用户体验成为了应用成功的关键之一。而登录方式的简便性，直接影响着用户的使用体验。传统的用户名和密码登录方式虽然广泛使用，但却因其繁琐和容易遗忘的特点，常常让用户感到不便。扫码登录作为一种更为便捷的方式，逐渐成为各类应用的首选登录方式，尤其是在 iOS 平台上。

扫码登录通过扫描二维码的方式，快速验证用户身份，既能提升安全性，又能避免传统登录的繁琐步骤。尤其在需要快速、安全地进行身份认证的场景中，扫码登录无疑是一个极具优势的解决方案。

本文将重点介绍如何在 iOS 客户端实现扫码登录功能，主要围绕二维码扫描的实现展开，带领你通过原生 AVFoundation 框架，掌握二维码扫描的基本流程，并帮助你顺利实现扫码登录功能。

扫码登录的工作原理

扫码登录是一种便捷的身份验证方式，用户通过扫描一个二维码来快速完成登录。其工作原理大致可以分为以下几个步骤：

生成二维码：

用户在登录页面点击“扫码登录”，系统会生成一个二维码，该二维码通常包含一个唯一的标识符（如会话 ID 或用户 token）。
这个二维码代表了当前登录请求的验证信息，可以通过扫描识别该信息后完成登录。

扫描二维码：

用户打开移动设备的扫码功能（通常是通过扫描页面上的二维码），客户端通过相机扫描二维码。
扫描过程会实时检测二维码的位置，并解析其中的信息。

解析二维码内容：

扫描到二维码后，客户端解析二维码中嵌入的信息，通常是一个 URL 或 token，代表着用户的登录请求。
客户端通过二维码内容向后台发送请求，完成身份验证。

完成登录：

后端接收到扫码信息后，验证是否有效。若有效，则生成用户会话并返回给客户端，完成登录过程。
用户成功登录后，可以访问受限资源。

扫码登录的优势在于其简便性和安全性，用户无需输入复杂的用户名和密码，只需简单地扫描二维码即可快速完成身份验证。

客户端的二维码扫描实现

二维码扫描是扫码登录的核心功能，用户通过设备摄像头对准二维码，扫描并解析其中的内容，完成登录验证。在 iOS 中，实现这一功能需要解决以下几个问题：

访问设备摄像头：二维码扫描依赖摄像头捕捉实时画面，因此需要请求用户的相机权限。
识别二维码内容：从实时视频流中检测并解析二维码信息。
实时性与用户体验：扫描过程需要快速、准确，同时提供清晰的反馈（如动画或提示）。

为了满足这些需求，iOS 提供了强大的 AVFoundation 框架，它是一个多媒体框架，可以用来处理音频、视频和相机相关的任务。通过 AVFoundation，我们可以方便地构建一个高效的二维码扫描功能，包括视频捕获、实时分析和结果处理。

接下来，我们将详细介绍如何使用 AVFoundation 实现二维码扫描功能。

获取相机权限

在iOS应用的开发中关于权限的内容十分敏感，首先我们需要在info文件中添加相册权限申请说明，否则当我们访问权限时会发生应用崩溃。

iOS 中对相机权限的管理通过AVCaptureDevice和AVAuthorizationStatus来处理。

检查当前权限状态

使用AVCaptureDevice.authorizationStatus(for: .video)检查应用是否已经拥有了相机访问权限。

权限状态包括：

.autorized：用户已授予权限，可以直接使用相机。
.notDetermined：用户尚未做出选择，需要请求权限。
.denied或者.resricted：用户拒绝权限，或设备限制了相机使用。

请求相机权限

如果状态为.notDetermined，可以调用AVCaptureDevice.requestAccess(for: .video)弹出权限请求框，让用户选择是否授予权限。

处理用户的选择

根据用户的选择决定是否继续启动二维码扫描功能。

具体代码如下：

import AVFoundation

func checkCameraPermission(completion: @escaping (Bool) -> Void) {
    let status = AVCaptureDevice.authorizationStatus(for: .video)
    
    switch status {
    case .authorized:
        // 用户已授权
        completion(true)
    case .notDetermined:
        // 用户尚未做出选择，请求权限
        AVCaptureDevice.requestAccess(for: .video) { granted in
            DispatchQueue.main.async {
                completion(granted)
            }
        }
    case .denied, .restricted:
        // 用户拒绝或设备限制
        completion(false)
    @unknown default:
        completion(false)
    }
}

如果用户拒绝了权限，可以通过引导提示（如弹窗或页面）告知用户需要在设置中开启相机权限。可以使用如下代码跳转到设置页面：

if let settingsURL = URL(string: UIApplication.openSettingsURLString) {
    UIApplication.shared.open(settingsURL)
}

设置AVCaptureSession

使用AVFoundation实现二维码的核心就是配置相机会话，包括设置会话输入，设置会话输出，启动扫描和停止扫描。

import UIKit
import AVFoundation
import MWCommon

class MWQRScanController: NSObject, AVCaptureMetadataOutputObjectsDelegate {
    
    /// 二维码扫描会话
    private(set) var qrScansession: AVCaptureSession?
    /// 创建一个队列
    private let qrScanQueue = DispatchQueue(label: "com.mw.qrscan.queue")
    
    /// 设置会话
    func setupSession() {
        qrScansession = AVCaptureSession()
        qrScansession?.sessionPreset = .high
        // 设置会话输入
        setupInput()
        // 设置会话输出
        setupOutput()
    }
    
    /// 设置输入
    private func setupInput() {
        guard let qrScansession = qrScansession else {
            MWAssert(false, "会话为空")
            return
        }
        guard let device = AVCaptureDevice.default(for: .video) else {
            MWAssert(false, "设备为空")
            return
        }
        guard let input = try? AVCaptureDeviceInput(device: device) else {
            MWAssert(false, "输入为空")
            return
        }
        if device.isAutoFocusRangeRestrictionSupported {
            do {
                try device.lockForConfiguration()
                device.autoFocusRangeRestriction = .near
                device.unlockForConfiguration()
            } catch {
                //                MWAssert(false, "设置自动对焦失败")
            }
        }
        qrScansession.addInput(input)
    }
    
    /// 设置输出
    private func setupOutput() {
        guard let qrScansession = qrScansession else {
            MWAssert(false, "会话为空")
            return
        }
        let output = AVCaptureMetadataOutput()
        qrScansession.addOutput(output)
        output.setMetadataObjectsDelegate(self, queue: DispatchQueue.main)
        output.metadataObjectTypes = [.qr]
    }
    
    
    /// 开始扫描
    func startScan() {
        guard let qrScansession = qrScansession else {
            MWAssert(false, "会话为空")
            return
        }
        if !qrScansession.isRunning {
            qrScanQueue.async {
                qrScansession.startRunning()
            }
        }
        
    }
    
    /// 停止扫描
    func stopScan() {
        guard let qrScansession = qrScansession else {
            MWAssert(false, "会话为空")
            return
        }
        if qrScansession.isRunning {
            qrScanQueue.async {
                qrScansession.stopRunning()
            }
        }
    }
    
    /// 代理方法 - 扫描到二维码
    func metadataOutput(_ output: AVCaptureMetadataOutput, didOutput metadataObjects: [AVMetadataObject], from connection: AVCaptureConnection) {


    }
    
    
}

设置预览图层

通过重写视图的layerClass的方式，改变自定义的View的图层，用来显示扫描的预览画面。

import UIKit
import AVFoundation

class MWQRScanView: UIView {

    /// 重写图层
    override class var layerClass: AnyClass {
        return AVCaptureVideoPreviewLayer.self
    }
    
    override init(frame: CGRect) {
        super.init(frame: frame)
        videoPreviewLayer.videoGravity = .resizeAspectFill
    }
    
    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
    
    /// 设置session
    var session: AVCaptureSession? {
        get {
            return (self.layer as! AVCaptureVideoPreviewLayer).session
        }
        set {
            (self.layer as! AVCaptureVideoPreviewLayer).session = newValue
        }
    }
    
    /// 获取图层
    var videoPreviewLayer: AVCaptureVideoPreviewLayer {
        return self.layer as! AVCaptureVideoPreviewLayer
    }

}

启动扫描

接下来只需要将扫描控制器和扫描的预览图层都整合到二维码扫描的视图控制器。当视图控制器出现时就可以实现二维码扫描功能了。

import UIKit
import MWCommon

class MWQRScanViewController: MWBaseViewController {
    
    /// 扫描管理类
    private let scanController = MWQRScanController()
    /// 扫描视图
    private let scanView = MWQRScanView()

    override func viewDidLoad() {
        super.viewDidLoad()
        setupScanController()
        addScanView()
    }
    
    override func viewWillAppear(_ animated: Bool) {
        scanController.startScan()
    }
    
    override func viewWillDisappear(_ animated: Bool) {
        scanController.stopScan()
    }
    
    /// 配置扫描控制器
    private func setupScanController() {
        scanController.setupSession()
        scanView.session = scanController.qrScansession
    }

    /// 添加扫描视图
    private func addScanView() {
        view.addSubview(scanView)
        scanView.snp.makeConstraints { make in
            make.edges.equalToSuperview()
        }
    }
 

}

二维码解析

当扫描到二维码数据之后，会进入到captureOutput代理方法。它支持同时处理多个数据，但我们在这里只简单的处理第一个数据，将扫描到的结果通过闭包进行回调。

    /// 代理方法 - 扫描到二维码
    func metadataOutput(_ output: AVCaptureMetadataOutput, didOutput metadataObjects: [AVMetadataObject], from connection: AVCaptureConnection) {
        guard let metadataObject = metadataObjects.first as? AVMetadataMachineReadableCodeObject else {
            return
        }
        guard let result = metadataObject.stringValue else {
            return
        }
        qrScanResultCallback?(result)

    }

    /// 配置扫描控制器
    private func setupScanController() {
        scanController.setupSession()
        scanView.session = scanController.qrScansession
        scanController.qrScanResultCallback = { [weak self] result in
            guard let self = self else { return }
            self.handleScanResult(result)
        }
    }

      /// 处理扫描结果
    private func handleScanResult(_ result: String) {
        // 是否获取结果
        var isGetResult = false
        /// 如果 是url且在白名单内，跳转到webview
        if result.contains(MWAPIHost.h5Host) {
            isGetResult = true
            var params = [String:Any]()
            params["url"] = result
            MWRouter.shared.route(path: MWRouterPath_H5,parameters: params)
        } else {
            requestLogin(qrCode: result)
        }
        /// 如果是扫描登录标识，弹出确认登录页面，根据数据请求登录。

        MWLogHelper.debug("扫描结果：\(result)", context: "MWQRScanViewController")
        if isGetResult {
            scanController.stopScan()
        }
        
    }
    
    /// 发起请求
    private func requestLogin(qrCode:String) {
        var params = [String:Any]()
        params["qrCode"] = qrCode
        MWNetworkHelper.request(endpoint: MWAPINormalEndpoint.api_scanLogin, parameters: params) {[weak self] model, data, error in
            guard let self = self else { return }
           
            
        }
    }