unity-ui

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Unity UI Skills

Unity UI 技能

BATCH-FIRST: Use
ui_create_batch
when creating 2+ UI elements.

优先批量操作：创建2个及以上UI元素时使用
ui_create_batch
。

Guardrails

使用规范

Mode: Full-Auto required

DO NOT (common hallucinations):

```
ui_create_canvas
```
is the correct name — NOT
```
ui_add_canvas
```
```
ui_create_label
```
does not exist → use
```
ui_create_text
```
```
ui_create_checkbox
```
does not exist → use
```
ui_create_toggle
```
```
ui_set_color
```
does not exist → use
```
component_set_property
```
on Image/Text component
Do not confuse UGUI (this module) with UI Toolkit (uitoolkit module)

Routing:

For UI Toolkit (UXML/USS) → use
```
uitoolkit
```
module
For XR-compatible UI → use
```
xr
```
module's
```
xr_setup_ui_canvas
```
to convert Canvas to World Space
For text updates →
```
ui_set_text
```
(this module)

For layout arrangement →

ui_layout_children

ui_align_selected

ui_distribute_selected

模式要求：必须使用全自动模式

禁止操作（常见的错误生成内容）：

正确的方法名是
```
ui_create_canvas
```
，不是
```
ui_add_canvas
```
不存在
```
ui_create_label
```
方法，请使用
```
ui_create_text
```
不存在
```
ui_create_checkbox
```
方法，请使用
```
ui_create_toggle
```
不存在
```
ui_set_color
```
方法，请针对Image/Text组件使用
```
component_set_property
```
修改颜色
不要混淆UGUI（本模块）和UI Toolkit（uitoolkit模块）

路由规则：

若使用UI Toolkit（UXML/USS）→ 请使用
```
uitoolkit
```
模块
若需要XR兼容的UI → 请使用
```
xr
```
模块的
```
xr_setup_ui_canvas
```
将Canvas转换为世界空间模式
若需要更新文本内容 → 请使用本模块的
```
ui_set_text
```

若需要布局排列 → 请使用

ui_layout_children

、

ui_align_selected

、

ui_distribute_selected

Skills Overview

技能概览

Single Object	Batch Version	Use Batch When
`ui_create_*`	`ui_create_batch`	Creating 2+ UI elements

Query/Utility Skills:

```
ui_set_text
```
- Update text content
```
ui_find_all
```
- Find UI elements
```
ui_set_rect
```
- Set RectTransform size/position
```
ui_set_anchor
```
- Set anchor preset
```
ui_layout_children
```
- Arrange children in layout
```
ui_align_selected
```
- Align selected elements
```
ui_distribute_selected
```
- Distribute selected elements
```
ui_set_image
```
- Set Image properties (type/fill/sprite)
```
ui_add_layout_element
```
- Add/configure LayoutElement
```
ui_add_canvas_group
```
- Add/configure CanvasGroup
```
ui_add_mask
```
- Add Mask or RectMask2D
```
ui_add_outline
```
- Add Shadow/Outline effect
```
ui_configure_selectable
```
- Configure Selectable colors/transition/navigation

单对象方法	批量版本	适用场景
`ui_create_*`	`ui_create_batch`	创建2个及以上UI元素

查询/工具类技能：

```
ui_set_text
```
- 更新文本内容
```
ui_find_all
```
- 查找UI元素
```
ui_set_rect
```
- 设置RectTransform的尺寸/位置
```
ui_set_anchor
```
- 设置锚点预设
```
ui_layout_children
```
- 按布局排列子元素
```
ui_align_selected
```
- 对齐选中的元素
```
ui_distribute_selected
```
- 均匀分布选中的元素
```
ui_set_image
```
- 设置Image属性（类型/填充/精灵图）
```
ui_add_layout_element
```
- 添加/配置LayoutElement
```
ui_add_canvas_group
```
- 添加/配置CanvasGroup
```
ui_add_mask
```
- 添加Mask或RectMask2D
```
ui_add_outline
```
- 添加阴影/描边效果
```
ui_configure_selectable
```
- 配置可交互组件的颜色/过渡/导航规则

Single-Object Skills

单对象操作技能

ui_create_canvas

Create a UI Canvas container.

Parameter	Type	Required	Default	Description
`name`	string	No	"Canvas"	Canvas name
`renderMode`	string	No	"ScreenSpaceOverlay"	ScreenSpaceOverlay/ScreenSpaceCamera/WorldSpace

