如何修复MapBox SceneKit（AR场景）中的‘Extra argument 'zoom' in call’错误？

我能理解你现在的困惑——文档明确要求传zoom参数，但实际调用却报错说不需要，移除后又提示参数不足，试了multiplier也没用，确实挺闹心的。下面给你几个排查和解决的方向：

1. 优先查看本地库的API实际签名 #

在线文档很容易出现版本滞后的情况，最准确的方式是直接查看你当前使用的TerrainNode类中fetchTerrainTexture方法的定义：

• 在Xcode中，按住Command键点击代码里的fetchTerrainTexture，跳转到它的声明处，看清楚它需要的参数列表、参数名和顺序。
• 有可能新版本的库已经把zoom参数替换成了scale/multiplier，或者把它整合进了其他配置项里，也有可能参数顺序发生了变化。

2. 针对当前错误尝试调整调用 #

如果移除zoom后提示需要两个参数，那大概率是方法的必选参数数量和你传入的不匹配。试试这两种调整：

情况A：方法只需要纹理ID+回调 #

如果方法签名是fetchTerrainTexture(_ textureId: String, completion: @escaping (UIImage?) -> Void)，调整后的调用应为：

terrainNode.fetchTerrainTexture("mapbox/satellite-v9") { image in
    NSLog("Texture load complete")
    terrainNode.geometry?.materials[4].diffuse.contents = image
}

如果需要进度回调，签名可能是fetchTerrainTexture(_ textureId: String, progress: ((Int, Int) -> Void)?, completion: @escaping (UIImage?) -> Void)，去掉zoom参数后直接保留进度和完成回调即可：

terrainNode.fetchTerrainTexture("mapbox/satellite-v9", progress: { progress, total in
    // 进度处理逻辑
}, completion: { image in
    NSLog("Texture load complete")
    terrainNode.geometry?.materials[4].diffuse.contents = image
})

情况B：方法需要纹理ID+尺寸/缩放参数 #

如果文档里的zoom被替换成了类似scale或者tileSize的参数，试试传入对应的数值：

// 假设替换成了scale参数
terrainNode.fetchTerrainTexture("mapbox/satellite-v9", scale: 14, progress: { progress, total in
}, completion: { image in
    NSLog("Texture load complete")
    terrainNode.geometry?.materials[4].diffuse.contents = image
})

3. 确认库的版本一致性 #

如果你是通过CocoaPods/Carthage等依赖管理工具引入的库，检查当前安装的版本和在线文档对应的版本是否一致：

• 比如文档针对v1.x版本，但你实际安装的是v2.x版本，API发生了破坏性更新。
• 可以尝试切换到文档对应的版本，或者查看新版本的迁移指南，看看fetchTerrainTexture的参数变化说明。

4. 检查地形节点的初始化配置 #

有没有可能zoom参数已经在TerrainNode初始化时指定过了？比如你的TerrainNode(minLat:..., maxLat:..., minLon:..., maxLon:...)初始化方法，是否有隐藏的配置项或者后续的设置方法可以指定缩放级别，不需要在fetchTerrainTexture中重复传入？

先从查看本地API定义开始，这是最快定位问题的方式，希望这些建议能帮你解决问题！

内容的提问来源于stack exchange，提问作者James Fergus