By Ne0 — Dec 6, 2023

Unity Vuforia 之简单实现Vuforia调用Android设备外接摄像头camera实现AR

一、简单介绍

Unity中使用 Vuforia 进行相关开发的只是整理。

Unity 在 Android 设备上进行AR开发，一般可以调用的是 Android 设备的后置摄像头，或者前置摄像头。本章介绍如何实现Vuforia 调用 Android 设备上的外接 USB 摄像头的方法 (Vuforia 官网的实现指导 )。

二、编译环境之工具准备：

如图：Vufoira官网配置要求

www.zeeklog.com - Unity Vuforia 之简单实现Vuforia调用Android设备外接摄像头camera实现AR

1、操作系统

本次使用的是：Windows 10 的 64 位操作系统

2、Python 配置要求版本 2 或者更高

1）到官网下载安装即可，如下图

(下载网址：)

2）下载好，安装即可，安装成功后，执行 python (环境配置，安装中勾选自动配置即可)，产看安装结果，如下图

3、Git 安装配置

1）可以到 Git 官网下载，如下图

（可以下载也可以不下载，到时候相关文件可以到GitHub 上直接下载 zip 即可）

下载网址：

2）下载安装好后，在任意文件夹中右键可以看到git相关信息，如下图

4、CMake 配置要求版本 3.6 或者更高

1）CMake 下载可以到官网上下载，如下图

下载网址：

2）下载安装 CMake 即可，然后把 CMake 配置到环境变量中（配置路径根据自己的安装路径相应修改），如下图

3）在 cmd 终端中，输入 camke -version，即可查看到版本，表示配置成功，如下图

5、Ninja 下载与环境配置

1）在官网下载 Ninja 相关资源包，如下图

下载网址：

2）下载完后，解压文件，得到如下文件

3）配置 ninja.exe 到环境变量中，如下图

4）在 cmd 终端中输入 ninja -help ，查看ninja是否配置成功，如下便是配置成功

6、Android NDK 13 下载并配置环境

1）到官网下载即可，如下图

下载网址：

2）把 Android NDK 13 配置到环境变量中，如下图

3）在 cmd 中检查是否配置成功，输入 ndk-build ，如下图便是配置成功了

7、Android SDK 22 下载安装，并配置环境

1）建议下载 Android Studio，在Android Studio 环境中下载对应 Android SDK ，Android Studio 下载如下图

下载地址：

2）下载好后，根据步骤安装 Android Studio 即可，打开 Android Studio 的 SDK Manager 安装 Android SDK 22 ，如下图

3）下载好后，对应文件夹下就会看到对应的SDK，如下图

4）配置环境，如下图

三、编译环境之文件资源准备：

如图：Vufroia 官网编译以来文件资源

1、Download Vuforia Engine for Android ，即是 vuforia-sdk-android-xx.zip 下载，如下图

下载网址：

2、Download the UVCDriver Sample，即是vuforia-samples-core-android-xxx.zip 下载，如下图

下载网址：

3、 vuforia-driver-sample-uvcdriver-android-xxx.zip 下载，如下图

下载地址：

4、Clone the https://github.com/ptc-shunt/UVCCamera repository，下载这个 git 即可，如下图

下载地址：

四、编译环境之文件夹整理：

如图：Vuforia 官网的编译（注意红框中）

1、首先解压下载好的文件，如下图

2、在 vuforia-sdk-android-8-6-7\samples 文件夹下新建一个 UVCDriver 文件夹，如下图

3、把 vuforia-driver-sample-uvcdriver-android-8-6-7 文件夹下的所有内容拷贝到新建的 UVCDriver （vuforia-sdk-android-8-6-7\samples\UVCDriver）文件夹下，如下图

4、UVCCamera-master\UVCCamera-master 下的所有内容拷贝到 UVCDriver （vuforia-sdk-android-8-6-7\samples\UVCDriver）文件夹下新添加的 UVCCamera 文件夹下（或者直接拷贝UVCCamera-master到UVCDriver文件夹下，再改名UVCCamera 即可），如下图

