HumanBreak/docs/logger/warn/warn1.md

警告代码一览及其解决方案 1-50

WARN CODE 1

Resource with type of 'none' is loaded.

• 警告原因：不能加载 none 类型的资源。
• 解决方案：加载资源时填写资源类型。

WARN CODE 2

Repeat load of resource '$1/$2'.

• 警告原因：同一个资源被加载了两次。
• 解决方案：避免对同一个资源调用两次加载。

WARN CODE 3

Unknown danmaku tag: $1

• 警告原因：出现了未知的弹幕标签（指 [xxx:xxx]）
• 解决方案：目前仅支持 [i:xxx] 标签，如果需要显示方括号，请使用 \[\]。

WARN CODE 4

Ignored a mismatched ']' in danmaku.

• 警告原因：出现了不能匹配的右方括号。
• 解决方案：如果需要显示方括号，请使用 \[\]。

WARN CODE 5

Repeat post danmaku.

• 警告原因：同一个弹幕被发送了两次。
• 解决方案：确保一个弹幕实例只调用了一次 post 方法。

WARN CODE 6

Registered special danmaku element: $1.

• 警告原因：要注册的弹幕标签已经存在。
• 解决方案：避免使用同一个标签名，如果内容不一样请换一个标签名。

WARN CODE 7

参考 CODE 3

WARN CODE 8

Incomplete render data is put. None will be filled to the lacked data.

• 警告原因：使用 <layer> 标签时，向地图渲染传入了不完整的地图信息（数据长度不是指定宽度的倍数），不完整的部分将会补零。
• 解决方案：确保传入的地图信息长度是 width 参数的倍数。

WARN CODE 9

Data transfered is partially (or totally) out of range. Overflowed data will be ignored.

• 警告原因：使用 <layer> 标签时，传入地图的渲染数据有一部分（或全部都）在地图之外，在地图之外的部分将会被忽略。
• 解决方案：确保传入的地图信息没有在地图之外的部分。

WARN CODE 10

Cannot resolve big image of enemy '$1'.

• 警告原因：无法解析怪物 $1 的大怪物贴图（绑定贴图），可能是因为图片不存在。
• 解决方案：确保此怪物绑定的贴图已经在全塔属性注册。

WARN CODE 11

Cannot resolve material $1. Material not exists.

• 警告原因：不能解析指定类型 $1 的素材，因为对应的素材文件不存在。
• 解决方案：检查 enemys.png npcs.png 等素材文件是否存在。

WARN CODE 12

Cannot mark buffable with a non-number status. Key: '$1'.

• 暂时碰不到这个报错。

WARN CODE 13

Cannot set buff of non-number status. Key: '$1'.

• 暂时碰不到这个报错。

WARN CODE 14

Cannot add status of non-number status. Key: '$1'.

• 暂时碰不到这个报错。

WARN CODE 15

Cannot get item of a non-item block on loc: $1,$2,$3.

• 警告原因：不能获取一个不存在物品的图块上的物品对象。
• 解决方案：提前判断那一格是不是物品，或确保要获取的格子包含物品。

WARN CODE 16

Override repeated state key: '$1'.

• 暂时碰不到这个报错。

WARN CODE 17

Floor-damage extension needs 'floor-binder' extension as dependency.

• 警告原因：楼层伤害拓展需要以楼层绑定拓展作为依赖。
• 解决方案：确保添加伤害拓展时也添加了楼层绑定拓展。

WARN CODE 18

Uncaught error in posting like info for danmaku. Danmaku id: $1.

• 警告原因：为弹幕点赞时出现报错。
• 解决方案：可能是网络问题，检查网络。

WARN CODE 19

Repeat light id: '$1'

• 警告原因：重复的光源 id。
• 解决方案：避免光源 id 出现重复。

WARN CODE 20

Cannot apply animation to camera operation that does not belong to it.

• 警告原因：不能向摄像机对象添加不属于它的动画操作。
• 解决方案：确保添加的动画操作是由这个摄像机对象创建的。

WARN CODE 21

Cannot apply transition to camera operation that does not belong to it.

• 警告原因：不能向摄像机对象添加不属于它的渐变操作。
• 解决方案：确保添加的渐变操作是由这个摄像机对象创建的。

WARN CODE 22

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 方法，或先禁用已激活的摄像机，再使用当前摄像机

WARN CODE 23

Render item with id of '$1' has already exists. Please avoid repeat id since it may cause issues when use 'getElementById'.

• 警告原因：两个渲染元素的 id 出现了重复，这会导致调用 getElementById 时出现问题。
• 解决方案：避免出现重复的 id。

WARN CODE 24

Uniform block can only be used in glsl version es 300.

• 警告原因：UBO(Uniform Block Object) 只能在 GLSL ES 300 版本的着色器脚本中使用。
• 解决方案：如果需要使用 UBO，考虑换用 es 300 版本的着色器脚本。

WARN CODE 25

Cannot activate weather since there's no weather with id of '$1'.

• 警告原因：不能启用不存在的天气类型。
• 解决方案：确保要启用的天气类型正确且存在，不存在则需要自行注册。

WARN CODE 26

Cannot set attribute when only element number specified. Use 'pointer' or 'pointerI' instead.

• 警告原因：使用 defineAttribute 时指定了不存在的顶点属性类型。
• 解决方案：如果需要传递数组，考虑使用 defineAttribArray 而不是 defineAttribute。

WARN CODE 27

