如何用RealityView Attachments在3D模型上方显示文本？代码排查求助

你的代码存在几个关键问题导致文本无法显示，以下是具体修复点：

1. Attachment ID 与获取标识不匹配 #

attachments.entity(for:) 是通过 Attachment 的 id 参数 来获取对应的实体，而不是 SwiftUI 的 .tag()。你当前 Attachment 的 id 是 "h1"，但却用 "panel" 去获取，自然拿不到实体。

2. 文本实体未设置合理位置 #

即使成功获取文本实体，默认位置会和地球模型重叠，或者处于相机视野外，需要手动调整位置到地球上方。

3. 避免重复添加实体 #

update 闭包会多次触发，直接调用 content.add(text) 会重复添加文本实体，应该将文本作为地球的子节点添加，确保只关联一次。

修正后的完整代码 #

import SwiftUI
import RealityKit

struct ContentView: View {
    @State private var earthEntity: ModelEntity?
    
    var body: some View {
        RealityView { content, attachments in
            // 异步加载地球模型
            do {
                let entity = try await ModelEntity(named: "World_Earth")
                entity.scale = SIMD3(0.0015, 0.0015, 0.0015)
                content.add(entity)
                earthEntity = entity
                
                // 模型加载完成后立即关联文本附件
                if let textEntity = attachments.entity(for: "panel") {
                    // 设置文本在地球上方的位置（根据模型缩放调整偏移量）
                    textEntity.position = SIMD3(0, 0.002, 0)
                    entity.addChild(textEntity)
                }
            } catch {
                print("加载模型失败: \(error.localizedDescription)")
            }
        } attachments: {
            // 将Attachment的id设为"panel"，和获取时的标识一致
            Attachment(id: "panel") {
                Text("hello")
                    .padding()
                    .background(.white.opacity(0.8))
                    .cornerRadius(8)
            }
        }
    }
}

额外说明 #

• 移除了不必要的 update 闭包：直接在模型加载完成的异步代码中关联文本，避免时机问题。
• 给文本添加了背景和 padding，提升可读性，避免和地球模型颜色混淆。
• 调整了文本的 position：根据地球的缩放比例，设置 y 轴偏移量为 0.002，确保文本在地球上方显示。
• 增加了错误捕获，方便排查模型加载失败的问题。

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