Swift Playgrounds：如何为非AR RealityKit项目添加HDRI？

针对你在Swift Playgrounds（SwiftPM环境）里没法用常规Xcode项目的skybox文件夹方法添加HDRI的问题，这里有几个直接可行的方案，完全不需要手动打灯或混合SceneKit：

方案1：用Reality工具将HDRI打包为环境资源 #

不管是Reality Converter还是Reality Composer Pro（Mac版，支持iOS/macOS项目），都能轻松把HDRI转换成RealityKit可直接加载的环境资源：

• Reality Converter操作：导入你的HDRI文件，在右侧面板选择「Environment」类型，导出为.reality或.usdz文件
• Reality Composer Pro操作：新建空场景，在「Environment」面板导入HDRI作为天空盒和环境照明，导出成.reality文件
• 将导出的资源文件直接拖入Swift Playgrounds的侧边栏，Playgrounds会自动将其标记为资源
• 代码中加载并应用：

import RealityKit

// 加载打包好的环境资源
guard let envResource = try? EnvironmentResource(named: "MyHDRIEnvironment.reality") else {
    fatalError("加载环境资源失败")
}
// 同时设置背景和照明
arView.environment.background = .skybox(envResource)
arView.environment.lighting = .environment(envResource)

方案2：直接通过代码加载HDR文件 #

不需要任何额外工具，直接把HDR文件（.hdr/.exr格式）拖入Playgrounds资源目录，就能用代码生成环境：

import RealityKit

// 直接加载HDR纹理
guard let hdriTex = try? TextureResource.load(named: "studio_hdr.hdr") else {
    fatalError("HDR文件未找到或格式不支持")
}
// 生成环境资源
let environment = EnvironmentResource.generate(from: hdriTex)
// 应用到场景
arView.environment.background = .skybox(environment)
arView.environment.lighting = .environment(environment)

这个方法完全绕过了常规Xcode的skybox文件夹要求，直接利用RealityKit的API生成环境。

方案3：从Cinema 4D导出时嵌入环境 #

既然你用Cinema 4D建模，可以直接把HDRI环境和模型一起导出：

• 在Cinema 4D中设置好HDRI作为场景的环境照明和背景
• 将模型导出为.usdz格式（用Cinema 4D的USD导出插件），或者导出FBX后用Reality Converter转成.reality/.usdz
• 把导出的文件拖入Playgrounds，加载模型时，环境会自动被带入场景：

import RealityKit

let modelAnchor = try! Entity.load(named: "ModelWithHDRI.usdz")
arView.scene.addAnchor(modelAnchor)
// 如果环境未自动应用，手动指定
if let env = modelAnchor.environment {
    arView.environment = env
}

额外说明 #

• 手动灯光确实无法复刻HDRI带来的全局柔和照明、真实反射和环境氛围，优先用上述HDRI方案
• 完全没必要混合SceneKit，RealityKit本身已经原生支持HDRI环境加载，操作更简洁

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