5、把 vuforia-samples-core-android-8-6-7\VuforiaSamples-8-6-7 直接拷贝到 vuforia-sdk-android-8-6-7\samples 问价夹下，如下图

五、编译环境之开始编译：

如图：Vuforia 官网给的编译步骤（注意红框中）

1、在 cmd 中，把目录切换到 xxx\vuforia-sdk-android-8-6-7\samples\UVCDriver\UVCCamera\libuvccamera\src\main\jni 中，然后 ndk-build 命令进行编译（编译完成要一些时间）如下图

（涉及到的命令有1、d: 2、cd xxx\xx 3、ndk-build）

2、上一步骤编译成功后，在 cmd 中，在切换到目录 xxx\vuforia-sdk-android-8-6-7\samples\UVCDriver，输入命令 python build.py 进行编译，如下图

（涉及到的命令有1、cd xxx\xx 2、python build.py）

3、编译成功后，会在 xxx\vuforia-sdk-android-8-6-7\samples\UVCDriver\build\bin\Android 文件夹下有编译后的平台 so 和 jar ，如下图

六、在Unity中使用编译成果，开发 Vuforia 调用 USB 摄像头工程

1、打开Unit有，新建一个空工程，如下图

2、把编译好的 so 和 jar 导入Unity 工程中添加的的 Plugins/Android/libs 文件夹下，如下图

3、在工程中新建一个脚本，用于获得外接USB 摄像头权限，如下图

4、把新建的脚本挂载到场景中，如下图

5、像正常在Unity中进行Vuforia开发的操作步骤，开发Vuforia AR 应用即可，如下图

6、编译打包，Android 设备连接USB摄像头即可

七、关键代码


using UnityEngine;

/// <summary>
/// 用于获得调用 USBCamera 摄像头的权限
/// </summary>
public class UVCManager : MonoBehaviour
{
    private void Awake()
    {
#if UNITY_ANDROID
        bool driverLibrarySet = false;
        driverLibrarySet = VuforiaUnity.SetDriverLibrary("libUVCDriver.so");

        if (driverLibrarySet)
        {
            // Load your applications scene here 
            // InitAndLoadScene(VUFORIA_DRIVER_CAMERA_SCENE_INDEX);

            // The application needs to ask for USB permissions to run the USB camera
            // this is done after the driver is loaded. We call a method in the UVC driver
            // Java code to request permissions, passing in the Unity app's activity.
            AndroidJavaClass unityJC = new AndroidJavaClass("com.unity3d.player.UnityPlayer");
            AndroidJavaObject unityActivity = unityJC.GetStatic<AndroidJavaObject>("currentActivity");

            AndroidJavaClass usbControllerJC = new AndroidJavaClass("com.vuforia.samples.uvcDriver.USBController");
            usbControllerJC.CallStatic("requestUSBPermission", unityActivity);
        }
        else
        {
            Debug.Log("Failed to initialize the UVC driver - defaulting to the standard scene");

            // Fall back to the in-built camera
        }
#endif
    }

    // Start is called before the first frame update
    void Start()
    {
        
    }

    
}

八、编译成功的vuforia-sdk 调用 usbcamera 的(so 和 jar )工程地址（可做参看）

九、测试调用 USBCamera 成功的 APK

链接：https://pan.baidu.com/s/1F8kWm-nm-8Df2GUbX0aaYQ

提取码：djfa

（若路径失效请留言）

十、注意事项（Vuforia 官方的）

The current supported cameras profiles are:

Logitech HD Webcam c310

Microsoft LifeCam Studio

十一、参考资料：

1、

网址：

2、

（上面地址涉及网址：

https://library.vuforia.com/articles/Solution/file-driver.html

https://library.vuforia.com/content/vuforia-library/en/articles/Solution/driver-framework.html

https://github.com/mironal/VuforiaExternalCameraSample

）

3、参考博文

Unity Vuforia 之简单实现Vuforia调用Android设备外接摄像头camera实现AR