RealityKit平面检测后纹理平铺失效问题求助（LiDAR设备）

核心方向：手动控制UV坐标映射 #

RealityKit默认会将纹理拉伸适配平面尺寸，要实现平铺效果，关键是主动控制纹理的UV坐标，以下是三种可行方案：

1. 利用textureTransform快速实现（iOS 15+） #

iOS 15及以上版本的RealityKit支持直接通过材质的textureTransform属性缩放纹理，实现平铺，代码最简洁：

// 加载棋盘格纹理
guard let texture = try? TextureResource.load(named: "checkerboard") else { return }

// 创建材质并设置纹理缩放（x/y方向各平铺10次，可根据需求调整）
var material = SimpleMaterial()
material.color = .init(texture: texture)
material.textureTransform = .init(scale: [10, 10])

// 将材质应用到检测到的平面实体
let planeEntity = ModelEntity(
    mesh: .generatePlane(width: planeAnchor.extent.x, depth: planeAnchor.extent.z),
    materials: [material]
)
anchor.addChild(planeEntity)

如果平面尺寸动态更新（LiDAR会实时调整平面范围），只需在didUpdate anchors回调里重新计算缩放值并更新textureTransform即可。

2. 自定义材质着色器控制UV #

需要更灵活的纹理控制时，使用CustomMaterial的着色器块修改UV坐标：

guard let texture = try? TextureResource.load(named: "checkerboard") else { return }

// 创建自定义材质，在着色器中缩放UV实现平铺
let customMaterial = CustomMaterial(
    color: .init(tint: .white, texture: texture),
    roughness: .init(floatLiteral: 0.5)
) { context in
    // 每米平铺10次，可根据需求调整tileCount
    let tileCount: Float = 10.0
    var uv = context.appearance.uv0
    uv.x *= tileCount
    uv.y *= tileCount
    return .modifyUV(uv)
}

let planeEntity = ModelEntity(
    mesh: .generatePlane(width: planeAnchor.extent.x, depth: planeAnchor.extent.z),
    materials: [customMaterial]
)
anchor.addChild(planeEntity)

3. 手动生成带自定义UV的网格 #

如果不想依赖自定义着色器，可以直接在生成平面网格时定义UV范围，让纹理自动平铺：

func generateTiledPlane(width: Float, depth: Float, tileSize: Float) -> MeshResource {
    // 根据平面尺寸和单块纹理大小计算平铺次数
    let tileCountX = width / tileSize
    let tileCountY = depth / tileSize
    
    // 定义顶点和对应的UV坐标
    let vertices: [MeshResource.Position] = [
        [0, 0, 0], [width, 0, 0], [width, 0, depth], [0, 0, depth]
    ]
    let uvs: [MeshResource.TextureCoordinate] = [
        [0, 0], [tileCountX, 0], [tileCountX, tileCountY], [0, tileCountY]
    ]
    let indices: [UInt32] = [0, 1, 2, 0, 2, 3]
    
    var descriptor = MeshDescriptor()
    descriptor.positions = MeshBuffers.Positions(vertices)
    descriptor.textureCoordinates = MeshBuffers.TextureCoordinates(uvs)
    descriptor.primitives = .triangles(indices)
    
    return try! MeshResource.generate(from: [descriptor])
}

// 使用时传入检测到的平面尺寸和单块棋盘格大小（比如0.2米）
let tiledMesh = generateTiledPlane(
    width: planeAnchor.extent.x, 
    depth: planeAnchor.extent.z, 
    tileSize: 0.2
)
let planeEntity = ModelEntity(
    mesh: tiledMesh, 
    materials: [SimpleMaterial(color: .init(texture: texture), isMetallic: false)]
)

适配LiDAR动态平面更新 #

由于LiDAR会实时更新平面的范围和尺寸，需要在ARSession的didUpdate anchors回调中，根据最新的ARPlaneAnchor参数，重新调整材质的缩放值或重新生成网格，确保平铺效果始终匹配平面大小。

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