设置SKEmitterNode的targetNode导致SpriteKit中zPosition表现异常

结论 #

这个是SpriteKit的设计特性而非系统Bug，属于官方文档没有明确说明的实现细节，是SpriteKit开发中常见的层级坑。

原理说明 #

SKEmitterNode的targetNode属性作用是指定粒子渲染所在的坐标系和父层级，两种场景的逻辑完全不同：

• 不设置targetNode时，所有发射出的粒子作为发射器的子节点渲染，继承发射器及其所有父节点的zPosition、坐标系等属性，所以你给父节点parent设zPosition=5时，粒子自然会在zPosition=0.5的背景上方显示。
• 设置targetNode为self.scene后，所有粒子会脱离发射器的原有父层级，直接作为你指定的targetNode的隐式子节点渲染，此时发射器本身的zPosition不会对粒子生效，粒子的层级由发射器的particleZPosition属性单独控制，默认值为0。

你遇到的粒子被背景遮挡的原因很简单：你设置的背景zPosition为0.5，大于粒子默认的particleZPosition=0，所以粒子会渲染在背景后方。

解决方案 #

任选以下一种方案即可修复：

1. 单独指定粒子层级：在配置发射器的代码中新增particleZPosition设置，值大于背景的zPosition即可：

if let emitter = emitter {
    emitter.zPosition = 5.0 // 该属性仅控制发射器自身，对targetNode模式下的粒子无效
    emitter.particleZPosition = 6.0 // 新增这行，粒子层级高于背景的0.5
    emitter.targetNode = self.scene
    parent.addChild(emitter)
}

2. 统一管理粒子层级：新增一个专门承载所有粒子的容器节点，设置好对应层级后添加到场景，后续所有发射器的targetNode都指向这个容器，不需要单独给每个发射器设置particleZPosition：

// 初始化粒子容器，全局只需要初始化一次
let particleContainer = SKNode()
particleContainer.zPosition = 10 // 设置为高于所有场景内容的层级
addChild(particleContainer)

// 配置发射器时指定targetNode为容器
emitter.targetNode = particleContainer

补充说明 #

• 模拟器和真机表现不一致是SpriteKit的已知差异：模拟器使用macOS平台的图形栈渲染，和真机的iOS/iPadOS图形栈实现存在细微差别，所有层级、性能相关的问题都必须以真机运行结果为准。
• 建议所有SpriteKit项目都开启SKView的ignoresSiblingOrder = true，此时渲染完全按照zPosition排序，不会出现同层级节点按添加顺序渲染的意外遮挡问题，同时也能提升渲染性能。

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