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

package/dist/browser.js

@@ -5872,10 +5872,10 @@
        */ _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);
@@ -7100,10 +7100,11 @@
         return FontStyle;
     }({});
     /**
-     * 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;
     }({});
     /**
@@ -7167,7 +7168,8 @@
         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);
@@ -7196,7 +7198,7 @@
                 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) {
@@ -7325,7 +7327,8 @@
                 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);
@@ -7344,7 +7347,7 @@
                 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;
@@ -7372,6 +7375,64 @@
             };
         };
         /**
+       * 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 measureAt(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 isFit(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
@@ -7488,12 +7549,17 @@
         };
         /**
        * @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;
         };
@@ -16372,6 +16438,14 @@
             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;
@@ -16427,12 +16501,26 @@
             }
         };
         _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;
@@ -16440,9 +16528,7 @@
             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;
@@ -16452,7 +16538,10 @@
                         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;
@@ -16504,7 +16593,7 @@
                                 j === firstRow && (minX = Math.min(minX, left));
                                 maxX = Math.max(maxX, right);
                             }
-                            startX += charInfo.xAdvance + characterSpacing;
+                            startX += charInfo.xAdvance + characterSpacing1;
                         }
                     }
                     startY -= lineHeight;
@@ -16560,7 +16649,7 @@
             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;
@@ -27040,6 +27129,249 @@
         /** The normal of the surface the ray hit. */ this.normal = new Vector3();
         /** The shape of the collider that was hit. */ this.shape = null;
     };
+    function _array_like_to_array$2(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$2(o, minLen) {
+        if (!o) return;
+        if (typeof o === "string") return _array_like_to_array$2(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$2(o, minLen);
+    }
+    function _create_for_of_iterator_helper_loose$2(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$2(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$2(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$2(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$1([
+        ignoreClone
+    ], Script.prototype, "_started", void 0);
+    __decorate$1([
+        ignoreClone
+    ], Script.prototype, "_onStartIndex", void 0);
+    __decorate$1([
+        ignoreClone
+    ], Script.prototype, "_onUpdateIndex", void 0);
+    __decorate$1([
+        ignoreClone
+    ], Script.prototype, "_onLateUpdateIndex", void 0);
+    __decorate$1([
+        ignoreClone
+    ], Script.prototype, "_onPhysicsUpdateIndex", void 0);
+    __decorate$1([
+        ignoreClone
+    ], Script.prototype, "_onPreRenderIndex", void 0);
+    __decorate$1([
+        ignoreClone
+    ], Script.prototype, "_onPostRenderIndex", void 0);
+    __decorate$1([
+        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() {
@@ -27311,6 +27643,7 @@
             for(var i = 0; i < step; i++){
                 componentsManager.callScriptOnPhysicsUpdate();
                 this._callColliderOnUpdate();
+                nativePhysicsManager.setContactEventEnabled(this._hasCollisionEventConsumers());
                 nativePhysicsManager.update(fixedTimeStep);
                 this._callColliderOnLateUpdate();
                 this._dispatchEvents(nativePhysicsManager.updateEvents());
@@ -27473,6 +27806,21 @@
             // 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);
         };
@@ -35716,249 +36064,6 @@
     Scene._fogColorProperty = ShaderProperty.getByName("scene_FogColor");
     Scene._fogParamsProperty = ShaderProperty.getByName("scene_FogParams");
     Scene._prefilterdDFGProperty = ShaderProperty.getByName("scene_PrefilteredDFG");
-    function _array_like_to_array$2(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$2(o, minLen) {
-        if (!o) return;
-        if (typeof o === "string") return _array_like_to_array$2(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$2(o, minLen);
-    }
-    function _create_for_of_iterator_helper_loose$2(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$2(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$2(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$2(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$1([
-        ignoreClone
-    ], Script.prototype, "_started", void 0);
-    __decorate$1([
-        ignoreClone
-    ], Script.prototype, "_onStartIndex", void 0);
-    __decorate$1([
-        ignoreClone
-    ], Script.prototype, "_onUpdateIndex", void 0);
-    __decorate$1([
-        ignoreClone
-    ], Script.prototype, "_onLateUpdateIndex", void 0);
-    __decorate$1([
-        ignoreClone
-    ], Script.prototype, "_onPhysicsUpdateIndex", void 0);
-    __decorate$1([
-        ignoreClone
-    ], Script.prototype, "_onPreRenderIndex", void 0);
-    __decorate$1([
-        ignoreClone
-    ], Script.prototype, "_onPostRenderIndex", void 0);
-    __decorate$1([
-        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
@@ -56637,7 +56742,7 @@
     ], EXT_texture_webp);
 
     //@ts-ignore
-    var version = "0.0.0-experimental-2.0-game.16";
+    var version = "0.0.0-experimental-2.0-game.18";
     console.log("Galacean Engine Version: " + version);
     for(var key in CoreObjects){
         Loader.registerClass(key, CoreObjects[key]);