#百家乐游戏结果格式规范
本文档描述了APIs 游戏中百家乐游戏结果所使用的格式。
#概述
百家乐游戏结果代表闲家和庄家位置的牌指数。结果以字符串形式提供，其中包含由分隔符分隔的卡片索引。
#格式结构
格式："playerCards-bankerCards" 其中卡片是逗号分隔的索引。
#格式模式
<playerCard1>,<playerCard2>,...-<bankerCard1>,<bankerCard2>,...
#组件
- 玩家卡牌：连字符之前以逗号分隔的卡牌索引 (
-) - 银行家卡：连字符后以逗号分隔的卡索引 (
-) - 分隔符：连字符 (
-) 分隔玩家牌和庄家牌
#卡片索引
卡片索引从 1 到 52，遵循以下映射：
#索引模式
牌首先按牌值索引，然后按花色索引。对于每个牌值（A 到 K），在移动到下一个牌值之前，所有四种花色都会被分配连续的索引。
#套装顺序
在每张牌的面值中，花色的顺序如下：
- 黑桃 ♠
- 俱乐部♣
- 钻石 ❖
- 心♥
#卡值顺序
卡牌面值顺序为：A、2、3、4、5、6、7、8、9、10、J、Q、K
#完整映射
| 指数范围 | 卡值 | 套装（按顺序） |
|---|---|---|
| 1-4 | 1-4王牌 | 黑桃、梅花、方块、红心 |
| 5-8 | 2 | 黑桃、梅花、方块、红心 |
| 9-12 | 3 | 黑桃、梅花、方块、红心 |
| 13-16 | 4 | 黑桃、梅花、方块、红心 |
| 17-20 | 17-20 5 | 黑桃、梅花、方块、红心 |
| 21-24 | 21-24 6 | 黑桃、梅花、方块、红心 |
| 25-28 | 25-28 7 | 黑桃、梅花、方块、红心 |
| 29-32 | 29-32 8 | 黑桃、梅花、方块、红心 |
| 33-36 | 33-36 9 | 黑桃、梅花、方块、红心 |
| 37-40 | 37-40 10 | 10黑桃、梅花、方块、红心 |
| 41-44 | 41-44杰克 | 黑桃、梅花、方块、红心 |
| 45-48 | 45-48女王 | 黑桃、梅花、方块、红心 |
| 49-52 | 49-52国王 | 黑桃、梅花、方块、红心 |
#示例
1, 15, 25, 40
解释：
- 1 = 黑桃 A
- 15 = 4 梅花
- 25 = 黑桃 7
- 40 = 红心 10
#计算公式
要从索引确定牌值和花色：
卡面值：
value = floor((index - 1) / 4) + 1- 映射到：1=A、2-10=数字、11=杰克、12=皇后、13=国王
套装：
suit_index = (index - 1) % 4- 映射到：0=黑桃、1=梅花、2=方块、3=红心
索引 33 的计算示例：
- 值：
floor((33-1)/4) + 1 = floor(32/4) + 1 = 8 + 1 = 9→ 9 - 花色：
(33-1) % 4 = 32 % 4 = 0→ 黑桃 - 结果：黑桃 9
#示例
#示例 1：每张两张牌（标准百家乐）
"33,37-29,29"
解释：
- 玩家：
- 卡牌 33 = 黑桃 9
- 卡牌 37 = 黑桃 10
- 银行家：
- 卡 29 = 黑桃 8
- 卡 29 = 黑桃 8（重复卡）
#示例 2：每张三张牌（抽出第三张牌）
"1,5,9-2,6,10"
解释：
- 玩家：
- 卡 1 = 黑桃 A
- 卡 5 = 黑桃 2
- 卡牌 9 = 黑桃 3
- 银行家：
- 卡 2 = 梅花 A
- 卡 6 = 2 梅花
- 卡 10 = 3 梅花
#示例 3：混合（闲家 2 张牌，庄家 3 张牌）
"15,20-25,30,35"
解释：
- 玩家：
- 卡 15 = 梅花 4
- 卡 20 = 梅花 5
- 银行家：
- 卡 25 = 黑桃 7
- 卡 30 = 梅花 8
- 卡 35 = 梅花 9
#百家乐游戏规则
在百家乐中：
- 每手牌（闲家和庄家）可以收到 2 或 3 张牌
- 根据标准百家乐规则发牌
- 结果格式反映了每个位置实际发的牌
#验证
处理百家乐游戏结果时：
- 确保格式与模式匹配：
"<cards>-<cards>" - 验证卡片索引是否在有效范围内（1-52）
- 检查逗号分隔值是否为有效整数
- 处理闲家或庄家可能有 2 或 3 张牌的情况（标准百家乐规则）
- 验证每手牌的数量是否符合百家乐游戏规则