@galacean/engine-core 0.0.0-experimental-2.0-game.17 → 0.0.0-experimental-2.0-game.18

package/dist/main.js

@@ -781,10 +781,10 @@ var AssetPromise = /*#__PURE__*/ function() {
    */ _proto.onProgress = function onProgress(onTaskComplete, onTaskDetail) {
         var completeProgress = this._taskCompleteProgress;
         var detailProgress = this._taskDetailProgress;
-        if (completeProgress) {
+        if (completeProgress && onTaskComplete) {
             onTaskComplete(completeProgress.loaded, completeProgress.total);
         }
-        if (detailProgress) {
+        if (detailProgress && onTaskDetail) {
             for(var url in detailProgress){
                 var _detailProgress_url = detailProgress[url], loaded = _detailProgress_url.loaded, total = _detailProgress_url.total;
                 onTaskDetail(url, loaded, total);
@@ -2020,10 +2020,11 @@ SystemInfo._initialize();
 }({});
 
 /**
- * The way to handle the situation where wrapped text is too tall to fit in the height.
+ * The way to handle the situation where the text is too large to fit in the bounds.
  */ var OverflowMode = /*#__PURE__*/ function(OverflowMode) {
     /** Overflow when the text is too tall */ OverflowMode[OverflowMode["Overflow"] = 0] = "Overflow";
     /** Truncate with height when the text is too tall */ OverflowMode[OverflowMode["Truncate"] = 1] = "Truncate";
+    /** Shrink the font size until the text fits within the bounds (both width and height) */ OverflowMode[OverflowMode["Shrink"] = 2] = "Shrink";
     return OverflowMode;
 }({});
 
@@ -2088,7 +2089,8 @@ SystemInfo._initialize();
     TextUtils.measureChar = function measureChar(char, fontString) {
         return TextUtils._measureFontOrChar(fontString, char, true);
     };
-    TextUtils.measureTextWithWrap = function measureTextWithWrap(renderer, rendererWidth, rendererHeight, lineSpacing, characterSpacing) {
+    TextUtils.measureTextWithWrap = function measureTextWithWrap(renderer, rendererWidth, rendererHeight, lineSpacing, characterSpacing, uploadCharTexture) {
+        if (uploadCharTexture === void 0) uploadCharTexture = true;
         var subFont = renderer._getSubFont();
         var fontString = subFont.nativeFontString;
         var fontSizeInfo = TextUtils.measureFont(fontString);
@@ -2117,7 +2119,7 @@ SystemInfo._initialize();
             var notFirstLine = false;
             for(var j = 0, m = subText.length; j < m; ++j){
                 var char = subText[j];
-                var charInfo = TextUtils._getCharInfo(char, fontString, subFont);
+                var charInfo = TextUtils._getCharInfo(char, fontString, subFont, uploadCharTexture);
                 var charCode = char.charCodeAt(0);
                 var isSpace = charCode === 32;
                 if (isSpace && notFirstLine && line.length === 0 && word.length === 0) {
@@ -2246,7 +2248,8 @@ SystemInfo._initialize();
             lineMaxSizes: lineMaxSizes
         };
     };
-    TextUtils.measureTextWithoutWrap = function measureTextWithoutWrap(renderer, rendererHeight, lineSpacing, characterSpacing) {
+    TextUtils.measureTextWithoutWrap = function measureTextWithoutWrap(renderer, rendererHeight, lineSpacing, characterSpacing, uploadCharTexture) {
+        if (uploadCharTexture === void 0) uploadCharTexture = true;
         var subFont = renderer._getSubFont();
         var fontString = subFont.nativeFontString;
         var fontSizeInfo = TextUtils.measureFont(fontString);
@@ -2265,7 +2268,7 @@ SystemInfo._initialize();
             var maxAscent = 0;
             var maxDescent = 0;
             for(var j = 0; j < lineLength; ++j){
-                var charInfo = TextUtils._getCharInfo(line[j], fontString, subFont);
+                var charInfo = TextUtils._getCharInfo(line[j], fontString, subFont, uploadCharTexture);
                 curWidth += charInfo.xAdvance;
                 var offsetY = charInfo.offsetY;
                 var halfH = charInfo.h * 0.5;
@@ -2293,6 +2296,64 @@ SystemInfo._initialize();
         };
     };
     /**
+   * Measure text in SHRINK overflow mode: keep shrinking the font size until the text fits
+   * within the bounds (both width and height). Mirrors Cocos Creator's `Overflow.SHRINK`.
+   *
+   * @param renderer - The text renderer
+   * @param rendererWidth - The width of the bounds in pixels
+   * @param rendererHeight - The height of the bounds in pixels
+   * @param originalFontSize - The font size set on the renderer (the upper bound, never enlarged)
+   * @param lineSpacing - The line spacing ratio (relative to font size)
+   * @param characterSpacing - The character spacing ratio (relative to font size)
+   * @param enableWrapping - Whether wrapping is enabled
+   * @param applyFontSize - Callback that switches the renderer's sub font to the given font size
+   * @returns The fitted text metrics and the actual font size used for layout
+   */ TextUtils.measureTextWithShrink = function measureTextWithShrink(renderer, rendererWidth, rendererHeight, originalFontSize, lineSpacing, characterSpacing, enableWrapping, applyFontSize) {
+        // During the binary search we only need the text dimensions, so pass `uploadCharTexture=false`
+        // to avoid building GPU font atlases for the intermediate font sizes that won't be used.
+        // The fitted size is then re-measured once with upload=true to populate its atlas. This trades
+        // one extra full measure pass (CPU) for skipping ~log2(size) throwaway atlas textures (GPU);
+        // we can't reuse the search's last measure because its char bitmaps were never cached.
+        var measureAt = function(fontSize, uploadCharTexture) {
+            applyFontSize(fontSize);
+            return enableWrapping ? TextUtils.measureTextWithWrap(renderer, rendererWidth, rendererHeight, lineSpacing * fontSize, characterSpacing * fontSize, uploadCharTexture) : TextUtils.measureTextWithoutWrap(renderer, rendererHeight, lineSpacing * fontSize, characterSpacing * fontSize, uploadCharTexture);
+        };
+        // The content height is `lineHeight * lineCount`; `metrics.height` is clamped to the bounds
+        // unless overflowMode is Overflow, so it can't be used to detect vertical overflow here.
+        var isFit = function(metrics) {
+            return metrics.width <= rendererWidth && metrics.lineHeight * metrics.lines.length <= rendererHeight;
+        };
+        // If the text already fits at the original size, keep it (SHRINK only shrinks, never enlarges).
+        var metrics = measureAt(originalFontSize, false);
+        if (isFit(metrics)) {
+            metrics = measureAt(originalFontSize, true);
+            return {
+                metrics: metrics,
+                fontSize: originalFontSize
+            };
+        }
+        // Binary search for the largest integer font size that fits (measure only, no atlas upload).
+        var low = 1;
+        var high = Math.floor(originalFontSize);
+        var fitFontSize = low;
+        while(low <= high){
+            var mid = low + high >> 1;
+            metrics = measureAt(mid, false);
+            if (isFit(metrics)) {
+                fitFontSize = mid;
+                low = mid + 1;
+            } else {
+                high = mid - 1;
+            }
+        }
+        // Re-measure the fitted size with upload=true so the sub font / atlas correspond to it.
+        metrics = measureAt(fitFontSize, true);
+        return {
+            metrics: metrics,
+            fontSize: fitFontSize
+        };
+    };
+    /**
    * Get native font hash.
    * @param fontName - The font name
    * @param fontSize - The font size
@@ -2409,12 +2470,17 @@ SystemInfo._initialize();
     };
     /**
    * @internal
-   */ TextUtils._getCharInfo = function _getCharInfo(char, fontString, font) {
+   */ TextUtils._getCharInfo = function _getCharInfo(char, fontString, font, uploadCharTexture) {
+        if (uploadCharTexture === void 0) uploadCharTexture = true;
         var charInfo = font._getCharInfo(char);
         if (!charInfo) {
             charInfo = TextUtils.measureChar(char, fontString);
-            font._uploadCharTexture(charInfo);
-            font._addCharInfo(char, charInfo);
+            // SHRINK 的二分阶段只需字符尺寸(measureChar 已给出),传 uploadCharTexture=false 跳过 GPU
+            // 字形图集上传与缓存,避免给用不到的中间字号建字体 atlas 纹理。
+            if (uploadCharTexture) {
+                font._uploadCharTexture(charInfo);
+                font._addCharInfo(char, charInfo);
+            }
         }
         return charInfo;
     };
@@ -11454,6 +11520,14 @@ __decorate([
         this._subFont = font._getSubFont(this.fontSize, this.fontStyle);
         this._subFont.nativeFontString = TextUtils.getNativeFontString(font.name, this.fontSize, this.fontStyle);
     };
+    /**
+   * Switch the sub font to a specific font size, used by the SHRINK overflow measurement.
+   */ _proto._applyFontSizeForShrink = function _applyFontSizeForShrink(fontSize) {
+        var font = this._font;
+        var subFont = font._getSubFont(fontSize, this._fontStyle);
+        subFont.nativeFontString = TextUtils.getNativeFontString(font.name, fontSize, this._fontStyle);
+        this._subFont = subFont;
+    };
     _proto._updatePosition = function _updatePosition() {
         var transform = this.entity.transform;
         var e = transform.worldMatrix.elements;
@@ -11509,12 +11583,26 @@ __decorate([
         }
     };
     _proto._updateLocalData = function _updateLocalData() {
+        var _this = this;
         var _pixelsPerUnit = Engine._pixelsPerUnit;
         var _this__localBounds = this._localBounds, min = _this__localBounds.min, max = _this__localBounds.max;
         var charRenderInfos = TextRenderer._charRenderInfos;
+        var rendererWidth = this.width * _pixelsPerUnit;
+        var rendererHeight = this.height * _pixelsPerUnit;
+        var fontSize = this._fontSize;
+        var textMetrics;
+        if (this._overflowMode === OverflowMode.Shrink) {
+            var result = TextUtils.measureTextWithShrink(this, rendererWidth, rendererHeight, this._fontSize, this._lineSpacing, this._characterSpacing, this.enableWrapping, function(size) {
+                return _this._applyFontSizeForShrink(size);
+            });
+            fontSize = result.fontSize;
+            textMetrics = result.metrics;
+        } else {
+            var characterSpacing = this._characterSpacing * fontSize;
+            textMetrics = this.enableWrapping ? TextUtils.measureTextWithWrap(this, rendererWidth, rendererHeight, this._lineSpacing * fontSize, characterSpacing) : TextUtils.measureTextWithoutWrap(this, rendererHeight, this._lineSpacing * fontSize, characterSpacing);
+        }
         var charFont = this._getSubFont();
-        var characterSpacing = this._characterSpacing * this._fontSize;
-        var textMetrics = this.enableWrapping ? TextUtils.measureTextWithWrap(this, this.width * _pixelsPerUnit, this.height * _pixelsPerUnit, this._lineSpacing * this._fontSize, characterSpacing) : TextUtils.measureTextWithoutWrap(this, this.height * _pixelsPerUnit, this._lineSpacing * this._fontSize, characterSpacing);
+        var characterSpacing1 = this._characterSpacing * fontSize;
         var height = textMetrics.height, lines = textMetrics.lines, lineWidths = textMetrics.lineWidths, lineHeight = textMetrics.lineHeight, lineMaxSizes = textMetrics.lineMaxSizes;
         var charRenderInfoPool = this.engine._charRenderInfoPool;
         var linesLen = lines.length;
@@ -11522,9 +11610,7 @@ __decorate([
         if (linesLen > 0) {
             var horizontalAlignment = this.horizontalAlignment;
             var pixelsPerUnitReciprocal = 1.0 / _pixelsPerUnit;
-            var rendererWidth = this._width * _pixelsPerUnit;
             var halfRendererWidth = rendererWidth * 0.5;
-            var rendererHeight = this._height * _pixelsPerUnit;
             var halfLineHeight = lineHeight * 0.5;
             var startY = 0;
             var topDiff = lineHeight * 0.5 - lineMaxSizes[0].ascent;
@@ -11534,7 +11620,10 @@ __decorate([
                     startY = rendererHeight * 0.5 - halfLineHeight + topDiff;
                     break;
                 case TextVerticalAlignment.Center:
-                    startY = height * 0.5 - halfLineHeight - (bottomDiff - topDiff) * 0.5;
+                    // Center the text block (lineHeight * lineCount) within the renderer, independent of
+                    // `height` — which equals the renderer height for Truncate/Shrink and would otherwise
+                    // push the text upward by (rendererHeight - blockHeight) / 2 when the box is taller.
+                    startY = lineHeight * linesLen * 0.5 - halfLineHeight - (bottomDiff - topDiff) * 0.5;
                     break;
                 case TextVerticalAlignment.Bottom:
                     startY = height - rendererHeight * 0.5 - halfLineHeight - bottomDiff;
@@ -11586,7 +11675,7 @@ __decorate([
                             j === firstRow && (minX = Math.min(minX, left));
                             maxX = Math.max(maxX, right);
                         }
-                        startX += charInfo.xAdvance + characterSpacing;
+                        startX += charInfo.xAdvance + characterSpacing1;
                     }
                 }
                 startY -= lineHeight;
@@ -11642,7 +11731,7 @@ __decorate([
         this._setDirtyFlagTrue(4 | 8);
     };
     _proto._isTextNoVisible = function _isTextNoVisible() {
-        return !this._font || this._text === "" || this._fontSize === 0 || this.enableWrapping && this.width <= 0 || this.overflowMode === OverflowMode.Truncate && this.height <= 0;
+        return !this._font || this._text === "" || this._fontSize === 0 || this.enableWrapping && this.width <= 0 || (this.overflowMode === OverflowMode.Truncate || this.overflowMode === OverflowMode.Shrink) && this.height <= 0;
     };
     _proto._buildChunk = function _buildChunk(textChunk, count) {
         var _this_color = this.color, r = _this_color.r, g = _this_color.g, b = _this_color.b, a = _this_color.a;
@@ -22208,100 +22297,351 @@ __decorate([
     /** The shape of the collider that was hit. */ this.shape = null;
 };
 
-/**
- * Describes a contact point where the collision occurs.
- */ var ContactPoint = function ContactPoint() {
-    /** The position of the contact point between the shapes, in world space. */ this.position = new engineMath.Vector3();
-    /** The normal of the contacting surfaces at the contact point. The normal direction points from the other shape to the self shape. */ this.normal = new engineMath.Vector3();
-    /** The impulse applied at the contact point, in world space. Divide by the simulation time step to get a force value. */ this.impulse = new engineMath.Vector3();
-};
+function _array_like_to_array(arr, len) {
+    if (len == null || len > arr.length) len = arr.length;
 
-/**
- * Collision information between two shapes when they collide.
- */ var Collision = /*#__PURE__*/ function() {
-    function Collision() {}
-    var _proto = Collision.prototype;
-    /**
-   * Get contact points.
-   * @param outContacts - The result of contact points
-   * @returns The actual count of contact points
-   *
-   * @remarks To optimize performance, the engine does not modify the length of the array you pass.
-   * You need to obtain the actual number of contact points from the function's return value.
-   */ _proto.getContacts = function getContacts(outContacts) {
-        var nativeCollision = this._nativeCollision;
-        var factor = this.shape.id === nativeCollision.shape1Id ? 1 : -1;
-        var nativeContactPoints = nativeCollision.getContacts();
-        var length = nativeContactPoints.size();
-        for(var i = 0; i < length; i++){
-            var _outContacts, _i;
-            var nativeContractPoint = nativeContactPoints.get(i);
-            var contact = (_outContacts = outContacts)[_i = i] || (_outContacts[_i] = new ContactPoint());
-            contact.position.copyFrom(nativeContractPoint.position);
-            contact.normal.copyFrom(nativeContractPoint.normal).scale(factor);
-            contact.impulse.copyFrom(nativeContractPoint.impulse).scale(factor);
-            contact.separation = nativeContractPoint.separation;
-        }
-        return length;
-    };
-    _create_class(Collision, [
-        {
-            key: "contactCount",
-            get: /**
-   * Count of contact points.
-   */ function get() {
-                return this._nativeCollision.contactCount;
-            }
-        }
-    ]);
-    return Collision;
-}();
+    for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i];
+
+    return arr2;
+}
+
+function _unsupported_iterable_to_array(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array(o, minLen);
+
+    var n = Object.prototype.toString.call(o).slice(8, -1);
+
+    if (n === "Object" && o.constructor) n = o.constructor.name;
+    if (n === "Map" || n === "Set") return Array.from(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
+}
+
+function _create_for_of_iterator_helper_loose(o, allowArrayLike) {
+    var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"];
+
+    if (it) return (it = it.call(o)).next.bind(it);
+    // Fallback for engines without symbol support
+    if (Array.isArray(o) || (it = _unsupported_iterable_to_array(o)) || allowArrayLike && o && typeof o.length === "number") {
+        if (it) o = it;
+
+        var i = 0;
+
+        return function() {
+            if (i >= o.length) return { done: true };
+
+            return { done: false, value: o[i++] };
+        };
+    }
+
+    throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
 
 /**
- * A physics scene is a collection of colliders and constraints which can interact.
- */ var PhysicsScene = /*#__PURE__*/ function() {
-    function PhysicsScene(scene) {
-        this._restTime = 0;
-        this._fixedTimeStep = 1 / 60;
-        this._colliders = new DisorderedArray();
-        this._gravity = new engineMath.Vector3(0, -9.81, 0);
-        this._scene = scene;
-        this._setGravity = this._setGravity.bind(this);
-        //@ts-ignore
-        this._gravity._onValueChanged = this._setGravity;
-        var engine = scene.engine;
-        if (engine._physicsInitialized) {
-            this._nativePhysicsScene = Engine._nativePhysics.createPhysicsScene(engine._nativePhysicsManager);
-        }
+ * Script class, used for logic writing.
+ */ var Script = /*#__PURE__*/ function(Component) {
+    _inherits(Script, Component);
+    function Script() {
+        var _this;
+        _this = Component.apply(this, arguments) || this, /** @internal */ _this._started = false, /** @internal */ _this._onStartIndex = -1, /** @internal */ _this._onUpdateIndex = -1, /** @internal */ _this._onLateUpdateIndex = -1, /** @internal */ _this._onPhysicsUpdateIndex = -1, /** @internal */ _this._onPreRenderIndex = -1, /** @internal */ _this._onPostRenderIndex = -1, /** @internal */ _this._entityScriptsIndex = -1;
+        return _this;
     }
-    var _proto = PhysicsScene.prototype;
+    var _proto = Script.prototype;
     /**
-   * Get whether two colliders can collide with each other.
-   * @param layer1 - The first collision layer
-   * @param layer2 - The second collision layer
-   * @returns Whether the colliders should collide
-   */ _proto.getColliderLayerCollision = function getColliderLayerCollision(layer1, layer2) {
-        var index1 = Math.log2(layer1);
-        var index2 = Math.log2(layer2);
-        if (!Number.isInteger(index1) || !Number.isInteger(index1)) {
-            throw new Error("Collision layer must be a single layer (Layer.Layer0 to Layer.Layer31)");
-        }
-        return Engine._nativePhysics.getColliderLayerCollision(index1, index2);
+   * Called when be enabled first time, only once.
+   */ _proto.onAwake = function onAwake() {};
+    /**
+   * Called when be enabled.
+   */ _proto.onEnable = function onEnable() {};
+    /**
+   * Called before the frame-level loop start for the first time, only once.
+   */ _proto.onStart = function onStart() {};
+    /**
+   * The main loop, called frame by frame.
+   * @param deltaTime - The delta time since last frame in seconds
+   */ _proto.onUpdate = function onUpdate(deltaTime) {};
+    /**
+   * Called after the onUpdate finished, called frame by frame.
+   * @param deltaTime - The delta time since last frame in seconds
+   */ _proto.onLateUpdate = function onLateUpdate(deltaTime) {};
+    /**
+   * Called before camera rendering, called per camera.
+   * @param camera - Current camera.
+   */ _proto.onBeginRender = function onBeginRender(camera) {};
+    /**
+   * Called after camera rendering, called per camera.
+   * @param camera - Current camera.
+   */ _proto.onEndRender = function onEndRender(camera) {};
+    /**
+   * Called before physics calculations, the number of times is related to the physical update frequency.
+   */ _proto.onPhysicsUpdate = function onPhysicsUpdate() {};
+    /**
+   * Called when the trigger enter.
+   * @param other - ColliderShape
+   */ _proto.onTriggerEnter = function onTriggerEnter(other) {};
+    /**
+   * Called when the trigger exit.
+   * @param other - ColliderShape
+   */ _proto.onTriggerExit = function onTriggerExit(other) {};
+    /**
+   * Called when the trigger stay.
+   * @remarks onTriggerStay is called every frame while the trigger stay.
+   * @param other - ColliderShape
+   */ _proto.onTriggerStay = function onTriggerStay(other) {};
+    /**
+   * Called when the collision enter.
+   * @param other - The Collision data associated with this collision event
+   * @remarks The Collision data will be invalid after this call, you should copy the data if needed.
+   */ _proto.onCollisionEnter = function onCollisionEnter(other) {};
+    /**
+   * Called when the collision exit.
+   * @param other - The Collision data associated with this collision event
+   * @remarks The Collision data will be invalid after this call, you should copy the data if needed.
+   */ _proto.onCollisionExit = function onCollisionExit(other) {};
+    /**
+   * Called when the collision stay.
+   * @param other - The Collision data associated with this collision event
+   * @remarks The Collision data will be invalid after this call, you should copy the data if needed.
+   */ _proto.onCollisionStay = function onCollisionStay(other) {};
+    /**
+   * Called when the pointer is down while over the ColliderShape.
+   * @param eventData - The pointer event data that triggered this callback
+   */ _proto.onPointerDown = function onPointerDown(eventData) {};
+    /**
+   * Called when the pointer is up while over the ColliderShape.
+   * @param eventData - The pointer event data that triggered this callback
+   */ _proto.onPointerUp = function onPointerUp(eventData) {};
+    /**
+   * Called when the pointer is down and up with the same collider.
+   * @param eventData - The pointer event data that triggered this callback
+   */ _proto.onPointerClick = function onPointerClick(eventData) {};
+    /**
+   *  Called when the pointer enters the ColliderShape.
+   * @param eventData - The pointer event data that triggered this callback
+   */ _proto.onPointerEnter = function onPointerEnter(eventData) {};
+    /**
+   * Called when the pointer exits the ColliderShape.
+   * @param eventData - The pointer event data that triggered this callback
+   */ _proto.onPointerExit = function onPointerExit(eventData) {};
+    /**
+   * This function will be called when the pointer is pressed on the collider.
+   * @param eventData - The pointer event data that triggered this callback
+   */ _proto.onPointerBeginDrag = function onPointerBeginDrag(eventData) {};
+    /**
+   *  When a drag collision occurs on the pointer, this function will be called every time it moves.
+   * @param eventData - The pointer event data that triggered this callback
+   */ _proto.onPointerDrag = function onPointerDrag(eventData) {};
+    /**
+   *  When dragging ends, this function will be called (Dragged object).
+   * @param eventData - The pointer event data that triggered this callback
+   */ _proto.onPointerEndDrag = function onPointerEndDrag(eventData) {};
+    /**
+   *  When dragging ends, this function will be called (Receiving object).
+   * @param eventData - The pointer event data that triggered this callback
+   */ _proto.onPointerDrop = function onPointerDrop(eventData) {};
+    /**
+   * Called when be disabled.
+   */ _proto.onDisable = function onDisable() {};
+    /**
+   * Called at the end of the destroyed frame.
+   */ _proto.onDestroy = function onDestroy() {};
+    /**
+   * @internal
+   */ _proto._onAwake = function _onAwake() {
+        this.onAwake();
     };
     /**
-   * Set whether two colliders can collide with each other.
-   * @param layer1 - The first collision layer
-   * @param layer2 - The second collision layer
-   * @param isCollide - Whether the colliders should collide
-   */ _proto.setColliderLayerCollision = function setColliderLayerCollision(layer1, layer2, isCollide) {
-        var index1 = Math.log2(layer1);
-        var index2 = Math.log2(layer2);
-        if (!Number.isInteger(index1) || !Number.isInteger(index1)) {
-            throw new Error("Collision layer must be a single layer (Layer.Layer0 to Layer.Layer31)");
-        }
-        Engine._nativePhysics.setColliderLayerCollision(index1, index2, isCollide);
+   * @internal
+   */ _proto._onEnable = function _onEnable() {
+        this.onEnable();
     };
-    _proto.raycast = function raycast(ray, distanceOrResult, layerMaskOrResult, outHitResult) {
+    /**
+   * @internal
+   */ _proto._onDisable = function _onDisable() {
+        this.onDisable();
+    };
+    /**
+   * @internal
+   */ _proto._onEnableInScene = function _onEnableInScene() {
+        var _this_scene = this.scene, componentsManager = _this_scene._componentsManager;
+        var prototype = Script.prototype;
+        if (!this._started) {
+            componentsManager.addOnStartScript(this);
+        }
+        if (this.onUpdate !== prototype.onUpdate) {
+            componentsManager.addOnUpdateScript(this);
+        }
+        if (this.onLateUpdate !== prototype.onLateUpdate) {
+            componentsManager.addOnLateUpdateScript(this);
+        }
+        if (this.onPhysicsUpdate !== prototype.onPhysicsUpdate) {
+            componentsManager.addOnPhysicsUpdateScript(this);
+        }
+        for(var _iterator = _create_for_of_iterator_helper_loose(Object.values(PointerMethods)), _step; !(_step = _iterator()).done;){
+            var pointerMethod = _step.value;
+            if (this[pointerMethod] === prototype[pointerMethod]) {
+                this[pointerMethod] = null;
+            }
+        }
+        this._entity._addScript(this);
+    };
+    /**
+   * @internal
+   */ _proto._onDisableInScene = function _onDisableInScene() {
+        var componentsManager = this.scene._componentsManager;
+        var prototype = Script.prototype;
+        if (!this._started) {
+            componentsManager.removeOnStartScript(this);
+        }
+        if (this.onUpdate !== prototype.onUpdate) {
+            componentsManager.removeOnUpdateScript(this);
+        }
+        if (this.onLateUpdate !== prototype.onLateUpdate) {
+            componentsManager.removeOnLateUpdateScript(this);
+        }
+        if (this.onPhysicsUpdate !== prototype.onPhysicsUpdate) {
+            componentsManager.removeOnPhysicsUpdateScript(this);
+        }
+        this._entity._removeScript(this);
+    };
+    /**
+   * @internal
+   */ _proto._onDestroy = function _onDestroy() {
+        Component.prototype._onDestroy.call(this);
+        this.onDestroy();
+    };
+    return Script;
+}(Component);
+__decorate([
+    ignoreClone
+], Script.prototype, "_started", void 0);
+__decorate([
+    ignoreClone
+], Script.prototype, "_onStartIndex", void 0);
+__decorate([
+    ignoreClone
+], Script.prototype, "_onUpdateIndex", void 0);
+__decorate([
+    ignoreClone
+], Script.prototype, "_onLateUpdateIndex", void 0);
+__decorate([
+    ignoreClone
+], Script.prototype, "_onPhysicsUpdateIndex", void 0);
+__decorate([
+    ignoreClone
+], Script.prototype, "_onPreRenderIndex", void 0);
+__decorate([
+    ignoreClone
+], Script.prototype, "_onPostRenderIndex", void 0);
+__decorate([
+    ignoreClone
+], Script.prototype, "_entityScriptsIndex", void 0);
+var PointerMethods = /*#__PURE__*/ function(PointerMethods) {
+    PointerMethods["onPointerDown"] = "onPointerDown";
+    PointerMethods["onPointerUp"] = "onPointerUp";
+    PointerMethods["onPointerClick"] = "onPointerClick";
+    PointerMethods["onPointerEnter"] = "onPointerEnter";
+    PointerMethods["onPointerExit"] = "onPointerExit";
+    PointerMethods["onPointerBeginDrag"] = "onPointerBeginDrag";
+    PointerMethods["onPointerDrag"] = "onPointerDrag";
+    PointerMethods["onPointerEndDrag"] = "onPointerEndDrag";
+    PointerMethods["onPointerDrop"] = "onPointerDrop";
+    return PointerMethods;
+}({});
+
+/**
+ * Describes a contact point where the collision occurs.
+ */ var ContactPoint = function ContactPoint() {
+    /** The position of the contact point between the shapes, in world space. */ this.position = new engineMath.Vector3();
+    /** The normal of the contacting surfaces at the contact point. The normal direction points from the other shape to the self shape. */ this.normal = new engineMath.Vector3();
+    /** The impulse applied at the contact point, in world space. Divide by the simulation time step to get a force value. */ this.impulse = new engineMath.Vector3();
+};
+
+/**
+ * Collision information between two shapes when they collide.
+ */ var Collision = /*#__PURE__*/ function() {
+    function Collision() {}
+    var _proto = Collision.prototype;
+    /**
+   * Get contact points.
+   * @param outContacts - The result of contact points
+   * @returns The actual count of contact points
+   *
+   * @remarks To optimize performance, the engine does not modify the length of the array you pass.
+   * You need to obtain the actual number of contact points from the function's return value.
+   */ _proto.getContacts = function getContacts(outContacts) {
+        var nativeCollision = this._nativeCollision;
+        var factor = this.shape.id === nativeCollision.shape1Id ? 1 : -1;
+        var nativeContactPoints = nativeCollision.getContacts();
+        var length = nativeContactPoints.size();
+        for(var i = 0; i < length; i++){
+            var _outContacts, _i;
+            var nativeContractPoint = nativeContactPoints.get(i);
+            var contact = (_outContacts = outContacts)[_i = i] || (_outContacts[_i] = new ContactPoint());
+            contact.position.copyFrom(nativeContractPoint.position);
+            contact.normal.copyFrom(nativeContractPoint.normal).scale(factor);
+            contact.impulse.copyFrom(nativeContractPoint.impulse).scale(factor);
+            contact.separation = nativeContractPoint.separation;
+        }
+        return length;
+    };
+    _create_class(Collision, [
+        {
+            key: "contactCount",
+            get: /**
+   * Count of contact points.
+   */ function get() {
+                return this._nativeCollision.contactCount;
+            }
+        }
+    ]);
+    return Collision;
+}();
+
+/**
+ * A physics scene is a collection of colliders and constraints which can interact.
+ */ var PhysicsScene = /*#__PURE__*/ function() {
+    function PhysicsScene(scene) {
+        this._restTime = 0;
+        this._fixedTimeStep = 1 / 60;
+        this._colliders = new DisorderedArray();
+        this._gravity = new engineMath.Vector3(0, -9.81, 0);
+        this._scene = scene;
+        this._setGravity = this._setGravity.bind(this);
+        //@ts-ignore
+        this._gravity._onValueChanged = this._setGravity;
+        var engine = scene.engine;
+        if (engine._physicsInitialized) {
+            this._nativePhysicsScene = Engine._nativePhysics.createPhysicsScene(engine._nativePhysicsManager);
+        }
+    }
+    var _proto = PhysicsScene.prototype;
+    /**
+   * Get whether two colliders can collide with each other.
+   * @param layer1 - The first collision layer
+   * @param layer2 - The second collision layer
+   * @returns Whether the colliders should collide
+   */ _proto.getColliderLayerCollision = function getColliderLayerCollision(layer1, layer2) {
+        var index1 = Math.log2(layer1);
+        var index2 = Math.log2(layer2);
+        if (!Number.isInteger(index1) || !Number.isInteger(index1)) {
+            throw new Error("Collision layer must be a single layer (Layer.Layer0 to Layer.Layer31)");
+        }
+        return Engine._nativePhysics.getColliderLayerCollision(index1, index2);
+    };
+    /**
+   * Set whether two colliders can collide with each other.
+   * @param layer1 - The first collision layer
+   * @param layer2 - The second collision layer
+   * @param isCollide - Whether the colliders should collide
+   */ _proto.setColliderLayerCollision = function setColliderLayerCollision(layer1, layer2, isCollide) {
+        var index1 = Math.log2(layer1);
+        var index2 = Math.log2(layer2);
+        if (!Number.isInteger(index1) || !Number.isInteger(index1)) {
+            throw new Error("Collision layer must be a single layer (Layer.Layer0 to Layer.Layer31)");
+        }
+        Engine._nativePhysics.setColliderLayerCollision(index1, index2, isCollide);
+    };
+    _proto.raycast = function raycast(ray, distanceOrResult, layerMaskOrResult, outHitResult) {
         var hitResult;
         var distance = Number.MAX_VALUE;
         if (typeof distanceOrResult === "number") {
@@ -22481,6 +22821,7 @@ __decorate([
         for(var i = 0; i < step; i++){
             componentsManager.callScriptOnPhysicsUpdate();
             this._callColliderOnUpdate();
+            nativePhysicsManager.setContactEventEnabled(this._hasCollisionEventConsumers());
             nativePhysicsManager.update(fixedTimeStep);
             this._callColliderOnLateUpdate();
             this._dispatchEvents(nativePhysicsManager.updateEvents());
@@ -22643,6 +22984,21 @@ __decorate([
         // Dispatch trigger events
         for(var i1 = 0, n1 = triggerEvents.length; i1 < n1; i1++)_loop1(i1);
     };
+    _proto._hasCollisionEventConsumers = function _hasCollisionEventConsumers() {
+        var _this__colliders = this._colliders, colliders = _this__colliders._elements;
+        var _Script_prototype = Script.prototype, onCollisionEnter = _Script_prototype.onCollisionEnter, onCollisionExit = _Script_prototype.onCollisionExit, onCollisionStay = _Script_prototype.onCollisionStay;
+        for(var i = this._colliders.length - 1; i >= 0; --i){
+            var scripts = colliders[i].entity._scripts;
+            var scriptElements = scripts._elements;
+            for(var j = scripts.length - 1; j >= 0; --j){
+                var script = scriptElements[j];
+                if (script.onCollisionEnter !== onCollisionEnter || script.onCollisionExit !== onCollisionExit || script.onCollisionStay !== onCollisionStay) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    };
     _proto._setGravity = function _setGravity() {
         this._nativePhysicsScene.setGravity(this._gravity);
     };
@@ -31017,257 +31373,6 @@ Scene._fogColorProperty = ShaderProperty.getByName("scene_FogColor");
 Scene._fogParamsProperty = ShaderProperty.getByName("scene_FogParams");
 Scene._prefilterdDFGProperty = ShaderProperty.getByName("scene_PrefilteredDFG");
 
-function _array_like_to_array(arr, len) {
-    if (len == null || len > arr.length) len = arr.length;
-
-    for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i];
-
-    return arr2;
-}
-
-function _unsupported_iterable_to_array(o, minLen) {
-    if (!o) return;
-    if (typeof o === "string") return _array_like_to_array(o, minLen);
-
-    var n = Object.prototype.toString.call(o).slice(8, -1);
-
-    if (n === "Object" && o.constructor) n = o.constructor.name;
-    if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
-}
-
-function _create_for_of_iterator_helper_loose(o, allowArrayLike) {
-    var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"];
-
-    if (it) return (it = it.call(o)).next.bind(it);
-    // Fallback for engines without symbol support
-    if (Array.isArray(o) || (it = _unsupported_iterable_to_array(o)) || allowArrayLike && o && typeof o.length === "number") {
-        if (it) o = it;
-
-        var i = 0;
-
-        return function() {
-            if (i >= o.length) return { done: true };
-
-            return { done: false, value: o[i++] };
-        };
-    }
-
-    throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
-}
-
-/**
- * Script class, used for logic writing.
- */ var Script = /*#__PURE__*/ function(Component) {
-    _inherits(Script, Component);
-    function Script() {
-        var _this;
-        _this = Component.apply(this, arguments) || this, /** @internal */ _this._started = false, /** @internal */ _this._onStartIndex = -1, /** @internal */ _this._onUpdateIndex = -1, /** @internal */ _this._onLateUpdateIndex = -1, /** @internal */ _this._onPhysicsUpdateIndex = -1, /** @internal */ _this._onPreRenderIndex = -1, /** @internal */ _this._onPostRenderIndex = -1, /** @internal */ _this._entityScriptsIndex = -1;
-        return _this;
-    }
-    var _proto = Script.prototype;
-    /**
-   * Called when be enabled first time, only once.
-   */ _proto.onAwake = function onAwake() {};
-    /**
-   * Called when be enabled.
-   */ _proto.onEnable = function onEnable() {};
-    /**
-   * Called before the frame-level loop start for the first time, only once.
-   */ _proto.onStart = function onStart() {};
-    /**
-   * The main loop, called frame by frame.
-   * @param deltaTime - The delta time since last frame in seconds
-   */ _proto.onUpdate = function onUpdate(deltaTime) {};
-    /**
-   * Called after the onUpdate finished, called frame by frame.
-   * @param deltaTime - The delta time since last frame in seconds
-   */ _proto.onLateUpdate = function onLateUpdate(deltaTime) {};
-    /**
-   * Called before camera rendering, called per camera.
-   * @param camera - Current camera.
-   */ _proto.onBeginRender = function onBeginRender(camera) {};
-    /**
-   * Called after camera rendering, called per camera.
-   * @param camera - Current camera.
-   */ _proto.onEndRender = function onEndRender(camera) {};
-    /**
-   * Called before physics calculations, the number of times is related to the physical update frequency.
-   */ _proto.onPhysicsUpdate = function onPhysicsUpdate() {};
-    /**
-   * Called when the trigger enter.
-   * @param other - ColliderShape
-   */ _proto.onTriggerEnter = function onTriggerEnter(other) {};
-    /**
-   * Called when the trigger exit.
-   * @param other - ColliderShape
-   */ _proto.onTriggerExit = function onTriggerExit(other) {};
-    /**
-   * Called when the trigger stay.
-   * @remarks onTriggerStay is called every frame while the trigger stay.
-   * @param other - ColliderShape
-   */ _proto.onTriggerStay = function onTriggerStay(other) {};
-    /**
-   * Called when the collision enter.
-   * @param other - The Collision data associated with this collision event
-   * @remarks The Collision data will be invalid after this call, you should copy the data if needed.
-   */ _proto.onCollisionEnter = function onCollisionEnter(other) {};
-    /**
-   * Called when the collision exit.
-   * @param other - The Collision data associated with this collision event
-   * @remarks The Collision data will be invalid after this call, you should copy the data if needed.
-   */ _proto.onCollisionExit = function onCollisionExit(other) {};
-    /**
-   * Called when the collision stay.
-   * @param other - The Collision data associated with this collision event
-   * @remarks The Collision data will be invalid after this call, you should copy the data if needed.
-   */ _proto.onCollisionStay = function onCollisionStay(other) {};
-    /**
-   * Called when the pointer is down while over the ColliderShape.
-   * @param eventData - The pointer event data that triggered this callback
-   */ _proto.onPointerDown = function onPointerDown(eventData) {};
-    /**
-   * Called when the pointer is up while over the ColliderShape.
-   * @param eventData - The pointer event data that triggered this callback
-   */ _proto.onPointerUp = function onPointerUp(eventData) {};
-    /**
-   * Called when the pointer is down and up with the same collider.
-   * @param eventData - The pointer event data that triggered this callback
-   */ _proto.onPointerClick = function onPointerClick(eventData) {};
-    /**
-   *  Called when the pointer enters the ColliderShape.
-   * @param eventData - The pointer event data that triggered this callback
-   */ _proto.onPointerEnter = function onPointerEnter(eventData) {};
-    /**
-   * Called when the pointer exits the ColliderShape.
-   * @param eventData - The pointer event data that triggered this callback
-   */ _proto.onPointerExit = function onPointerExit(eventData) {};
-    /**
-   * This function will be called when the pointer is pressed on the collider.
-   * @param eventData - The pointer event data that triggered this callback
-   */ _proto.onPointerBeginDrag = function onPointerBeginDrag(eventData) {};
-    /**
-   *  When a drag collision occurs on the pointer, this function will be called every time it moves.
-   * @param eventData - The pointer event data that triggered this callback
-   */ _proto.onPointerDrag = function onPointerDrag(eventData) {};
-    /**
-   *  When dragging ends, this function will be called (Dragged object).
-   * @param eventData - The pointer event data that triggered this callback
-   */ _proto.onPointerEndDrag = function onPointerEndDrag(eventData) {};
-    /**
-   *  When dragging ends, this function will be called (Receiving object).
-   * @param eventData - The pointer event data that triggered this callback
-   */ _proto.onPointerDrop = function onPointerDrop(eventData) {};
-    /**
-   * Called when be disabled.
-   */ _proto.onDisable = function onDisable() {};
-    /**
-   * Called at the end of the destroyed frame.
-   */ _proto.onDestroy = function onDestroy() {};
-    /**
-   * @internal
-   */ _proto._onAwake = function _onAwake() {
-        this.onAwake();
-    };
-    /**
-   * @internal
-   */ _proto._onEnable = function _onEnable() {
-        this.onEnable();
-    };
-    /**
-   * @internal
-   */ _proto._onDisable = function _onDisable() {
-        this.onDisable();
-    };
-    /**
-   * @internal
-   */ _proto._onEnableInScene = function _onEnableInScene() {
-        var _this_scene = this.scene, componentsManager = _this_scene._componentsManager;
-        var prototype = Script.prototype;
-        if (!this._started) {
-            componentsManager.addOnStartScript(this);
-        }
-        if (this.onUpdate !== prototype.onUpdate) {
-            componentsManager.addOnUpdateScript(this);
-        }
-        if (this.onLateUpdate !== prototype.onLateUpdate) {
-            componentsManager.addOnLateUpdateScript(this);
-        }
-        if (this.onPhysicsUpdate !== prototype.onPhysicsUpdate) {
-            componentsManager.addOnPhysicsUpdateScript(this);
-        }
-        for(var _iterator = _create_for_of_iterator_helper_loose(Object.values(PointerMethods)), _step; !(_step = _iterator()).done;){
-            var pointerMethod = _step.value;
-            if (this[pointerMethod] === prototype[pointerMethod]) {
-                this[pointerMethod] = null;
-            }
-        }
-        this._entity._addScript(this);
-    };
-    /**
-   * @internal
-   */ _proto._onDisableInScene = function _onDisableInScene() {
-        var componentsManager = this.scene._componentsManager;
-        var prototype = Script.prototype;
-        if (!this._started) {
-            componentsManager.removeOnStartScript(this);
-        }
-        if (this.onUpdate !== prototype.onUpdate) {
-            componentsManager.removeOnUpdateScript(this);
-        }
-        if (this.onLateUpdate !== prototype.onLateUpdate) {
-            componentsManager.removeOnLateUpdateScript(this);
-        }
-        if (this.onPhysicsUpdate !== prototype.onPhysicsUpdate) {
-            componentsManager.removeOnPhysicsUpdateScript(this);
-        }
-        this._entity._removeScript(this);
-    };
-    /**
-   * @internal
-   */ _proto._onDestroy = function _onDestroy() {
-        Component.prototype._onDestroy.call(this);
-        this.onDestroy();
-    };
-    return Script;
-}(Component);
-__decorate([
-    ignoreClone
-], Script.prototype, "_started", void 0);
-__decorate([
-    ignoreClone
-], Script.prototype, "_onStartIndex", void 0);
-__decorate([
-    ignoreClone
-], Script.prototype, "_onUpdateIndex", void 0);
-__decorate([
-    ignoreClone
-], Script.prototype, "_onLateUpdateIndex", void 0);
-__decorate([
-    ignoreClone
-], Script.prototype, "_onPhysicsUpdateIndex", void 0);
-__decorate([
-    ignoreClone
-], Script.prototype, "_onPreRenderIndex", void 0);
-__decorate([
-    ignoreClone
-], Script.prototype, "_onPostRenderIndex", void 0);
-__decorate([
-    ignoreClone
-], Script.prototype, "_entityScriptsIndex", void 0);
-var PointerMethods = /*#__PURE__*/ function(PointerMethods) {
-    PointerMethods["onPointerDown"] = "onPointerDown";
-    PointerMethods["onPointerUp"] = "onPointerUp";
-    PointerMethods["onPointerClick"] = "onPointerClick";
-    PointerMethods["onPointerEnter"] = "onPointerEnter";
-    PointerMethods["onPointerExit"] = "onPointerExit";
-    PointerMethods["onPointerBeginDrag"] = "onPointerBeginDrag";
-    PointerMethods["onPointerDrag"] = "onPointerDrag";
-    PointerMethods["onPointerEndDrag"] = "onPointerEndDrag";
-    PointerMethods["onPointerDrop"] = "onPointerDrop";
-    return PointerMethods;
-}({});
-
 /**
  * Signal is a typed event mechanism for Galacean Engine.
  * @typeParam T - Tuple type of the signal arguments