ARFoundation从零开始5-AR图像跟踪

以现实世界中的某物体、某介质为参照物，将AR内容固定到该参照物的相对位置，伴随参照物的移动而发生相对位置的改变，即所谓的AR跟踪。

2D图像追踪（ARKit和ARCore），通过检测环境中的特定2D图像，Tracked Image Manager可以自动创建表示所有已识别图像的GameObject，让你可以根据特定图像改动AR体验。

本项目示例源代码：

https://github.com/sueleeyu/ar-augment

一、创建项目工程

1.新建项目

2.重命名为ImagesScene，选择Window-Package Manager- Unity Register,依次下载：

XR Plugin Management 4.0.7

AR Foundation 4.1.10

ARCore XR Plugin 4.1.10

ARKit XR Plugin 4.1.10

3.如下：

二、添加AR组件

1.删除原有摄像机, 点击“+”，添加Session Origin，AR Session：

2.选择 AR Session Origin，Inspector中点击添加组件，搜索框输入art，选择AR Tracked Image Manager添加。

三、添加界面UI和模型

1.log Text，用来显示日志信息：Hierarchy-‘+’- UI –Text，新建Text组件，命名Log，设置：

2.添加Button，Hierarchy-Canvas右键，UI-Button，设置：

Button-Text设置：

四、创建参考图库

1.Project –Assets 右键，Create-Folder，新建文件夹，命名Images：

2.创建参考图库，Project –Assets –Images 右键，Create-XR-Reference Image Library:

3.复制多张图片到Images目录下：

4.添加参考图，选择ReferenceImageLibrary，点击右侧Inspector的Add Image

5.拖动图片到右侧贴图，依次完成参考图的添加：

添加如下：

 

参考图中属性的含义：

Name：每一个参考图有一个唯一的guid和一个name，Name可以用来实时匹配检测到的图片和参考图

Specify Size：指定图片的大小，一些平台下需要指定才能识别，所有最好选中。

Keep Texture at Runtime：是否使用纹理，如果要修改Prefab外观可以选中。

6. AR Tracked Image Manager添加Reference Library属性：选择Hierarchy-AR Session Origin，选择右侧Inspector的AR Tracked Image Manager项的Serialized Library右侧圆点，点击列表对应项添加：

五、需要的图片和预制件

1.Hierarchy下新建Cube，命名One（对应参考库中图片Name），拖动Images下One.png到场景中的Cube：

 

2.Assets下新建Resources/Prefabs文件夹，把立方体One拖动到Prefabs下，删除场景中的One，其他依次制作。

六、编写脚本

1. Project-Assets右键，新建Scripts文件夹，新建Logger.cs，用于查看log日志

 

2.Logger挂载

代码：

using System.Collections.Generic;
using System.Text;
using UnityEngine.UI;

namespace UnityEngine.XR.ARFoundation.Samples
{
    public class Logger : MonoBehaviour
    {
        [SerializeField]
        Text m_LogText;//挂载到Log Text组件
        public Text logText
        {
            get => m_LogText;
            set => m_LogText = value;
        }

        [SerializeField]
        int m_VisibleMessageCount = 40;
        public int visibleMessageCount
        {
            get => m_VisibleMessageCount;
            set => m_VisibleMessageCount = value;
        }

        int m_LastMessageCount;

        static List<string> s_Log = new List<string>();

        static StringBuilder m_StringBuilder = new StringBuilder();

        void Awake()
        {
            if (m_LogText == null)
            {
                m_LogText = GetComponent<Text>();
            }

            lock (s_Log)
            {
                s_Log?.Clear();
            }

            Log("Log console initialized.");
        }

        void Update()
        {
            lock (s_Log)
            {
                if (m_LastMessageCount != s_Log.Count)
                {
                    m_StringBuilder.Clear();
                    var startIndex = Mathf.Max(s_Log.Count - m_VisibleMessageCount, 0);
                    for (int i = startIndex; i < s_Log.Count; ++i)
                    {
                        m_StringBuilder.Append($"{i:000}> {s_Log[i]}\n");
                    }

                    var text = m_StringBuilder.ToString();

                    if (m_LogText)
                    {
                        m_LogText.text = text;
                    }
                    else
                    {
                        Debug.Log(text);
                    }
                }

                m_LastMessageCount = s_Log.Count;
            }
        }

        public static void Log(string message)
        {
            lock (s_Log)
            {
                if (s_Log == null)
                    s_Log = new List<string>();

                s_Log.Add(message);
            }
        }
    }
}

 

做关联：

 

3.新建MultiImageTracking.cs,编写代码。

加载预制件，在Strat中：

void Start()

        {

            //加载预制件

            GameObject one = Resources.Load<GameObject>("Prefabs/One");

            prefabs.Add("One", one);

            GameObject two= Resources.Load<GameObject>("Prefabs/Two");

            prefabs.Add("Two", two);

            GameObject qrcode = Resources.Load<GameObject>("Prefabs/QRCode");

            prefabs.Add("QRCode", qrcode);

            Logger.Log("MultiImageTracking-Start");

        }

4.注册ARTrackedImagesChangedEventArgs事件：

private void OnEnable()

        {

            ImgTrackedManager.trackedImagesChanged += OnTrackedImagesChanged;

        }

OnTrackedImagesChanged中实现加载：

void OnTrackedImagesChanged(ARTrackedImagesChangedEventArgs eventArgs)

        {

            foreach (var trackedImage in eventArgs.added)

            {

                // Give the initial image a reasonable default scale

                var minLocalScalar = Mathf.Min(trackedImage.size.x, trackedImage.size.y) / 2;

                trackedImage.transform.localScale = new Vector3(minLocalScalar, minLocalScalar, minLocalScalar);//对模型缩放

                Instantiate(prefabs[trackedImage.referenceImage.name], trackedImage.transform);//实例化预制件

                //OnImagesChanged(trackedImage);

            }           

        }

5.挂载MultiImageTracking.cs到AR Session Origin，选择AR Session Origin，Inspector中点击Add Component，输入并选择MultiImageTracking.cs,将Button-Text组件拖到MultiImageTracking的Toggle Text属性栏：

 

七、android打包

1.运行：

   

八、常见问题

1.ARFoundration打包会报错：“Failded to generated ARCore reference image library”

报错原因应该是图像质量不符合要求。

九、参考文献

1. Unity api：

Unity - Manual: Unity User Manual 2021.3 (LTS)

2.ARFoundation示例：

GitHub - Unity-Technologies/arfoundation-samples: Example content for Unity projects based on AR Foundation

3.ARCore 文档

为图像添加维度  |  ARCore  |  Google Developers

4.本项目示例源代码：

sueleeyu/ar-augment · GitHub