Android端ar_flutter_plugin加载自定义3D模型失败求助

问题概述 #

使用ar_flutter_plugin开发Android端AR功能时，官方示例中的Chicken_01.gltf模型可正常加载，但自行下载的其他GLTF/GLB模型（无论本地文件还是网络链接）均无法加载。项目GitHub仓库已存在同款Issue#136，尝试多种方法后仍未解决，附相关代码、错误截图及模型文件，寻求技术支持。

相关核心代码：

class LocalAndWebObjectsView extends StatefulWidget {
  const LocalAndWebObjectsView({Key? key}) : super(key: key);

  @override
  State<LocalAndWebObjectsView> createState() => _LocalAndWebObjectsViewState();
}

class _LocalAndWebObjectsViewState extends State<LocalAndWebObjectsView> {
  late ARSessionManager arSessionManager;
  late ARObjectManager arObjectManager;

  ARNode? localObjectNode;
  ARNode? webObjectNode;

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text("Local / Web Objects")),
      body: Padding(
        padding: const EdgeInsets.symmetric(horizontal: 10),
        child: Column(
          mainAxisAlignment: MainAxisAlignment.spaceEvenly,
          children: [
            SizedBox(
              height: MediaQuery.of(context).size.height * .8,
              child: ClipRRect(
                borderRadius: BorderRadius.circular(22),
                child: Container(
                  color: Colors.black,
                  child: ARView(onARViewCreated: onARViewCreated),
                ),
              ),
            ),
            Row(
              children: [
                Expanded(
                  child: ElevatedButton(
                      onPressed: onLocalObjectButtonPressed,
                      child: const Text("Add / Remove Local Object")),
                ),
                const SizedBox(width: 10),
                Expanded(
                  child: ElevatedButton(
                      onPressed: onWebObjectAtButtonPressed,
                      child: const Text("Add / Remove Web Object")),
                ),
              ],
            ),
          ],
        ),
      ),
    );
  }

  void onARViewCreated(
    ARSessionManager arSessionManager,
    ARObjectManager arObjectManager,
    ARAnchorManager arAnchorManager,
    ARLocationManager arLocationManager,
  ) {
    this.arSessionManager = arSessionManager;
    this.arObjectManager = arObjectManager;

    this.arSessionManager.onInitialize(
          showFeaturePoints: false,
          showPlanes: true,
          customPlaneTexturePath: "triangle.png",
          showWorldOrigin: true,
          handleTaps: false,
        );

    this.arObjectManager.onInitialize();
  }

  Future<void> onLocalObjectButtonPressed() async {
    if (localObjectNode != null) {
      arObjectManager.removeNode(localObjectNode!);
      localObjectNode = null;
    } else {
      var newNode = ARNode(
          type: NodeType.localGLTF2,
          uri: "assets/Chicken_01/Chicken_01.gltf",
          scale: vec.Vector3(0.2, 0.2, 0.2),
          position: vec.Vector3(0.0, 0.0, 0.0),
          rotation: vec.Vector4(1.0, 0.0, 0.0, 0.0));

      bool? didAddLocalNode = await arObjectManager.addNode(newNode);
      localObjectNode = (didAddLocalNode!) ? newNode : null;
    }
  }

  Future<void> onWebObjectAtButtonPressed() async {
    if (webObjectNode != null) {
      arObjectManager.removeNode(webObjectNode!);
      webObjectNode = null;
    } else {
      var newNode = ARNode(
          type: NodeType.webGLB,
          uri:
              "https://github.com/KhronosGroup/glTF-Sample-Models/raw/master/2.0/Duck/glTF-Binary/Duck.glb",
          scale: vec.Vector3(0.2, 0.2, 0.2));
      bool? didAddWebNode = await arObjectManager.addNode(newNode);
      webObjectNode = (didAddWebNode!) ? newNode : null;
    }
  }
}

可能原因及对应解决方案 #

1. 模型格式兼容性问题 #

ar_flutter_plugin依赖ARCore底层，仅支持glTF 2.0标准，且对部分扩展（如复杂材质、动画扩展）支持有限。

• 使用glTF官方验证工具检查模型，修复不符合标准的报错项
• 简化模型：移除冗余动画、替换ARCore不支持的材质（如改用基础PBR材质）、降低多边形数量

2. 本地模型资源配置错误 #

• 确保pubspec.yaml正确声明所有模型关联资源：

assets:
  - assets/your_model/
  - assets/your_model/model.gltf
  - assets/your_model/texture.png
  - assets/your_model/model.bin

• 检查模型文件路径与代码中uri完全匹配，且gltf引用的bin、纹理文件与gltf文件在同一目录，文件名一致

3. 网络模型加载权限与链接问题 #

• 在AndroidManifest.xml添加网络权限：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

• 确认模型URL为原始文件直链（非GitHub页面链接），且服务器返回正确的Content-Type（如model/gltf+json或model/gltf-binary）

4. ARNode参数配置问题 #

• 调整scale值：避免模型过大/过小超出视野，可先尝试vec.Vector3(0.5,0.5,0.5)测试
• 修改position参数：将模型放置在相机前方可观测区域（如vec.Vector3(0.0, -0.5, 1.0)）
• 确认NodeType与模型类型匹配：本地GLB用NodeType.localGLB，网络GLB用NodeType.webGLB

5. 插件底层问题 #

参考GitHub Issue#136中的社区讨论，尝试临时修复方案（如修改插件Android原生代码的模型加载逻辑）；或升级ar_flutter_plugin至最新版本，考虑切换至更活跃的AR插件（如flutter_ar_core）

内容的提问来源于stack exchange，提问作者Sapinder Singh