创建UI Canvas容器。

参数	类型	必填	默认值	描述
`name`	string	否	"Canvas"	Canvas名称
`renderMode`	string	否	"ScreenSpaceOverlay"	渲染模式：ScreenSpaceOverlay/ScreenSpaceCamera/WorldSpace

ui_create_panel

Create a Panel container.

Parameter	Type	Required	Default	Description
`name`	string	No	"Panel"	Panel name
`parent`	string	No	null	Parent Canvas/object
`r/g/b/a`	float	No	1,1,1,0.5	Background color
`width/height`	float	No	200	Size in pixels

创建Panel容器。

参数	类型	必填	默认值	描述
`name`	string	否	"Panel"	Panel名称
`parent`	string	否	null	父级Canvas/对象
`r/g/b/a`	float	否	1,1,1,0.5	背景颜色
`width/height`	float	否	200	尺寸（单位：像素）

ui_create_button

Create a Button.

Parameter	Type	Required	Default	Description
`name`	string	No	"Button"	Button name
`parent`	string	No	null	Parent object
`text`	string	No	"Button"	Button label
`width/height`	float	No	160/30	Size
`x/y`	float	No	0	Position offset

创建Button。

参数	类型	必填	默认值	描述
`name`	string	否	"Button"	Button名称
`parent`	string	否	null	父级对象
`text`	string	否	"Button"	Button标签文本
`width/height`	float	否	160/30	尺寸
`x/y`	float	否	0	位置偏移

ui_create_text

Create a Text element.

Parameter	Type	Required	Default	Description
`name`	string	No	"Text"	Text name
`parent`	string	No	null	Parent object
`text`	string	No	"Text"	Content
`fontSize`	int	No	24	Font size
`r/g/b/a`	float	No	0,0,0,1	Text color
`width/height`	float	No	200/50	Size

创建Text元素。

参数	类型	必填	默认值	描述
`name`	string	否	"Text"	Text元素名称
`parent`	string	否	null	父级对象
`text`	string	否	"Text"	文本内容
`fontSize`	int	否	24	字体大小
`r/g/b/a`	float	否	0,0,0,1	文本颜色
`width/height`	float	否	200/50	尺寸

ui_create_image

Create an Image element.

Parameter	Type	Required	Default	Description
`name`	string	No	"Image"	Image name
`parent`	string	No	null	Parent object
`spritePath`	string	No	null	Sprite asset path
`r/g/b/a`	float	No	1,1,1,1	Tint color
`width/height`	float	No	100	Size

创建Image元素。

参数	类型	必填	默认值	描述
`name`	string	否	"Image"	Image元素名称
`parent`	string	否	null	父级对象
`spritePath`	string	否	null	精灵图资源路径
`r/g/b/a`	float	否	1,1,1,1	着色颜色
`width/height`	float	否	100	尺寸

ui_create_inputfield

Create an InputField.

Parameter	Type	Required	Default	Description
`name`	string	No	"InputField"	Field name
`parent`	string	No	null	Parent object
`placeholder`	string	No	"Enter text..."	Placeholder
`width/height`	float	No	200/30	Size

创建InputField。

参数	类型	必填	默认值	描述
`name`	string	否	"InputField"	输入框名称
`parent`	string	否	null	父级对象
`placeholder`	string	否	"Enter text..."	占位提示文本
`width/height`	float	否	200/30	尺寸

ui_create_slider

Create a Slider.

Parameter	Type	Required	Default	Description
`name`	string	No	"Slider"	Slider name
`parent`	string	No	null	Parent object
`minValue`	float	No	0	Minimum value
`maxValue`	float	No	1	Maximum value
`value`	float	No	0.5	Initial value
`width/height`	float	No	160/20	Size

创建Slider。

参数	类型	必填	默认值	描述
`name`	string	否	"Slider"	滑块名称
`parent`	string	否	null	父级对象
`minValue`	float	否	0	最小值
`maxValue`	float	否	1	最大值
`value`	float	否	0.5	初始值
`width/height`	float	否	160/20	尺寸

ui_create_toggle

Create a Toggle/Checkbox.

Parameter	Type	Required	Default	Description
`name`	string	No	"Toggle"	Toggle name
`parent`	string	No	null	Parent object
`label`	string	No	"Toggle"	Label text
`isOn`	bool	No	false	Initial state

创建Toggle/Checkbox。

