style: Optimize the code comments.(优化代码注释)

Author: LayaCharley

src/layaAir/Laya.ts

@@ -37,9 +37,9 @@ import { VertexMesh } from "./laya/RenderEngine/RenderShader/VertexMesh";
 
 /**
  * @en Laya is the reference entry for global objects.
- * @en The Laya class refers to some commonly used global objects, such as Laya.stage: stage, Laya.timer: time manager, Laya.loader: loading manager. Pay attention to case when using.
+ * - The Laya class refers to some commonly used global objects, such as Laya.stage: stage, Laya.timer: time manager, Laya.loader: loading manager. Pay attention to case when using.
  * @zh Laya是全局对象的引用入口集。
- * @zh Laya类引用了一些常用的全局对象，比如Laya.stage：舞台，Laya.timer：时间管理器，Laya.loader：加载管理器，使用时注意大小写。
+ * - Laya类引用了一些常用的全局对象，比如Laya.stage：舞台，Laya.timer：时间管理器，Laya.loader：加载管理器，使用时注意大小写。
  */
 export class Laya {
     /**

src/layaAir/laya/d3/physics/PhysicsCollider.ts

@@ -42,8 +42,8 @@ export class PhysicsCollider extends PhysicsColliderComponent {
     }
 
     /**
-     * @en If this collider is a trigger.
-     * @zh 此碰撞器是否为触发器。
+     * @en If this collider is a trigger. A trigger will trigger events but not produce actual physical blocking effects.
+     * @zh 此碰撞器是否为触发器。触发器会触发事件但不会产生实际的物理阻挡效果。
      */
     get isTrigger(): boolean {
         return this._isTrigger;

src/layaAir/laya/d3/physics/PhysicsColliderComponent.ts

@@ -89,16 +89,16 @@ export class PhysicsColliderComponent extends Component {
     protected _eventsArray: string[];
 
     /**
-     * @en The collider object.
-     * @zh 碰撞器对象。
+     * @en The collider object. Used to access the underlying physics engine's collider object and directly operate on the underlying physics engine's collision characteristics.
+     * @zh 碰撞器对象。用于访问底层物理引擎的碰撞器对象，直接操作底层物理引擎的碰撞特性。
      */
     get collider(): ICollider {
         return this._collider;
     }
 
     /**
-     * @en The restitution of the collider (also known as bounciness).
-     * @zh 碰撞器的弹力（也叫Bounciness）。
+     * @en The restitution coefficient is a key parameter in the physics engine that controls the elasticity of object collisions.
+     * @zh 恢复系数是物理引擎中控制物体碰撞弹性程度的关键参数，在中文物理学术语中也被称为"弹性系数"或"反弹系数"。
      */
     get restitution(): number {
         return this._restitution;
@@ -112,8 +112,8 @@ export class PhysicsColliderComponent extends Component {
     }
 
     /**
-     * @en The friction of the collider.
-     * @zh 碰撞器的摩擦力。
+     * @en The friction of the collider defines the friction coefficient of the object's surface, affecting the difficulty of the object sliding on the contact surface. The larger the value, the greater the friction, making it harder for the object to slide.
+     * @zh 碰撞器的摩擦力。用于定义物体表面的摩擦系数，影响物体在接触面上滑动的难易程度。值越大，摩擦力越大，物体越难以滑动。
      */
     get friction(): number {
         return this._friction;
@@ -130,8 +130,8 @@ export class PhysicsColliderComponent extends Component {
     }
 
     /**
-     * @en The rolling friction of the collider.
-     * @zh 碰撞器的滚动摩擦力。
+     * @en The rolling friction of the collider. Controls the resistance of an object as it rolls on a surface, affecting how quickly the object slows down when rolling. The larger the value, the faster the object's roll deceleration.
+     * @zh 碰撞器的滚动摩擦力。用于控制物体在表面上滚动时的阻力，影响物体的滚动减速速率。值越大，物体滚动减速越快。
      */
     get rollingFriction(): number {
         return this._rollingFriction;
@@ -148,8 +148,8 @@ export class PhysicsColliderComponent extends Component {
     }
 
     /**
-     * @en The dynamic friction of the collider.
-     * @zh 碰撞器的动态摩擦力。
+     * @en The dynamic friction of the collider. Defines the friction coefficient of an object when it is already in motion.
+     * @zh 碰撞器的动态摩擦力。定义物体在已经运动状态下的摩擦系数。
      */
     get dynamicFriction(): number {
         return this._dynamicFriction;
@@ -162,8 +162,8 @@ export class PhysicsColliderComponent extends Component {
     }
 
     /**
-     * @en The static friction of the collider.
-     * @zh 碰撞器的静态摩擦力。
+     * @en The static friction of the collider. Defines the friction coefficient of an object when it is stationary, resisting its movement. Typically greater than or equal to dynamic friction.
+     * @zh 碰撞器的静态摩擦力。定义物体在静止状态时抵抗开始移动的摩擦系数。通常大于或等于动态摩擦力。
      */
     get staticFriction(): number {
         return this._staticFriction;
@@ -208,7 +208,7 @@ export class PhysicsColliderComponent extends Component {
      * - Minimum: The minimum friction coefficient of the two objects is used.
      * - Maximum: The maximum friction coefficient of the two objects is used.
      * - Multiply: The friction coefficients of the two objects are multiplied to get the final friction coefficient.
-     * @zh 弹力组合模式，用于定义在两个物体发生碰撞时，如何组合它们的弹力系数，以确定最终的弹力。
+     * @zh 恢复系数(弹力)组合模式，用于定义在两个物体发生碰撞时，如何组合它们的恢复系数，以确定最终的反弹效果。
      * 值为：
      * - Average（平均值）：两个物体的摩擦系数取平均值。
      * - Minimum（最小值）：使用两个物体摩擦系数中的最小值。
@@ -227,8 +227,8 @@ export class PhysicsColliderComponent extends Component {
     }
 
     /**
-     * @en The collider shape of the physics collider.
-     * @zh 物理碰撞器的碰撞形状。
+     * @en The collider shape of the physics collider. Used to set the geometric shape used by a physics collider, such as box, sphere, capsule, etc., defining the physical boundaries of an object.
+     * @zh 物理碰撞器的碰撞形状。用于设置物理碰撞器使用的几何形状，如盒体、球体、胶囊体等，用于定义物体的物理边界。
      */
     get colliderShape(): Physics3DColliderShape {
         return this._colliderShape;
@@ -246,8 +246,8 @@ export class PhysicsColliderComponent extends Component {
     }
 
     /**
-     * @en The collision group this collider belongs to.
-     * @zh 此碰撞器所属的碰撞组。
+     * @en The collision group this collider belongs to, used to control which objects can collide with it based on bitwise operations.
+     * @zh 此碰撞器所属的碰撞组，用于控制哪些物体可以与之碰撞，基于位掩码实现。
      */
     get collisionGroup(): number {
         return this._collisionGroup;

src/layaAir/laya/d3/physics/Rigidbody3D.ts

@@ -20,7 +20,7 @@ export class Rigidbody3D extends PhysicsColliderComponent {
     /** @internal */
     private _mass = 1.0;
     /** @internal */
-    private _gravity = new Vector3(0, -10, 0);
+    private _gravity = new Vector3(0, -9.8, 0);
     /** @internal */
     private _angularDamping = 0.0;
     /** @internal */
@@ -55,8 +55,8 @@ export class Rigidbody3D extends PhysicsColliderComponent {
     }
 
     /**
-     * @en The mass of the rigidbody.
-     * @zh 刚体的质量。
+     * @en The mass of the rigidbody. It affects the size of acceleration and momentum transfer during force application in collisions.
+     * @zh 刚体的质量。影响其受力时的加速度大小和在碰撞中的动量传递。
      */
     get mass(): number {
         return this._mass;
@@ -71,7 +71,7 @@ export class Rigidbody3D extends PhysicsColliderComponent {
 
     /**
      * @en Determines if the rigidbody is kinematic. If true, the rigidbody can only be moved by transform property, not by other force-related properties.
-     * @zh 确定刚体是否为运动物体。如果为true仅可通过transform属性移动物体,而非其他力相关属性。
+     * @zh 设置刚体是否为运动学控制模式。如果为true仅可通过transform属性移动物体,而非其他力相关属性。
      */
     get isKinematic(): boolean {
         return this._isKinematic;
@@ -85,8 +85,8 @@ export class Rigidbody3D extends PhysicsColliderComponent {
     }
 
     /**
-     * @en The linear damping of the rigidbody.
-     * @zh 刚体的线阻力。
+     * @en The linear damping of the rigidbody. It simulates air resistance and other environmental factors to make the object slow down gradually.
+     * @zh 控制刚体线性运动的阻尼系数，模拟空气阻力等环境因素，使物体逐渐减速。
      */
     get linearDamping(): number {
         return this._linearDamping;
@@ -100,8 +100,8 @@ export class Rigidbody3D extends PhysicsColliderComponent {
     }
 
     /**
-     * @en The angular damping of the rigidbody.
-     * @zh 刚体的角阻力。
+     * @en The angular damping of the rigidbody. It simulates angular resistance and other environmental factors to make the object's rotation slow down gradually. 
+     * @zh 刚体的角阻力。控制刚体旋转运动的阻尼系数，使旋转逐渐减速，防止永久旋转。
      */
     get angularDamping(): number {
         return this._angularDamping;
@@ -115,8 +115,8 @@ export class Rigidbody3D extends PhysicsColliderComponent {
     }
 
     /**
-     * @en The gravity applied to the rigidbody.
-     * @zh 应用于刚体的重力。
+     * @en Sets the gravity vector applied to the rigidbody, allowing customization of direction and magnitude. 
+     * @zh 设置作用于刚体的重力向量，可自定义方向和大小。
      */
     get gravity(): Vector3 {
         return this._gravity;
@@ -131,7 +131,7 @@ export class Rigidbody3D extends PhysicsColliderComponent {
 
     /**
      * @en The linear motion scaling factor for each axis of the rigidbody. If the value of any axis is 0, it means that the linear motion is frozen on that axis.
-     * @zh 刚体每个轴的线性运动缩放因子。如果某一轴的值为0表示冻结在该轴的线性运动。
+     * @zh 限制刚体在特定轴向的线性运动, 如果某一轴的值为0表示冻结在该轴的线性运动。
      */
     get linearFactor(): Vector3 {
         return this._linearFactor;
@@ -165,7 +165,7 @@ export class Rigidbody3D extends PhysicsColliderComponent {
 
     /**
      * @en The angular motion scaling factor for each axis of the rigidbody. If the value of any axis is 0, it means that the angular motion is frozen on that axis.
-     * @zh 刚体每个轴的角度运动缩放因子。如果某一轴的值为0表示冻结在该轴的角度运动。
+     * @zh 限制刚体在特定轴向的旋转运动，如果某一轴的值为0表示冻结在该轴的角度运动。
      */
     get angularFactor(): Vector3 {
         return this._angularFactor;
@@ -233,8 +233,8 @@ export class Rigidbody3D extends PhysicsColliderComponent {
     }
 
     /**
-     * @en If the rigidbody is a trigger.
-     * @zh 刚体是否为触发器。
+     * @en Sets whether the rigidbody is a trigger. Triggers can detect collisions but do not produce physical reactions.
+     * @zh 设置刚体是否作为触发器使用。触发器可以检测碰撞但不产生物理反应。
      */
     public get trigger(): boolean {
         return this._trigger;