Cannot vertex attribute integer point when specified as float. Use 'set' or 'pointer' instead.

• 遇不到这个报错

WARN CODE 28

Redefinition of shader $1: '$2'

• 警告原因：定义了重复的着色器变量/顶点属性/UBO 等。
• 解决方案：避免对同一个变量调用多次 defineXxxx。

WARN CODE 29

Cannot define new texture since texture index is larger than max texture count.

• 警告原因：定义的纹理数量超过了设备支持的上限。
• 解决方案：考虑将多个纹理合并为同一个纹理作为图集，然后使用顶点属性或一致变量进行裁剪。

WARN CODE 30

Cannot use indices named $1 since no definition for it. Please define it in advance.

• 警告原因：要作为顶点索引的索引数组不存在，因为没有定义。
• 解决方案：提前定义索引数组。

WARN CODE 31

Cannot use indices since the indices instance is not belong to the program.

• 警告原因：使用的顶点索引数组不属于当前着色器程序。
• 解决方案：确保使用的顶点索引数组是由当前着色器程序创建的。

WARN CODE 32

Sub-image exceeds texture dimensions, auto adjusting size.

• 警告原因：使用 IShaderTexture.sub 时，传入的图像数据超出了纹理大小。
• 解决方案：确保传入的图片不会超出纹理大小。如果需要修改纹理大小，请使用 IShaderTexture.set 方法。

WARN CODE 33

Cannot modify MotaOffscreenCanvas2D that is freezed.

• 警告原因：不能修改已冻结的画布属性。
• 解决方案：如果这个画布后续还需要修改属性，那么就不要冻结它。

WARN CODE 34

Repeated render tag registration: '$1'.

• 警告原因：注册了重复的渲染标签。
• 解决方案：确保注册的渲染标签名称不重复。

WARN CODE 35

Cannot append child on plain render item, please ensure you have overrided 'appendChild' method in your own element.

• 警告原因：默认的渲染元素中，只有一部分可以添加子元素，而其他的不能添加。
• 解决方案：不要在不能添加子元素的元素里面添加子元素。如果是自定义元素，请确保实现了 appendChild 方法。

WARN CODE 36

Cannot remove child on plain render item, please ensure you have overrided 'removeChild' method in your own element.

• 警告原因：默认的渲染元素中，只有一部分可以移除子元素，而其他的不能移除。
• 解决方案：不要在不能移除子元素的元素里面移除子元素。如果是自定义元素，请确保实现了 removeChild 方法。

WARN CODE 37

Cannot execute 'requestSort' on plain render item, please ensure you have overrided 'requestSort' method in your own element.

• 警告原因：默认的渲染元素中，只有一部分可以拥有排序功能，而其他的不能排序。
• 解决方案：不要在不能拥有子元素的元素上调用 requestSort。如果是自定义元素，请确保实现了 requestSort 方法。

WARN CODE 38

Using plain text in jsx is strongly not recommended, since you can hardly modify its attributes. Consider using Text element instead.

• 警告原因：在 JSX 中直接填写文字内容是极其不推荐的，因为你几乎不能修改它的任何属性。
• 解决方案：考虑使用 text 标签替代。

WARN CODE 39

Plain text is not supported outside Text element.

• 警告原因：不能在 text 元素外使用变量作为文字，例如：

<container>{text.value}</container>

• 解决方案：换用 text 标签。

WARN CODE 40

Cannot return canvas that is not provided by this pool.

• 遇不到这个报错。

WARN CODE 41

Width of text content components must be positive. receive: $1

• 警告原因：TextContent 组件的宽度必须是正值，而你可能传入了一个负值或 0。
• 解决方案：确保宽度属性是正值。

WARN CODE 42

Repeated Textbox id: '$1'.

• 警告原因：Textbox 组件使用了重复的 id。
• 解决方案：避免 Textbox 组件的 id 重复。

WARN CODE 43

Cannot set icon of '$1', since it does not exists. Please ensure you have delivered correct icon id or number.

• 警告原因：向 icon 元素中传入了不存在的图标。
• 解决方案：确保传入的图标 id 或数字是正确的。

WARN CODE 44

Unexpected end when loading stream audio, reason: '$1'

• 警告原因：加载流式音频时被意外中断。
• 解决方案：根据原因解决。

WARN CODE 45

Audio route with id of '$1' has already existed. New route will override old route.

• 警告原因：id 为 $1 的音频路由已经存在，新的路由将会覆盖旧路由。
• 解决方案：确保音频路由不会重复。

WARN CODE 46

Cannot pipe new StreamReader object when stream is loading.

• 警告原因：在流式加载过程中无法将流加载对象泵入其他对象。
• 解决方案：在流式加载前就执行 pipe 方法。

WARN CODE 47

Audio stream decoder for audio type '$1' has already existed.

• 警告原因：$1 类型的音频解码器已经存在。
• 解决方案：不要为同一种类型的音频注册多种解码器。

WARN CODE 48

Sample rate in stream audio must be constant.

• 警告原因：流式音频中，音频的采样率应该保持一致。
• 解决方案：确保音频的采样率不会改变，如果会的话，请换一个音频。

WARN CODE 49

Repeated patch for '$1', key: '$2'.

• 警告原因：对同一个 2.x 样板接口重写了两次。
• 解决方案：将两次重写合并为一次。

WARN CODE 50

Unknown audio extension name: '$1'

• 警告原因：未知的文件拓展名 $1。
• 解决方案：换一个类型的音频。