SpriteKit碰撞检测实现方法：如何检测Player与Puff对象的碰撞

SpriteKit的碰撞交互基于物理体的三类掩码参数实现，按以下步骤配置即可实现需求：

步骤1：定义物理类别掩码 #

提前用常量定义不同对象的物理类别，每个类别对应二进制单独一位，最多支持32种不同类别：

struct PhysicsCategory {
    static let player: UInt32 = 0x1 << 0 // 对应二进制 0001
    static let puff: UInt32 = 0x1 << 1   // 对应二进制 0010
    // 其他对象类别可按相同规则向下扩展
}

步骤2：分别配置两类对象的物理体属性 #

• Player对象物理体配置：

// 可根据实际需要替换物理体形状初始化方法
player.physicsBody = SKPhysicsBody(rectangleOf: player.size)
player.physicsBody?.categoryBitMask = PhysicsCategory.player
// 配置需要检测接触的对象类别
player.physicsBody?.contactTestBitMask = PhysicsCategory.puff
// 碰撞掩码按需设置，不需要物理碰撞反弹效果可设为0
player.physicsBody?.collisionBitMask = PhysicsCategory.puff
// 动态物体才会触发接触检测，非静态对象需设为true
player.physicsBody?.isDynamic = true

• Puff对象物理体配置：

puff.physicsBody = SKPhysicsBody(circleOfRadius: puff.size.width/2)
puff.physicsBody?.categoryBitMask = PhysicsCategory.puff
puff.physicsBody?.contactTestBitMask = PhysicsCategory.player
puff.physicsBody?.collisionBitMask = PhysicsCategory.player
// 如果Puff是固定不动的对象可以设为false，动态移动则设为true
puff.physicsBody?.isDynamic = false

步骤3：实现物理接触代理 #

首先在游戏场景类中声明遵守SKPhysicsContactDelegate协议，并给物理世界设置代理：

class GameScene: SKScene, SKPhysicsContactDelegate {
    override func didMove(to view: SKView) {
        physicsWorld.contactDelegate = self
    }
}

实现接触触发方法，判断碰撞对象类型后执行自定义交互逻辑：

func didBegin(_ contact: SKPhysicsContact) {
    // 计算两个碰撞物体的类别掩码组合
    let contactMask = contact.bodyA.categoryBitMask | contact.bodyB.categoryBitMask
    
    // 确认是Player和Puff发生接触
    if contactMask == PhysicsCategory.player | PhysicsCategory.puff {
        // 统一提取两个碰撞节点
        let playerNode = contact.bodyA.categoryBitMask == PhysicsCategory.player ? contact.bodyA.node : contact.bodyB.node
        let puffNode = contact.bodyA.categoryBitMask == PhysicsCategory.puff ? contact.bodyA.node : contact.bodyB.node
        
        guard let player = playerNode as? SKSpriteNode, let puff = puffNode as? SKSpriteNode else { return }
        // 此处替换为你需要的自定义交互逻辑
        runCustomEffect(player: player, puff: puff)
    }
}

// 自定义交互逻辑示例
func runCustomEffect(player: SKSpriteNode, puff: SKSpriteNode) {
    // 示例：Puff播放消失动画后移除
    puff.run(SKAction.sequence([
        SKAction.scale(to: 1.5, duration: 0.1),
        SKAction.fadeOut(withDuration: 0.15),
        SKAction.removeFromParent()
    ]))
    // 示例：Player触发弹跳效果
    player.run(SKAction.moveBy(x: 0, y: 25, duration: 0.1))
}

异常排查 #

如果碰撞未触发，优先检查以下配置：

• 两个对象的physicsBody都已完成初始化，不为空
• 至少有一个对象的isDynamic属性为true
• 两类对象的contactTestBitMask都正确设置了对方的类别值
• 场景的physicsWorld.contactDelegate已完成赋值

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