Android ArCore Sceneform API：如何在运行时更换纹理？

我之前也踩过这个一模一样的坑！调用modelRenderable.getMaterial().setTexture("normalMap", normalMap.get())没效果，大概率是这几个细节没处理到位，咱们逐个排查：

• 确认材质参数名称是否完全匹配
  不同材质模板（比如Filament的默认材质）对纹理参数的命名可能有差异，比如有些材质里法线纹理的参数名是normal而非normalMap，或者是带前缀的baseColor、metallicRoughness这类。你可以先打印出材质的所有参数列表，确认目标参数的准确拼写和大小写：

  Material material = modelRenderable.getMaterial();
  for (MaterialParameter param : material.getParameters()) {
      Log.d("MaterialParams", param.getName());
  }
  

  差一个字符都可能导致设置无效，必须严格匹配！

• 确保纹理已完全加载完成
  如果你的纹理是异步加载的（比如从本地文件或网络获取），调用normalMap.get()的时候可能纹理还没准备好，自然设置后看不到效果。建议在纹理加载完成的回调里执行设置操作：

  // 假设normalMap是ListenableFuture<Texture>类型
  normalMap.whenComplete((texture, throwable) -> {
      if (throwable == null && texture != null) {
          // 这里再执行纹理设置
          modelRenderable.getMaterial().setTexture("normalMap", texture);
      } else {
          Log.e("TextureLoad", "加载法线纹理失败: " + throwable.getMessage());
      }
  });
  

• 必须克隆独立的材质实例
  这是最容易被忽略的关键！默认情况下，多个Renderable可能共享同一个材质实例，引擎会把共享材质标记为不可修改（或者修改后不会实时生效）。正确的做法是先克隆出独立的MaterialInstance，再修改纹理：

  // 克隆材质实例，避免影响其他共享该材质的模型
  MaterialInstance materialInstance = modelRenderable.getMaterial().makeCopy();
  // 批量设置各类纹理
  materialInstance.setTexture("baseColorMap", baseColorTexture.get());
  materialInstance.setTexture("normalMap", normalMap.get());
  materialInstance.setTexture("metallicMap", metallicTexture.get());
  materialInstance.setTexture("roughnessMap", roughnessTexture.get());
  // 将修改后的材质设置回Renderable
  modelRenderable.setMaterial(materialInstance);
  

• 检查纹理格式是否符合材质要求
  比如法线纹理需要是存储法线信息的RGB格式（而非普通彩色图），金属度/粗糙度纹理通常是单通道或RG通道的灰度图。如果纹理格式不对，即使设置成功也不会有视觉效果。你可以在创建纹理时指定正确的用法：

  Texture.Builder normalTextureBuilder = Texture.builder()
          .setSource(...)
          .setUsage(Texture.Usage.NORMAL_MAP); // 明确标记为法线纹理
  

按照这几个步骤排查下来，基本就能解决纹理不生效的问题了！

内容的提问来源于stack exchange，提问作者Alexey Shmakov