From 42a9efe431a78ea9c620f7efd5932d2b2b7f9d42 Mon Sep 17 00:00:00 2001 From: unanmed <1319491857@qq.com> Date: Tue, 14 Oct 2025 19:28:27 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=AE=8C=E5=96=84=E9=94=99=E8=AF=AF?= =?UTF-8?q?=E4=BB=A3=E7=A0=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/logger/error/error1.md | 108 ++++++++++-------- docs/logger/warn/warn1.md | 195 +++++++++++++++++--------------- docs/logger/warn/warn2.md | 70 +++++++----- packages/common/src/logger.json | 8 +- 4 files changed, 210 insertions(+), 171 deletions(-) diff --git a/docs/logger/error/error1.md b/docs/logger/error/error1.md index f4b0a27..fd5eed5 100644 --- a/docs/logger/error/error1.md +++ b/docs/logger/error/error1.md @@ -6,8 +6,10 @@ Unexpected error when posting danmaku. Error info: $1 ``` -- 报错原因:发送弹幕时发生报错。 -- 解决方案:查看后面的 Error info,检查报错信息内容,按照报错信息修复问题。 +> 应该不会遇到这个报错,因为样板并不内置弹幕系统。 + +- 报错原因:发送弹幕时发生报错。 +- 解决方案:查看后面的 Error info,检查报错信息内容,按照报错信息修复问题。 ## ERROR CODE 2 @@ -15,8 +17,8 @@ Unexpected error when posting danmaku. Error info: $1 Unexpected loading error in loading resource '$1/$2'. Error info: $3 ``` -- 报错原因:加载资源时发生报错,可能是资源不存在,或者是网络问题。 -- 解决方案:查看后面的 Error info,检查报错信息内容,按照报错信息修复问题。 +- 报错原因:加载资源时发生报错,可能是资源不存在,或者是网络问题。 +- 解决方案:查看后面的 Error info,检查报错信息内容,按照报错信息修复问题。 ## ERROR CODE 3 @@ -24,8 +26,10 @@ Unexpected loading error in loading resource '$1/$2'. Error info: $3 Syntax error in parsing CSS: Unexpected ':'. Col: $1. CSS string: '$2 ``` -- 报错原因:解析 CSS 时报错,一般是在发送弹幕时引起。 -- 解决方案:检查弹幕 CSS 语法是否正确。 +> 应该不会遇到这个报错,因为样板并不内置弹幕系统。 + +- 报错原因:解析 CSS 时报错,一般是在发送弹幕时引起。 +- 解决方案:检查弹幕 CSS 语法是否正确。 ## ERROR CODE 4 @@ -33,8 +37,10 @@ Syntax error in parsing CSS: Unexpected ':'. Col: $1. CSS string: '$2 Syntax error in parsing CSS: Unexpected ';'. Col: $1. CSS string: '$2' ``` -- 报错原因:解析 CSS 时报错,一般是在发送弹幕时引起。 -- 解决方案:检查弹幕 CSS 语法是否正确。 +> 应该不会遇到这个报错,因为样板并不内置弹幕系统。 + +- 报错原因:解析 CSS 时报错,一般是在发送弹幕时引起。 +- 解决方案:检查弹幕 CSS 语法是否正确。 ## ERROR CODE 5 @@ -42,8 +48,10 @@ Syntax error in parsing CSS: Unexpected ';'. Col: $1. CSS string: '$2' Syntax error in parsing CSS: Missing property name after '-'. Col: $1. CSS string: '$2' ``` -- 报错原因:解析 CSS 时报错,一般是在发送弹幕时引起。 -- 解决方案:检查弹幕 CSS 语法是否正确。 +> 应该不会遇到这个报错,因为样板并不内置弹幕系统。 + +- 报错原因:解析 CSS 时报错,一般是在发送弹幕时引起。 +- 解决方案:检查弹幕 CSS 语法是否正确。 ## ERROR CODE 6 @@ -51,8 +59,10 @@ Syntax error in parsing CSS: Missing property name after '-'. Col: $1. CSS strin Syntax error in parsing CSS: Unexpected end of css, expecting ':'. Col: $1. CSS string: '$2' ``` -- 报错原因:解析 CSS 时报错,一般是在发送弹幕时引起。 -- 解决方案:检查弹幕 CSS 语法是否正确。 +> 应该不会遇到这个报错,因为样板并不内置弹幕系统。 + +- 报错原因:解析 CSS 时报错,一般是在发送弹幕时引起。 +- 解决方案:检查弹幕 CSS 语法是否正确。 ## ERROR CODE 7 @@ -60,8 +70,10 @@ Syntax error in parsing CSS: Unexpected end of css, expecting ':'. Col: $1. CSS Syntax error in parsing CSS: Unexpected end of css, expecting property value. Col: $1. CSS string: '$2' ``` -- 报错原因:解析 CSS 时报错,一般是在发送弹幕时引起。 -- 解决方案:检查弹幕 CSS 语法是否正确。 +> 应该不会遇到这个报错,因为样板并不内置弹幕系统。 + +- 报错原因:解析 CSS 时报错,一般是在发送弹幕时引起。 +- 解决方案:检查弹幕 CSS 语法是否正确。 ## ERROR CODE 8 @@ -69,8 +81,10 @@ Syntax error in parsing CSS: Unexpected end of css, expecting property value. Co Post danmaku with not allowed css. Info: $1 ``` -- 报错原因:弹幕 CSS 中使用了不允许的 css 属性类型。 -- 解决方案:目前仅支持 `color` `background-color` `font-size: x%` 属性。 +> 应该不会遇到这个报错,因为样板并不内置弹幕系统。 + +- 报错原因:弹幕 CSS 中使用了不允许的 css 属性类型。 +- 解决方案:目前仅支持 `color` `background-color` `font-size: x%` 属性。 ## ERROR CODE 9 @@ -78,8 +92,8 @@ Post danmaku with not allowed css. Info: $1 Cannot initialize shader program. Error info: $1 ``` -- 报错原因:不能够初始化着色器脚本,可能是着色器代码中有语法错误,或者是定义了不存在的变量等。 -- 解决方案:查看报错内容,根据报错内容解决。 +- 报错原因:不能够初始化着色器脚本,可能是着色器代码中有语法错误,或者是定义了不存在的变量等。 +- 解决方案:查看报错内容,根据报错内容解决。 ## ERROR CODE 10 @@ -87,8 +101,8 @@ Cannot initialize shader program. Error info: $1 Cannot compile $1 shader. Error info: $2 ``` -- 报错原因:不能编译着色器脚本,可能是语法错误,设备不支持 OpenGL 等原因。 -- 解决方案:查看报错内容,根据报错内容解决。 +- 报错原因:不能编译着色器脚本,可能是语法错误,设备不支持 OpenGL 等原因。 +- 解决方案:查看报错内容,根据报错内容解决。 ## ERROR CODE 11 @@ -96,8 +110,8 @@ Cannot compile $1 shader. Error info: $2 Cache depth cannot larger than 31. ``` -- 报错原因:`BlockCache` 最大允许 31 层深度缓存。 -- 解决方案:降低缓存深度。 +- 报错原因:`BlockCache` 最大允许 31 层深度缓存。 +- 解决方案:降低缓存深度。 ## ERROR CODE 12 @@ -105,8 +119,8 @@ Cache depth cannot larger than 31. Cannot move while status is not 'moving'. Call 'readyMove' first. ``` -- 报错原因:调用移动时没有调用 `readyMove` 准备移动。 -- 解决方案:在移动前先调用 `readyMove`。 +- 报错原因:调用移动时没有调用 `readyMove` 准备移动。 +- 解决方案:在移动前先调用 `readyMove`。 ## ERROR CODE 13 @@ -118,8 +132,8 @@ Cannot move while status is not 'moving'. Call 'readyMove' first. Cannot find log message for $1 code $2. ``` -- 报错原因:不能找到错误代码 $2 的消息。 -- 解决方案:避免使用 `logger` 输出不存在的错误代码。 +- 报错原因:不能找到错误代码 $2 的消息。 +- 解决方案:避免使用 `logger` 输出不存在的错误代码。 ## ERROR CODE 17 @@ -127,17 +141,17 @@ Cannot find log message for $1 code $2. Cannot use shader program for shader element that does not belong to it. ``` -- 报错原因:在一个着色器上使用了不属于这个着色器的着色器程序。 -- 解决方案:确保使用的着色器程序是由着色器对象自身创建的。 +- 报错原因:在一个着色器上使用了不属于这个着色器的着色器程序。 +- 解决方案:确保使用的着色器程序是由着色器对象自身创建的。 ## ERROR CODE 18 ```txt -Cannot delete shader program for shader element that does not belong to +Cannot delete shader program for shader element that does not belong to it. ``` -- 报错原因:在一个着色器上删除了不属于这个着色器的着色器程序。 -- 解决方案:确保删除的着色器程序是由着色器对象自身创建的。 +- 报错原因:在一个着色器上删除了不属于这个着色器的着色器程序。 +- 解决方案:确保删除的着色器程序是由着色器对象自身创建的。 ## ERROR CODE 19 @@ -145,8 +159,8 @@ Cannot delete shader program for shader element that does not belong to Cannot create MotaRenderer instance for nonexistent canvas. ``` -- 报错原因:在一个不存在的画布上创建了渲染器对象。 -- 解决方案:确保目标画布存在。 +- 报错原因:在一个不存在的画布上创建了渲染器对象。 +- 解决方案:确保目标画布存在。 ## ERROR CODE 20 @@ -154,8 +168,8 @@ Cannot create MotaRenderer instance for nonexistent canvas. Cannot create render element for tag '$1', since there's no registration for it. ``` -- 报错原因:不能创建 $1 标签,因为没有注册这个标签。 -- 解决方案:确保你已经在 `tagMap` 注册了这个标签。 +- 报错原因:不能创建 $1 标签,因为没有注册这个标签。 +- 解决方案:确保你已经在 `tagMap` 注册了这个标签。 ## ERROR CODE 21 @@ -163,8 +177,8 @@ Cannot create render element for tag '$1', since there's no registration for it. Incorrect render prop type is delivered. key: '$1', expected type: '$2', delivered type: '$3' ``` -- 报错原因:向元素中传入了错误类型的参数(props)。 -- 解决方案:确保传入元素的 $1 参数的类型是 $2。 +- 报错原因:向元素中传入了错误类型的参数(props)。 +- 解决方案:确保传入元素的 $1 参数的类型是 $2。 ## ERROR CODE 22 @@ -172,8 +186,8 @@ Incorrect render prop type is delivered. key: '$1', expected type: '$2', deliver Incorrect props for custom tag. Please ensure you have delivered 'item' prop and other required props. ``` -- 报错原因:没有向 `cutsom` 标签传入 `item` 参数。 -- 解决方案:确保传入了 `item` 参数和需要的所有参数。 +- 报错原因:没有向 `cutsom` 标签传入 `item` 参数。 +- 解决方案:确保传入了 `item` 参数和需要的所有参数。 ## ERROR CODE 23 @@ -181,8 +195,8 @@ Incorrect props for custom tag. Please ensure you have delivered 'item' prop and Cannot get reader when fetching '$1'. ``` -- 报错原因:流式加载 URL $1 时不能获取 `StreamReader`。 -- 解决方案:检查加载的 URL 是否合法,检查浏览器版本是否过老。 +- 报错原因:流式加载 URL $1 时不能获取 `StreamReader`。 +- 解决方案:检查加载的 URL 是否合法,检查浏览器版本是否过老。 ## ERROR CODE 24 @@ -190,8 +204,8 @@ Cannot get reader when fetching '$1'. Cannot decode source type of '$1', since there is no registered decoder for that type. ``` -- 报错原因:音频系统中的流式音频源不能解析 $1 格式的音频,因为没有对应的解码器。 -- 解决方案:如果不是 `opus` `ogg` 格式的音频,请使用 `ElementSource`。 +- 报错原因:音频系统中的流式音频源不能解析 $1 格式的音频,因为没有对应的解码器。 +- 解决方案:如果不是 `opus` `ogg` 格式的音频,请使用 `ElementSource`。 ## ERROR CODE 25 @@ -199,8 +213,8 @@ Cannot decode source type of '$1', since there is no registered decoder for that Unknown audio type. Header: '$1' ``` -- 报错原因:未知的音频类型。 -- 解决方案:目前仅支持 `mp3` `wav` `flac` `opus` `ogg` `aac` 格式的音频。 +- 报错原因:未知的音频类型。 +- 解决方案:目前仅支持 `mp3` `wav` `flac` `opus` `ogg` `aac` 格式的音频。 ## ERROR CODE 26 @@ -208,5 +222,5 @@ Unknown audio type. Header: '$1' Uncaught error when fetching stream data from '$1'. Error info: $2. ``` -- 报错原因:流式加载时报错。 -- 解决方案:查看报错内容,根据报错内容解决问题。 +- 报错原因:流式加载时报错。 +- 解决方案:查看报错内容,根据报错内容解决问题。 diff --git a/docs/logger/warn/warn1.md b/docs/logger/warn/warn1.md index 6ef9683..b291ee5 100644 --- a/docs/logger/warn/warn1.md +++ b/docs/logger/warn/warn1.md @@ -6,8 +6,8 @@ Resource with type of 'none' is loaded. ``` -- 警告原因:不能加载 `none` 类型的资源。 -- 解决方案:加载资源时填写资源类型。 +- 警告原因:不能加载 `none` 类型的资源。 +- 解决方案:加载资源时填写资源类型。 ## WARN CODE 2 @@ -15,8 +15,8 @@ Resource with type of 'none' is loaded. Repeat load of resource '$1/$2'. ``` -- 警告原因:同一个资源被加载了两次。 -- 解决方案:避免对同一个资源调用两次加载。 +- 警告原因:同一个资源被加载了两次。 +- 解决方案:避免对同一个资源调用两次加载。 ## WARN CODE 3 @@ -24,8 +24,10 @@ Repeat load of resource '$1/$2'. Unknown danmaku tag: $1 ``` -- 警告原因:出现了未知的弹幕标签(指 `[xxx:xxx]`) -- 解决方案:目前仅支持 `[i:xxx]` 标签,如果需要显示方括号,请使用 `\[\]`。 +> 应该不会遇到这个报错,因为样板并不内置弹幕系统。 + +- 警告原因:出现了未知的弹幕标签(指 `[xxx:xxx]`) +- 解决方案:目前仅支持 `[i:xxx]` 标签,如果需要显示方括号,请使用 `\[\]`。 ## WARN CODE 4 @@ -33,8 +35,10 @@ Unknown danmaku tag: $1 Ignored a mismatched ']' in danmaku. ``` -- 警告原因:出现了不能匹配的右方括号。 -- 解决方案:如果需要显示方括号,请使用 `\[\]`。 +> 应该不会遇到这个报错,因为样板并不内置弹幕系统。 + +- 警告原因:出现了不能匹配的右方括号。 +- 解决方案:如果需要显示方括号,请使用 `\[\]`。 ## WARN CODE 5 @@ -42,8 +46,10 @@ Ignored a mismatched ']' in danmaku. Repeat post danmaku. ``` -- 警告原因:同一个弹幕被发送了两次。 -- 解决方案:确保一个弹幕实例只调用了一次 `post` 方法。 +> 应该不会遇到这个报错,因为样板并不内置弹幕系统。 + +- 警告原因:同一个弹幕被发送了两次。 +- 解决方案:确保一个弹幕实例只调用了一次 `post` 方法。 ## WARN CODE 6 @@ -51,8 +57,10 @@ Repeat post danmaku. Registered special danmaku element: $1. ``` -- 警告原因:要注册的弹幕标签已经存在。 -- 解决方案:避免使用同一个标签名,如果内容不一样请换一个标签名。 +> 应该不会遇到这个报错,因为样板并不内置弹幕系统。 + +- 警告原因:要注册的弹幕标签已经存在。 +- 解决方案:避免使用同一个标签名,如果内容不一样请换一个标签名。 ## WARN CODE 7 @@ -64,8 +72,8 @@ Registered special danmaku element: $1. Incomplete render data is put. None will be filled to the lacked data. ``` -- 警告原因:使用 `` 标签时,向地图渲染传入了不完整的地图信息(数据长度不是指定宽度的倍数),不完整的部分将会补零。 -- 解决方案:确保传入的地图信息长度是 `width` 参数的倍数。 +- 警告原因:使用 `` 标签时,向地图渲染传入了不完整的地图信息(数据长度不是指定宽度的倍数),不完整的部分将会补零。 +- 解决方案:确保传入的地图信息长度是 `width` 参数的倍数。 ## WARN CODE 9 @@ -73,8 +81,8 @@ Incomplete render data is put. None will be filled to the lacked data. Data transfered is partially (or totally) out of range. Overflowed data will be ignored. ``` -- 警告原因:使用 `` 标签时,传入地图的渲染数据有一部分(或全部都)在地图之外,在地图之外的部分将会被忽略。 -- 解决方案:确保传入的地图信息没有在地图之外的部分。 +- 警告原因:使用 `` 标签时,传入地图的渲染数据有一部分(或全部都)在地图之外,在地图之外的部分将会被忽略。 +- 解决方案:确保传入的地图信息没有在地图之外的部分。 ## WARN CODE 10 @@ -82,8 +90,8 @@ Data transfered is partially (or totally) out of range. Overflowed data will be Cannot resolve big image of enemy '$1'. ``` -- 警告原因:无法解析怪物 $1 的大怪物贴图(绑定贴图),可能是因为图片不存在。 -- 解决方案:确保此怪物绑定的贴图已经在全塔属性注册。 +- 警告原因:无法解析怪物 $1 的大怪物贴图(绑定贴图),可能是因为图片不存在。 +- 解决方案:确保此怪物绑定的贴图已经在全塔属性注册。 ## WARN CODE 11 @@ -91,8 +99,8 @@ Cannot resolve big image of enemy '$1'. Cannot resolve material $1. Material not exists. ``` -- 警告原因:不能解析指定类型 $1 的素材,因为对应的素材文件不存在。 -- 解决方案:检查 `enemys.png` `npcs.png` 等素材文件是否存在。 +- 警告原因:不能解析指定类型 $1 的素材,因为对应的素材文件不存在。 +- 解决方案:检查 `enemys.png` `npcs.png` 等素材文件是否存在。 ## WARN CODE 12 @@ -100,7 +108,7 @@ Cannot resolve material $1. Material not exists. Cannot mark buffable with a non-number status. Key: '$1'. ``` -- 暂时碰不到这个报错。 +- 暂时碰不到这个报错。 ## WARN CODE 13 @@ -108,7 +116,7 @@ Cannot mark buffable with a non-number status. Key: '$1'. Cannot set buff of non-number status. Key: '$1'. ``` -- 暂时碰不到这个报错。 +- 暂时碰不到这个报错。 ## WARN CODE 14 @@ -116,7 +124,7 @@ Cannot set buff of non-number status. Key: '$1'. Cannot add status of non-number status. Key: '$1'. ``` -- 暂时碰不到这个报错。 +- 暂时碰不到这个报错。 ## WARN CODE 15 @@ -124,8 +132,8 @@ Cannot add status of non-number status. Key: '$1'. Cannot get item of a non-item block on loc: $1,$2,$3. ``` -- 警告原因:不能获取一个不存在物品的图块上的物品对象。 -- 解决方案:提前判断那一格是不是物品,或确保要获取的格子包含物品。 +- 警告原因:不能获取一个不存在物品的图块上的物品对象。 +- 解决方案:提前判断那一格是不是物品,或确保要获取的格子包含物品。 ## WARN CODE 16 @@ -133,7 +141,7 @@ Cannot get item of a non-item block on loc: $1,$2,$3. Override repeated state key: '$1'. ``` -- 暂时碰不到这个报错。 +- 暂时碰不到这个报错。 ## WARN CODE 17 @@ -141,8 +149,8 @@ Override repeated state key: '$1'. Floor-damage extension needs 'floor-binder' extension as dependency. ``` -- 警告原因:楼层伤害拓展需要以楼层绑定拓展作为依赖。 -- 解决方案:确保添加伤害拓展时也添加了楼层绑定拓展。 +- 警告原因:楼层伤害拓展需要以楼层绑定拓展作为依赖。 +- 解决方案:确保添加伤害拓展时也添加了楼层绑定拓展。 ## WARN CODE 18 @@ -150,8 +158,10 @@ Floor-damage extension needs 'floor-binder' extension as dependency. Uncaught error in posting like info for danmaku. Danmaku id: $1. ``` -- 警告原因:为弹幕点赞时出现报错。 -- 解决方案:可能是网络问题,检查网络。 +> 应该不会遇到这个报错,因为样板并不内置弹幕系统。 + +- 警告原因:为弹幕点赞时出现报错。 +- 解决方案:可能是网络问题,检查网络。 ## WARN CODE 19 @@ -159,8 +169,10 @@ Uncaught error in posting like info for danmaku. Danmaku id: $1. Repeat light id: '$1' ``` -- 警告原因:重复的光源 id。 -- 解决方案:避免光源 id 出现重复。 +> 应该不会遇到这个报错,因为样板并不内置点光源。 + +- 警告原因:重复的光源 id。 +- 解决方案:避免光源 id 出现重复。 ## WARN CODE 20 @@ -168,8 +180,8 @@ Repeat light id: '$1' Cannot apply animation to camera operation that does not belong to it. ``` -- 警告原因:不能向摄像机对象添加不属于它的动画操作。 -- 解决方案:确保添加的动画操作是由这个摄像机对象创建的。 +- 警告原因:不能向摄像机对象添加不属于它的动画操作。 +- 解决方案:确保添加的动画操作是由这个摄像机对象创建的。 ## WARN CODE 21 @@ -177,8 +189,8 @@ Cannot apply animation to camera operation that does not belong to it. Cannot apply transition to camera operation that does not belong to it. ``` -- 警告原因:不能向摄像机对象添加不属于它的渐变操作。 -- 解决方案:确保添加的渐变操作是由这个摄像机对象创建的。 +- 警告原因:不能向摄像机对象添加不属于它的渐变操作。 +- 解决方案:确保添加的渐变操作是由这个摄像机对象创建的。 ## WARN CODE 22 @@ -186,8 +198,8 @@ Cannot apply transition to camera operation that does not belong to it. There is already an active camera for delivered render item. Consider using 'Camera.for' or disable the active camera to avoid some exceptions. ``` -- 警告原因:在目标渲染元素上,现在已经有了一个已激活的摄像机对象,这可能导致两个摄像机操作冲突,产生问题。 -- 解决方案:考虑使用 [`Camera.for`](../../api/motajs-render-elements/Camera.md#Camera.for) 方法,或先禁用已激活的摄像机,再使用当前摄像机 +- 警告原因:在目标渲染元素上,现在已经有了一个已激活的摄像机对象,这可能导致两个摄像机操作冲突,产生问题。 +- 解决方案:考虑使用 [`Camera.for`](../../api/motajs-render-elements/Camera.md#Camera.for) 方法,或先禁用已激活的摄像机,再使用当前摄像机 ## WARN CODE 23 @@ -195,8 +207,8 @@ There is already an active camera for delivered render item. Consider using 'Cam Render item with id of '$1' has already exists. Please avoid repeat id since it may cause issues when use 'getElementById'. ``` -- 警告原因:两个渲染元素的 id 出现了重复,这会导致调用 `getElementById` 时出现问题。 -- 解决方案:避免出现重复的 id。 +- 警告原因:两个渲染元素的 id 出现了重复,这会导致调用 `getElementById` 时出现问题。 +- 解决方案:避免出现重复的 id。 ## WARN CODE 24 @@ -204,8 +216,8 @@ Render item with id of '$1' has already exists. Please avoid repeat id since it Uniform block can only be used in glsl version es 300. ``` -- 警告原因:UBO(Uniform Block Object) 只能在 GLSL ES 300 版本的着色器脚本中使用。 -- 解决方案:如果需要使用 UBO,考虑换用 es 300 版本的着色器脚本。 +- 警告原因:UBO(Uniform Block Object) 只能在 GLSL ES 300 版本的着色器脚本中使用。 +- 解决方案:如果需要使用 UBO,考虑换用 es 300 版本的着色器脚本。 ## WARN CODE 25 @@ -213,8 +225,8 @@ Uniform block can only be used in glsl version es 300. Cannot activate weather since there's no weather with id of '$1'. ``` -- 警告原因:不能启用不存在的天气类型。 -- 解决方案:确保要启用的天气类型正确且存在,不存在则需要自行注册。 +- 警告原因:不能启用不存在的天气类型。 +- 解决方案:确保要启用的天气类型正确且存在,不存在则需要自行注册。 ## WARN CODE 26 @@ -222,8 +234,8 @@ Cannot activate weather since there's no weather with id of '$1'. Cannot set attribute when only element number specified. Use 'pointer' or 'pointerI' instead. ``` -- 警告原因:使用 `defineAttribute` 时指定了不存在的顶点属性类型。 -- 解决方案:如果需要传递数组,考虑使用 `defineAttribArray` 而不是 `defineAttribute`。 +- 警告原因:使用 `defineAttribute` 时指定了不存在的顶点属性类型。 +- 解决方案:如果需要传递数组,考虑使用 `defineAttribArray` 而不是 `defineAttribute`。 ## WARN CODE 27 @@ -231,7 +243,7 @@ Cannot set attribute when only element number specified. Use 'pointer' or 'point Cannot vertex attribute integer point when specified as float. Use 'set' or 'pointer' instead. ``` -- 遇不到这个报错 +- 遇不到这个报错 ## WARN CODE 28 @@ -239,8 +251,8 @@ Cannot vertex attribute integer point when specified as float. Use 'set' or 'poi Redefinition of shader $1: '$2' ``` -- 警告原因:定义了重复的着色器变量/顶点属性/UBO 等。 -- 解决方案:避免对同一个变量调用多次 `defineXxxx`。 +- 警告原因:定义了重复的着色器变量/顶点属性/UBO 等。 +- 解决方案:避免对同一个变量调用多次 `defineXxxx`。 ## WARN CODE 29 @@ -248,8 +260,8 @@ Redefinition of shader $1: '$2' Cannot define new texture since texture index is larger than max texture count. ``` -- 警告原因:定义的纹理数量超过了设备支持的上限。 -- 解决方案:考虑将多个纹理合并为同一个纹理作为图集,然后使用顶点属性或一致变量进行裁剪。 +- 警告原因:定义的纹理数量超过了设备支持的上限。 +- 解决方案:考虑将多个纹理合并为同一个纹理作为图集,然后使用顶点属性或一致变量进行裁剪。 ## WARN CODE 30 @@ -257,8 +269,8 @@ Cannot define new texture since texture index is larger than max texture count. Cannot use indices named $1 since no definition for it. Please define it in advance. ``` -- 警告原因:要作为顶点索引的索引数组不存在,因为没有定义。 -- 解决方案:提前定义索引数组。 +- 警告原因:要作为顶点索引的索引数组不存在,因为没有定义。 +- 解决方案:提前定义索引数组。 ## WARN CODE 31 @@ -266,8 +278,8 @@ Cannot use indices named $1 since no definition for it. Please define it in adva Cannot use indices since the indices instance is not belong to the program. ``` -- 警告原因:使用的顶点索引数组不属于当前着色器程序。 -- 解决方案:确保使用的顶点索引数组是由当前着色器程序创建的。 +- 警告原因:使用的顶点索引数组不属于当前着色器程序。 +- 解决方案:确保使用的顶点索引数组是由当前着色器程序创建的。 ## WARN CODE 32 @@ -275,8 +287,8 @@ Cannot use indices since the indices instance is not belong to the program. Sub-image exceeds texture dimensions, auto adjusting size. ``` -- 警告原因:使用 `IShaderTexture.sub` 时,传入的图像数据超出了纹理大小。 -- 解决方案:确保传入的图片不会超出纹理大小。如果需要修改纹理大小,请使用 `IShaderTexture.set` 方法。 +- 警告原因:使用 `IShaderTexture.sub` 时,传入的图像数据超出了纹理大小。 +- 解决方案:确保传入的图片不会超出纹理大小。如果需要修改纹理大小,请使用 `IShaderTexture.set` 方法。 ## WARN CODE 33 @@ -284,8 +296,7 @@ Sub-image exceeds texture dimensions, auto adjusting size. Cannot modify MotaOffscreenCanvas2D that is freezed. ``` -- 警告原因:不能修改已冻结的画布属性。 -- 解决方案:如果这个画布后续还需要修改属性,那么就不要冻结它。 +- 遇不到这个报错。 ## WARN CODE 34 @@ -293,8 +304,8 @@ Cannot modify MotaOffscreenCanvas2D that is freezed. Repeated render tag registration: '$1'. ``` -- 警告原因:注册了重复的渲染标签。 -- 解决方案:确保注册的渲染标签名称不重复。 +- 警告原因:注册了重复的渲染标签。 +- 解决方案:确保注册的渲染标签名称不重复。 ## WARN CODE 35 @@ -302,8 +313,8 @@ Repeated render tag registration: '$1'. Cannot append child on plain render item, please ensure you have overrided 'appendChild' method in your own element. ``` -- 警告原因:默认的渲染元素中,只有一部分可以添加子元素,而其他的不能添加。 -- 解决方案:不要在不能添加子元素的元素里面添加子元素。如果是自定义元素,请确保实现了 `appendChild` 方法。 +- 警告原因:默认的渲染元素中,只有一部分可以添加子元素,而其他的不能添加。 +- 解决方案:不要在不能添加子元素的元素里面添加子元素。如果是自定义元素,请确保实现了 `appendChild` 方法。 ## WARN CODE 36 @@ -311,8 +322,8 @@ Cannot append child on plain render item, please ensure you have overrided 'appe Cannot remove child on plain render item, please ensure you have overrided 'removeChild' method in your own element. ``` -- 警告原因:默认的渲染元素中,只有一部分可以移除子元素,而其他的不能移除。 -- 解决方案:不要在不能移除子元素的元素里面移除子元素。如果是自定义元素,请确保实现了 `removeChild` 方法。 +- 警告原因:默认的渲染元素中,只有一部分可以移除子元素,而其他的不能移除。 +- 解决方案:不要在不能移除子元素的元素里面移除子元素。如果是自定义元素,请确保实现了 `removeChild` 方法。 ## WARN CODE 37 @@ -320,8 +331,8 @@ Cannot remove child on plain render item, please ensure you have overrided 'remo Cannot execute 'requestSort' on plain render item, please ensure you have overrided 'requestSort' method in your own element. ``` -- 警告原因:默认的渲染元素中,只有一部分可以拥有排序功能,而其他的不能排序。 -- 解决方案:不要在不能拥有子元素的元素上调用 `requestSort`。如果是自定义元素,请确保实现了 `requestSort` 方法。 +- 警告原因:默认的渲染元素中,只有一部分可以拥有排序功能,而其他的不能排序。 +- 解决方案:不要在不能拥有子元素的元素上调用 `requestSort`。如果是自定义元素,请确保实现了 `requestSort` 方法。 ## WARN CODE 38 @@ -329,8 +340,8 @@ Cannot execute 'requestSort' on plain render item, please ensure you have overri Using plain text in jsx is strongly not recommended, since you can hardly modify its attributes. Consider using Text element instead. ``` -- 警告原因:在 JSX 中直接填写文字内容是极其不推荐的,因为你几乎不能修改它的任何属性。 -- 解决方案:考虑使用 `text` 标签替代。 +- 警告原因:在 JSX 中直接填写文字内容是极其不推荐的,因为你几乎不能修改它的任何属性。 +- 解决方案:考虑使用 `text` 标签替代。 ## WARN CODE 39 @@ -338,13 +349,13 @@ Using plain text in jsx is strongly not recommended, since you can hardly modify Plain text is not supported outside Text element. ``` -- 警告原因:不能在 `text` 元素外使用变量作为文字,例如: +- 警告原因:不能在 `text` 元素外使用变量作为文字,例如: ```tsx {text.value} ``` -- 解决方案:换用 `text` 标签。 +- 解决方案:换用 `text` 标签。 ## WARN CODE 40 @@ -352,7 +363,7 @@ Plain text is not supported outside Text element. Cannot return canvas that is not provided by this pool. ``` -- 遇不到这个报错。 +- 遇不到这个报错。 ## WARN CODE 41 @@ -360,8 +371,8 @@ Cannot return canvas that is not provided by this pool. Width of text content components must be positive. receive: $1 ``` -- 警告原因:`TextContent` 组件的宽度必须是正值,而你可能传入了一个负值或 0。 -- 解决方案:确保宽度属性是正值。 +- 警告原因:`TextContent` 组件的宽度必须是正值,而你可能传入了一个负值或 0。 +- 解决方案:确保宽度属性是正值。 ## WARN CODE 42 @@ -369,8 +380,8 @@ Width of text content components must be positive. receive: $1 Repeated Textbox id: '$1'. ``` -- 警告原因:`Textbox` 组件使用了重复的 id。 -- 解决方案:避免 `Textbox` 组件的 id 重复。 +- 警告原因:`Textbox` 组件使用了重复的 id。 +- 解决方案:避免 `Textbox` 组件的 id 重复。 ## WARN CODE 43 @@ -378,8 +389,8 @@ Repeated Textbox id: '$1'. Cannot set icon of '$1', since it does not exists. Please ensure you have delivered correct icon id or number. ``` -- 警告原因:向 `icon` 元素中传入了不存在的图标。 -- 解决方案:确保传入的图标 id 或数字是正确的。 +- 警告原因:向 `icon` 元素中传入了不存在的图标。 +- 解决方案:确保传入的图标 id 或数字是正确的。 ## WARN CODE 44 @@ -387,8 +398,8 @@ Cannot set icon of '$1', since it does not exists. Please ensure you have delive Unexpected end when loading stream audio, reason: '$1' ``` -- 警告原因:加载流式音频时被意外中断。 -- 解决方案:根据原因解决。 +- 警告原因:加载流式音频时被意外中断。 +- 解决方案:根据原因解决。 ## WARN CODE 45 @@ -396,8 +407,8 @@ Unexpected end when loading stream audio, reason: '$1' Audio route with id of '$1' has already existed. New route will override old route. ``` -- 警告原因:id 为 $1 的音频路由已经存在,新的路由将会覆盖旧路由。 -- 解决方案:确保音频路由不会重复。 +- 警告原因:id 为 $1 的音频路由已经存在,新的路由将会覆盖旧路由。 +- 解决方案:确保音频路由不会重复。 ## WARN CODE 46 @@ -405,8 +416,8 @@ Audio route with id of '$1' has already existed. New route will override old rou Cannot pipe new StreamReader object when stream is loading. ``` -- 警告原因:在流式加载过程中无法将流加载对象泵入其他对象。 -- 解决方案:在流式加载前就执行 `pipe` 方法。 +- 警告原因:在流式加载过程中无法将流加载对象泵入其他对象。 +- 解决方案:在流式加载前就执行 `pipe` 方法。 ## WARN CODE 47 @@ -414,8 +425,8 @@ Cannot pipe new StreamReader object when stream is loading. Audio stream decoder for audio type '$1' has already existed. ``` -- 警告原因:$1 类型的音频解码器已经存在。 -- 解决方案:不要为同一种类型的音频注册多种解码器。 +- 警告原因:$1 类型的音频解码器已经存在。 +- 解决方案:不要为同一种类型的音频注册多种解码器。 ## WARN CODE 48 @@ -423,8 +434,8 @@ Audio stream decoder for audio type '$1' has already existed. Sample rate in stream audio must be constant. ``` -- 警告原因:流式音频中,音频的采样率应该保持一致。 -- 解决方案:确保音频的采样率不会改变,如果会的话,请换一个音频。 +- 警告原因:流式音频中,音频的采样率应该保持一致。 +- 解决方案:确保音频的采样率不会改变,如果会的话,请换一个音频。 ## WARN CODE 49 @@ -432,8 +443,8 @@ Sample rate in stream audio must be constant. Repeated patch for '$1', key: '$2'. ``` -- 警告原因:对同一个 2.x 样板接口重写了两次。 -- 解决方案:将两次重写合并为一次。 +- 警告原因:对同一个 2.x 样板接口重写了两次。 +- 解决方案:将两次重写合并为一次。 ## WARN CODE 50 @@ -441,5 +452,5 @@ Repeated patch for '$1', key: '$2'. Unknown audio extension name: '$1' ``` -- 警告原因:未知的文件拓展名 $1。 -- 解决方案:换一个类型的音频。 +- 警告原因:未知的文件拓展名 $1。 +- 解决方案:换一个类型的音频。 diff --git a/docs/logger/warn/warn2.md b/docs/logger/warn/warn2.md index b1bf500..6ec0d2c 100644 --- a/docs/logger/warn/warn2.md +++ b/docs/logger/warn/warn2.md @@ -6,8 +6,8 @@ Cannot decode sound '$1', since audio file may not supported by 2.b. ``` -- 警告原因:不能解码音效 $1,可能因为文件类型不支持。 -- 解决方案:换一个音乐文件格式,建议使用 `opus` 格式。 +- 警告原因:不能解码音效 $1,可能因为文件类型不支持。 +- 解决方案:换一个音乐文件格式,建议使用 `opus` 格式。 ## WARN CODE 52 @@ -15,8 +15,8 @@ Cannot decode sound '$1', since audio file may not supported by 2.b. Cannot play sound '$1', since there is no added data named it. ``` -- 警告原因:播放了不存在的音效。 -- 解决方案:确保要播放音效名称正确。 +- 警告原因:播放了不存在的音效。 +- 解决方案:确保要播放音效名称正确。 ## WARN CODE 53 @@ -24,8 +24,8 @@ Cannot play sound '$1', since there is no added data named it. Cannot $1 audio route '$2', since there is not added route named it. ``` -- 警告原因:不能对 $2 路由执行 $1(播放、暂停等)操作,因为没有名字叫这个的音频路由。 -- 解决方案:确保要操作的路由存在。 +- 警告原因:不能对 $2 路由执行 $1(播放、暂停等)操作,因为没有名字叫这个的音频路由。 +- 解决方案:确保要操作的路由存在。 ## WARN CODE 54 @@ -33,8 +33,8 @@ Cannot $1 audio route '$2', since there is not added route named it. Missing start tag for '$1', index: $2. ``` -- 警告原因:在 `TextContent` 组件中,匹配不到转义字符 $1 的起始位置。 -- 解决方案:确保每个转义字符包含起始标签。 +- 警告原因:在 `TextContent` 组件中,匹配不到转义字符 $1 的起始位置。 +- 解决方案:确保每个转义字符包含起始标签。 ## WARN CODE 55 @@ -42,8 +42,8 @@ Missing start tag for '$1', index: $2. Unchildable tag '$1' should follow with param. ``` -- 警告原因:在 `TextContent` 组件中,没有子标签的转义字符(`\i`)后面必须跟着参数。 -- 解决方案:确保 `\i` 后面紧跟着图标名称,例如 `\i[greenSlime]`。 +- 警告原因:在 `TextContent` 组件中,没有子标签的转义字符(`\i`)后面必须跟着参数。 +- 解决方案:确保 `\i` 后面紧跟着图标名称,例如 `\i[greenSlime]`。 ## WARN CODE 56 @@ -51,8 +51,8 @@ Unchildable tag '$1' should follow with param. Method '$1' has been deprecated. Consider using '$2' instead. ``` -- 警告原因:接口 $1 已经弃用。 -- 解决方案:考虑换为 $2。 +- 警告原因:接口 $1 已经弃用。 +- 解决方案:考虑换为 $2。 ## WARN CODE 57 @@ -60,8 +60,8 @@ Method '$1' has been deprecated. Consider using '$2' instead. Repeated UI controller id '$1'. ``` -- 警告原因:重复的 UI 控制器 id。 -- 解决方案:避免 UI 控制器的 id 重复。 +- 警告原因:重复的 UI 控制器 id。 +- 解决方案:避免 UI 控制器的 id 重复。 ## WARN CODE 58 @@ -69,8 +69,8 @@ Repeated UI controller id '$1'. Fail to set ellipse round rect, since length of 'ellipse' property should only be 2, 4, 6 or 8. delivered: $1 ``` -- 警告原因:椭圆模式的圆角矩形传入的参数数组需要是 2,4,6,8 长度,而传入了 $1 长度的数组。 -- 解决方案:确保传入参数正确。 +- 警告原因:椭圆模式的圆角矩形传入的参数数组需要是 2,4,6,8 长度,而传入了 $1 长度的数组。 +- 解决方案:确保传入参数正确。 ## WARN CODE 59 @@ -78,8 +78,8 @@ Fail to set ellipse round rect, since length of 'ellipse' property should only b Unknown icon '$1' in parsing text content. ``` -- 警告原因:在 `TextContent` 中出现了未知的图标。 -- 解决方案:确保 `\i` 后的图标参数正确。 +- 警告原因:在 `TextContent` 中出现了未知的图标。 +- 解决方案:确保 `\i` 后的图标参数正确。 ## WARN CODE 60 @@ -87,8 +87,8 @@ Unknown icon '$1' in parsing text content. Repeated Tip id: '$1'. ``` -- 警告原因:`Tip` 组件的 id 重复。 -- 解决方案:避免 id 重复。 +- 警告原因:`Tip` 组件的 id 重复。 +- 解决方案:避免 id 重复。 ## WARN CODE 61 @@ -96,8 +96,8 @@ Repeated Tip id: '$1'. Unexpected recursive call of $1.update?$2 in render function. Please ensure you have to do this, if you do, ignore this warn. ``` -- 警告原因:在渲染元素的渲染函数中出现了递归 `update` 调用,这会导致元素一直更新而且难以察觉,同时也会引起性能问题。 -- 解决方案:避免在渲染函数中调用 `update` 方法。如果你必须这么做,请忽视这个警告。 +- 警告原因:在渲染元素的渲染函数中出现了递归 `update` 调用,这会导致元素一直更新而且难以察觉,同时也会引起性能问题。 +- 解决方案:避免在渲染函数中调用 `update` 方法。如果你必须这么做,请忽视这个警告。 ## WARN CODE 62 @@ -105,8 +105,8 @@ Unexpected recursive call of $1.update?$2 in render function. Please ensure you Recursive fallback fonts in '$1'. ``` -- 警告原因:字体回退出现了循环。例如 `font1` -> `font2` -> `font1`。 -- 解决方案:避免出现循环字体回退。 +- 警告原因:字体回退出现了循环。例如 `font1` -> `font2` -> `font1`。 +- 解决方案:避免出现循环字体回退。 ## WARN CODE 63 @@ -114,5 +114,23 @@ Recursive fallback fonts in '$1'. Uncaught promise error in waiting box component. Error reason: $1 ``` -- 警告原因:在等待 box 组件(选择框、确认框等)时,出现了异步报错。 -- 解决方案:根据报错内容解决问题。 +- 警告原因:在等待 box 组件(选择框、确认框等)时,出现了异步报错。 +- 解决方案:根据报错内容解决问题。 + +## WARN CODE 64 + +```txt +Text node type and block type mismatch: '$1' vs '$2' +``` + +- 警告原因:多行文本(TextContent)解析时节点类型和分块类型不一致。 +- 解决方案:理应不会遇到这个问题,如果遇到了,请到造塔群寻求帮助。 + +## WARN CODE 65 + +```txt +Cannot bind a weather controller twice. +``` + +- 警告原因:一个天气控制器不能绑定到两个元素上。 +- 解决方案:如果两个元素需要天气,那么请创建两个天气控制器,一个天气控制器只能绑定一个,且不能解绑。 diff --git a/packages/common/src/logger.json b/packages/common/src/logger.json index a45a561..73f3e08 100644 --- a/packages/common/src/logger.json +++ b/packages/common/src/logger.json @@ -26,10 +26,7 @@ "24": "Cannot decode source type of '$1', since there is no registered decoder for that type.", "25": "Unknown audio type. Header: '$1'", "26": "Uncaught error when fetching stream data from '$1'. Error info: $2.", - "1101": "Shadow extension needs 'floor-hero' extension as dependency.", - "1201": "Floor-damage extension needs 'floor-binder' extension as dependency.", - "1301": "Portal extension need 'floor-binder' extension as dependency.", - "1401": "Halo extension needs 'floor-binder' extension as dependency." + "1201": "Floor-damage extension needs 'floor-binder' extension as dependency." }, "warn": { "1": "Resource with type of 'none' is loaded.", @@ -97,7 +94,6 @@ "63": "Uncaught promise error in waiting box component. Error reason: $1", "64": "Text node type and block type mismatch: '$1' vs '$2'", "65": "Cannot bind a weather controller twice.", - "1001": "Item-detail extension needs 'floor-binder' and 'floor-damage' extension as dependency.", - "1101": "Cannot add new effect to point effect instance, for there's no more reserve space for it. Please increase the max count of the instance." + "1001": "Item-detail extension needs 'floor-binder' and 'floor-damage' extension as dependency." } }