You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Unity集成ARCore报错DllNotFoundException: arcore_unity_api求助

分析Unity ARCore示例相机黑屏+arcore_unity_api找不到的原因

我之前帮朋友排查过几乎一模一样的问题,结合你说原生ARCore示例正常的情况,大概率是Unity打包或插件配置层面的问题,给你列几个最常见的原因:

  • ARCore Native库未被正确打包进APK
    这是最常见的诱因。Unity构建Android包时,如果ARCore的libarcore_unity_api.so文件没有被包含到对应架构的目录下,就会触发这个DLL找不到的异常。你可以做这些排查:

    1. 解压你构建的APK,查看lib/[你的设备架构](比如arm64-v8a)目录下有没有这个.so文件;
    2. 检查Unity Build Settings 里的“Target Architectures”是否和你的测试设备匹配(比如设备是64位,就要勾选ARM64);
    3. 确认ARCore插件导入完整,没有缺失Native文件夹下的文件。
  • Unity版本与ARCore插件版本不兼容
    ARCore对Unity的版本要求很严格,不同版本的ARCore插件只支持特定范围的Unity版本。比如你参考的官方Quickstart文档里指定的Unity版本,可能和你当前使用的版本不匹配,导致Native库无法正常加载。建议你核对ARCore插件的发布说明,确保两者版本兼容。

  • Player Settings中的ARCore配置错误
    配置项出错也会导致Native库加载失败:

    1. 打开Unity Player Settings > XR Plug-in Management,确认已经启用了ARCore插件;
    2. 检查“Other Settings”里的“Package Name”是否符合Google的格式要求(比如不能是默认的com.Company.ProductName,需要改成你自己的有效包名);
    3. 确认“ARCore Required”或“ARCore Optional”的选项已经正确开启(根据你的需求选择)。
  • Unity构建缓存或残留文件干扰
    有时候Unity的缓存文件或者旧的构建残留会导致异常。你可以尝试:

    1. 删除项目根目录下的Library文件夹(记得先备份项目!);
    2. 清理之前的构建输出目录;
    3. 重新导入ARCore插件后再重新构建项目。

因为你原生ARCore示例运行正常,说明设备本身是支持ARCore的,所以不用考虑设备兼容性问题。优先从上面几个点入手排查,应该能解决问题。

内容的提问来源于stack exchange,提问作者fsch

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.29 07:50:05