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

## WARN CODE 1

```txt
Resource with type of 'none' is loaded.
```

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

## WARN CODE 2

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

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

## WARN CODE 3

```txt
Unknown danmaku tag: $1
```

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

## WARN CODE 4

```txt
Ignored a mismatched ']' in danmaku.
```

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

## WARN CODE 5

```txt
Repeat post danmaku.
```

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

## WARN CODE 6

```txt
Registered special danmaku element: $1.
```

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

## WARN CODE 7

参考 [CODE 3](#warn-code-3)

## WARN CODE 8

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

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

## WARN CODE 9

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

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

## WARN CODE 10

```txt
Cannot resolve big image of enemy '$1'.
```

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

## WARN CODE 11

```txt
Cannot resolve material $1. Material not exists.
```

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

## WARN CODE 12

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

-   暂时碰不到这个报错。

## WARN CODE 13

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

-   暂时碰不到这个报错。

## WARN CODE 14

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

-   暂时碰不到这个报错。

## WARN CODE 15

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

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

## WARN CODE 16

```txt
Override repeated state key: '$1'.
```

-   暂时碰不到这个报错。

## WARN CODE 17

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

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

## WARN CODE 18

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

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

## WARN CODE 19

```txt
Repeat light id: '$1'
```

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

## WARN CODE 20

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

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

## WARN CODE 21

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

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

## WARN CODE 22

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

## WARN CODE 23

```txt
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

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

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

## WARN CODE 25

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

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

## WARN CODE 26

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

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

## WARN CODE 27

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

-   遇不到这个报错

## WARN CODE 28

```txt
Redefinition of shader $1: '$2'
```

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

## WARN CODE 29

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

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

## WARN CODE 30

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

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

## WARN CODE 31

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

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

## WARN CODE 32

```txt
Sub-image exceeds texture dimensions, auto adjusting size.
```

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

## WARN CODE 33

```txt
Cannot modify MotaOffscreenCanvas2D that is freezed.
```

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

## WARN CODE 34

```txt
Repeated render tag registration: '$1'.
```

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

## WARN CODE 35

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

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

## WARN CODE 36

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

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

## WARN CODE 37

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

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

## WARN CODE 38

```txt
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

```txt
Plain text is not supported outside Text element.
```

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

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

-   解决方案：换用 `text` 标签。

## WARN CODE 40

```txt
Cannot return canvas that is not provided by this pool.
```

-   遇不到这个报错。

## WARN CODE 41

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

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

## WARN CODE 42

```txt
Repeated Textbox id: '$1'.
```

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

## WARN CODE 43

```txt
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

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

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

## WARN CODE 45

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

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

## WARN CODE 46

```txt
Cannot pipe new StreamReader object when stream is loading.
```

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

## WARN CODE 47

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

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

## WARN CODE 48

```txt
Sample rate in stream audio must be constant.
```

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

## WARN CODE 49

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

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

## WARN CODE 50

```txt
Unknown audio extension name: '$1'
```

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