166 lines
11 KiB
JSON
166 lines
11 KiB
JSON
{
|
|
"460": "LimboAI 类型化参数的基类。",
|
|
"461": "LimboAI 类型化参数的基类，既可以引用 <l1>Blackboard</l> 变量，也可以直接保存某个 Variant.Type 类型的原始值。",
|
|
"462": "<b>注意</b>：不要直接实例化，请改用具体的子类型。",
|
|
"463": "<l1>saved_value</l>",
|
|
"464": "<l1>ValueSource</l>",
|
|
"465": "<l1>value_source</l>",
|
|
"466": "<l1>variable</l>",
|
|
"467": "Variant.Type",
|
|
"468": "<l1>get_type</l>() <2/>",
|
|
"469": "<l1>get_value</l>(scene_root: <2/>, blackboard: <l3>Blackboard</l>, default: <4/> = null)",
|
|
"470": "enum <b>ValueSource</b>: <l1>🔗</l>",
|
|
"471": "<l1>ValueSource</l> <b>SAVED_VALUE</b> = <2/>",
|
|
"472": "值直接存储在 BBParam 资源中。",
|
|
"473": "<l1>ValueSource</l> <b>BLACKBOARD_VAR</b> = <2/>",
|
|
"474": "值通过变量名引用，并从 <l1>Blackboard</l> 中获取。变量名存储在 BBParam 资源中。",
|
|
"475": "<1/> <b>saved_value</b> = <2/> <l3>🔗</l>",
|
|
"476": "<1/> <b>set_saved_value</b>(value: <2/>)",
|
|
"477": "<1/> <b>get_saved_value</b>()",
|
|
"478": "当 <l1>value_source</l> 设为 <l2>SAVED_VALUE</l> 时，用于存储参数值。值的类型由 <l3>get_type</l> 决定。",
|
|
"479": "<l1>ValueSource</l> <b>value_source</b> = <2/> <l3>🔗</l>",
|
|
"480": "<1/> <b>set_value_source</b>(value: <l2>ValueSource</l>)",
|
|
"481": "<l1>ValueSource</l> <b>get_value_source</b>()",
|
|
"482": "指定 BBParam 取值的来源。见 <l1>ValueSource</l>。",
|
|
"483": "<1/> <b>variable</b> <l2>🔗</l>",
|
|
"484": "<1/> <b>set_variable</b>(value: <2/>)",
|
|
"485": "<1/> <b>get_variable</b>()",
|
|
"486": "当 <l2>value_source</l> 设为 <l3>BLACKBOARD_VAR</l> 时，存储 <l1>Blackboard</l> 变量的名称。",
|
|
"487": "Variant.Type <b>get_type</b>() <1/> <l2>🔗</l>",
|
|
"488": "返回该参数预期的数据类型。",
|
|
"489": "<1/> <b>get_value</b>(scene_root: <2/>, blackboard: <l3>Blackboard</l>, default: <4/> = null) <l5>🔗</l>",
|
|
"490": "返回该参数的值。",
|
|
"491": "LimboState",
|
|
"492": "<b>被继承：</b><l1>BTState</l>、<l2>LimboHSM</l>",
|
|
"493": "用于分层状态机（HSM）的状态节点。",
|
|
"494": "LimboAI 中用于分层状态机（HSM）的状态节点。",
|
|
"495": "你可以通过继承这个类来编写自己的状态行为。要实现状态逻辑，可以重写 <l1>_enter</l>、<l2>_exit</l>、<l3>_setup</l> 和 <l4>_update</l>。或者，你也可以用 <5/> 方法把状态实现委托给外部方法。",
|
|
"496": "关于状态机的更多细节，请参阅 <l1>LimboHSM</l>。",
|
|
"497": "<l1>EVENT_FINISHED</l>",
|
|
"498": "<l1>agent</l>",
|
|
"499": "<l1>blackboard</l>",
|
|
"500": "<l1>blackboard_plan</l>",
|
|
"501": "<l1>_enter</l>() <2/>",
|
|
"502": "<l1>_exit</l>() <2/>",
|
|
"503": "<l1>_setup</l>() <2/>",
|
|
"504": "<l1>_update</l>(delta: <2/>) <3/>",
|
|
"505": "<l1>add_event_handler</l>(event: <2/>, handler: <3/>)",
|
|
"506": "<l1>LimboState</l>",
|
|
"507": "<l1>call_on_enter</l>(callable: <2/>)",
|
|
"508": "<l1>call_on_exit</l>(callable: <2/>)",
|
|
"509": "<l1>call_on_update</l>(callable: <2/>)",
|
|
"510": "<l1>clear_guard</l>()",
|
|
"511": "<l1>dispatch</l>(event: <2/>, cargo: <3/> = null)",
|
|
"512": "<l1>get_root</l>() <2/>",
|
|
"513": "<l1>is_active</l>() <2/>",
|
|
"514": "<l1>named</l>(name: <2/>)",
|
|
"515": "<l1>set_guard</l>(guard_callable: <2/>)",
|
|
"516": "<b>entered</b>() <l1>🔗</l>",
|
|
"517": "当状态被进入时发出。",
|
|
"518": "<b>exited</b>() <l1>🔗</l>",
|
|
"519": "当状态被退出时发出。",
|
|
"520": "<b>setup</b>() <l1>🔗</l>",
|
|
"521": "当状态被初始化时发出。",
|
|
"522": "<b>updated</b>(delta: <1/>) <l2>🔗</l>",
|
|
"523": "当状态被更新时发出。",
|
|
"524": "<1/> <b>EVENT_FINISHED</b> <l2>🔗</l>",
|
|
"525": "<1/> <b>event_finished</b>()",
|
|
"526": "一个常用事件，表示状态已经完成其工作。",
|
|
"527": "<1/> <b>agent</b> <l2>🔗</l>",
|
|
"528": "与该状态关联的智能体，在初始化时赋值。",
|
|
"529": "<l1>Blackboard</l> <b>blackboard</b> <l2>🔗</l>",
|
|
"530": "该状态所属状态机中各状态共享的键值数据存储。",
|
|
"531": "<l1>BlackboardPlan</l> <b>blackboard_plan</b> <l2>🔗</l>",
|
|
"532": "<1/> <b>_enter</b>() <2/> <l3>🔗</l>",
|
|
"533": "当状态被进入时调用。",
|
|
"534": "<1/> <b>_exit</b>() <2/> <l3>🔗</l>",
|
|
"535": "当状态被退出时调用。这会在转换到另一个状态时发生，也会在状态机从场景树中被移除时发生（例如节点被 Node.queue_free 释放或场景切换）。由于实现细节，<l1>_exit</l> 不会在调用 Object.free 时被执行！",
|
|
"536": "<1/> <b>_setup</b>() <2/> <l3>🔗</l>",
|
|
"537": "在初始化期间被调用一次。用这个方法初始化你的状态。",
|
|
"538": "<1/> <b>_update</b>(delta: <2/>) <3/> <l4>🔗</l>",
|
|
"539": "在更新期间调用。用这个方法实现你状态的行为。",
|
|
"540": "<1/> <b>add_event_handler</b>(event: <2/>, handler: <3/>) <l4>🔗</l>",
|
|
"541": "注册一个 <1/>，在 <2/> 被派发时调用。处理函数应具有以下签名：",
|
|
"542": "如果处理函数返回 <1/>，事件将被消费。Cargo 是可选参数，可以传给处理函数。另见 <l2>dispatch</l>。",
|
|
"543": "<l1>LimboState</l> <b>call_on_enter</b>(callable: <2/>) <l3>🔗</l>",
|
|
"544": "链式方法，把 <l1>entered</l> 信号连接到一个 <2/>。",
|
|
"545": "<l1>LimboState</l> <b>call_on_exit</b>(callable: <2/>) <l3>🔗</l>",
|
|
"546": "链式方法，把 <l1>exited</l> 信号连接到一个 <2/>。",
|
|
"547": "<l1>LimboState</l> <b>call_on_update</b>(callable: <2/>) <l3>🔗</l>",
|
|
"548": "链式方法，把 <l1>updated</l> 信号连接到一个 <2/>。",
|
|
"549": "<1/> <b>clear_guard</b>() <l2>🔗</l>",
|
|
"550": "清除守卫函数，移除之前由 <l2>set_guard</l> 设置的 <1/>。",
|
|
"551": "<1/> <b>dispatch</b>(event: <2/>, cargo: <3/> = null) <l4>🔗</l>",
|
|
"552": "递归派发一个名为 <1/> 的状态机事件，可选参数为 <2/>。如果事件被消费则返回 <3/>。",
|
|
"553": "事件会从叶状态向根状态传播，一旦某个状态消费了该事件，传播就会停止。如果状态有相关的转换或事件处理器，它就会消费该事件。关于事件处理器的更多信息，见 <l1>add_event_handler</l>。",
|
|
"554": "<l1>LimboState</l> <b>get_root</b>() <2/> <l3>🔗</l>",
|
|
"555": "返回根 <b>LimboState</b>。",
|
|
"556": "<1/> <b>is_active</b>() <2/> <l3>🔗</l>",
|
|
"557": "如果当前处于活动状态（即它是父级 <l2>LimboHSM</l> 的活动子状态），则返回 <1/>。",
|
|
"558": "<l1>LimboState</l> <b>named</b>(name: <2/>) <l3>🔗</l>",
|
|
"559": "用于设置此状态名称的链式方法。",
|
|
"560": "<1/> <b>set_guard</b>(guard_callable: <2/>) <l3>🔗</l>",
|
|
"561": "设置守卫（guard）函数，每当考虑转换到该状态时都会调用它。如果该函数返回 <1/>，该转换将被禁止。",
|
|
"562": "LimboHSM",
|
|
"563": "<b>继承：</b><l1>LimboState</l>",
|
|
"564": "基于事件的分层状态机（HSM）。",
|
|
"565": "基于事件的分层状态机（HSM），用于管理 <l1>LimboState</l> 实例并处理它们之间的转换。LimboHSM 本身就是一个 <l2>LimboState</l>，也可以作为另一个 LimboHSM 节点的子节点。",
|
|
"566": "<l1>LimboState</l>",
|
|
"567": "<l1>ANYSTATE</l>",
|
|
"568": "<l1>initial_state</l>",
|
|
"569": "<l1>UpdateMode</l>",
|
|
"570": "<l1>update_mode</l>",
|
|
"571": "<l1>add_transition</l>(from_state: <l2>LimboState</l>, to_state: <l3>LimboState</l>, event: <4/>, guard: <5/> = Callable())",
|
|
"572": "<l1>change_active_state</l>(state: <l2>LimboState</l>)",
|
|
"573": "<l1>get_active_state</l>() <2/>",
|
|
"574": "<l1>get_leaf_state</l>() <2/>",
|
|
"575": "<l1>get_previous_active_state</l>() <2/>",
|
|
"576": "<l1>has_transition</l>(from_state: <l2>LimboState</l>, event: <3/>) <4/>",
|
|
"577": "<l1>initialize</l>(agent: <2/>, parent_scope: <l3>Blackboard</l> = null)",
|
|
"578": "<l1>remove_transition</l>(from_state: <l2>LimboState</l>, event: <3/>)",
|
|
"579": "<l1>set_active</l>(active: <2/>)",
|
|
"580": "<l1>update</l>(delta: <2/>)",
|
|
"581": "<b>active_state_changed</b>(current: <l1>LimboState</l>, previous: <l2>LimboState</l>) <l3>🔗</l>",
|
|
"582": "当当前活动的子状态切换到另一个子状态时发出。",
|
|
"583": "enum <b>UpdateMode</b>: <l1>🔗</l>",
|
|
"584": "<l1>UpdateMode</l> <b>IDLE</b> = <2/>",
|
|
"585": "在空闲处理期间更新状态机。",
|
|
"586": "<l1>UpdateMode</l> <b>PHYSICS</b> = <2/>",
|
|
"587": "在物理处理期间更新状态机。",
|
|
"588": "<l1>UpdateMode</l> <b>MANUAL</b> = <2/>",
|
|
"589": "通过在脚本中调用 <l1>update</l> 来手动更新状态机。",
|
|
"590": "<l1>LimboState</l> <b>ANYSTATE</b> <l2>🔗</l>",
|
|
"591": "<l1>LimboState</l> <b>anystate</b>()",
|
|
"592": "用于定义“从任意状态出发”的转换。",
|
|
"593": "<l1>LimboState</l> <b>initial_state</b> <l2>🔗</l>",
|
|
"594": "<1/> <b>set_initial_state</b>(value: <l2>LimboState</l>)",
|
|
"595": "<l1>LimboState</l> <b>get_initial_state</b>()",
|
|
"596": "使用 <l1>set_active</l> 方法激活状态机时会变为活动的子状态。如果没有显式设置，LimboHSM 的第一个子节点将被视为初始状态。",
|
|
"597": "<l1>UpdateMode</l> <b>update_mode</b> = <2/> <l3>🔗</l>",
|
|
"598": "<1/> <b>set_update_mode</b>(value: <l2>UpdateMode</l>)",
|
|
"599": "<l1>UpdateMode</l> <b>get_update_mode</b>()",
|
|
"600": "指定状态机应在何时更新。见 <l1>UpdateMode</l>。",
|
|
"601": "<1/> <b>add_transition</b>(from_state: <l2>LimboState</l>, to_state: <l3>LimboState</l>, event: <4/>, guard: <5/> = Callable()) <l6>🔗</l>",
|
|
"602": "建立从一个状态到另一个状态的转换，在 <1/> 被派发时触发。<2/> 和 <3/> 都必须是此 <b>LimboHSM</b> 的直接子节点。",
|
|
"603": "可选地，可以指定一个 <1/> 函数，它必须返回布尔值。如果守卫函数返回 <2/>，则不会发生转换。守卫函数会在考虑该转换之前立即被调用。关于状态级别的守卫函数，请查看 <l3>LimboState.set_guard</l>。",
|
|
"604": "<1/> <b>change_active_state</b>(state: <l2>LimboState</l>) <l3>🔗</l>",
|
|
"605": "把当前活动的子状态切换为 <1/>。如果 <2/> 已经处于活动状态，它会被退出并重新进入。",
|
|
"606": "<1/> 必须是此 <b>LimboHSM</b> 的子节点。",
|
|
"607": "<l1>LimboState</l> <b>get_active_state</b>() <2/> <l3>🔗</l>",
|
|
"608": "返回当前活动的子状态。",
|
|
"609": "<l1>LimboState</l> <b>get_leaf_state</b>() <2/> <l3>🔗</l>",
|
|
"610": "返回状态机中当前活动的叶状态。",
|
|
"611": "<l1>LimboState</l> <b>get_previous_active_state</b>() <2/> <l3>🔗</l>",
|
|
"612": "返回上一个活动的子状态。",
|
|
"613": "<1/> <b>has_transition</b>(from_state: <l2>LimboState</l>, event: <3/>) <4/> <l5>🔗</l>",
|
|
"614": "如果存在从 <2/> 出发、针对给定 <3/> 的转换，则返回 <1/>。",
|
|
"615": "<1/> <b>initialize</b>(agent: <2/>, parent_scope: <l3>Blackboard</l> = null) <l4>🔗</l>",
|
|
"616": "初始化该状态，并为它自身及所有子状态调用 <l1>LimboState._setup</l>。",
|
|
"617": "<1/> <b>remove_transition</b>(from_state: <l2>LimboState</l>, event: <3/>) <l4>🔗</l>",
|
|
"618": "移除某个状态上与特定 <1/> 关联的转换。",
|
|
"619": "<1/> <b>set_active</b>(active: <2/>) <l3>🔗</l>",
|
|
"620": "设为 <1/> 时，会把状态切换到 <l2>initial_state</l>，并根据 <l3>update_mode</l> 激活状态处理。",
|
|
"621": "<1/> <b>update</b>(delta: <2/>) <l3>🔗</l>",
|
|
"622": "对它自身和活动子状态调用 <l1>LimboState._update</l>，调用会逐级向下传递到叶状态。如果 <l2>update_mode</l> 未设为 <l3>MANUAL</l>，此方法会自动触发。"
|
|
}
|