以现实世界中的某物体、某介质为参照物,将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示例:
3.ARCore 文档
为图像添加维度 | ARCore | Google Developers
4.本项目示例源代码: