Unity MR二维码识别开发实战指南

前置要求#

注意：从 v76 开始，使用摄像头 API 的应用已支持上架 Quest 商店。

限制：

• 目前不适合处理移动对象
• 不适合识别小的或远的图像和文本
• SDK 目前无法在串流模式下生效，需要打包到头显测试

官方样例工程#

PassthroughCameraApiSamples

• CameraViewer：将摄像头画面渲染到 RawImage
• CameraToWorld：相机坐标转世界坐标
• BrightnessEstimation：环境亮度估计
• MultiObjectDetection：AI 语义物体识别（Unity Sentis）
• ShaderSample：虚拟水面倒影特效

Quest Vision Kit

• Color Picker：吸取现实颜色转虚拟画笔
• Object Detection：AI 语义识别
• QR Code Tracking：二维码识别追踪（ZXing）
• Shader Samples：毛玻璃特效
• OpenAI Vision：基于 GPT 的视觉助手
• WebRTC Streaming：网络串流摄像头画面

配置步骤#

1
using UnityEngine;
2
using Meta.XR.MRUK;
3

4
public class RequestCameraPermissions : MonoBehaviour
5
{
6
    private void Awake()
7
    {
8
        OVRPermissionsRequester.Request(new[]
9
        {
10
            OVRPermissionsRequester.Permission.Scene,
11
            OVRPermissionsRequester.Permission.PassthroughCameraAccess
12
        });
13
    }
14
}

1
<uses-permission android:name="com.oculus.permission.HEADSET_CAMERA" />

官方工程#

Quest Vision Kit：https://github.com/xrdevrob/QuestCameraKit

配置步骤#

1
private static bool HasZXingDLL()
2
{
3
    var files = Directory.GetFiles(Application.dataPath, "*ZXing.dll", SearchOption.AllDirectories)
4
                         .Concat(Directory.GetFiles(Application.dataPath, "*zxing.dll", SearchOption.AllDirectories))
5
                         .Concat(Directory.GetFiles(Application.dataPath, "*zxing.unity.dll", SearchOption.AllDirectories));
6
    Debug.Log($"Has ZxingDLL:{files.Any()}");
7
    return files.Any();
8
}

Unity 6 之前的版本#

XR Plug-in Management 安卓端勾选 Oculus

Unity 6 及以上#

1. XR Plug-in Management 安卓端勾选 OpenXR
2. 导入包：com.unity.xr.meta-openxr

移植文件#

1. zxing.unity.dll → Assets/Plugins/
2. Assets/Samples/QRCodeTracking → 自己的项目
3. Assets/Samples/Common → 自己的项目

检查项#

• ZXING_ENABLED 符号已配置
• OVRManager 的 Passthrough Camera Access 已勾选

框架集成包#

核心物体：

次要物体（空间锚点相关）：

实际项目需求#

1. 指定二维码识别：只识别特定二维码
2. 多二维码分组：场地内多个二维码，同组只识别一个
3. 重定位恢复：重定位后重新扫码恢复定位
4. 空间锚点保存：借助空间锚点固定虚拟场景
5. 关闭扫码节省性能：识别成功后关闭扫码功能

二维码坐标轴朝向#

MR 大空间扫码通常是：

• 竖直码：贴在墙上，Z 轴垂直于二维码平面
• 水平码：贴在桌上，Y 轴朝上

配置规则：

• 竖直码：虚拟场景 Z 轴与二维码法线朝向一致
• 水平码：虚拟场景 Z 轴与二维码 Y 轴一致

权限弹窗没出现#

1. 检查 OVRManager 的 Permission Request On Startup 是否勾选
2. 使用代码手动请求权限
3. 在头显 设置 > 隐私与安全 > 应用权限 > 头戴设备摄像头 手动开启

摄像头画面显示白色#

1. 检查 AndroidManifest 是否有摄像头权限
2. 运行 Project Setup Tool 的 Fix All
3. 检查 OVRManager 的 Enable Passthrough Camera Access 是否勾选

二维码识别不稳定#

使用稳定识别框架，进行多次采样滤波。

空间锚点保存失败#

• 需要设备账号开启双重身份认证
• 手机 APP 需要开启开发者模式
• 代激活/租的设备可能无法使用空间锚点