@galacean/effects-plugin-model 2.0.0-alpha.16 → 2.0.0-alpha.18

package/dist/index.mjs

@@ -3,10 +3,11 @@
  * Description: Galacean Effects player model plugin
  * Author: Ant Group CO., Ltd.
  * Contributors: 飂兮
- * Version: v2.0.0-alpha.16
+ * Version: v2.0.0-alpha.18
  */
 
-import { math, Transform, PLAYER_OPTIONS_ENV_EDITOR, spec, glContext, Texture, TextureSourceType, RenderPassAttachmentStorageType, Material, Mesh, Geometry, GLSLVersion, addItem, removeItem, effectsClass, RendererComponent, ItemBehaviour, HitTestType, AnimationClip, RenderPass, TextureLoadAction, DestroyOptions, RenderPassDestroyAttachmentType, Player, Renderer, getDefaultTextureFactory, loadImage, generateGUID, VFXItem, AbstractPlugin, glType2VertexFormatType, Downloader, getStandardJSON, registerPlugin, logger, version as version$1 } from '@galacean/effects';
+import * as EFFECTS from '@galacean/effects';
+import { math, Transform, PLAYER_OPTIONS_ENV_EDITOR, spec, glContext, Texture, TextureSourceType, RenderPassAttachmentStorageType, Material, Mesh, Geometry, GLSLVersion, addItem, removeItem, effectsClass, RendererComponent, ItemBehaviour, HitTestType, AnimationClip, RenderPass, TextureLoadAction, DestroyOptions, RenderPassDestroyAttachmentType, Player, Renderer, getDefaultTextureFactory, loadImage, generateGUID, VFXItem, AbstractPlugin, glType2VertexFormatType, Downloader, getStandardJSON, isObject, registerPlugin, logger } from '@galacean/effects';
 
 /**
  * Model 插件元素类型
@@ -1155,7 +1156,7 @@ var TextureDataMode;
         var matList = props.inverseBindMatrices;
         if (matList !== undefined && matList.length > 0) {
             if (matList.length % 16 !== 0 || matList.length !== this.jointItem.length * 16) {
-                throw new Error("Invalid array length, invert bind matrices " + matList.length + ", joint array " + this.jointItem.length);
+                throw new Error("Invalid array length, invert bind matrices " + matList.length + ", joint array " + this.jointItem.length + ".");
             }
             var matrixCount = matList.length / 16;
             for(var i = 0; i < matrixCount; i++){
@@ -1186,7 +1187,7 @@ var TextureDataMode;
             });
         } else {
             this.animationMatrices = this.inverseBindMatrices;
-            console.error("Some error occured, replace skin animation matrices by invert bind matrices");
+            console.error("Some error occured, replace skin animation matrices by invert bind matrices.");
         }
     };
     /**
@@ -1247,7 +1248,7 @@ var TextureDataMode;
             } else if (detail.halfFloatTexture) {
                 return 2;
             } else {
-                throw new Error("Too many joint count " + jointCount + ", half float texture not support");
+                throw new Error("Too many joint count " + jointCount + ", half float texture not support.");
             }
         } else {
             return 0;
@@ -1260,7 +1261,7 @@ var TextureDataMode;
         (_props_boneNames = props.boneNames) == null ? void 0 : _props_boneNames.forEach(function(boneName) {
             var node = name2Item[boneName];
             if (!node) {
-                throw new Error("Can't find node of bone name " + boneName);
+                throw new Error("Can't find node of bone name " + boneName + ".");
             }
             jointItems.push(node);
         });
@@ -1357,19 +1358,19 @@ var TextureDataMode;
      * 还要注意最大数目不能超过5，否则也直接报错。
      * 后续考虑是否做个兼容，目前还是严格报错比较好。
      */ if (positionCount > 0 && positionCount != this.morphWeightsLength) {
-            console.error("Position morph count mismatch: " + this.morphWeightsLength + ", " + positionCount);
+            console.error("Position morph count mismatch: " + this.morphWeightsLength + ", " + positionCount + ".");
             return false;
         }
         if (normalCount > 0 && normalCount != this.morphWeightsLength) {
-            console.error("Normal morph count mismatch: " + this.morphWeightsLength + ", " + normalCount);
+            console.error("Normal morph count mismatch: " + this.morphWeightsLength + ", " + normalCount + ".");
             return false;
         }
         if (tangentCount > 0 && tangentCount != this.morphWeightsLength) {
-            console.error("Tangent morph count mismatch: " + this.morphWeightsLength + ", " + tangentCount);
+            console.error("Tangent morph count mismatch: " + this.morphWeightsLength + ", " + tangentCount + ".");
             return false;
         }
         if (this.morphWeightsLength > 5) {
-            console.error("Tangent morph count should not greater than 5, current " + this.morphWeightsLength);
+            console.error("Tangent morph count should not greater than 5, current " + this.morphWeightsLength + ".");
             return false;
         }
         return true;
@@ -1391,7 +1392,7 @@ var TextureDataMode;
     _proto.updateWeights = function updateWeights(weights) {
         var _this = this;
         if (weights.length != this.morphWeightsArray.length) {
-            console.error("Length of morph weights mismatch: input " + weights.length + ", internel " + this.morphWeightsArray.length);
+            console.error("Length of morph weights mismatch: input " + weights.length + ", internel " + this.morphWeightsArray.length + ".");
             return;
         }
         weights.forEach(function(value, index) {
@@ -1512,16 +1513,16 @@ var PAnimPathType;
             this.component = this.dataArray.length / this.timeArray.length;
             // special checker for weights animation
             if (this.component <= 0) {
-                console.error("Invalid weights component: " + this.timeArray.length + ", " + this.component + ", " + this.dataArray.length);
+                console.error("Invalid weights component: " + this.timeArray.length + ", " + this.component + ", " + this.dataArray.length + ".");
             } else if (this.timeArray.length * this.component != this.dataArray.length) {
-                console.error("Invalid weights array length: " + this.timeArray.length + ", " + this.component + ", " + this.dataArray.length);
+                console.error("Invalid weights array length: " + this.timeArray.length + ", " + this.component + ", " + this.dataArray.length + ".");
             }
         } else {
             // should never happened
-            console.error("Invalid path status: " + path);
+            console.error("Invalid path status: " + path + ".");
         }
         if (this.timeArray.length * this.component > this.dataArray.length) {
-            throw new Error("Data length mismatch: " + this.timeArray.length + ", " + this.component + ", " + this.dataArray.length);
+            throw new Error("Data length mismatch: " + this.timeArray.length + ", " + this.component + ", " + this.dataArray.length + ".");
         }
         if (interpolation === "LINEAR") {
             this.interp = 0;
@@ -2541,7 +2542,7 @@ function _assert_this_initialized(self) {
             _this.subMeshes.push(subMesh);
         });
         if (_this.subMeshes.length <= 0) {
-            console.warn("No primitive inside mesh item " + name);
+            console.warn("No primitive inside mesh item " + name + ".");
         }
         _this.boundingBox = _this.getItemBoundingBox(meshData.interaction);
         return _this;
@@ -2629,7 +2630,7 @@ function _assert_this_initialized(self) {
             return;
         }
         if (updatedArray.length != weightsArray.length) {
-            throw new Error("weight array length mismatch");
+            throw new Error("Weight array length mismatch.");
         }
         for(var i = 0; i < updatedArray.length; i++){
             updatedArray[i] = weightsArray[i];
@@ -3623,7 +3624,7 @@ var EffectsMeshProxy = /*#__PURE__*/ function() {
         this.brdfLUT = this.sceneCache.getBrdfLutTexture();
         this.initGlobalState(opts);
         if (this.maxLightCount > 8) {
-            console.warn("Too many light items: " + this.maxLightCount + " light(s)");
+            console.warn("Too many light items: " + this.maxLightCount + " light(s).");
         }
     };
     _proto.initGlobalState = function initGlobalState(opts) {
@@ -3973,9 +3974,8 @@ var StandardShaderSource;
         }
         if (isWebGL2) {
             return "#version 300 es\n" + source;
-        } else {
-            return "#version 100\n" + source;
         }
+        return "#version 100\n" + source;
     }
     StandardShaderSource.getSourceCode = getSourceCode;
 })(StandardShaderSource || (StandardShaderSource = {}));