参数	类型	必填	默认值	描述
`name`	string	否	"Toggle"	开关名称
`parent`	string	否	null	父级对象
`label`	string	否	"Toggle"	标签文本
`isOn`	bool	否	false	初始状态

ui_set_text

Update text content.

Parameter	Type	Required	Description
`name`	string	Yes	Text object name
`text`	string	Yes	New content

更新文本内容。

参数	类型	必填	描述
`name`	string	是	Text对象名称
`text`	string	是	新的文本内容

ui_find_all

Find UI elements in scene.

Parameter	Type	Required	Default	Description
`uiType`	string	No	null	Filter: Button/Text/Image/etc.
`limit`	int	No	100	Max results

查找场景中的UI元素。

参数	类型	必填	默认值	描述
`uiType`	string	否	null	过滤条件：Button/Text/Image等
`limit`	int	否	100	最大返回结果数

ui_set_rect

Set RectTransform size, position, and padding.

Parameter	Type	Required	Description
`name`	string	No*	UI element name
`instanceId`	int	No*	Instance ID
`width` , `height`	float	No	Size
`x` , `y`	float	No	Position
`left` , `right` , `top` , `bottom`	float	No	Padding offsets

设置RectTransform的尺寸、位置和内边距。

参数	类型	必填	描述
`name`	string	否*	UI元素名称
`instanceId`	int	否*	实例ID
`width` , `height`	float	否	尺寸
`x` , `y`	float	否	位置
`left` , `right` , `top` , `bottom`	float	否	内边距偏移

ui_set_anchor

Set anchor preset for a UI element.

Parameter	Type	Required	Default	Description
`name`	string	No*	-	UI element name
`instanceId`	int	No*	-	Instance ID
`preset`	string	No	"MiddleCenter"	Anchor preset
`setPivot`	bool	No	true	Also set pivot

Presets: TopLeft, TopCenter, TopRight, MiddleLeft, MiddleCenter, MiddleRight, BottomLeft, BottomCenter, BottomRight, StretchHorizontal, StretchVertical, StretchAll

为UI元素设置锚点预设。

参数	类型	必填	默认值	描述
`name`	string	否*	-	UI元素名称
`instanceId`	int	否*	-	实例ID
`preset`	string	否	"MiddleCenter"	锚点预设
`setPivot`	bool	否	true	同时设置枢轴点

预设值：TopLeft、TopCenter、TopRight、MiddleLeft、MiddleCenter、MiddleRight、BottomLeft、BottomCenter、BottomRight、StretchHorizontal、StretchVertical、StretchAll

ui_layout_children

Arrange child UI elements in a layout.

Parameter	Type	Required	Default	Description
`name`	string	No*	-	Parent element name
`instanceId`	int	No*	-	Instance ID
`layout`	string	No	"Vertical"	Layout type
`spacing`	float	No	10	Spacing between elements

Layout types: Vertical, Horizontal, Grid

按布局排列子UI元素。

参数	类型	必填	默认值	描述
`name`	string	否*	-	父元素名称
`instanceId`	int	否*	-	实例ID
`layout`	string	否	"Vertical"	布局类型
`spacing`	float	否	10	元素间距

布局类型：Vertical、Horizontal、Grid

ui_align_selected

Align selected UI elements.

Parameter	Type	Required	Default	Description
`alignment`	string	No	"Center"	Alignment type

Alignments: Left, Center, Right, Top, Middle, Bottom

对齐选中的UI元素。

参数	类型	必填	默认值	描述
`alignment`	string	否	"Center"	对齐类型

对齐选项：Left、Center、Right、Top、Middle、Bottom

ui_distribute_selected

Distribute selected UI elements evenly.

Parameter	Type	Required	Default	Description
`direction`	string	No	"Horizontal"	Distribution direction

均匀分布选中的UI元素。

参数	类型	必填	默认值	描述
`direction`	string	否	"Horizontal"	分布方向

Batch Skill

批量操作技能

ui_create_batch

Create multiple UI elements in one call.

Parameter	Type	Required	Description
`items`	array	Yes	Array of UI element configs

Item properties:

type

(required),

name

parent

text

width

height

, etc.

Supported types: Button, Text, Image, Panel, Slider, Toggle, InputField, Dropdown, ScrollView, RawImage, Scrollbar

Returns:

{success, totalItems, successCount, failCount, results: [{success, name, type, instanceId}]}

