Appearance
Expressions参考
表达式可以在看到带有以下按钮之一的字段时输入：
- 左侧按钮表示“字符串表达式”（文本）
- 右侧按钮表示“数值表达式”（数字）
这个页面是按照扩展、对象或行为分组的 GDevelop 中可使用的所有表达式的参考。当写下 Object 时，您应该输入一个对象名称。在这里了解更多如何编写表达式的信息
提示
有时表达式也被称为函数，就像在数学中一样。
对象
这些是可用于 GDevelop 中所有对象的常见特征。阅读更多有关的解释
表达式
描述
PickedInstancesCount(object)
返回之前条件（或操作）选择的实例数量。
👾 Object
表达式
描述
Object.Angle()
对象的当前角度（以度为单位）
Object.AngleToObject(object)
计算两个对象之间的角度（以度为单位）。如果需要计算到任意位置的角度，请使用 AngleToPosition。
👾 Object
表达式
描述
Object.AngleToPosition(number, number)
计算对象中心和“目标”位置之间的角度（以度为单位）。如果需要计算两个对象之间的角度，请使用 AngleToObject。
🔢 Number
目标 X 位置
🔢 Number
目标 Y 位置
Object.ArrayVariableFirstNumber(object variable)
如果是数字变量，则获取对象数组变量的第一个元素的值。
🗄️ Object variable
数组变量
Object.ArrayVariableFirstString(object variable)
如果是文本（字符串）变量，则获取对象数组变量的第一个元素的值。
🗄️ Object variable
数组变量
Object.ArrayVariableLastNumber(object variable)
如果是数字变量，则获取对象数组变量的最后一个元素的值。
🗄️ Object variable
数组变量
Object.ArrayVariableLastString(object variable)
如果是文本（字符串）变量，则获取对象数组变量的最后一个元素的值。
🗄️ Object variable
数组变量
Object.BoundingBoxBottom()
返回包围对象的区域（边界框）底部位置。
Object.BoundingBoxCenterX()
返回包围对象的区域（边界框）中心 X 位置。
Object.BoundingBoxCenterY()
返回包围对象的区域（边界框）中心 Y 位置。
Object.BoundingBoxLeft()
返回包围对象的区域（边界框）左侧位置。
Object.BoundingBoxRight()
返回包围对象的区域（边界框）右侧位置。
Object.BoundingBoxTop()
返回包围对象的区域（边界框）顶部位置。
Object.CenterX()
返回旋转中心的 X 位置。
Object.CenterY()
返回旋转中心的 Y 位置。
Object.Distance(object)
两个对象之间的距离
👾 Object
对象
Object.DistanceToPosition(number, number)
对象和位置之间的距离
🔢 Number
目标 X 位置
🔢 Number
目标 Y 位置
Object.ForceAngle()
力的合力角度（以度为单位）
Object.ForceLength()
力的合力长度
Object.ForceX()
合力的 X 坐标
Object.ForceY()
合力的 Y 坐标
Object.Height()
对象的高度
Object.Layer()
返回对象所在图层的名称
Object.ObjectName()
返回对象的名称
Object.ObjectTimerElapsedTime(string)
对象定时器的值
🔤 Name (String)
定时器的名称
Object.SqDistance(object)
两个对象之间的平方距离
👾 Object
对象
Object.SqDistanceToPosition(number, number)
对象和位置之间的平方距离
🔢 Number
目标 X 位置
🔢 Number
目标 Y 位置
Object.Variable(object variable)
对象变量的数字值
🗄️ Object variable
变量
Object.VariableChildCount(object variable)
对象数组或结构变量中的子项数
🗄️ Object variable
数组或结构变量
Object.VariableString(object variable)
对象变量的文本
🗄️ Object variable
变量
Object.Width()
对象的宽度
Object.X()
对象的 X 位置
Object.XFromAngleAndDistance(number, number)
在给定起始对象的角度和距离的情况下计算 X 位置。这也被称为使用极坐标获取 2D 矢量的笛卡尔坐标。
🔢 Number
角度，以度为单位
🔢 Number
距离
Object.Y()
对象的 Y 位置
Object.YFromAngleAndDistance(number, number)
在给定起始对象的角度和距离的情况下计算 Y 位置。这也被称为使用极坐标获取 2D 矢量的笛卡尔坐标。
🔢 Number
角度，以度为单位
🔢 Number
距离
Object.ZOrder()
对象的 Z 轴顺序
精灵
可用于游戏中大多数元素的动画对象。阅读更多有关的解释
表达式
描述
Object.AnimationFrameCount()
对象当前动画中的帧数
Object.PointX(object point name)
点的 X 位置
🔤 Object Point Name (String)
点的名称
Object.PointY(object point name)
点的 Y 位置
🔤 Object Point Name (String)
点的名称
Object.Sprite()
对象动画的当前帧
转换
用于转换数字、文本和数量的表达式。阅读更多有关的解释
| 表达式 | 描述 |
|---|---|
LargeNumberToString(number) | 将表达式的结果转换为文本，不使用科学计数法 |
| 🔢 数字 | 要转换为文本的表达式 |
ObjectVarToJSON(object, object variable) | 将对象变量转换为JSON格式 |
| 👾 对象 | 包含变量的对象 |
| 🗄️ 对象变量 | 要序列化的对象变量 |
ToDeg(number) | 将以弧度表示的角度转换为度数 |
| 🔢 数字 | 以弧度表示的角度 |
ToJSON(variable) | 将变量转换为JSON格式 |
| ⚗️ 任意变量 | 要序列化的变量 |
ToNumber(string) | 将文本转换为数字 |
| string | 要转换为数字的文本 |
ToRad(number) | 将以度数表示的角度转换为弧度 |
| 🔢 数字 | 以度数表示的角度 |
ToString(number) | 将表达式的结果转换为文本 |
| 🔢 数字 | 要转换为文本的表达式 |
变量
处理变量的动作、条件和表达式，从简单的变量如玩家得分、剩余生命数量到包含任意数据（如库存或网络请求结果）的复杂变量。阅读更多解释
| 表达式 | 描述 |
|---|---|
GlobalVariable(global variable) | 全局变量的数值 |
| ⚗️ 全局变量 | 全局变量的名称 |
GlobalVariableChildCount(global variable) | 全局数组或结构变量中的子元素数量 |
| ⚗️ 全局变量 | 数组或结构变量 |
GlobalVariableFirstNumber(global variable) | 如果是数值变量，则返回全局数组变量的第一个元素值 |
| ⚗️ 全局变量 | 数组变量 |
GlobalVariableFirstString(global variable) | 如果是文本（字符串）变量，则返回全局数组变量的第一个元素值 |
| ⚗️ 全局变量 | 数组变量 |
GlobalVariableLastNumber(global variable) | 如果是数值变量，则返回全局数组变量的最后一个元素值 |
| ⚗️ 全局变量 | 数组变量 |
GlobalVariableLastString(global variable) | 如果是文本（字符串）变量，则返回全局数组变量的最后一个元素值 |
| ⚗️ 全局变量 | 数组变量 |
GlobalVariableString(global variable) | 全局变量的文本 |
| ⚗️ 全局变量 | 变量 |
SceneVariableFirstNumber(scene variable) | 如果是数值，则获取场景数组变量的第一个元素值 |
| ⚗️ 场景变量 | 数组变量 |
SceneVariableFirstString(scene variable) | 如果是文本（字符串），则获取场景数组变量的第一个元素值 |
| ⚗️ 场景变量 | 数组变量 |
SceneVariableLastNumber(scene variable) | 如果是数值，则获取场景数组变量的最后一个元素值 |
| ⚗️ 场景变量 | 数组变量 |
SceneVariableLastString(scene variable) | 如果是文本（字符串），则获取场景数组变量的最后一个元素值 |
| ⚗️ 场景变量 | 数组变量 |
Variable(scene variable) | 场景变量的数值 |
| ⚗️ 场景变量 | 变量 |
VariableChildCount(variable) | 场景数组或结构变量中的子元素数量 |
| ⚗️ 任意变量 | 数组或结构变量 |
VariableFirstNumber(variable) | 如果是数值，则获取数组变量的第一个元素值 |
| ⚗️ 任意变量 | 数组变量 |
VariableFirstString(variable) | 如果是文本（字符串），则获取数组变量的第一个元素值 |
| ⚗️ 任意变量 | 数组变量 |
VariableLastNumber(variable) | 如果是数值，则获取数组变量的最后一个元素值 |
| ⚗️ 任意变量 | 数组变量 |
VariableLastString(variable) | 如果是文本（字符串），则获取数组变量的最后一个元素值 |
| ⚗️ 任意变量 | 数组变量 |
VariableString(scene variable) | 场景变量的文本 |
| ⚗️ 场景变量 | 变量 |
鼠标与触摸
处理鼠标或触摸屏上触摸的条件和动作。默认情况下，与鼠标相关的条件也会处理触摸 - 因此在你的游戏中更容易同时处理两者。如果你想要在不同的事件中分别处理它们，可以禁用这种行为。阅读更多解释
| 表达式 | 描述 |
|---|---|
CursorX(layer name, number) | 返回光标或触摸的X位置。 |
| 🔤 图层名称 (字符串) | 图层 可选 |
| 🔢 数字 | 摄像头编号（默认：0）可选 |
CursorY(layer name, number) | 返回光标或触摸的Y位置。 |
| 📐 图层名称 (字符串) | 图层 可选 |
| 🔢 数字 | 摄像头编号（默认：0）可选 |
MouseWheelDelta() | 鼠标滚轮位移 |
StartedTouchOrMouseCount() | 在这一帧刚开始接触屏幕的触摸次数（包括鼠标）。可以使用 StartedTouchOrMouseId() 获取触摸标识符。 |
StartedTouchOrMouseId(number) | 在这一帧刚开始接触屏幕的触摸或鼠标的标识符。可以使用 StartedTouchOrMouseCount() 获取触摸次数。 |
| 🔢 数字 | 触摸索引 |
TouchX(number, layer name, number) | 返回特定触摸的X位置。 |
| 🔢 数字 | 触摸标识符 |
| ⚗️ 图层名称 (字符串) | 图层 可选 |
| 🔢 数字 | 摄像头编号（默认：0）可选 |
TouchY(number, layer name, number) | 返回特定触摸的Y位置。 |
| 🔢 数字 | 触摸标识符 |
| ⚗️ 图层名称 (字符串) | 图层 可选 |
| 🔢 数字 | 摄像头编号（默认：0）可选 |
键盘
允许游戏响应键盘输入。请注意，这不适用于触屏设备上的屏幕键盘：当制作移动/触摸屏设备的游戏时，应该使用与触摸相关的条件。阅读更多解释
| 表达式 | 描述 |
|---|---|
LastPressedKey() | 获取最近按下的键盘键名 |
场景
在游戏过程中操作和操纵场景的行为和条件。
表达式
描述
CurrentSceneName()
当前场景的名称
SceneLoadingProgress(场景名称)
返回场景背景资源加载的进度（介于0和1之间）。
- 🔤 场景名称（字符串）
计时器和时间
运行计时器、获取当前时间或修改时间尺度（游戏运行速度 - 对于慢动作效果很有用）的行为和条件。点击此处阅读更多解释。
表达式
描述
Time(字符串)
当前时间
- 🔤 字符串
- 小时：hour - 分钟：min - 秒：sec - 月份的第几天：mday - 自一月份开始的月数：mon - 自1900年起的年数：year - 自周日以来的天数：wday - 自1月1日以来的天数：yday - 时间戳（毫秒）：timestamp
TimeDelta()
自上一帧渲染到屏幕上的时间间隔
TimeFromStart()
自场景开始以来经过的时间
TimeScale()
返回场景的时间尺度
TimerElapsedTime(字符串)
场景计时器的值
- 🔤 名称（字符串）
数学工具
一组可用于表达式中的数学函数。
表达式
描述
AngleBetweenPositions(数，数，数，数)
计算两个位置之间的角度（以度为单位）
- 🔢 数
- 第一个点X位置
- 🔢 数
- 第一个点Y位置
- 🔢 数
- 第二个点X位置
- 🔢 数
- 第二个点Y位置
AngleDifference(数，数)
两个角度之间的差异
- 🔢 数
- 第一个角度，以度为单位
- 🔢 数
- 第二个角度，以度为单位
DistanceBetweenPositions(数，数，数，数)
计算两个位置之间的距离
- 🔢 数
- 第一个点X位置
- 🔢 数
- 第一个点Y位置
- 🔢 数
- 第二个点X位置
- 🔢 数
- 第二个点Y位置
Pi()
圆周率π（3.1415...）
Random(数)
随机整数
- 🔢 数
- 最大值
RandomFloat(数)
随机浮点数
- 🔢 数
- 最大值
RandomFloatInRange(数，数)
范围内的随机浮点数
- 🔢 数
- 最小值
- 🔢 数
- 最大值
RandomInRange(数，数)
范围内的随机整数
- 🔢 数
- 最小值
- 🔢 数
- 最大值
RandomWithStep(数，数，数)
步长中的随机值
- 🔢 数
- 最小值
- 🔢 数
- 最大值
- 🔢 数
- 步长
XFromAngleAndDistance(数，数)
给定角度和距离相对原点（0;0）时的X位置
- 🔢 数
- 角度，以度为单位
- 🔢 数
- 距离
YFromAngleAndDistance(数，数)
给定角度和距离相对原点（0;0）时的Y位置
- 🔢 数
- 角度，以度为单位
- 🔢 数
- 距离
abs(数)
绝对值
- 🔢 数
- 表达式
acos(数)
反余弦，返回一个角度（弧度）。ToDeg允许将其转换为度数。
- 🔢 数
- 表达式
acosh(数)
反双曲余弦
- 🔢 数
- 表达式
asin(数)
反正弦，返回一个角度（弧度）。ToDeg允许将其转换为度数。
- 🔢 数
- 表达式
asinh(数)
反双曲正弦
- 🔢 数
- 表达式
atan(数)
反正切，返回一个角度（弧度）。ToDeg允许将其转换为度数。
- 🔢 数
- 表达式
atan2(数，数)
2参数反正切（atan2）
- 🔢 数
- Y
- 🔢 数
- X
atanh(数)
反双曲正切
- 🔢 数
- 表达式
cbrt(数)
立方根
- 🔢 数
- 表达式
ceil(数)
将数字向上取整到整数
- 🔢 数
- 表达式
ceilTo(数，数)
将数字向上取整到小数点后第N位
- 🔢 数
- 表达式
- 🔢 数
- 表达式 （可选）
clamp(数，数，数)
将值限制在给定范围内
- 🔢 数
- 值
- 🔢 数
- 最小值
- 🔢 数
- 最大值
cos(数)
角度的余弦（以弧度为单位）。如果要使用度数，请使用ToRad：sin(ToRad(45))。
- 🔢 数
- 表达式
cosh(数)
双曲余弦
- 🔢 数
- 表达式
cot(数)
余切
- 🔢 数
- 表达式
csc(数)
余割
- 🔢 数
- 表达式
exp(数)
指数
- 🔢 数
- 表达式
floor(数)
将数字向下取整到整数
- 🔢 数
- 血拆表达式
floorTo(数，数)
将数字向下取整到小数点后第N位
- 🔢 数
- 表达式
- 🔢 数
- 表达式 （可选）
lerp(数，数，数)
线性插值从a到b为x
- 🔢 数
- a（在a+(b-a)*x中的a）
- 🔢 数
- b（在a+(b-a)*x中的b）
- 🔢 数
- x（在a+(b-a)*x中的x）
lerpAngle(数，数，数)
在两个角度之间进行线性插值（以度为单位），沿着圆圈朝最短方向。
- 🔢 数
- 起始角度，以度为单位
- 🔢 数
- 目标角度，以度为单位
- 🔢 数
- 0和1之间的插值
log(数)
对数
- 🔢 数
- 表达式
log10(数)
以10为底对数
- 🔢 数
- 表达式
log2(数)
以2为底对数
- 🔢 数
- 表达式
max(数，数)
两个数中的最大值
- 🔢 数
- 第一个表达式
- 🔢 数
- 第二个表达式
min(数，数)
两个数中的最小值
- 🔢 数
- 第一个表达式
- 🔢 数
- 第二个表达式
mod(数，数)
x mod y
- 🔢 数
- x（如x mod y）
- 🔢 数
- y（如x mod y）
normalize(数，数，数)
将值重新映射为0到1之间。
- 🔢 数
- 值
- 🔢 数
- 最小值
- 🔢 数
- 最大值
nthroot(数，数)
一个数字的N次根
- 🔢 数
- 数字
- 🔢 数
- N
pow(数，数)
将一个数字提高到幂
- 🔢 数
- 数字
- 🔢 数
- 幂（“x的幂n”中的n）
round(数)
Round a number
🔢 Number
Expression
roundTo(number, number)
Round a number to the Nth decimal place
🔢 Number
Expression
🔢 Number
Expression Optional.
sec(number)
Secant
🔢 Number
Expression
sign(number)
Return the sign of a number (1,-1 or 0)
🔢 Number
Expression
sin(number)
Sine of an angle (in radian). If you want to use degrees, useToRad: sin(ToRad(45)).
🔢 Number
Expression
sinh(number)
Hyperbolic sine
🔢 Number
Expression
sqrt(number)
Square root of a number
🔢 Number
Expression
tan(number)
Tangent of an angle (in radian). If you want to use degrees, useToRad: tan(ToRad(45)).
🔢 Number
Expression
tanh(number)
Hyperbolic tangent
🔢 Number
Expression
trunc(number)
Truncate a number
🔢 Number
Expression
Layers and cameras
Each scene can be composed of multiple layers. These conditions and actions allow to manipulate them during the game. In particular, you can move the camera of a layer to center it on an object or a position. Read more explanations about it.
Expression
Description
CameraAngle(layer name, number)
Return the angle of rotation of a camera (in degrees).
🔤 Layer name (String)
Layer Optional.
🔢 Number
Camera number (default : 0) Optional.
CameraBorderBottom(layer name, number)
Return the position of the bottom border of a camera.
🔤 Layer name (String)
Layer Optional.
🔢 Number
Camera number Optional.
CameraBorderLeft(layer name, number)
Return the position of the left border of a camera.
🔤 Layer name (String)
Layer Optional.
🔢 Number
Camera number Optional.
CameraBorderRight(layer name, number)
Return the position of the right border of a camera.
🔤 Layer name (String)
Layer Optional.
🔢 Number
Camera number Optional.
CameraBorderTop(layer name, number)
Return the position of the top border of a camera.
🔤 Layer name (String)
Layer Optional.
🔢 Number
Camera number Optional.
CameraCenterX(layer name, number)
Return the X position of the center of a camera.
🔤 Layer name (String)
Layer Optional.
🔢 Number
Camera number (default : 0) Optional.
CameraCenterY(layer name, number)
Return the Y position of the center of a camera.
🔤 Layer name (String)
Layer Optional.
🔢 Number
Camera number (default : 0) Optional.
CameraHeight(layer name, number)
Return the height of a camera of a layer.
🔤 Layer name (String)
Layer Optional.
🔢 Number
Camera number Optional.
CameraWidth(layer name, number)
Return the width of a camera of a layer.
🔤 Layer name (String)
Layer Optional.
🔢 Number
Camera number Optional.
CameraZoom(layer name, number)
Zoom of a camera of a layer
🔤 Layer name (String)
Layer Optional.
🔢 Number
Camera number (default : 0) Optional.
LayerDefaultZOrder(layer name)
Default Z Order for a layer
🔤 Layer name (String)
Layer
LayerTimeScale(layer name)
Returns the time scale of the specified layer.
🔤 Layer name (String)
Layer
Sounds and music
GDevelop provides several conditions and actions to play audio files. They can be either long music or short sound effects. Read more explanations about it.
Expression
Description
GlobalVolume()
Global volume value
MusicChannelPitch(number)
Music's pitch
🔢 Number
Channel
MusicChannelPlayingOffset(number)
Music playing offset
🔢 Number
Channel
MusicChannelVolume(number)
Music volume
🔢 Number
Channel
SoundChannelPitch(number)
Sound's pitch
🔢 Number
Channel
SoundChannelPlayingOffset(number)
Sound playing offset
🔢 Number
Channel
SoundChannelVolume(number)
Sound volume
🔢 Number
Channel
Game window and resolution
Provides actions and conditions to manipulate the game window. Depending on the platform on which the game is running, not all of these features can be applied. Read more explanations about it.
Expression
Description
SceneWindowHeight()
Height of the scene window (or scene canvas for HTML5 games)
SceneWindowWidth()
Width of the scene window (or scene canvas for HTML5 games)
ScreenHeight()
Height of the screen (or the page for HTML5 games in browser)
ScreenWidth()
Width of the screen (or the page for HTML5 games in browser)
WindowTitle()
Window's title
Text manipulation
Provides expressions to manipulate strings (also called texts).
Expression
Description
FromCodePoint(number)
Get character from code point
🔢 Number
Code point
NewLine()
Insert a new line
StrAt(string, number)
Get a character from a text
string
Text
🔢 Number
Position of the character (the first letter is at position 0)
StrFind(string, string)
Search in a text (return the position of the result or -1 if not found)
string
Text
string
Text to search for
StrFindFrom(string, string, number)
Search in a text, starting from a position (return the position of the result or -1 if not found)
string
Text
string
Text to search for
🔢 Number
Position of the first character in the string to be considered in the search
StrFindLast(string, string)
Search the last occurrence in a string (return the position of the result, from the beginning of the string, or -1 if not found)
string
Text
string
Text to search for
StrFindLastFrom(string, string, number)
Search in a text the last occurrence, starting from a position (return the position of the result, from the beginning of the string, or -1 if not found)
string
Text
string
Text to search for
🔢 Number
Position of the last character in the string to be considered in the search
StrLength(string)
Length of a text
文本
StrRepeat(string, number)
重复文本
文本
要重复的文本
🔢 数字
重复次数
SubStr(string, number, number)
获取文本的一部分
文本
文本
🔢 数字
部分的起始位置（第一个字母的位置为0）
🔢 数字
部分的长度
ToLowerCase(string)
将文本转为小写
文本
ToUpperCase(string)
将文本转为大写
文本
可动画化能力
对对象进行动画化。阅读更多解释。
表达式
描述
Object.Animation::Duration()
返回当前动画的持续时间（秒）。
Object.Animation::ElapsedTime()
返回从动画开始时经过的时间（秒）。
Object.Animation::Index()
返回对象使用动画编号（来自动画列表的动画）播放的动画。
Object.Animation::Name()
使用动画的名称返回对象播放的动画。
Object.Animation::SpeedScale()
返回动画速度比例（1 = 默认速度，>1 = 更快，<1 = 更慢）。
效果能力
将视觉效果应用于对象。阅读更多解释。
此行为没有表达式。
可翻转能力
翻转对象。阅读更多解释。
此行为没有表达式。
可调整大小能力
改变对象的尺寸。阅读更多解释。
此行为没有表达式。
可缩放能力
改变对象的缩放比例。阅读更多解释。
表达式
描述
Object.Scale::Value()
返回对象的缩放比例（默认比例为1）。
Object.Scale::X()
返回对象在X轴上的缩放比例（默认比例为1）。
Object.Scale::Y()
返回对象在Y轴上的缩放比例（默认比例为1）。
不透明能力
改变对象的不透明度。阅读更多解释。
表达式
描述
Object.Opacity::Value()
返回对象的不透明度，范围从0（完全透明）到255（不透明）。
文本能力
访问对象文本。阅读更多解释。
表达式
描述
Object.Text::Value()
返回文本。
平台（来自扩展平台行为）
将对象标记为可供角色奔跑的平台。阅读更多解释。
此行为没有表达式。
平台式角色（来自扩展平台行为）
在平台上跳跃奔跑。阅读更多解释。
表达式
描述
Object.PlatformerObject::Acceleration()
返回对象的水平加速度（每秒每秒的像素）。
Object.PlatformerObject::CurrentFallSpeed()
返回对象的当前下落速度（每秒的像素）。其值始终为正值。
Object.PlatformerObject::CurrentJumpSpeed()
返回对象的当前跳跃速度（每秒的像素）。其值始终为正值。
Object.PlatformerObject::CurrentSpeed()
返回对象的当前水平速度（每秒的像素）。对象向左移动的值为负值，向右移动的值为正值。
Object.PlatformerObject::Deceleration()
返回对象的水平减速度（每秒每秒的像素）。
Object.PlatformerObject::Gravity()
返回对象上施加的重力（每秒每秒的像素）。
Object.PlatformerObject::JumpSpeed()
返回对象的跳跃速度（每秒的像素）。其值始终为正值。
Object.PlatformerObject::JumpSustainTime()
返回对象的跳跃维持时间（秒）。这是保持跳跃按钮按下时，初始跳跃速度保持不变的时间。
Object.PlatformerObject::LadderClimbingSpeed()
返回对象的梯子爬升速度（每秒的像素）。
Object.PlatformerObject::MaxFallingSpeed()
返回对象的最大下落速度（每秒的像素）。
Object.PlatformerObject::MaxSpeed()
返回对象的最大水平速度（每秒的像素）。
在屏幕外销毁（来自销毁超出屏幕行为扩展）
当物体超出屏幕边界时自动销毁物体。阅读更多解释。
此行为没有表达式。
平铺精灵（来自平铺精灵对象扩展）
在一个区域上重复显示图像。阅读更多解释。
表达式
描述
Object.XOffset()
返回在显示图像时在X轴上使用的偏移量。
Object.YOffset()
返回在显示图像时在Y轴上使用的偏移量。
可拖动对象（来自拖动行为扩展）
通过按住鼠标按钮（或触摸）移动对象。阅读更多解释。
此行为没有表达式。
自上而下移动（4或8个方向）（来自自上而下移动扩展）Move objects left, up, right, and down (and, optionally, diagonally). 点击此处阅读更多关于它的解释。
表达式
说明
Object.TopDownMovement::Acceleration()
对象的加速度
Object.TopDownMovement::Angle()
移动的角度（以度为单位）
Object.TopDownMovement::AngleOffset()
应用于对象的旋转偏移
Object.TopDownMovement::AngularMaxSpeed()
对象的角速度最大值
Object.TopDownMovement::Deceleration()
对象的减速度
Object.TopDownMovement::MaxSpeed()
对象的最大速度
Object.TopDownMovement::MovementAngleOffset()
返回移动角度偏移。
Object.TopDownMovement::Speed()
对象的速度
Object.TopDownMovement::StickAngle()
返回模拟杆输入的角度（以度为单位）
Object.TopDownMovement::XVelocity()
移动在X轴上的速度
Object.TopDownMovement::YVelocity()
移动在Y轴上的速度
文本（从扩展文本对象）
在屏幕上显示文本。点击此处阅读更多关于它的解释。
表达式
说明
Object.FontSize()
返回文本对象的字体大小。
Object.OutlineThickness()
返回文本的轮廓厚度。
Object.Padding()
填充
Object.ShadowAngle()
返回文本阴影的角度。
Object.ShadowBlurRadius()
返回文本阴影的模糊半径。
Object.ShadowDistance()
返回文本阴影的距离。
Object.ShadowOpacity()
返回文本阴影的不透明度。
粒子发射器（来自扩展粒子系统）
显示大量小粒子以创建视觉效果。点击此处阅读更多关于它的解释。
表达式
说明
Object.ConeSprayAngle()
喷射锥的角度
Object.CurrentParticleCount()
当前显示的粒子数。
Object.EmitterAngle()
粒子的发射角度。
Object.EmitterForceMax()
粒子的最大发射力。
Object.EmitterForceMin()
粒子的最小发射力。
Object.Flow()
粒子的流量（每秒粒子数）。
Object.MaxParticlesCount()
返回显示的最大粒子数。
Object.ParticleAlpha1()
粒子的起始不透明度。
Object.ParticleAlpha2()
粒子的结束不透明度。
Object.ParticleBlue1()
粒子的起始蓝色成分。
Object.ParticleBlue2()
粒子的结束蓝色成分。
Object.ParticleGravityAngle()
重力角度。
Object.ParticleGravityLength()
重力值。
Object.ParticleGravityX()
作用在X轴上的粒子重力。
Object.ParticleGravityY()
作用在Y轴上的粒子重力。
Object.ParticleGreen1()
粒子的起始绿色成分。
Object.ParticleGreen2()
粒子的结束绿色成分。
Object.ParticleLifeTimeMax()
粒子的最大寿命。
Object.ParticleLifeTimeMin()
粒子的最小寿命。
Object.ParticleRed1()
粒子的起始红色成分。
Object.ParticleRed2()
粒子的结束红色成分。
Object.ParticleRotationMaxSpeed()
返回粒子的最大旋转速度。
Object.ParticleRotationMinSpeed()
返回粒子的最小旋转速度。
Object.ParticleSize1()
粒子的初始大小。
Object.ParticleSize2()
粒子的结束大小。
Object.RendererParam1()
渲染的第一个参数
Object.RendererParam2()
渲染的第二个参数
Object.Tank()
粒子容量。
Object.Texture()
粒子显示的图像的名称。
Object.ZoneRadius()
发射区域的半径。
面板精灵（“9块”）（来自扩展面板精灵（9块）对象）
一个带有单独拉伸边缘和角落部分的图像。点击此处阅读更多关于它的解释。
此对象没有表达式。
锚点
将对象锚定到窗口边界。点击此处阅读更多关于它的解释。
此行为没有表达式。
形状绘制器
允许您在屏幕上使用事件绘制简单的形状。点击此处阅读更多关于它的解释。
表达式
说明
Object.Antialiasing()
返回正在使用的抗锯齿类型：无，低，中或高。
Object.FillColorBlue()
填充颜色的蓝色分量
Object.FillColorGreen()
填充颜色的绿色分量
Object.FillColorRed()
填充颜色的红色分量
Object.FillOpacity()
填充不透明度
Object.OutlineColorBlue()
轮廓颜色的蓝色分量
Object.OutlineColorGreen()
轮廓颜色的绿色分量
Object.OutlineColorRed()
轮廓颜色的红色分量
Object.OutlineOpacity()
轮廓不透明度
Object.OutlineSize()
轮廓大小
Object.ToDrawingX(数字，数字)
从场景绘制点的X绘制坐标
🔢 数字
X场景位置
🔢 数字
Y场景位置
Object.ToDrawingY(数字，数字)
从场景绘制点的Y绘制坐标
🔢 数字
X场景位置
🔢 数字
Y场景位置
Object.ToSceneX(数字，数字)
从绘图的X场景坐标
🔢 数字
X绘图位置
🔢 数字
Y绘图位置
Object.ToSceneY(数字，数字)
从绘图的Y场景坐标
🔢 数字
X绘图位置
🔢 数字
Y绘图位置
文字输入（来自扩展文字输入对象）
用于获取使用键盘输入的文本的不可见对象。点击此处阅读更多关于它的解释。## 表达式
描述
Object.String()
键盘输入的文本
库存
提供将库存添加到游戏中的操作和条件，其中包含内存中的物品。了解更多关于库存的解释。
表达式
描述
Inventory::Count(string, string)
获取库存中物品的数量
string
库存名称
string
物品名称
Inventory::Maximum(string, string)
获取库存中物品的最大数量，如果无限则返回0
string
库存名称
string
物品名称
寻路（来自路径查找行为扩展）
将对象移动到目标位置，同时避开所有标记为障碍物的对象。了解更多关于路径查找的解释。
表达式
描述
Object.Pathfinding::Acceleration()
对象在路径上的加速度
Object.Pathfinding::AngleOffset()
对象在路径上施加的旋转偏移
Object.Pathfinding::AngularMaxSpeed()
对象在路径上的角速度
Object.Pathfinding::CellHeight()
虚拟网格的高度
Object.Pathfinding::CellWidth()
虚拟网格的宽度
Object.Pathfinding::DestinationX()
目标X位置
Object.Pathfinding::DestinationY()
目标Y位置
Object.Pathfinding::ExtraBorder()
在路径上施加的额外边界
Object.Pathfinding::GetNodeX(number)
获取下一个路标的X位置
🔢 数字
节点索引（从0开始！）
Object.Pathfinding::GetNodeY(number)
获取下一个路标的Y位置
🔢 数字
节点索引（从0开始！）
Object.Pathfinding::GridOffsetX()
返回虚拟网格的X偏移
Object.Pathfinding::GridOffsetY()
返回虚拟网格的Y偏移
Object.Pathfinding::LastNodeX()
最后一个路标的X位置
Object.Pathfinding::LastNodeY()
最后一个路标的Y位置
Object.Pathfinding::MaxSpeed()
对象在路径上的最大速度
Object.Pathfinding::MovementAngle()
在路径上移动的角度
Object.Pathfinding::NextNodeIndex()
获取要到达的下一个路标的索引
Object.Pathfinding::NextNodeX()
获取下一个路标的X位置
Object.Pathfinding::NextNodeY()
获取下一个路标的Y位置
Object.Pathfinding::NodeCount()
获取路径上的路标数量
Object.Pathfinding::Speed()
对象在路径上的速度
路径查找的障碍物（来自路径查找行为扩展）
标记对象为路径查找的障碍物。了解更多关于路径查找的解释。
表达式
描述
Object.PathfindingObstacle::Cost()
障碍物的成本
物理引擎（来自物理引擎（已弃用）扩展）
使对象按照物理定律移动。如果您正在创建新游戏，请优先使用物理引擎 2.0 了解更多关于物理引擎的解释。
表达式
描述
Object.Physics::AngularDamping()
角阻尼
Object.Physics::AngularVelocity()
角速度
Object.Physics::LinearDamping()
线性阻尼
Object.Physics::LinearVelocity()
线性速度
Object.Physics::LinearVelocityX()
X 分量
Object.Physics::LinearVelocityY()
Y 分量
Object.Physics::PolygonScaleX()
碰撞多边形 X 缩放
Object.Physics::PolygonScaleY()
碰撞多边形 Y 缩放
3D
支持 GDevelop 中的 3D 功能。
表达式
描述
Scene3D::CameraFarPlane(layer name, number)
返回相机远平面距离。
🔤 层名称（字符串）
图层 可选。
🔢 数字
相机编号（默认值：0）可选。
Scene3D::CameraFov(layer name, number)
返回相机视场角度。
🔤 层名称（字符串）
图层 可选。
🔢 数字
相机编号（默认值：0）可选。
Scene3D::CameraNearPlane(layer name, number)
返回相机近平面距离。
🔤 层名称（字符串）
图层 可选。
🔢 数字
相机编号（默认值：0）可选。
Scene3D::CameraRotationX(layer name, number)
返回相机在 X 轴上的旋转。
🔤 层名称（字符串）
图层 可选。
🔢 数字
相机编号（默认值：0）可选。
Scene3D::CameraRotationY(layer name, number)
返回相机在 Y 轴上的旋转。
🔤 层名称（字符串）
图层 可选。
🔢 数字
相机编号（默认值：0）可选。
Scene3D::CameraZ(layer name, number)
返回相机在 Z 轴上的位置。
🔤 层名称（字符串）
图层 可选。
🔢 数字
相机编号（默认值：0）可选。
3D 立方体（来自 3D 扩展）
一个具有每个面的图像的立方体
此对象没有表达式。
3D 模型（来自 3D 扩展）
一个带动画的 3D 模型。
此对象没有表达式。
3D 能力（来自 3D 扩展）
在 3D 空间中移动对象。
表达式
描述
Object.Object3D::CenterZ()
返回旋转中心的 Z 位置。
Object.Object3D::Depth()
返回深度（Z 轴上的大小）。
Object.Object3D::RotationX()
返回 X 轴上的旋转。
Object.Object3D::RotationY()
返回 Y 轴上的旋转。
Object.Object3D::ScaleZ()
返回对象的 Z 轴比例（默认比例为 1）。
Object.Object3D::Z()
返回 Z 位置（“海拔”）。
高级窗口管理
提供与游戏窗口定位和操作系统交互相关的高级功能。
表达式
描述
AdvancedWindow::WindowOpacity()
返回当前窗口的不透明度（从0到1的数字，1为完全不透明）。
AdvancedWindow::WindowX()
返回当前窗口的 X 位置。
AdvancedWindow::WindowY()
返回当前窗口的 Y 位置。
Returns the file name from the given file path.返回带有扩展名的文件名。Get the linear velocity angle of an object.
Object.Physics2::LinearVelocityX()
Get the linear velocity of an object on X axis.
Object.Physics2::LinearVelocityY()
Get the linear velocity of an object on Y axis.
Object.Physics2::Mass()
Return the mass of the object (in kilograms)
Object.Physics2::MassCenterX()
Mass center X
Object.Physics2::MassCenterY()
Mass center Y
Object.Physics2::MotorJointAngularOffset(number)
Motor joint angular offset
🔢 Number
Joint ID
Object.Physics2::MotorJointCorrectionFactor(number)
Motor joint correction factor
🔢 Number
Joint ID
Object.Physics2::MotorJointMaxForce(number)
Motor joint maximum force
🔢 Number
Joint ID
Object.Physics2::MotorJointMaxTorque(number)
Motor joint maximum torque
🔢 Number
Joint ID
Object.Physics2::MotorJointOffsetX(number)
Motor joint offset X
🔢 Number
Joint ID
Object.Physics2::MotorJointOffsetY(number)
Motor joint offset Y
🔢 Number
Joint ID
Object.Physics2::MouseJointDampingRatio(number)
Mouse joint damping ratio
🔢 Number
Joint ID
Object.Physics2::MouseJointFrequency(number)
Mouse joint frequency
🔢 Number
Joint ID
Object.Physics2::MouseJointMaxForce(number)
Mouse joint maximum force
🔢 Number
Joint ID
Object.Physics2::MouseJointTargetX(number)
Mouse joint target X
🔢 Number
Joint ID
Object.Physics2::MouseJointTargetY(number)
Mouse joint target Y
🔢 Number
Joint ID
Object.Physics2::PrismaticJointAxisAngle(number)
Prismatic joint axis angle
🔢 Number
Joint ID
Object.Physics2::PrismaticJointMaxMotorForce(number)
Prismatic joint maximum motor force
🔢 Number
Joint ID
Object.Physics2::PrismaticJointMaxTranslation(number)
Prismatic joint maximum translation
🔢 Number
Joint ID
Object.Physics2::PrismaticJointMinTranslation(number)
Prismatic joint minimum translation
🔢 Number
Joint ID
Object.Physics2::PrismaticJointMotorForce(number)
Prismatic joint motor force
🔢 Number
Joint ID
Object.Physics2::PrismaticJointMotorSpeed(number)
Prismatic joint motor speed
🔢 Number
Joint ID
Object.Physics2::PrismaticJointReferenceAngle(number)
Prismatic joint reference angle
🔢 Number
Joint ID
Object.Physics2::PrismaticJointSpeed(number)
Prismatic joint speed
🔢 Number
Joint ID
Object.Physics2::PrismaticJointTranslation(number)
Prismatic joint current translation
🔢 Number
Joint ID
Object.Physics2::PulleyJointFirstGroundAnchorX(number)
Pulley joint first ground anchor X
🔢 Number
Joint ID
Object.Physics2::PulleyJointFirstGroundAnchorY(number)
Pulley joint first ground anchor Y
🔢 Number
Joint ID
Object.Physics2::PulleyJointFirstLength(number)
Pulley joint first length
🔢 Number
Joint ID
Object.Physics2::PulleyJointRatio(number)
Pulley joint ratio
🔢 Number
Joint ID
Object.Physics2::PulleyJointSecondGroundAnchorX(number)
Pulley joint second ground anchor X
🔢 Number
Joint ID
Object.Physics2::PulleyJointSecondGroundAnchorY(number)
Pulley joint second ground anchor Y
🔢 Number
Joint ID
Object.Physics2::PulleyJointSecondLength(number)
Pulley joint second length
🔢 Number
Joint ID
Object.Physics2::Restitution()
Get the restitution of an object.
Object.Physics2::RevoluteJointAngle(number)
Revolute joint current angle
🔢 Number
Joint ID
Object.Physics2::RevoluteJointMaxAngle(number)
Revolute joint maximum angle
🔢 Number
Joint ID
Object.Physics2::RevoluteJointMaxMotorTorque(number)
Revolute joint maximum motor torque
🔢 Number
Joint ID
Object.Physics2::RevoluteJointMinAngle(number)
Revolute joint minimum angle
🔢 Number
Joint ID
Object.Physics2::RevoluteJointMotorSpeed(number)
Revolute joint motor speed
🔢 Number
Joint ID
Object.Physics2::RevoluteJointMotorTorque(number)
Revolute joint motor torque
🔢 Number
Joint ID
Object.Physics2::RevoluteJointReferenceAngle(number)
Revolute joint reference angle
🔢 Number
Joint ID
Object.Physics2::RevoluteJointSpeed(number)
Revolute joint angular speed
🔢 Number
Joint ID
Object.Physics2::RopeJointMaxLength(number)
Rope joint maximum length
🔢 Number
Joint ID
Object.Physics2::TimeScale()
World time scale
Object.Physics2::WeldJointDampingRatio(number)
Weld joint damping ratio
🔢 Number
Joint ID
Object.Physics2::WeldJointFrequency(number)
Weld joint frequency
🔢 Number
Joint ID
Object.Physics2::WeldJointReferenceAngle(number)
Weld joint reference angle
🔢 Number
Joint ID
Object.Physics2::WheelJointAxisAngle(number)
Wheel joint axis angle
🔢 Number
Joint ID
Object.Physics2::WheelJointDampingRatio(number)
Wheel joint damping ratio
🔢 Number
Joint ID
Object.Physics2::WheelJointFrequency(number)
Wheel joint frequency
🔢 Number
Joint ID
Object.Physics2::WheelJointMaxMotorTorque(number)
Wheel joint maximum motor torque
🔢 Number
Joint ID
Object.Physics2::WheelJointMotorSpeed(number)
Wheel joint motor speed
🔢 Number
Joint ID
Object.Physics2::WheelJointMotorTorque(number)
Wheel joint motor torque
🔢 Number
Joint ID
Object.Physics2::WheelJointSpeed(number)
Wheel joint speed
🔢 Number
Joint ID
Object.Physics2::WheelJointTranslation(number)
Wheel joint current translation
🔢 Number
Joint ID
Player Authentication
Allow your game to authenticate players. Read more explanations about it.
Expression
Description
PlayerAuthentication::UserID()
Get the unique user ID of the authenticated player.
PlayerAuthentication::Username()
Get the username of the authenticated player.
Spine (experimental)
Display and smoothly animate a 2D object with skeletal animations made with Spine. Use files exported from Spine (json, atlas and image). Read more explanations about it.
Object.Animation()
返回两个动画之间平滑过渡的持续时间（以秒为单位）。🔤 名称 (字符串)
Tween 标识符
平滑地动画化对象的位置、角度、缩放和其他属性。对其进行更多解释。
表达式
描述
Object.Tween::Progress(string)
返回缓动的进度（介于 0.0 和 1.0 之间）。
🔤 名称 (字符串)
Tween 标识符
Object.Tween::Value(string)
返回缓动的值。对于具有多个值的缓动，该值始终为 0。
🔤 名称 (字符串)
Tween 标识符
视频
显示视频。对其进行更多解释。
表达式
描述
Object.CurrentTime()
返回视频对象的当前时间（以秒为单位）。
Object.Duration()
返回视频对象的持续时间（以秒为单位）。
Object.PlaybackSpeed()
返回视频对象的播放速度
Object.Volume()
获取视频对象的音量，范围在 0（静音）和 100（最大）之间。