@@ -4253,7 +4253,7 @@ function getQuadFilterVS() {
         if (func !== undefined) {
             return func(context);
         } else {
-            throw new Error("Invalid material type " + materialType + ", shader content " + context);
+            throw new Error("Invalid material type " + materialType + ", shader content " + context + ".");
         }
     };
     /**
@@ -4850,10 +4850,10 @@ var ModelAnimationClip = /*#__PURE__*/ function(AnimationClip) {
                     var properties = curve3.property.split(".");
                     setProperty(component, properties, value3);
                 } else {
-                    console.error("Can't find mesh component");
+                    console.error("Can't find mesh component.");
                 }
             } else {
-                console.warn("Ignore curve: className " + curve3.className);
+                console.warn("Ignore curve: className " + curve3.className + ".");
             }
         }
     };
@@ -4881,7 +4881,7 @@ var ModelAnimationClip = /*#__PURE__*/ function(AnimationClip) {
                 }
             }
             if (!findTag) {
-                throw new Error("Can't find path in tree " + rootItem.id + ", " + path);
+                throw new Error("Can't find path in tree " + rootItem.id + ", " + path + ".");
             }
         }
         this.path2Node[path] = target;
@@ -4895,7 +4895,7 @@ function setProperty(obj, properties, value) {
     for(var i = 0; i < len - 1; i++){
         var propName = properties[i];
         if (!(propName in current) || typeof current[propName] !== "object") {
-            console.error("Invalid properties " + properties);
+            console.error("Invalid properties " + properties + ".");
             return;
         }
         current = current[propName];
@@ -5138,7 +5138,7 @@ var normal = new Vector3();
             var blob, urlCreator, imageUrl, imageObj;
             return __generator(this, function(_state) {
                 if (image.imageData === undefined) {
-                    console.error("createTexture2D: Invalid image data from " + image);
+                    console.error("createTexture2D: Invalid image data from " + image + ".");
                     // 这里不应该发生的，做个兜底
                     return [
                         2,
@@ -6157,7 +6157,7 @@ var normal = new Vector3();
                         if (_instanceof1(inverseBindMatrices, Float32Array)) {
                             studioSkin.inverseBindMatrices = inverseBindMatrices;
                         } else {
-                            console.error("setupItem3DOptions: Invalid inverseBindMatrices type, " + inverseBindMatrices);
+                            console.error("setupItem3DOptions: Invalid inverseBindMatrices type, " + inverseBindMatrices + ".");
                         }
                     }
                 } else if (item.type === spec.ItemType.tree) {
@@ -6175,12 +6175,12 @@ var normal = new Vector3();
                                 if (_instanceof1(inputArray, Float32Array)) {
                                     studioTrack.input = inputArray;
                                 } else {
-                                    console.error("setupItem3DOptions: Type of inputArray should be float32, " + inputArray);
+                                    console.error("setupItem3DOptions: Type of inputArray should be float32, " + inputArray + ".");
                                 }
                                 if (_instanceof1(outputArray, Float32Array)) {
                                     studioTrack.output = outputArray;
                                 } else {
-                                    console.error("setupItem3DOptions: Type of outputArray should be float32, " + outputArray);
+                                    console.error("setupItem3DOptions: Type of outputArray should be float32, " + outputArray + ".");
                                 }
                             });
                         });
@@ -6192,7 +6192,7 @@ var normal = new Vector3();
                     var studioOptions = studioSkybox.content.options;
                     var specularImage = _this.getTextureObj(composition.textures, options.specularImage);
                     if (specularImage === undefined) {
-                        console.error("setupItem3DOptions: skybox specualrImage is undefined, " + CheckerHelper.stringify(options));
+                        console.error("setupItem3DOptions: skybox specualrImage is undefined, " + CheckerHelper.stringify(options) + ".");
                     }
                     studioOptions.specularImage = specularImage;
                     //
@@ -6236,7 +6236,7 @@ var normal = new Vector3();
             case WebGLRenderingContext["UNSIGNED_BYTE"]:
                 return array;
             default:
-                console.error("Invalid index attribute type " + type);
+                console.error("Invalid index attribute type " + type + ".");
         }
     };
     /**
@@ -6264,7 +6264,7 @@ var normal = new Vector3();
             // aPos, aNormal, aTangent,
             // aUV, aUV2, aJoints, aWeights
             // aTargetXXX
-            console.warn("Unknown attribute name: " + name);
+            console.warn("Unknown attribute name: " + name + ".");
         }
         return name;
     };
@@ -6278,7 +6278,7 @@ var normal = new Vector3();
             return null;
         }
         if (index < 0 || index >= textures.length) {
-            console.error("Invalid index for textures: " + index + ", " + textures.length);
+            console.error("Invalid index for textures: " + index + ", " + textures.length + ".");
         }
         return textures[index];
     };
@@ -6404,7 +6404,7 @@ var normal = new Vector3();
                             if (b) {
                                 resolve(b.arrayBuffer());
                             } else {
-                                reject(new Error("no canvas blob"));
+                                reject(new Error("No canvas blob."));
                             }
                         }, "image/png", 1);
                     })
@@ -6566,7 +6566,7 @@ var AttributeArray = /*#__PURE__*/ function() {
         this.offset = (_inAttrib_offset = inAttrib.offset) != null ? _inAttrib_offset : 0;
         if (this.offset > 0) {
             if (this.offset % this.typeSize !== 0) {
-                console.error("Invalid offset " + this.offset + ", type size " + this.typeSize);
+                console.error("Invalid offset " + this.offset + ", type size " + this.typeSize + ".");
             }
             this.offset = this.offset / this.typeSize;
         }
@@ -6575,7 +6575,7 @@ var AttributeArray = /*#__PURE__*/ function() {
         this.stride = (_inAttrib_stride = inAttrib.stride) != null ? _inAttrib_stride : 0;
         if (this.stride > 0) {
             if (this.stride % this.typeSize !== 0) {
-                console.error("Invalid stride " + this.stride + ", type size " + this.typeSize);
+                console.error("Invalid stride " + this.stride + ", type size " + this.typeSize + ".");
             }
             this.stride = this.stride / this.typeSize;
         } else {
@@ -7088,7 +7088,7 @@ var AttributeArray = /*#__PURE__*/ function() {
    */ CheckerHelper.checkTexture = function checkTexture(v) {
         if (_instanceof1(v, Texture)) {
             if (v.isDestroyed) {
-                console.error("Texture is destroyed, " + v.name);
+                console.error("Texture is destroyed, " + v.name + ".");
             }
             return !v.isDestroyed;
         } else {
@@ -7165,14 +7165,14 @@ var AttributeArray = /*#__PURE__*/ function() {
    * @param s - 蒙皮参数
    */ CheckerHelper.assertGeometry = function assertGeometry(v, s) {
         if (!_instanceof1(v, Geometry)) {
-            console.error("Invalid geometry type " + this.stringify(v));
+            console.error("Invalid geometry type " + this.stringify(v) + ".");
         }
         // @ts-expect-error
         if (v.isDestroyed === true) {
-            console.error("Geometry object is destroyed");
+            console.error("Geometry object is destroyed.");
         }
         if (!this.checkNonnegative(v.getDrawStart())) {
-            console.error("Invalid geometry draw start: " + v.getDrawStart() + ", " + this.stringify(v));
+            console.error("Invalid geometry draw start: " + v.getDrawStart() + ", " + this.stringify(v) + ".");
         }
     // // drawCount不再为负
     // if (!this.checkPositive(v.getDrawCount())) {
@@ -7231,7 +7231,7 @@ var AttributeArray = /*#__PURE__*/ function() {
         var attribArray = this.createAttributeArray(v, name);
         if (attribArray !== undefined) {
             if (attribArray.getLength() < drawCount) {
-                console.error(name + " Length(" + attribArray.getLength() + ") is less than draw count(" + drawCount + "), " + this.stringify(v));
+                console.error(name + " Length(" + attribArray.getLength() + ") is less than draw count(" + drawCount + "), " + this.stringify(v) + ".");
             }
         }
     };
@@ -7264,24 +7264,24 @@ var AttributeArray = /*#__PURE__*/ function() {
    * @param v - 蒙皮参数
    */ CheckerHelper.assertModelSkinOptions = function assertModelSkinOptions(v) {
         if (!this.checkStringUndef(v.name)) {
-            console.error("Invalid skin name " + v.name + ", " + this.stringify(v));
+            console.error("Invalid skin name " + v.name + ", " + this.stringify(v) + ".");
         }
         if (!this.checkNumberArray(v.joints)) {
-            console.error("Invalid skin joints " + v.joints + ", " + this.stringify(v));
+            console.error("Invalid skin joints " + v.joints + ", " + this.stringify(v) + ".");
         }
         if (!this.checkNumberUndef(v.skeleton)) {
-            console.error("Invalid skin skeleton " + v.skeleton + ", " + this.stringify(v));
+            console.error("Invalid skin skeleton " + v.skeleton + ", " + this.stringify(v) + ".");
         }
         if (!this.checkFloat32ArrayUndef(v.inverseBindMatrices)) {
-            console.error("Invalid skin inverseBindMatrices " + v.inverseBindMatrices + ", " + this.stringify(v));
+            console.error("Invalid skin inverseBindMatrices " + v.inverseBindMatrices + ", " + this.stringify(v) + ".");
         }
         //
         if (v.inverseBindMatrices !== undefined) {
             if (v.inverseBindMatrices.length <= 0 || v.inverseBindMatrices.length % 16 !== 0) {
-                console.error("Invalid skin inverseBindMatrices length " + v.inverseBindMatrices + ", " + this.stringify(v));
+                console.error("Invalid skin inverseBindMatrices length " + v.inverseBindMatrices + ", " + this.stringify(v) + ".");
             }
             if (v.joints.length * 16 !== v.inverseBindMatrices.length) {
-                console.error("Mismatch: skin joints and inverseBindMatrices length, " + v.joints + ", " + v.inverseBindMatrices + ", " + this.stringify(v));
+                console.error("Mismatch: skin joints and inverseBindMatrices length, " + v.joints + ", " + v.inverseBindMatrices + ", " + this.stringify(v) + ".");
             }
             var mat = new Matrix4();
             for(var i = 0; i < v.inverseBindMatrices.length; i += 16){
@@ -7289,12 +7289,12 @@ var AttributeArray = /*#__PURE__*/ function() {
                     mat.elements[j] = v.inverseBindMatrices[i + j];
                 }
                 if (Math.abs(mat.determinant()) < 1e-5) {
-                    console.error("Determinant of inverseBindMatrices is too small " + mat.determinant() + ", index " + i / 16 + ", " + this.stringify(v));
+                    console.error("Determinant of inverseBindMatrices is too small " + mat.determinant() + ", index " + i / 16 + ", " + this.stringify(v) + ".");
                 }
             }
         } else {
             if (v.joints.length <= 0) {
-                console.error("Invalid skin joints length " + v.joints + ", " + this.stringify(v));
+                console.error("Invalid skin joints length " + v.joints + ", " + this.stringify(v) + ".");
             }
         }
     };
@@ -7304,138 +7304,138 @@ var AttributeArray = /*#__PURE__*/ function() {
    */ CheckerHelper.assertMatOptions = function assertMatOptions(v) {
         if (v.type === spec.MaterialType.unlit) {
             if (!this.checkString(v.name)) {
-                console.error("Invalid material name " + v.name + ", " + this.stringify(v));
+                console.error("Invalid material name " + v.name + ", " + this.stringify(v) + ".");
             }
             //
             if (!this.checkNonnegative4(v.baseColorFactor)) {
-                console.error("Invalid material baseColorFactor " + v.baseColorFactor + ", " + this.stringify(v));
+                console.error("Invalid material baseColorFactor " + v.baseColorFactor + ", " + this.stringify(v) + ".");
             }
             if (!this.checkTextureUndef(v.baseColorTexture)) {
-                console.error("Invalid material baseColorTexture " + v.baseColorTexture + ", " + this.stringify(v));
+                console.error("Invalid material baseColorTexture " + v.baseColorTexture + ", " + this.stringify(v) + ".");
             }
             if (!this.checkTexTransformUndef(v.baseColorTextureTransform)) {
-                console.error("Invalid material baseColorTextureTransform " + v.baseColorTextureTransform + ", " + this.stringify(v));
+                console.error("Invalid material baseColorTextureTransform " + v.baseColorTextureTransform + ", " + this.stringify(v) + ".");
             }
             if (!this.checkTexCoord(v.baseColorTextureCoordinate)) {
-                console.error("Invalid material baseColorTextureCoordinate " + v.baseColorTextureCoordinate + ", " + this.stringify(v));
+                console.error("Invalid material baseColorTextureCoordinate " + v.baseColorTextureCoordinate + ", " + this.stringify(v) + ".");
             }
             //
             if (!this.checkBooleanUndef(v.depthMask)) {
-                console.error("Invalid material depthMask " + v.depthMask + ", " + this.stringify(v));
+                console.error("Invalid material depthMask " + v.depthMask + ", " + this.stringify(v) + ".");
             }
             if (!this.checkMatBlending(v.blending)) {
-                console.error("Invalid material blending " + v.blending + ", " + this.stringify(v));
+                console.error("Invalid material blending " + v.blending + ", " + this.stringify(v) + ".");
             }
             if (!this.checkMatSide(v.side)) {
-                console.error("Invalid material side " + v.side + ", " + this.stringify(v));
+                console.error("Invalid material side " + v.side + ", " + this.stringify(v) + ".");
             }
             if (v.blending === spec.MaterialBlending.masked) {
                 if (v.alphaCutOff === undefined) {
-                    console.error("Material alphaCutOff is required for mask, " + this.stringify(v));
+                    console.error("Material alphaCutOff is required for mask, " + this.stringify(v) + ".");
                 }
             }
             if (!this.checkNumber01Undef(v.alphaCutOff)) {
-                console.error("Invalid material alphaCutOff " + v.alphaCutOff + ", " + this.stringify(v));
+                console.error("Invalid material alphaCutOff " + v.alphaCutOff + ", " + this.stringify(v) + ".");
             }
         } else if (v.type === spec.MaterialType.pbr) {
             if (!this.checkString(v.name)) {
-                console.error("Invalid material name " + v.name + ", " + this.stringify(v));
+                console.error("Invalid material name " + v.name + ", " + this.stringify(v) + ".");
             }
             //
             if (!this.checkNonnegative4(v.baseColorFactor)) {
-                console.error("Invalid material baseColorFactor " + v.baseColorFactor + ", " + this.stringify(v));
+                console.error("Invalid material baseColorFactor " + v.baseColorFactor + ", " + this.stringify(v) + ".");
             }
             if (!this.checkTextureUndef(v.baseColorTexture)) {
-                console.error("Invalid material baseColorTexture " + v.baseColorTexture + ", " + this.stringify(v));
+                console.error("Invalid material baseColorTexture " + v.baseColorTexture + ", " + this.stringify(v) + ".");
             }
             if (!this.checkTexTransformUndef(v.baseColorTextureTransform)) {
-                console.error("Invalid material baseColorTextureTransform " + v.baseColorTextureTransform + ", " + this.stringify(v));
+                console.error("Invalid material baseColorTextureTransform " + v.baseColorTextureTransform + ", " + this.stringify(v) + ".");
             }
             if (!this.checkTexCoord(v.baseColorTextureCoordinate)) {
-                console.error("Invalid material baseColorTextureCoordinate " + v.baseColorTextureCoordinate + ", " + this.stringify(v));
+                console.error("Invalid material baseColorTextureCoordinate " + v.baseColorTextureCoordinate + ", " + this.stringify(v) + ".");
             }
             //
             if (!this.checkBooleanUndef(v.useSpecularAA)) {
-                console.error("Invalid material useSpecularAA " + v.useSpecularAA + ", " + this.stringify(v));
+                console.error("Invalid material useSpecularAA " + v.useSpecularAA + ", " + this.stringify(v) + ".");
             }
             if (!this.checkNumber01(v.metallicFactor)) {
-                console.error("Invalid material metallicFactor " + v.metallicFactor + ", " + this.stringify(v));
+                console.error("Invalid material metallicFactor " + v.metallicFactor + ", " + this.stringify(v) + ".");
             }
             if (!this.checkNonnegative(v.roughnessFactor)) {
-                console.error("Invalid material roughnessFactor " + v.roughnessFactor + ", " + this.stringify(v));
+                console.error("Invalid material roughnessFactor " + v.roughnessFactor + ", " + this.stringify(v) + ".");
             }
             if (!this.checkTextureUndef(v.metallicRoughnessTexture)) {
-                console.error("Invalid material metallicRoughnessTexture " + v.metallicRoughnessTexture + ", " + this.stringify(v));
+                console.error("Invalid material metallicRoughnessTexture " + v.metallicRoughnessTexture + ", " + this.stringify(v) + ".");
             }
             if (!this.checkTexTransformUndef(v.metallicRoughnessTextureTransform)) {
-                console.error("Invalid material metallicRoughnessTextureTransform " + v.metallicRoughnessTextureTransform + ", " + this.stringify(v));
+                console.error("Invalid material metallicRoughnessTextureTransform " + v.metallicRoughnessTextureTransform + ", " + this.stringify(v) + ".");
             }
             if (!this.checkTexCoord(v.metallicRoughnessTextureCoordinate)) {
-                console.error("Invalid material metallicRoughnessTextureCoordinate " + v.metallicRoughnessTextureCoordinate + ", " + this.stringify(v));
+                console.error("Invalid material metallicRoughnessTextureCoordinate " + v.metallicRoughnessTextureCoordinate + ", " + this.stringify(v) + ".");
             }
             //
             if (!this.checkTextureUndef(v.normalTexture)) {
-                console.error("Invalid material normalTexture " + v.normalTexture + ", " + this.stringify(v));
+                console.error("Invalid material normalTexture " + v.normalTexture + ", " + this.stringify(v) + ".");
             }
             if (!this.checkNonnegativeUndef(v.normalTextureScale)) {
-                console.error("Invalid material normalTextureScale " + v.normalTextureScale + ", " + this.stringify(v));
+                console.error("Invalid material normalTextureScale " + v.normalTextureScale + ", " + this.stringify(v) + ".");
             }
             if (!this.checkTexTransformUndef(v.normalTextureTransform)) {
-                console.error("Invalid material normalTextureTransform " + v.normalTextureTransform + ", " + this.stringify(v));
+                console.error("Invalid material normalTextureTransform " + v.normalTextureTransform + ", " + this.stringify(v) + ".");
             }
             if (!this.checkTexCoord(v.normalTextureCoordinate)) {
-                console.error("Invalid material normalTextureCoordinate " + v.normalTextureCoordinate + ", " + this.stringify(v));
+                console.error("Invalid material normalTextureCoordinate " + v.normalTextureCoordinate + ", " + this.stringify(v) + ".");
             }
             //
             if (!this.checkTextureUndef(v.occlusionTexture)) {
-                console.error("Invalid material occlusionTexture " + v.occlusionTexture + ", " + this.stringify(v));
+                console.error("Invalid material occlusionTexture " + v.occlusionTexture + ", " + this.stringify(v) + ".");
             }
             if (!this.checkNumber01Undef(v.occlusionTextureStrength)) {
-                console.error("Invalid material occlusionTextureStrength " + v.occlusionTextureStrength + ", " + this.stringify(v));
+                console.error("Invalid material occlusionTextureStrength " + v.occlusionTextureStrength + ", " + this.stringify(v) + ".");
             }
             if (!this.checkTexTransformUndef(v.occlusionTextureTransform)) {
-                console.error("Invalid material occlusionTextureTransform " + v.occlusionTextureTransform + ", " + this.stringify(v));
+                console.error("Invalid material occlusionTextureTransform " + v.occlusionTextureTransform + ", " + this.stringify(v) + ".");
             }
             if (!this.checkTexCoord(v.occlusionTextureCoordinate)) {
-                console.error("Invalid material occlusionTextureCoordinate " + v.occlusionTextureCoordinate + ", " + this.stringify(v));
+                console.error("Invalid material occlusionTextureCoordinate " + v.occlusionTextureCoordinate + ", " + this.stringify(v) + ".");
             }
             //
             //
             if (!this.checkNonnegative4(v.emissiveFactor)) {
-                console.error("Invalid material emissiveFactor " + v.emissiveFactor + ", " + this.stringify(v));
+                console.error("Invalid material emissiveFactor " + v.emissiveFactor + ", " + this.stringify(v) + ".");
             }
             if (!this.checkNonnegative(v.emissiveIntensity)) {
-                console.error("Invalid material emissiveIntensity " + v.emissiveIntensity + ", " + this.stringify(v));
+                console.error("Invalid material emissiveIntensity " + v.emissiveIntensity + ", " + this.stringify(v) + ".");
             }
             if (!this.checkTextureUndef(v.emissiveTexture)) {
-                console.error("Invalid material emissiveTexture " + v.emissiveTexture + ", " + this.stringify(v));
+                console.error("Invalid material emissiveTexture " + v.emissiveTexture + ", " + this.stringify(v) + ".");
             }
             if (!this.checkTexTransformUndef(v.emissiveTextureTransform)) {
-                console.error("Invalid material emissiveTextureTransform " + v.emissiveTextureTransform + ", " + this.stringify(v));
+                console.error("Invalid material emissiveTextureTransform " + v.emissiveTextureTransform + ", " + this.stringify(v) + ".");
             }
             if (!this.checkTexCoord(v.emissiveTextureCoordinate)) {
-                console.error("Invalid material emissiveTextureCoordinate " + v.emissiveTextureCoordinate + ", " + this.stringify(v));
+                console.error("Invalid material emissiveTextureCoordinate " + v.emissiveTextureCoordinate + ", " + this.stringify(v) + ".");
             }
             //
             if (!this.checkBooleanUndef(v.depthMask)) {
-                console.error("Invalid material depthMask " + v.depthMask + ", " + this.stringify(v));
+                console.error("Invalid material depthMask " + v.depthMask + ", " + this.stringify(v) + ".");
             }
             if (!this.checkMatBlending(v.blending)) {
-                console.error("Invalid material blending " + v.blending + ", " + this.stringify(v));
+                console.error("Invalid material blending " + v.blending + ", " + this.stringify(v) + ".");
             }
             if (!this.checkMatSide(v.side)) {
-                console.error("Invalid material side " + v.side + ", " + this.stringify(v));
+                console.error("Invalid material side " + v.side + ", " + this.stringify(v) + ".");
             }
             if (v.blending === spec.MaterialBlending.masked) {
                 if (v.alphaCutOff === undefined) {
-                    console.error("Material alphaCutOff is required for mask, " + this.stringify(v));
+                    console.error("Material alphaCutOff is required for mask, " + this.stringify(v) + ".");
                 }
             }
             if (!this.checkNumber01Undef(v.alphaCutOff)) {
-                console.error("Invalid material alphaCutOff " + v.alphaCutOff + ", " + this.stringify(v));
+                console.error("Invalid material alphaCutOff " + v.alphaCutOff + ", " + this.stringify(v) + ".");
             }
         } else {
-            console.error("Invalid material type " + this.stringify(v));
+            console.error("Invalid material type " + this.stringify(v) + ".");
         }
     };
     /**
@@ -7453,7 +7453,7 @@ var AttributeArray = /*#__PURE__*/ function() {
    * @param v - Model 插件 Mesh 参数
    */ CheckerHelper.assertModelMeshOptions = function assertModelMeshOptions(v) {
         if (!this.checkParent(v.parent)) {
-            console.error("Invalid mesh parent " + v.parent + ", " + this.stringify(v));
+            console.error("Invalid mesh parent " + v.parent + ", " + this.stringify(v) + ".");
         }
         if (v.skin !== undefined) {
             this.assertModelSkinOptions(v.skin);
@@ -7462,7 +7462,7 @@ var AttributeArray = /*#__PURE__*/ function() {
         for(var i = 0; i < v.primitives.length; i++){
             var prim = v.primitives[i];
             if (!this.assertPrimOptions(prim)) {
-                console.error("Invalid primitive " + prim + ", " + this.stringify(v));
+                console.error("Invalid primitive " + prim + ", " + this.stringify(v) + ".");
             }
             var morph = new PMorph();
             morph.create(prim.geometry);
@@ -7472,11 +7472,11 @@ var AttributeArray = /*#__PURE__*/ function() {
             var morph0 = morphList[i1 - 1];
             var morph1 = morphList[i1];
             if (!morph0.equals(morph1)) {
-                console.error("Morph states mismatch: " + this.stringify(morph0) + ", " + this.stringify(morph1) + ", " + this.stringify(v));
+                console.error("Morph states mismatch: " + this.stringify(morph0) + ", " + this.stringify(morph1) + ", " + this.stringify(v) + ".");
             }
         }
         if (!this.checkBooleanUndef(v.hide)) {
-            console.error("Invalid mesh hide " + v.hide + ", " + this.stringify(v));
+            console.error("Invalid mesh hide " + v.hide + ", " + this.stringify(v) + ".");
         }
     };
     /**
@@ -7484,22 +7484,22 @@ var AttributeArray = /*#__PURE__*/ function() {
    * @param v - Model 插件相机参数
    */ CheckerHelper.assertModelCameraOptions = function assertModelCameraOptions(v) {
         if (!this.checkParent(v.parent)) {
-            console.error("Invalid camera parent " + v.parent + ", " + this.stringify(v));
+            console.error("Invalid camera parent " + v.parent + ", " + this.stringify(v) + ".");
         }
         if (!this.checkNumberUndef(v.aspect)) {
-            console.error("Invalid camera aspect " + v.aspect + ", " + this.stringify(v));
+            console.error("Invalid camera aspect " + v.aspect + ", " + this.stringify(v) + ".");
         }
         if (!this.checkPositive(v.near)) {
-            console.error("Invalid camera near " + v.near + ", " + this.stringify(v));
+            console.error("Invalid camera near " + v.near + ", " + this.stringify(v) + ".");
         }
         if (!this.checkPositive(v.far) || v.far <= v.near) {
-            console.error("Invalid camera far " + v.far + ", " + this.stringify(v));
+            console.error("Invalid camera far " + v.far + ", " + this.stringify(v) + ".");
         }
         if (!this.checkPositive(v.fov)) {
-            console.error("Invalid camera fov " + v.fov + ", " + this.stringify(v));
+            console.error("Invalid camera fov " + v.fov + ", " + this.stringify(v) + ".");
         }
         if (!this.checkNumber01(v.clipMode)) {
-            console.error("Invalid camera clipMode " + v.clipMode + ", " + this.stringify(v));
+            console.error("Invalid camera clipMode " + v.clipMode + ", " + this.stringify(v) + ".");
         }
     };
     /**
@@ -7508,58 +7508,58 @@ var AttributeArray = /*#__PURE__*/ function() {
    */ CheckerHelper.assertModelLightOptions = function assertModelLightOptions(v) {
         if (v.lightType === "directional") {
             if (!this.checkParent(v.parent)) {
-                console.error("Invalid light parent " + v.parent + ", " + this.stringify(v));
+                console.error("Invalid light parent " + v.parent + ", " + this.stringify(v) + ".");
             }
             if (!this.checkNonnegative4(v.color)) {
-                console.error("Invalid light color " + v.color + ", " + this.stringify(v));
+                console.error("Invalid light color " + v.color + ", " + this.stringify(v) + ".");
             }
             if (!this.checkNonnegative(v.intensity)) {
-                console.error("Invalid light intensity " + v.intensity + ", " + this.stringify(v));
+                console.error("Invalid light intensity " + v.intensity + ", " + this.stringify(v) + ".");
             }
         } else if (v.lightType === "point") {
             if (!this.checkParent(v.parent)) {
-                console.error("Invalid light parent " + v.parent + ", " + this.stringify(v));
+                console.error("Invalid light parent " + v.parent + ", " + this.stringify(v) + ".");
             }
             if (!this.checkNonnegative4(v.color)) {
-                console.error("Invalid light color " + v.color + ", " + this.stringify(v));
+                console.error("Invalid light color " + v.color + ", " + this.stringify(v) + ".");
             }
             if (!this.checkNonnegative(v.intensity)) {
-                console.error("Invalid light intensity " + v.intensity + ", " + this.stringify(v));
+                console.error("Invalid light intensity " + v.intensity + ", " + this.stringify(v) + ".");
             }
             if (!this.checkNonnegative(v.range)) {
-                console.error("Invalid light range " + v.range + ", " + this.stringify(v));
+                console.error("Invalid light range " + v.range + ", " + this.stringify(v) + ".");
             }
         } else if (v.lightType === "spot") {
             if (!this.checkParent(v.parent)) {
-                console.error("Invalid light parent " + v.parent + ", " + this.stringify(v));
+                console.error("Invalid light parent " + v.parent + ", " + this.stringify(v) + ".");
             }
             if (!this.checkNonnegative4(v.color)) {
-                console.error("Invalid light color " + v.color + ", " + this.stringify(v));
+                console.error("Invalid light color " + v.color + ", " + this.stringify(v) + ".");
             }
             if (!this.checkNonnegative(v.intensity)) {
-                console.error("Invalid light intensity " + v.intensity + ", " + this.stringify(v));
+                console.error("Invalid light intensity " + v.intensity + ", " + this.stringify(v) + ".");
             }
             if (!this.checkNonnegative(v.range)) {
-                console.error("Invalid light range " + v.range + ", " + this.stringify(v));
+                console.error("Invalid light range " + v.range + ", " + this.stringify(v) + ".");
             }
             if (!this.checkNonnegative(v.innerConeAngle)) {
-                console.error("Invalid light innerConeAngle " + v.innerConeAngle + ", " + this.stringify(v));
+                console.error("Invalid light innerConeAngle " + v.innerConeAngle + ", " + this.stringify(v) + ".");
             }
             if (!this.checkNonnegative(v.outerConeAngle)) {
-                console.error("Invalid light outerConeAngle " + v.outerConeAngle + ", " + this.stringify(v));
+                console.error("Invalid light outerConeAngle " + v.outerConeAngle + ", " + this.stringify(v) + ".");
             }
         } else if (v.lightType === "ambient") {
             if (!this.checkParent(v.parent)) {
-                console.error("Invalid light parent " + v.parent + ", " + this.stringify(v));
+                console.error("Invalid light parent " + v.parent + ", " + this.stringify(v) + ".");
             }
             if (!this.checkNonnegative4(v.color)) {
-                console.error("Invalid light color " + v.color + ", " + this.stringify(v));
+                console.error("Invalid light color " + v.color + ", " + this.stringify(v) + ".");
             }
             if (!this.checkNonnegative(v.intensity)) {
-                console.error("Invalid light intensity " + v.intensity + ", " + this.stringify(v));
+                console.error("Invalid light intensity " + v.intensity + ", " + this.stringify(v) + ".");
             }
         } else {
-            console.error("Invalid light type " + this.stringify(v));
+            console.error("Invalid light type " + this.stringify(v) + ".");
         }
     };
     /**
@@ -7568,43 +7568,43 @@ var AttributeArray = /*#__PURE__*/ function() {
    */ CheckerHelper.assertModelSkyboxOptions = function assertModelSkyboxOptions(v) {
         var _this = this;
         if (!this.checkBoolean(v.renderable)) {
-            console.error("Invalid skybox renderable " + v.renderable + ", " + this.stringify(v));
+            console.error("Invalid skybox renderable " + v.renderable + ", " + this.stringify(v) + ".");
         }
         if (!this.checkNonnegative(v.intensity)) {
-            console.error("Invalid skybox intensity " + v.intensity + ", " + this.stringify(v));
+            console.error("Invalid skybox intensity " + v.intensity + ", " + this.stringify(v) + ".");
         }
         if (!this.checkNonnegative(v.reflectionsIntensity)) {
-            console.error("Invalid skybox reflectionsIntensity " + v.reflectionsIntensity + ", " + this.stringify(v));
+            console.error("Invalid skybox reflectionsIntensity " + v.reflectionsIntensity + ", " + this.stringify(v) + ".");
         }
         //
         var c = v.irradianceCoeffs;
         if (c !== undefined) {
             if (!Array.isArray(c) || c.length != 9) {
-                console.error("Invalid skybox irradianceCoeffs " + c + ", " + this.stringify(v));
+                console.error("Invalid skybox irradianceCoeffs " + c + ", " + this.stringify(v) + ".");
             }
             c.forEach(function(v) {
                 if (!_this.checkVec3(v)) {
-                    console.error("Invalid skybox irradianceCoeffs " + c + ", " + _this.stringify(v));
+                    console.error("Invalid skybox irradianceCoeffs " + c + ", " + _this.stringify(v) + ".");
                 }
             });
         } else if (v.diffuseImage !== undefined) {
             if (!this.checkTexture(v.diffuseImage)) {
-                console.error("Invalid skybox diffuseImage " + v.diffuseImage + ", " + this.stringify(v));
+                console.error("Invalid skybox diffuseImage " + v.diffuseImage + ", " + this.stringify(v) + ".");
             }
         } else {
-            console.error("Invalid skybox, irradianceCoeffs or diffuseImage should give one, " + this.stringify(v));
+            console.error("Invalid skybox, irradianceCoeffs or diffuseImage should give one, " + this.stringify(v) + ".");
         }
         if (!this.checkTexture(v.specularImage)) {
-            console.error("Invalid skybox specularImage " + v.specularImage + ", " + this.stringify(v));
+            console.error("Invalid skybox specularImage " + v.specularImage + ", " + this.stringify(v) + ".");
         }
         if (!this.checkPositive(v.specularImageSize)) {
-            console.error("Invalid skybox specularImageSize " + v.specularImageSize + ", " + this.stringify(v));
+            console.error("Invalid skybox specularImageSize " + v.specularImageSize + ", " + this.stringify(v) + ".");
         }
         if (!this.checkPositive(v.specularMipCount)) {
-            console.error("Invalid skybox specularMipCount " + v.specularMipCount + ", " + this.stringify(v));
+            console.error("Invalid skybox specularMipCount " + v.specularMipCount + ", " + this.stringify(v) + ".");
         }
         if (this.pow2(v.specularMipCount) > v.specularImageSize) {
-            console.error("Invalid skybox specularMipCount or specularImageSize, " + this.stringify(v));
+            console.error("Invalid skybox specularMipCount or specularImageSize, " + this.stringify(v) + ".");
         }
     };
     /**
@@ -7640,14 +7640,14 @@ var AttributeArray = /*#__PURE__*/ function() {
    */ CheckerHelper.assertModelAnimOptions = function assertModelAnimOptions(v) {
         var _this = this;
         if (!this.checkStringUndef(v.name)) {
-            console.error("Invalid animation name " + v.name + ", " + this.stringify(v));
+            console.error("Invalid animation name " + v.name + ", " + this.stringify(v) + ".");
         }
         if (!Array.isArray(v.tracks)) {
-            console.error("Invalid animation tracks " + v.tracks + ", " + this.stringify(v));
+            console.error("Invalid animation tracks " + v.tracks + ", " + this.stringify(v) + ".");
         }
         v.tracks.forEach(function(t) {
             if (!_this.checkModelAnimTrackOptions(t)) {
-                console.error("Invalid animation track " + t + ", " + _this.stringify(v));
+                console.error("Invalid animation track " + t + ", " + _this.stringify(v) + ".");
             }
         });
     };
@@ -7657,18 +7657,18 @@ var AttributeArray = /*#__PURE__*/ function() {
    */ CheckerHelper.assertTreeOptions = function assertTreeOptions(v) {
         var _this = this;
         if (!this.checkNumberUndef(v.animation)) {
-            console.error("Invalid tree animation " + v.animation + ", " + this.stringify(v));
+            console.error("Invalid tree animation " + v.animation + ", " + this.stringify(v) + ".");
         }
         if (v.animations !== undefined) {
             if (!Array.isArray(v.animations)) {
-                console.error("Invalid tree animations " + v.animations + ", " + this.stringify(v));
+                console.error("Invalid tree animations " + v.animations + ", " + this.stringify(v) + ".");
             }
             v.animations.forEach(function(anim) {
                 _this.assertModelAnimOptions(anim);
             });
             if (v.animation !== undefined) {
                 if (v.animation < -1 || v.animation >= v.animations.length) {
-                    console.error("Invalid tree animations " + v.animations + ", " + this.stringify(v));
+                    console.error("Invalid tree animations " + v.animations + ", " + this.stringify(v) + ".");
                 }
             }
         }
@@ -8793,7 +8793,7 @@ var CullMode;
         } else {
             var coeffs = this.irradianceCoeffs;
             if (coeffs === undefined || coeffs.length != 9) {
-                throw new Error("Invalid skybox irradiance coeffs " + coeffs);
+                throw new Error("Invalid skybox irradiance coeffs " + coeffs + ".");
             }
             var aliasName = [
                 "l00",
@@ -8856,11 +8856,11 @@ var PSkyboxType;
                         if (i > 0) {
                             if (i % 6 === 0) {
                                 if (image.width * 2 !== lastImage.width || image.height * 2 !== lastImage.height) {
-                                    throw new Error("Invalid cube map list1: index " + i + ", image0 " + lastImage + ", image1 " + image);
+                                    throw new Error("Invalid cube map list1: index " + i + ", image0 " + lastImage + ", image1 " + image + ".");
                                 }
                             } else {
                                 if (image.width !== lastImage.width || image.height !== lastImage.height) {
-                                    throw new Error("Invalid cube map list2: index " + i + ", image0 " + lastImage + ", image1 " + image);
+                                    throw new Error("Invalid cube map list2: index " + i + ", image0 " + lastImage + ", image1 " + image + ".");
                                 }
                             }
                         }
@@ -9394,7 +9394,7 @@ var PSkyboxType;
         this.loadSkybox = loadSkybox;
         if (this.brdfLutTexture === undefined || this.brdfLutTexture.isDestroyed) {
             if (CompositionCache.brdfLutTexOptions === undefined) {
-                throw new Error("Please load brdfLutTexOptions at first");
+                throw new Error("Please load brdfLutTexOptions at first.");
             }
             //
             var brdfLutTextureName = "brdfLutTexture";
@@ -9803,8 +9803,8 @@ var ModelPluginComponent = /*#__PURE__*/ function(ItemBehaviour) {
                         var newPosition = invWorldMatrix.transformPoint(position);
                         component.setTransform(newPosition);
                         // 正式版本不会走到这个流程，只在测试时使用
-                        console.info("Scene AABB [" + sceneAABB.min.toArray() + "], [" + sceneAABB.max.toArray() + "]");
-                        console.info("Update camera position [" + newPosition.toArray() + "]");
+                        console.info("Scene AABB [" + sceneAABB.min.toArray() + "], [" + sceneAABB.max.toArray() + "].");
+                        console.info("Update camera position [" + newPosition.toArray() + "].");
                     }
                 }
             });
@@ -10154,7 +10154,7 @@ var CameraGestureHandlerImp = /*#__PURE__*/ function() {
         // can't find camera item, throw error message
         var item = this.getItem();
         if (item === undefined) {
-            console.warn("can't find camera item " + this.startParams.target);
+            console.warn("[CameraGestureHandlerImp] Unable to locate camera item with ID: " + this.startParams.target + ".");
             return this.composition.camera.getOptions();
         }
         var camera = this.composition.camera;
@@ -10325,7 +10325,7 @@ var CameraGestureHandlerImp = /*#__PURE__*/ function() {
         this.startParams.type = CameraGestureType.none;
         var item = this.getItem();
         if (item === undefined) {
-            console.warn("can't find camera item");
+            console.warn("[CameraGestureHandlerImp] Can't find camera item.");
             return;
         }
         this.setPosition(item, position);
@@ -10335,7 +10335,7 @@ var CameraGestureHandlerImp = /*#__PURE__*/ function() {
         this.startParams.type = CameraGestureType.none;
         var item = this.getItem();
         if (item === undefined) {
-            console.warn("can't find camera item");
+            console.warn("[CameraGestureHandlerImp] Can't find camera item.");
             return;
         }
         this.setQuaternion(item, quat);
@@ -10345,7 +10345,7 @@ var CameraGestureHandlerImp = /*#__PURE__*/ function() {
         this.startParams.type = CameraGestureType.none;
         var item = this.getItem();
         if (item === undefined) {
-            console.warn("can't find camera item");
+            console.warn("[CameraGestureHandlerImp] Can't find camera item.");
             return;
         }
         var newDistance = distance != null ? distance : 5;
@@ -10402,7 +10402,7 @@ var CameraGestureHandlerImp = /*#__PURE__*/ function() {
         this.startParams = args;
         this.updateCameraTransform(this.composition.camera.getOptions());
         if (!this.getItem()) {
-            console.warn("invalid target");
+            console.warn("[CameraGestureHandlerImp] Invalid target specified in startGesture.");
         }
         return this.composition.camera.getOptions();
     };
@@ -10410,7 +10410,7 @@ var CameraGestureHandlerImp = /*#__PURE__*/ function() {
         if (this.getCurrentType() === arg.type) {
             var item = this.getItem();
             if (item === undefined) {
-                console.warn("can't find camera item");
+                console.warn("[CameraGestureHandlerImp] Can't find camera item.");
                 return this.composition.camera.getOptions();
             }
             var _arg_speed;
@@ -10464,10 +10464,10 @@ var CameraGestureHandlerImp = /*#__PURE__*/ function() {
                 item.transform.setQuaternion(newRotation1.x, newRotation1.y, newRotation1.z, newRotation1.w);
                 this.setTransform(item, newPosition, item.transform.rotation);
             } else {
-                console.warn("not implement");
+                console.warn("[CameraGestureHandlerImp] Movement type not implemented.");
             }
         } else {
-            console.warn("invalid move type");
+            console.warn("[CameraGestureHandlerImp] Invalid move type specified: " + arg.type);
         }
         return this.composition.camera.getOptions();
     };
@@ -10736,7 +10736,7 @@ var LoaderImpl = /*#__PURE__*/ function() {
         var nodeList = scene.nodes.map(function(node, nodeIndex) {
             var children = node.children.map(function(child) {
                 if (child.nodeIndex === undefined) {
-                    throw new Error("Undefined nodeIndex for child " + child);
+                    throw new Error("Undefined nodeIndex for child " + child + ".");
                 }
                 return child.nodeIndex;
             });
@@ -10745,7 +10745,7 @@ var LoaderImpl = /*#__PURE__*/ function() {
             var scale;
             if (node.matrix !== undefined) {
                 if (node.matrix.length !== 16) {
-                    throw new Error("Invalid matrix length " + node.matrix.length + " for node " + node);
+                    throw new Error("Invalid matrix length " + node.matrix.length + " for node " + node + ".");
                 }
                 var mat = Matrix4.fromArray(node.matrix);
                 var transform = mat.getTransform();
@@ -10778,7 +10778,7 @@ var LoaderImpl = /*#__PURE__*/ function() {
         });
         var rootNodes = scene.rootNodes.map(function(root) {
             if (root.nodeIndex === undefined) {
-                throw new Error("Undefined nodeIndex for root " + root);
+                throw new Error("Undefined nodeIndex for root " + root + ".");
             }
             return root.nodeIndex;
         });
@@ -10823,18 +10823,18 @@ var LoaderImpl = /*#__PURE__*/ function() {
     _proto.createTextureCube = function createTextureCube(cubeImages, level0Size) {
         var _this = this;
         if (cubeImages.length == 0) {
-            throw new Error("createTextureCube: Invalid cubeImages length " + cubeImages);
+            throw new Error("createTextureCube: Invalid cubeImages length " + cubeImages + ".");
         }
         var mipmaps = [];
         cubeImages.forEach(function(cubeImage) {
             if (cubeImage.length != 6) {
-                throw new Error("createTextureCube: cubeimage count should always be 6, " + cubeImage);
+                throw new Error("createTextureCube: cubeimage count should always be 6, " + cubeImage + ".");
             }
             //
             var imgList = [];
             cubeImage.forEach(function(img) {
                 if (img.imageData === undefined) {
-                    throw new Error("createTextureCube: Invalid image data from " + img);
+                    throw new Error("createTextureCube: Invalid image data from " + img + ".");
                 }
                 //
                 imgList.push({
@@ -10902,7 +10902,7 @@ var LoaderImpl = /*#__PURE__*/ function() {
     };
     _proto.createDefaultSkybox = function createDefaultSkybox(typeName) {
         if (typeName !== "NFT" && typeName !== "FARM") {
-            throw new Error("Invalid skybox type name " + typeName);
+            throw new Error("Invalid skybox type specified: '" + typeName + "'. Valid types are: 'NFT', 'FARM'.");
         }
         //
         var typ = typeName === "NFT" ? PSkyboxType.NFT : PSkyboxType.FARM;
@@ -10933,7 +10933,7 @@ var LoaderImpl = /*#__PURE__*/ function() {
                         };
                         gltfResource = options.gltf.resource;
                         if (typeof gltfResource === "string" || _instanceof1(gltfResource, Uint8Array)) {
-                            throw new Error("Please load resource by GLTFTools at first");
+                            throw new Error("Please load the resource using GLTFTools first.");
                         }
                         _this._gltfScene = gltfResource.scenes[0];
                         _this._gltfSkins = _this._gltfScene.skins;
@@ -11144,7 +11144,7 @@ var LoaderImpl = /*#__PURE__*/ function() {
         var texIndex = texInfo.index;
         var tex = this.getTextureManager().getTexture(matIndex, texIndex, isBaseColor);
         if (tex === undefined && noWarning !== true) {
-            console.warn("Can't find texture for mat " + matIndex + ", tex " + JSON.stringify(texInfo) + ", basecolor " + isBaseColor);
+            console.warn("Can't find texture for mat " + matIndex + ", tex " + JSON.stringify(texInfo) + ", basecolor " + isBaseColor + ".");
         }
         return tex;
     };
@@ -11176,7 +11176,7 @@ var LoaderImpl = /*#__PURE__*/ function() {
         var _this = this;
         var meshIndex = node.mesh;
         if (meshIndex === undefined) {
-            throw new Error("Invalid mesh index in node " + node);
+            throw new Error("Invalid mesh index in node " + node + ".");
         }
         var skin;
         if (node.skin !== undefined) {
@@ -11512,7 +11512,7 @@ var GeometryProxy = /*#__PURE__*/ function() {
                     var attrib = this.positionAttrib;
                     attributes["aPos"] = this._getBufferAttrib(attrib);
                 } else {
-                    throw new Error("Position attribute missing");
+                    throw new Error("Position attribute missing.");
                 }
                 if (this.hasNormal) {
                     var attrib1 = this.normalAttrib;
@@ -12015,15 +12015,15 @@ var JSONConverter = /*#__PURE__*/ function() {
     _proto.processScene = function processScene(sceneData) {
         var _this = this;
         return _async_to_generator(function() {
-            var sceneJSON, oldScene, binFiles, _iterator, _step, bin, _, newScene;
+            var sceneJSON, _tmp, oldScene, binFiles, _iterator, _step, bin, _, newScene;
             return __generator(this, function(_state) {
                 switch(_state.label){
                     case 0:
-                        if (!_instanceof1(sceneData, Object)) return [
+                        if (!isObject(sceneData)) return [
                             3,
                             1
                         ];
-                        sceneJSON = sceneData;
+                        _tmp = sceneData;
                         return [
                             3,
                             3
@@ -12034,9 +12034,10 @@ var JSONConverter = /*#__PURE__*/ function() {
                             _this.loadJSON(sceneData)
                         ];
                     case 2:
-                        sceneJSON = _state.sent();
+                        _tmp = _state.sent();
                         _state.label = 3;
                     case 3:
+                        sceneJSON = _tmp;
                         // @ts-expect-error
                         sceneJSON.textures.forEach(function(tex) {
                             if (tex.source === undefined) {
@@ -12225,7 +12226,7 @@ var JSONConverter = /*#__PURE__*/ function() {
                 newComponents.push(this.createLightComponent(comp, newScene));
             } else if (comp.dataType === spec.DataType.CameraComponent) {
                 newComponents.push(comp);
-                console.warn("Find camera component", comp);
+                console.warn("Camera component found: " + comp + ".");
             } else if (comp.dataType === spec.DataType.TreeComponent) {
                 var treeComp = comp;
                 this.createItemsFromTreeComponent(comp, newScene, oldScene);
@@ -12269,7 +12270,7 @@ var JSONConverter = /*#__PURE__*/ function() {
                     2,
                     new Promise(function(resolve, reject) {
                         _this.downloader.downloadJSON(url, resolve, function(status, responseText) {
-                            reject(new Error("Couldn't load JSON " + JSON.stringify(url) + ": status " + status + ", " + responseText));
+                            reject(new Error("Failed to load JSON from URL '" + url + "': status " + status + " - " + responseText + ". Please check the URL or network settings."));
                         });
                     })
                 ];
@@ -12298,7 +12299,7 @@ var JSONConverter = /*#__PURE__*/ function() {
                 _pointer_ = pointer[1], index = _pointer_[0], start = _pointer_[1], length = _pointer_[2];
                 bin = bins[index];
                 if (!bin) {
-                    throw new Error("invalid bin pointer: " + JSON.stringify(pointer));
+                    throw new Error("Invalid bin pointer: " + JSON.stringify(pointer) + ".");
                 }
                 return [
                     2,
@@ -12367,7 +12368,7 @@ var JSONConverter = /*#__PURE__*/ function() {
         });
         var geometryData = getGeometryDataFromPropsList(geometryPropsList);
         if (!geometryData) {
-            throw new Error("no primitives");
+            throw new Error("No primitives available to process.");
         }
         newScene.geometries.push(geometryData);
         (_newScene_materials = newScene.materials).push.apply(_newScene_materials, [].concat(materialDatas));
@@ -12394,12 +12395,12 @@ var JSONConverter = /*#__PURE__*/ function() {
                 }
             }
             if (parentItemId === component.item.id) {
-                throw new Error("Can't item " + component.item);
+                throw new Error("Can't item " + component.item + ".");
             }
             var treeItem = this.treeInfo.getTreeItemByNodeId(parentItemId);
             var treeNodeList = this.treeInfo.getTreeNodeListByNodeId(parentItemId);
             if (!treeItem || !treeNodeList) {
-                throw new Error("Can't find tree node list for " + component.item);
+                throw new Error("Failed to retrieve tree node list for item with ID " + component.item.id + ". Ensure the item exists and has a valid tree structure.");
             }
             var rootBoneItem = this.setupBoneData(geometryData, meshOptions.skin, oldScene, treeItem, treeNodeList);
             meshComponent.rootBone = {
@@ -12528,13 +12529,13 @@ var JSONConverter = /*#__PURE__*/ function() {
                     var inputArray = typedArrayFromBinary(bins, track.input);
                     var outputArray = typedArrayFromBinary(bins, track.output);
                     if (!_instanceof1(inputArray, Float32Array)) {
-                        throw new Error("Type of inputArray should be float32, " + inputArray);
+                        throw new Error("Type of inputArray should be float32, " + inputArray + ".");
                     }
                     if (!_instanceof1(outputArray, Float32Array)) {
-                        throw new Error("Type of outputArray should be float32, " + outputArray);
+                        throw new Error("Type of outputArray should be float32, " + outputArray + ".");
                     }
                     if (track.interpolation !== "LINEAR") {
-                        throw new Error("Invalid interpolation type " + track.interpolation);
+                        throw new Error("Invalid interpolation type " + track.interpolation + ".");
                     }
                     if (track.path === "rotation") {
                         var points = [];
@@ -12870,7 +12871,7 @@ var JSONConverter = /*#__PURE__*/ function() {
         var bins = oldScene.bins;
         var joints = skin.joints, skeleton = skin.skeleton, inverseBindMatrices = skin.inverseBindMatrices;
         if (!inverseBindMatrices) {
-            throw new Error("inverseBindMatrices is undefined " + skin);
+            throw new Error("'inverseBindMatrices' is undefined for the skin configuration: " + JSON.stringify(skin) + ". Ensure 'inverseBindMatrices' is properly defined in your skin data.");
         }
         var bindMatrixArray = typedArrayFromBinary(bins, inverseBindMatrices);
         geom.inverseBindMatrices = Array.from(bindMatrixArray);
@@ -12879,12 +12880,12 @@ var JSONConverter = /*#__PURE__*/ function() {
         if (skeleton !== undefined) {
             rootBoneItem = treeNodeList[skeleton];
         } else {
-            console.warn("Root bone is missing");
+            console.warn("Root bone is missing for the skeleton. Defaulting to the primary tree item as the root bone.");
         }
         joints.forEach(function(joint) {
             var node = treeNodeList[joint];
             if (node !== rootBoneItem && node.parentId === rootBoneItem.parentId) {
-                console.error("Find invalid node for rootBoneItem and adjust rootBoneItem");
+                console.error("Invalid node detected for 'rootBoneItem'. Adjusting 'rootBoneItem' to the primary tree item. Please verify the tree structure.");
                 rootBoneItem = treeItem;
             }
         });
@@ -12922,12 +12923,12 @@ var TreeInfo = /*#__PURE__*/ function() {
     _proto.add = function add(treeItem, treeNodeList) {
         var _this = this;
         if (this.tree2NodeList[treeItem.id]) {
-            throw new Error("Find duplicate treeItem id: " + treeItem.id);
+            throw new Error("Duplicate treeItem ID detected: " + treeItem.id + ". Ensure each tree item has a unique ID.");
         }
         this.tree2NodeList[treeItem.id] = treeNodeList;
         treeNodeList.forEach(function(node) {
             if (_this.nodeList2Tree[node.id]) {
-                throw new Error("Find duplicate tree node id: " + node.id);
+                throw new Error("Duplicate tree node ID found: " + node.id + ". Each node in the tree must have a unique ID.");
             }
             _this.nodeList2Tree[node.id] = treeItem;
             _this.nodeId2Node[node.id] = node;
@@ -12956,7 +12957,7 @@ var TreeInfo = /*#__PURE__*/ function() {
     _proto.getTreeNodeListByNodeId = function getTreeNodeListByNodeId(id) {
         var treeItem = this.nodeList2Tree[id];
         if (!treeItem) {
-            throw new Error("Invalid id " + id);
+            throw new Error("Invalid id " + id + ".");
         }
         return this.getTreeNodeListByTreeId(treeItem.id);
     };
@@ -13170,7 +13171,7 @@ function createGeometryData(props, subMeshes) {
         var attribData1 = props.attributes[attrib1];
         var semantic = vertexBufferSemanticMap[attrib1];
         if (!semantic) {
-            throw new Error("Invalid attrib " + attrib1);
+            throw new Error("Invalid attrib " + attrib1 + ".");
         }
         // @ts-expect-error
         vertexCount = attribData1.data.length / attribData1.size;
@@ -13365,9 +13366,9 @@ var vertexBufferSemanticMap = {
 
 registerPlugin("tree", ModelTreePlugin, VFXItem, true);
 registerPlugin("model", ModelPlugin, VFXItem);
-var version = "2.0.0-alpha.16";
-logger.info("plugin model version: " + version);
-if (version !== version$1) {
+var version = "2.0.0-alpha.18";
+logger.info("Plugin model version: " + version + ".");
+if (version !== EFFECTS.version) {
     console.error("注意：请统一 Model 插件与 Player 版本，不统一的版本混用会有不可预知的后果！", "\nAttention: Please ensure the Model plugin is synchronized with the Player version. Mixing and matching incompatible versions may result in unpredictable consequences!");
 }