Swift Playground中SpriteKit的SKPhysicsContactDelegate didBegin方法不执行求助

阿华AIGC实验室

2026-5-21

排查SpriteKit中didBegin(_:)不执行的常见原因

看起来你在Swift Playgrounds里用SpriteKit做碰撞检测时遇到了棘手的问题，我帮你梳理几个最容易踩坑的点，结合你给出的代码片段来分析：

忘记设置物理世界的代理
这是最常见的错误！你已经让MyScene遵循了SKPhysicsContactDelegate协议，但必须在didMove(to:)里把场景的physicsWorld.contactDelegate指向自身，否则系统不知道要把碰撞事件通知给谁。请补充这段代码：
```
public override func didMove(to view: SKView) {
    // 其他物理设置...
    physicsWorld.contactDelegate = self
}
```

物理体（PhysicsBody）未正确初始化
你的node是可选类型，要确保它的physicsBody不是nil。比如创建节点时要给它分配合适的物理体：

node = SKSpriteNode(color: .red, size: CGSize(width: 50, height: 50))
node?.physicsBody = SKPhysicsBody(rectangleOf: node!.size) // 或者对应形状的物理体
node?.physicsBody?.isDynamic = true // 确保是动态物体，默认是true，但最好显式设置
addChild(node!) // 别忘了把节点添加到场景中

碰撞掩码（Contact Bit Mask）未正确配置
你定义了nodeCategory和touchedNodeCategory，但需要让两个节点的contactBitMask包含对方的类别，这样系统才会检测它们之间的碰撞并触发didBegin。比如：

// 对于node节点
node?.physicsBody?.categoryBitMask = nodeCategory
node?.physicsBody?.contactBitMask = touchedNodeCategory // 告诉系统要检测和touchedNodeCategory的碰撞

// 对于touchedNode（你通过Timer创建的节点）
let touchedNode = SKSpriteNode(color: .blue, size: CGSize(width: 30, height: 30))
touchedNode.physicsBody = SKPhysicsBody(rectangleOf: touchedNode.size)
touchedNode.physicsBody?.categoryBitMask = touchedNodeCategory
touchedNode.physicsBody?.contactBitMask = nodeCategory // 同样要包含nodeCategory
addChild(touchedNode)

注意：collisionBitMask是控制物理碰撞（比如两个物体是否会互相推开），而contactBitMask才是控制是否触发didBegin这类碰撞事件回调，别搞混了！

节点未添加到场景中
不管是node还是通过touchedNodeCreator创建的节点，都必须调用addChild(_:)把它们加入场景，否则它们的物理体不会在物理世界中存在，自然不会有碰撞事件。
检查isDynamic和isContactTestEnabled属性
- isDynamic：如果节点设置为false，它会变成静态物体，默认不会触发碰撞事件（除非和动态物体碰撞，但有些情况可能不生效），确保你需要检测碰撞的节点都是动态的。
- isContactTestEnabled：这个属性默认是true，但如果被误设为false，会关闭该物理体的碰撞事件检测，记得确认它的状态。