Swift ARKit 1.5：如何获取摄像头识别的参考图像名称并加载对应模型？

嗨，这个需求其实在主流AR框架里都有现成的方案，核心就是利用参考图像库的命名标识符和AR锚点的关联来实现，我给你拆解下具体步骤和代码示例：

你猜的完全没错——不管是ARKit还是ARCore这类主流AR框架，都会把识别到的参考图像和对应的ARImageAnchor（或类似锚点对象）绑定。每个参考图像都有你预先设置的唯一名称/标识符，我们只需要从锚点里提取这个信息，就能轻松关联到对应的3D模型。

这是最常用的跨平台方案，适配iOS和Android：

1. 配置参考图像库

   • 在你的AR Resources文件夹中创建XR Reference Image Library资源，添加所有需要识别的参考图像。
   • 给每幅图像设置独特的名称（比如CoffeeCup_Image、BookCover_Image），同时可以设置对应的物理尺寸（方便AR框架更精准地定位）。
   • 把这个图像库赋值到场景中AR Session Origin组件下的AR Tracked Image Manager里。

2. 监听图像识别事件并处理

   • 通过ARTrackedImageManager的回调事件，在图像被识别或跟踪状态更新时触发逻辑，提取图像名称并加载对应模型：

   using UnityEngine;
   using UnityEngine.XR.ARFoundation;
   
   public class ARImageHandler : MonoBehaviour
   {
       [SerializeField] private ARTrackedImageManager _trackedImageManager;
       // 可以直接在Inspector面板绑定对应模型
       [SerializeField] private GameObject _coffeeCupModel;
       [SerializeField] private GameObject _bookCoverModel;
   
       private void OnEnable()
       {
           // 订阅图像识别/更新事件
           _trackedImageManager.trackedImagesChanged += OnTrackedImagesUpdated;
       }
   
       private void OnDisable()
       {
           _trackedImageManager.trackedImagesChanged -= OnTrackedImagesUpdated;
       }
   
       private void OnTrackedImagesUpdated(ARTrackedImagesChangedEventArgs args)
       {
           // 处理新识别到的图像
           foreach (var trackedImage in args.added)
           {
               SpawnCorrespondingModel(trackedImage);
           }
   
           // 处理已识别图像的跟踪状态更新（可选，确保模型始终贴合图像）
           foreach (var trackedImage in args.updated)
           {
               if (trackedImage.trackingState == UnityEngine.XR.ARSubsystems.TrackingState.Tracking)
               {
                   SpawnCorrespondingModel(trackedImage);
               }
           }
       }
   
       private void SpawnCorrespondingModel(ARTrackedImage trackedImage)
       {
           // 核心：获取参考图像的名称
           string imageName = trackedImage.referenceImage.name;
           Debug.Log($"识别到参考图像：{imageName}");
   
           // 根据名称匹配并生成对应模型
           switch (imageName)
           {
               case "CoffeeCup_Image":
                   Instantiate(_coffeeCupModel, trackedImage.transform.position, trackedImage.transform.rotation);
                   break;
               case "BookCover_Image":
                   Instantiate(_bookCoverModel, trackedImage.transform.position, trackedImage.transform.rotation);
                   break;
               // 可继续添加更多图像的匹配逻辑
               default:
                   Debug.LogWarning($"未找到与{imageName}对应的模型");
                   break;
           }
       }
   }
   

3. 优化建议：用字典管理模型映射
   如果你的参考图像很多，冗长的switch语句会不好维护，推荐用字典来存储名称和模型的映射：

   private Dictionary<string, GameObject> _imageToModelMap;
   
   private void Awake()
   {
       _imageToModelMap = new Dictionary<string, GameObject>()
       {
           {"CoffeeCup_Image", _coffeeCupModel},
           {"BookCover_Image", _bookCoverModel}
           // 添加更多键值对
       };
   }
   

   然后在SpawnCorrespondingModel里替换成：

   if (_imageToModelMap.TryGetValue(imageName, out GameObject targetModel))
   {
       Instantiate(targetModel, trackedImage.transform.position, trackedImage.transform.rotation);
   }
   

如果不用Unity，直接用原生框架开发：

• ARKit（Swift）：在ARSessionDelegate的session(_:didAdd:)方法中，判断锚点类型为ARImageAnchor，通过anchor.referenceImage.name获取图像名称。
• ARCore（Kotlin/Java）：在ARFrame的跟踪结果中找到AugmentedImage类型的Trackable，通过augmentedImage.name获取名称。

这样就能完美实现“识别不同图像→展示对应模型”的需求啦！

内容的提问来源于stack exchange，提问作者Pietro Messineo