#百家樂遊戲結果格式規範
本文檔描述了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 張牌的情況（標準百家樂規則）
- 驗證每手牌的數量是否符合百家樂遊戲規則