python

unity_skills.call_skill("ui_create_batch", items=[
    {"type": "Button", "name": "StartBtn", "parent": "MenuPanel", "text": "Start", "y": 60},
    {"type": "Button", "name": "OptionsBtn", "parent": "MenuPanel", "text": "Options", "y": 0},
    {"type": "Button", "name": "QuitBtn", "parent": "MenuPanel", "text": "Quit", "y": -60}
])

单次调用创建多个UI元素。

参数	类型	必填	描述
`items`	array	是	UI元素配置数组

元素配置属性：

type

（必填）、

name

、

parent

、

text

、

width

、

height

、

等

支持的元素类型：Button、Text、Image、Panel、Slider、Toggle、InputField、Dropdown、ScrollView、RawImage、Scrollbar

返回值：

{success, totalItems, successCount, failCount, results: [{success, name, type, instanceId}]}

python

unity_skills.call_skill("ui_create_batch", items=[
    {"type": "Button", "name": "StartBtn", "parent": "MenuPanel", "text": "Start", "y": 60},
    {"type": "Button", "name": "OptionsBtn", "parent": "MenuPanel", "text": "Options", "y": 0},
    {"type": "Button", "name": "QuitBtn", "parent": "MenuPanel", "text": "Quit", "y": -60}
])

Example: Efficient Menu Creation

示例：高效创建菜单

python

import unity_skills

python

import unity_skills

BAD: 5 API calls

不推荐写法：5次API调用

unity_skills.call_skill("ui_create_canvas", name="MainMenu") unity_skills.call_skill("ui_create_panel", name="MenuPanel", parent="MainMenu") unity_skills.call_skill("ui_create_button", name="StartBtn", parent="MenuPanel", text="Start", y=60) unity_skills.call_skill("ui_create_button", name="OptionsBtn", parent="MenuPanel", text="Options", y=0) unity_skills.call_skill("ui_create_button", name="QuitBtn", parent="MenuPanel", text="Quit", y=-60)

GOOD: 2 API calls

推荐写法：2次API调用

unity_skills.call_skill("ui_create_canvas", name="MainMenu") unity_skills.call_skill("ui_create_batch", items=[ {"type": "Panel", "name": "MenuPanel", "parent": "MainMenu", "width": 300, "height": 200}, {"type": "Button", "name": "StartBtn", "parent": "MenuPanel", "text": "Start", "y": 60}, {"type": "Button", "name": "OptionsBtn", "parent": "MenuPanel", "text": "Options", "y": 0}, {"type": "Button", "name": "QuitBtn", "parent": "MenuPanel", "text": "Quit", "y": -60} ])

undefined

undefined

TextMeshPro Support

TextMeshPro 支持

UI Skills auto-detect TextMeshPro:

With TMP: Uses
```
TextMeshProUGUI
```
Without TMP: Falls back to legacy
```
UnityEngine.UI.Text
```

Response includes

usingTMP

field to indicate which was used.

UI技能会自动检测TextMeshPro：

已安装TMP：使用
```
TextMeshProUGUI
```
组件
未安装TMP：降级使用旧版
```
UnityEngine.UI.Text
```
组件

返回结果包含

usingTMP

字段，标识实际使用的文本组件类型。

New Element Creation Skills

新增元素创建技能

ui_create_dropdown

Create a Dropdown with options list and full Template/ScrollRect hierarchy.

Parameter	Type	Required	Default	Description
`name`	string	No	"Dropdown"	Dropdown name
`parent`	string	No	null	Parent object
`options`	string	No	"Option A,Option B,Option C"	Comma-separated options
`width/height`	float	No	160/30	Size

创建带有选项列表和完整Template/ScrollRect层级的Dropdown。

参数	类型	必填	默认值	描述
`name`	string	否	"Dropdown"	下拉框名称
`parent`	string	否	null	父级对象
`options`	string	否	"Option A,Option B,Option C"	逗号分隔的选项列表
`width/height`	float	否	160/30	尺寸

ui_create_scrollview

Create a ScrollRect with Viewport, RectMask2D, and Content.

Parameter	Type	Required	Default	Description
`name`	string	No	"ScrollView"	Name
`parent`	string	No	null	Parent object
`width/height`	float	No	300/200	Size
`horizontal`	bool	No	false	Enable horizontal scroll
`vertical`	bool	No	true	Enable vertical scroll
`movementType`	string	No	"Elastic"	Unrestricted/Elastic/Clamped

