核心組件
- StateMachine:持有當前狀態,驅動
tick() 推進
- BaseState:抽象基類,定義
enter/do_work/exit 生命周期 + add_transition(condition, next_state)
- Transition:
(condition_callable, next_state),條件滿足時觸發遷移
框架代碼
import random
from time import sleep
from random import shuffle
class StateMachine:
def set_starting_state(self, state):
state.enter()
self.state = state
def tick(self):
next_state = self.state.check_transitions()
if next_state is None:
self.state.do_work()
else:
self.state.exit()
next_state.enter()
self.state = next_state
class BaseState:
def add_transition(self, condition, next_state):
assert callable(condition)
assert hasattr(next_state, 'enter') and callable(next_state.enter)
assert hasattr(next_state, 'do_work') and callable(next_state.do_work)
assert hasattr(next_state, 'exit') and callable(next_state.exit)
if not hasattr(self, 'transitions'):
self.transitions = []
self.transitions.append((condition, next_state))
def check_transitions(self):
if hasattr(self, 'transitions'):
shuffle(self.transitions) # 隨機順序,避免優先級固化
for cond, state in self.transitions:
if cond():
return state
return None
def enter(self): pass
def do_work(self): pass
def exit(self): pass
實戰示例:角色移動狀態機
class WalkingState(BaseState):
def enter(self):
print("→ Walking")
def to_jog(): return random.randint(1,5) == 5
def to_run(): return random.randint(1,5) == 5
self.add_transition(to_jog, JoggingState())
self.add_transition(to_run, RunningState())
def do_work(self): print(" Walking...")
def exit(self): print("← Walking")
class JoggingState(BaseState):
def enter(self):
print("→ Jogging")
self.stamina = random.randint(5, 15)
self.add_transition(lambda: self.stamina <= 0, WalkingState())
def do_work(self):
self.stamina -= 1
print(f" Jogging (stamina={self.stamina})")
def exit(self): print("← Jogging")
class RunningState(BaseState):
def enter(self):
print("→ Running")
self.stamina = random.randint(5, 15)
self.add_transition(lambda: self.stamina <= 0, WalkingState())
self.add_transition(lambda: random.randint(1,10) == 10, TrippingState())
def do_work(self):
self.stamina -= 2
print(f" Running (stamina={self.stamina})")
def exit(self): print("← Running")
class TrippingState(BaseState):
def enter(self):
print("→ Tripped!")
self.tripped = False
self.add_transition(lambda: self.tripped, WalkingState())
def do_work(self):
print(" Ouch!")
self.tripped = True
def exit(self): print("← Tripping")
運行
if __name__ == '__main__':
sm = StateMachine()
sm.set_starting_state(WalkingState())
try:
while True:
sm.tick()
sleep(1)
except KeyboardInterrupt:
print("\nStopped.")
優勢
- 狀態邏輯封裝,單一職責
- 轉移條件集中管理,易於擴展新狀態
- 適用於:遊戲 AI、工作流引擎、協議狀態、UI 交互流程