Files
zt-online-game-backend/internal/room/ai.go
T

51 lines
1.8 KiB
Go

package room // 与 room.go 同包
import (
"log/slog" // 标准库:记录 AI 驱动异常
"git.lzcwy.cn/zhengchiliu/zt-online-game-backend/internal/dto"
"git.lzcwy.cn/zhengchiliu/zt-online-game-backend/internal/game"
)
// driveAI 让房间里的 AI 玩家先行动,再交给玩法推进世界。
//
// AI 由玩法自己决定怎么走(玩法实现可选的 game.AIBrain 接口):
// 房间只是把玩法返回的动作代 AI 执行一遍,因此:
// - 房间不知道谁是 AI,也不需要知道(对外完全无差别)
// - 未实现 AIBrain 的玩法不会被补 AI(匹配器在建房前会校验)
func (r *Room) driveAI(now int64) {
if r.status != StatusPlaying { // 仅对局中才行动
return
}
brain, ok := r.g.(game.AIBrain) // 玩法是否支持 AI
if !ok { // 不支持:直接跳过
return
}
actions := brain.TickAI(now, r.state) // 问玩法:AI 本回合要做什么
if len(actions) == 0 { // AI 本回合无动作(如还在思考)
return
}
for _, a := range actions { // 逐个代 AI 执行
events, finish, err := r.g.OnAction(a.UID, a.Action, r.state)
if err != nil { // 玩法拒绝(如不是该 AI 的回合):忽略即可,下一回合再试
slog.Debug("room ai action rejected", "room_id", r.id,
"user_id", a.UID, "error", err)
continue
}
r.deliver(events) // 投递 AI 行为产生的事件
if finish != nil { // AI 走完直接分出胜负
r.finishGame(finish)
return
}
r.broadcastState() // 让所有人看到 AI 的落子/转向结果
}
}
// Roster 返回本房间的玩家名册(昵称、头像、座位),供匹配通知与结算展示使用。
// 名册里包含 AI,但没有任何 AI 标识,客户端无法区分。
func (r *Room) Roster() []dto.PlayerBrief {
return r.roster
}