RealityView体积窗口内3D美国地图模型持续被裁剪的问题求助

在Apple Vision Pro真机上，使用RealityKit与RealityView在体积窗口中渲染3D美国地图（usdz格式）时，模型内容始终被裁剪。调整窗口默认大小无效果，平移模型仅能显示部分区域（如右移后阿拉斯加可见但右侧内容被裁剪），已排除usdz文件本身的问题。

窗口组定义代码：

WindowGroup {
    MapView()
}
.windowStyle(.volumetric)
.defaultSize(Size3D(width: 2.7, height: 0.9, depth: 0.9), in: .meters)

模型加载代码：

RealityView { content in
    guard let usMap = try? await Entity(named: "us_map") else {
        return
    }

    content.add(usMap)
}

1. 适配模型缩放与位置，使其匹配体积窗口尺寸 #

模型被裁剪的核心原因往往是自身尺寸远超窗口范围，或原点未对齐窗口中心。加载模型后，计算模型边界框并自动调整缩放与位置：

RealityView { content in
    guard let usMap = try? await Entity(named: "us_map") else {
        return
    }
    
    // 获取模型的边界框（优先取碰撞体边界，无则用模型自身边界）
    let boundingBox = usMap.collision?.shape?.boundingBox ?? usMap.boundingBox
    let modelExtents = boundingBox.extents
    
    // 窗口目标尺寸（可替换为动态获取的当前窗口尺寸）
    let windowSize = Size3D(width: 2.7, height: 0.9, depth: 0.9)
    
    // 计算适配窗口的缩放比例，保留10%边距避免边缘裁剪
    let scaleX = windowSize.width / modelExtents.x * 0.9
    let scaleY = windowSize.height / modelExtents.y * 0.9
    let scaleZ = windowSize.depth / modelExtents.z * 0.9
    let targetScale = min(scaleX, scaleY, scaleZ)
    
    // 应用缩放
    usMap.scale = SIMD3(repeating: targetScale)
    
    // 将模型原点对齐窗口中心（抵消模型自身偏移）
    let modelCenterOffset = boundingBox.center * targetScale
    usMap.position = -modelCenterOffset
    
    content.add(usMap)
}

2. 调整相机裁剪平面范围 #

体积窗口默认相机的近/远裁剪平面可能过窄，导致模型部分区域被裁。可以修改相机参数扩大裁剪范围：

RealityView { content in
    // ...模型加载与适配代码
    
    // 找到默认相机并调整裁剪参数
    if let camera = content.entities.first(where: { $0 is Camera }) as? Camera {
        camera.near = 0.01  // 缩小近裁剪面，避免近距离模型被裁
        camera.far = 100.0  // 扩大远裁剪面，容纳远处模型部分
    }
}

3. 调整相机位置扩大视野 #

如果模型适配后仍有裁剪，可以将相机向后移动，增加视野范围以容纳整个模型：

RealityView { content in
    // ...模型加载与适配代码
    
    if let camera = content.entities.first(where: { $0 is Camera }) as? Camera {
        // 沿Z轴向后移动相机（数值根据实际模型大小调整）
        camera.position.z = -1.8
    }
}

4. 验证窗口实际尺寸 #

若调整默认窗口大小无效果，可在MapView中添加GeometryReader确认窗口实际渲染尺寸，确保模型适配的是真实窗口大小：

struct MapView: View {
    var body: some View {
        GeometryReader { geo in
            RealityView { content in
                // ...模型加载代码，这里可以用geo.size计算窗口实际尺寸（需转换为3D）
                let windowWidth = geo.size.width / UIScreen.main.scale  // 转换为物理尺寸
                // ...后续适配逻辑
            }
        }
    }
}

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