VisionOS中RealityKit如何实现实体跨手部分层渲染及手部可见性调整？

架构老林

2026-6-18

VisionOS RealityKit 手部分层遮挡解决方案

一、实现部分实体在手部上方、部分在下方

可以通过**渲染顺序（Render Order）**结合默认手部遮挡逻辑来实现：

给需要显示在手部上方的实体设置更高的renderOrder值，示例代码：

let topEntity = ModelEntity(mesh: MeshResource.generateBox(size: 0.1))
topEntity.renderOrder = 10 // 默认值为0，数值越高越晚绘制（显示在上方）
arView.scene.addAnchor(topEntity)

保持upperLimbVisibility为默认状态（不设置.hidden），此时手部会自动遮挡renderOrder低于它的实体，而renderOrder更高的实体则能覆盖在手部上方。

二、完全沉浸模式下保留手部可见，同时让实体显示在手上

不要使用upperLimbVisibility(.hidden)，而是通过**渲染层级（Rendering Layer）**来控制绘制顺序：

获取系统手部实体：通过AR会话的锚点找到手部对应的实体（通常是HandAnchor关联的实体）

给手部实体设置自定义材质并指定低渲染层级：

if let handEntity = arView.scene.findEntity(named: "Hand_Right") {
    var handMaterial = SimpleMaterial()
    handMaterial.renderingLayer = 0
    handEntity.model?.materials = [handMaterial]
}

给需要显示在手上的实体设置更高的渲染层级：

let overlayEntity = ModelEntity(mesh: MeshResource.generateSphere(radius: 0.05))
var overlayMaterial = SimpleMaterial()
overlayMaterial.renderingLayer = 1
overlayEntity.model?.materials = [overlayMaterial]
arView.scene.addAnchor(overlayEntity)

RealityKit会按照渲染层级从低到高绘制内容，手部先绘制，实体后绘制就能覆盖在手上，同时手部保持可见。