创建包含Viewport、RectMask2D和Content的ScrollRect。

参数	类型	必填	默认值	描述
`name`	string	否	"ScrollView"	滚动视图名称
`parent`	string	否	null	父级对象
`width/height`	float	否	300/200	尺寸
`horizontal`	bool	否	false	启用横向滚动
`vertical`	bool	否	true	启用纵向滚动
`movementType`	string	否	"Elastic"	滚动类型：Unrestricted/Elastic/Clamped

ui_create_rawimage

Create a RawImage element (for Texture2D/RenderTexture).

Parameter	Type	Required	Default	Description
`name`	string	No	"RawImage"	Name
`parent`	string	No	null	Parent object
`texturePath`	string	No	null	Texture asset path
`width/height`	float	No	100	Size

创建RawImage元素（用于展示Texture2D/RenderTexture）。

参数	类型	必填	默认值	描述
`name`	string	否	"RawImage"	RawImage元素名称
`parent`	string	否	null	父级对象
`texturePath`	string	否	null	纹理资源路径
`width/height`	float	否	100	尺寸

ui_create_scrollbar

Create a standalone Scrollbar.

Parameter	Type	Required	Default	Description
`name`	string	No	"Scrollbar"	Name
`parent`	string	No	null	Parent object
`direction`	string	No	"BottomToTop"	LeftToRight/RightToLeft/BottomToTop/TopToBottom
`value`	float	No	0	Initial value (0-1)
`size`	float	No	0.2	Handle size (0-1)
`numberOfSteps`	int	No	0	0=continuous, >0=discrete

创建独立的Scrollbar。

参数	类型	必填	默认值	描述
`name`	string	否	"Scrollbar"	滚动条名称
`parent`	string	否	null	父级对象
`direction`	string	否	"BottomToTop"	滚动方向：LeftToRight/RightToLeft/BottomToTop/TopToBottom
`value`	float	否	0	初始值（0-1）
`size`	float	否	0.2	滑块尺寸（0-1）
`numberOfSteps`	int	否	0	0=连续滚动，大于0为离散滚动

Property Configuration Skills

属性配置技能

ui_set_image

Set Image advanced properties (type, fill, sprite).

Parameter	Type	Required	Default	Description
`name`	string	No*	—	Image element name
`instanceId`	int	No*	0	Instance ID
`type`	string	No	—	Simple/Sliced/Tiled/Filled
`fillMethod`	string	No	—	Radial360/Radial180/Radial90/Horizontal/Vertical
`fillAmount`	float	No	—	0-1 fill amount
`fillClockwise`	bool	No	—	Fill direction
`preserveAspect`	bool	No	—	Preserve aspect ratio
`spritePath`	string	No	—	Sprite asset path

设置Image的高级属性（类型、填充、精灵图）。

参数	类型	必填	默认值	描述
`name`	string	否*	—	Image元素名称
`instanceId`	int	否*	0	实例ID
`type`	string	否	—	图片类型：Simple/Sliced/Tiled/Filled
`fillMethod`	string	否	—	填充方式：Radial360/Radial180/Radial90/Horizontal/Vertical
`fillAmount`	float	否	—	填充比例（0-1）
`fillClockwise`	bool	否	—	填充方向是否为顺时针
`preserveAspect`	bool	否	—	是否保持宽高比
`spritePath`	string	否	—	精灵图资源路径

ui_add_layout_element

Add/configure LayoutElement constraints.

Parameter	Type	Required	Default	Description
`name`	string	No*	—	Element name
`minWidth/minHeight`	float	No	—	Minimum size
`preferredWidth/preferredHeight`	float	No	—	Preferred size
`flexibleWidth/flexibleHeight`	float	No	—	Flexible size (0=fixed, >0=grow)
`ignoreLayout`	bool	No	—	Ignore layout group
`layoutPriority`	int	No	—	Priority (higher overrides)

添加/配置LayoutElement约束。

参数	类型	必填	默认值	描述
`name`	string	否*	—	元素名称
`minWidth/minHeight`	float	否	—	最小尺寸
`preferredWidth/preferredHeight`	float	否	—	首选尺寸
`flexibleWidth/flexibleHeight`	float	否	—	弹性尺寸（0=固定尺寸，大于0可拉伸）
`ignoreLayout`	bool	否	—	是否忽略布局组规则
`layoutPriority`	int	否	—	布局优先级（值越高优先级越高）

