「学习笔记」Cocos Creator 3.8 物理系统

import { _decorator, Component, Node, RigidBody2D, Collider2D, BoxCollider2D } from 'cc';
const { ccclass, property } = _decorator;

@ccclass('My2DPhysics')
export class My2DPhysics extends Component {
    @property(RigidBody2D)
    rigidBody: RigidBody2D | null = null; //刚体组件

    @property(BoxCollider2D)
    boxCollider: BoxCollider2D | null = null; //碰撞器组件

    start() {
        if (!this.rigidBody) {
            this.rigidBody = this.node.addComponent(RigidBody2D);
        }
        if (!this.boxCollider) {
            this.boxCollider = this.node.addComponent(BoxCollider2D);
        }

        // 设置刚体属性
        this.rigidBody.type = EPhysics2D.RigidBodyType.Dynamic; // 动态刚体
        this.rigidBody.gravityScale = 1.0; // 重力缩放
        this.rigidBody.linearDamping = 0.1; // 线性阻尼
        this.rigidBody.angularDamping = 0.1; // 角度阻尼

        // 设置矩形碰撞器的属性
        this.boxCollider.size = new Vec2(50, 50); // 碰撞盒大小
        this.boxCollider.offset = new Vec2(0, 0); // 碰撞盒偏移

        // // 在节点上添加圆形碰撞器
        // let circleCollider = this.node.addComponent(CircleCollider2D);
        // circleCollider.radius = 20; // 圆形半径
        // circleCollider.offset = new Vec2(0, 0); // 偏移
    }
}

import { RevoluteJoint2D } from 'cc';
@ccclass('My2DPhysics')
export class My2DPhysics extends Component {
    @property(Node)
    otherNode: Node | null = null;
    start() {
        if (this.otherNode) {
            let joint = this.node.addComponent(RevoluteJoint2D);
            joint.connectedBody = this.otherNode.getComponent(RigidBody2D);
            joint.anchor = new Vec2(0, 0); // 锚点
        }
    }
}

@ccclass('TestContactCallBack')
export class TestContactCallBack extends Component {
  start () {
    // 注册单个碰撞体的回调函数
    let collider = this.getComponent(Collider2D);
    if (collider) {
      collider.on(Contact2DType.BEGIN_CONTACT, this.onBeginContact, this);
      collider.on(Contact2DType.END_CONTACT, this.onEndContact, this);
    }
  }
  onBeginContact (selfCollider: Collider2D, otherCollider: Collider2D, contact: IPhysics2DContact | null) {
    // 只在两个碰撞体开始接触时被调用一次
    console.log('onBeginContact');
  }
  onEndContact (selfCollider: Collider2D, otherCollider: Collider2D, contact: IPhysics2DContact | null) {
    // 只在两个碰撞体结束接触时被调用一次
    console.log('onEndContact');
  }
}

import { _decorator, Component, Node, Vec3, PhysicsSystem } from 'cc';
const { ccclass, property } = _decorator;
@ccclass('Example')
export class Example extends Component {
  start () {
    PhysicsSystem.instance.enable = true;                //开启物理系统，默认开启
    PhysicsSystem.instance.gravity = new Vec3(0, -10, 0);//重力矢量，默认值 { x: 0, y: -10, z: 0 }
    PhysicsSystem.instance.allowSleep = false;           //是否允许系统进入休眠状态，默认值 true
    PhysicsSystem.instance.friction = 0.5;               //摩擦系数，默认值 0.5
  }
}

import { _decorator, Component, Node, RigidBody, Collider, BoxCollider } from 'cc';
const { ccclass, property } = _decorator;

@ccclass('My3DPhysics')
export class My3DPhysics extends Component {
    @property(RigidBody)
    rigidBody: RigidBody | null = null;
    @property(BoxCollider)
    boxCollider: BoxCollider | null = null;

    start() {
        if (!this.rigidBody) {
            this.rigidBody = this.node.addComponent(RigidBody);
        }
        if (!this.boxCollider) {
            this.boxCollider = this.node.addComponent(BoxCollider);
        }
        // 设置刚体属性
        this.rigidBody.type = ERigidBodyType.DYNAMIC; // 动态刚体
        this.rigidBody.gravityScale = 1.0; // 重力缩放
        this.rigidBody.linearDamping = 0.1; // 线性阻尼
        this.rigidBody.angularDamping = 0.1; // 角度阻尼
        // 设置碰撞器属性
        this.boxCollider.size = new Vec3(1, 1, 1); // 碰撞盒大小
        this.boxCollider.center = new Vec3(0, 0, 0); // 碰撞盒中心
        // 在节点上添加球体碰撞器
        // let sphereCollider = this.node.addComponent(SphereCollider);
        // sphereCollider.radius = 1.0; // 球体半径
        // sphereCollider.center = new Vec3(0, 0, 0); // 球体中心
    }
}

import { IPhysicsContact, CollisionEvent, RigidBody, Collider } from 'cc';
@ccclass('My3DPhysics')
export class My3DPhysics extends Component {
    onCollisionEnter(event: CollisionEvent) {
        console.log('Collision Enter');
        // 获取碰撞对象
        let otherNode = event.otherCollider.node;
        let otherRigidbody = otherNode.getComponent(RigidBody);
        // 可以在这里添加碰撞逻辑
        if (otherRigidbody) {
            otherRigidbody.applyForce(new Vec3(10, 0, 0), new Vec3(0, 0, 0)); // 施加力
        }
    }
    onCollisionStay(event: CollisionEvent) {
        console.log('Collision Stay');
    }
    onCollisionExit(event: CollisionEvent) {
        console.log('Collision Exit');
    }
}

import { geometry } from 'cc';

// 构造一条从（0，-1，0）出发，指向 Y 轴的射线 （前三个参数是起点，后三个参数是方向）
const worldRay = new geometry.Ray(0, -1, 0, 0, 1, 0); // 或通过静态方法 geometry.Ray.create(0, -1, 0, 0, 1, 0);
// 以下参数可选
const mask = 0xffffffff;// 用于过滤的 掩码，可以传入需要检测的分组，默认为 0xffffffff
const maxDistance = 10000000;// 最大检测距离，默认为 10000000
const queryTrigger = true; // 是否检测触发器

const bResult = PhysicsSystem.instance.raycast(worldRay, mask, maxDistance, queryTrigger);
if(bResult){
  const results = PhysicsSystem.instance.raycastResults;
  for (let i = 0; i < results.length; i++) {
    const result = results[i];
    const collider = result.collider;// 击中的碰撞器
    const distance = result.distance;// 击中点与射线起点的距离
    const hitPoint = result.hitPoint;// 击中点（世界坐标系中）
    const hitNormal = result.hitNormal;// 击中点所处面的法线（世界坐标系中）
  }
}

lineStripCast (samplePointsWorldSpace: Array<Vec3>, mask = 0xffffffff, maxDistance = 10000000, queryTrigger = true): boolean;
lineStripCastClosest (samplePointsWorldSpace: Array<Vec3>, mask = 0xffffffff, maxDistance = 10000000, queryTrigger = true): boolean;