DouZero_API

API 交互斗地主 AI

本项目基于DouZero

调用API

程序默认运行于24813端口 目前只支持post方法调用，请求头 Content-Type: application/json

{
  "action": string,
  "data": object
}

参数名	说明
action	上报类型，可选"init"/"play"，对应 初始化游戏/游戏进程上报
data	上报数据，见下方

上报数据：

初始化游戏

{
  "pid": string / int,
  "three_landlord_cards": string,
  "ai_amount": int,
  "player_data":[
    {
      "model": string,
      "hand_cards": string,
      "position_code": int
    },
    {
      "model": string,
      "hand_cards": string,
      "position_code": int
    }
  ]
}

参数名	说明	示例
pid	对局唯一标识，若为int类型会自动转为string	10001
three_landlord_cards	三张地主牌	"444"
ai_amount	AI玩家数量，为1或2	2
player_data	AI玩家数据，AI玩家数为1时只会读取数组中的第一个元素，内容元素见下方	\
model	AI玩家使用的模型	"WP"
hand_cards	AI玩家的手牌	"333444456789TJQKA2XD"
position_code	AI玩家的位号 0-地主上家，1-地主，2-地主下家	1

完整示例

{
  "action": "init",
  "data": {
    "three_landlord_cards": "444",
    "pid": 10001,
    "ai_amount": 2,
    "player_data": [
      {
        "model": "WP",
        "hand_cards": "333444456789TJQKA2XD",
        "position_code": 1
      },
      {
        "model": "WP",
        "hand_cards": "3555666777888999T",
        "position_code": 2
      }
    ]
  }
}

游戏进程上报

也就是上报玩家出牌

{
  "pid": string / int,
  "player": int,
  "cards": string
}

参数名	说明	示例
pid	对局唯一标识，若为int类型会自动转为string	10001
player	出牌玩家位号	0
cards	玩家出的牌，为空字符串则表示不要	"TJQKA"

程序并不会检测玩家所出的牌是否遵循规则，请保证上报数据准确

完整示例

{
  "action": "play",
  "data": {
    "pid": 10001,
    "player": 0,
    "cards": "TJQKA"
  }
}

API响应

{
  "type": string,
  "action": string,
  "status": string,
  "msg": string,
  "data": object
}

参数名	说明
type	响应类型，与上报数据的action相对应，上报"play"时为"step"
action	响应AI操作，尚未轮到AI出牌时为"receive"，AI出牌时为"play"
status	响应状态，为"ok"/"fail"
msg	错误信息，响应状态为"fail"时不为空
data	响应数据，见下方

响应数据：

{
  "pid": pid,
  "game_over": boolen,
  "play": [
    {
      "cards": array,
      "confidence": string
    },
    {
      "cards": array,
      "confidence": string
    }
  ]
}

参数名	说明
pid	对应对局标识
game_over	对局是否结束，结束则为true
play	AI出牌数据，action为"receive"时无此元素，元素内容见下方
cards	AI出的牌，为数组类型
confidence	AI的胜率估计

预设模型简介

• WP

DouZero-WP (baselines/douzero_WP/): 以胜率（Winning Percentage, WP）为目标训练的Douzero智能体

• ADP

DouZero-ADP (baselines/douzero_ADP/): 以平均分数差异（Average Difference Points, ADP）为目标训练的Douzero智能体

大概更倾向于出炸弹刷分

自定义运行端口

程序默认运行于0.0.0.0:24813，通过-H参数修改host，-p参数修改端口，如：

DouZero_API.exe -H 127.0.0.1 -p 24814

python start.py -H 127.0.0.1 -p 24814

超时检测

程序每5分钟将检查一次进程列表，超过半个小时未响应的游戏进程将被删除。

使用自己的模型

在baselines/文件夹下新建文件夹，将自己训练的landlord.ckpt、landlord_up.ckpt、landlord_down.ckpt扔进去，文件夹名即为游戏初始化时需要填入的"model"参数

鸣谢

• 本项目基于DouZero
• 借鉴了DouZero_For_HappyDouDiZhu项目的部分代码与写法