ui_add_canvas_group

Add/configure CanvasGroup (alpha, interactable, blocksRaycasts).

Parameter	Type	Required	Default	Description
`name`	string	No*	—	Element name
`alpha`	float	No	—	Group alpha (0-1)
`interactable`	bool	No	—	Children interactable
`blocksRaycasts`	bool	No	—	Blocks raycasts
`ignoreParentGroups`	bool	No	—	Ignore parent groups

添加/配置CanvasGroup（透明度、可交互性、射线检测阻挡）。

参数	类型	必填	默认值	描述
`name`	string	否*	—	元素名称
`alpha`	float	否	—	组透明度（0-1）
`interactable`	bool	否	—	子元素是否可交互
`blocksRaycasts`	bool	否	—	是否阻挡射线检测
`ignoreParentGroups`	bool	否	—	是否忽略父级CanvasGroup规则

ui_add_mask

Add Mask (stencil-based) or RectMask2D (rect clipping).

Parameter	Type	Required	Default	Description
`name`	string	No*	—	Element name
`maskType`	string	No	"RectMask2D"	Mask/RectMask2D
`showMaskGraphic`	bool	No	true	Show mask graphic (Mask only)

添加Mask（基于模板缓冲）或RectMask2D（矩形裁剪）。

参数	类型	必填	默认值	描述
`name`	string	否*	—	元素名称
`maskType`	string	否	"RectMask2D"	遮罩类型：Mask/RectMask2D
`showMaskGraphic`	bool	否	true	是否显示遮罩图形（仅Mask类型生效）

ui_add_outline

Add Shadow or Outline visual effect.

Parameter	Type	Required	Default	Description
`name`	string	No*	—	Element name
`effectType`	string	No	"Outline"	Shadow/Outline
`r/g/b/a`	float	No	0,0,0,0.5	Effect color
`distanceX/distanceY`	float	No	1/-1	Effect offset
`useGraphicAlpha`	bool	No	true	Use graphic alpha

添加阴影或描边视觉效果。

参数	类型	必填	默认值	描述
`name`	string	否*	—	元素名称
`effectType`	string	否	"Outline"	效果类型：Shadow/Outline
`r/g/b/a`	float	否	0,0,0,0.5	效果颜色
`distanceX/distanceY`	float	否	1/-1	效果偏移
`useGraphicAlpha`	bool	否	true	是否使用图形透明度

ui_configure_selectable

Configure Selectable properties on Button/Toggle/Slider/etc.

Parameter	Type	Required	Default	Description
`name`	string	No*	—	Element name
`transition`	string	No	—	None/ColorTint/SpriteSwap/Animation
`interactable`	bool	No	—	Interactable state
`navigationMode`	string	No	—	None/Horizontal/Vertical/Automatic/Explicit
`normalR/G/B`	float	No	—	Normal state color
`highlightedR/G/B`	float	No	—	Highlighted state color
`pressedR/G/B`	float	No	—	Pressed state color
`disabledR/G/B`	float	No	—	Disabled state color
`colorMultiplier`	float	No	—	Color multiplier (1-5)
`fadeDuration`	float	No	—	Fade duration

配置Button/Toggle/Slider等可交互组件的属性。

参数	类型	必填	默认值	描述
`name`	string	否*	—	元素名称
`transition`	string	否	—	过渡效果：None/ColorTint/SpriteSwap/Animation
`interactable`	bool	否	—	可交互状态
`navigationMode`	string	否	—	导航模式：None/Horizontal/Vertical/Automatic/Explicit
`normalR/G/B`	float	否	—	正常状态颜色
`highlightedR/G/B`	float	否	—	高亮状态颜色
`pressedR/G/B`	float	否	—	按下状态颜色
`disabledR/G/B`	float	否	—	禁用状态颜色
`colorMultiplier`	float	否	—	颜色倍数（1-5）
`fadeDuration`	float	否	—	淡入淡出时长

Best Practices

最佳实践

Always create Canvas first
Use Panels to organize related elements
Use meaningful names for scripting access
Set parent for proper hierarchy
WorldSpace canvas for 3D UI (health bars, etc.)

始终优先创建Canvas
使用Panel组织相关联的元素
使用有意义的命名方便后续脚本访问
设置父元素以维护正确的层级关系
3D UI（如血条等）使用WorldSpace渲染模式的Canvas