# Keypad 新版規格文件
###### tags: `keypad`

Zeplin切圖：[XG_game&keypad>Keypad_V2](https://reurl.cc/Qj243o)
AXURE : [AXURE-V2.4](https://5q01xj.axshare.com/)

## <font color="#0089A7"> 版本修訂 </font>
:::spoiler {state="open"} 版本 V1.2
* 時間：2021/12/20
* 項目
1. 桌號擴充為四碼英數字
2. 移除「開放時間」功能
3. 自動發牌移除快捷鍵處理，觸發設定於RD內建的UI
:::

:::spoiler {state="open"} 版本 V2.0
* 時間：2021/12/27
* 項目
1. 移除「keypad狀態」提示
2. UI介面位置更動：荷官資料、視頻畫面
3. 「開牌結果」提示更改為覆蓋顯示
:::

:::spoiler {state="open"} 版本 V2.1
* 時間：2022/01/07
* 項目
1. 各遊戲
若連續開出相同遊戲結果，將顯示「連贏提示」。
2. 百家樂、龍虎
測試模式依照遊戲刷卡位置更改UI。
3. 色諜
手動改牌更改顯示邏輯，選擇項目為五種開牌結果。搖骰提示增加隨機搖骰次數。
4. 輪盤
開獎區域輸入結果更改為輸入數字，增加手動改牌功能。
:::

:::spoiler {state="open"} 版本 V2.2
* 時間：2022/01/17
* 項目
1. 更改提示語狀態：「取消此局」狀態顯示依據Server流程；「準備進入中場休息」更改為橫幅提示。
2. 中場休息：增加接收維護訊息狀態。
3. 增加刷卡輸入荷官員工編號功能。
:::

:::spoiler {state="open"} 版本 V2.3
* 時間：2022/02/17
* 項目
1. 遊戲輪局號更改文案，Round ➜ Shoe 、 Run ➜ Round。

:::spoiler {state="open"} 版本 V2.4
* 時間：2023/08/16
* 項目
1. 新增聊天打賞視窗，功能說明於H處說明。
2. 因新增聊天打賞視窗，微調UI擺放位置，功能皆無更動。
:::

## <font color="#0089A7"> 功能說明 </font>
圖示以百家樂Keypad畫面進行示意

A 遊戲名稱
B 桌號、輪局號
C 中場休息
D 荷官資料
E 視頻畫面
F 倒時器
G1 開獎區域
G2 確認按鈕
H 打賞聊天室

### <font color="#0089A7"> A 遊戲名稱 </font>
1. 遊戲名稱顯示皆為大寫，分別為以下
* 百家樂：BACCARAT
* 龍虎：DRAGON TIGER
* 輪盤：ROULETTE
* 骰寶：SICBO
* 極速骰寶：SPEED SICBO
* 色碟：SEDIE
2. 流程
* 點擊左上方遊戲名稱，彈窗顯示選擇項目，[取消當局]或[設定keypad]，如下圖。
* 取消當局
(1) 點擊  按鈕
(2) 請主管輸入密碼，再次確認是否要取消當局
(2-1) 輸入密碼後，點擊  將取消當局，遊戲進入中場休息狀態
(2-2) 選擇  返回keypad畫面，遊戲繼續進行
* 設定keypad：調整keypad設定，點擊  彈窗顯示設定視窗。

彈窗提示示意圖

### <font color="#0089A7"> B 桌號、輪局號 </font>
詳細資料由Key Server提供。
1. 桌號：由四碼英數字組成，需可修改英數字。
2. 輪號
* **百家樂、龍虎**：一靴牌靴為一輪，當荷官發牌發至紅卡時，需等待該局遊戲結果出現後，再進行更換新牌靴，換完牌靴開新局後輪號即可變更。
* **輪盤、骰寶、極速骰寶、色碟**：一工作天為一輪，直至下一個工作天，輪號才可更動。
3. 局號：依每局結束而更動。

### <font color="#0089A7"> C 中場休息 </font>
當現場手動進行中場休息及接收後臺維護訊息時，顯示此狀態。

<font color="#0089A7"> **手動維護流程說明** </font>
1. 點擊[中場休息]按鈕
(點擊彈窗)➜
2. 彈窗確認是否進入中場休息
（2-1） 選擇[確認]將關閉彈窗，[中場休息]變更為[等待結算完畢]，結算後顯示[進入新局]，遊戲畫面顯示中場休息畫面，中場休息狀態不可遮蓋到「進入新局」按鈕，如下圖。
(變更)➜(本局結算完畢後)➜
（2-1-1） 點擊[進入新局]即可進入新局。
（2-2） 選擇[取消]將關閉彈窗，返回遊戲keypad畫面。

<font color="#0089A7"> :bulb: **測試模式** </font>

僅有==卡牌遊戲==有[測試模式]功能，卡牌遊戲包含百家樂、龍虎遊戲。
* **觸發**
點擊「中場休息」彈窗顯示「測試模式」視窗，唯有keypad在中場休息狀態才能觸發此視窗，點擊  將關閉視窗，如下圖。

 (點擊)➜彈窗顯示 

* **狀態**
預設狀態為無卡牌的方框，當測試人員測試刷卡時，方格顯示刷卡的卡牌，若再次刷卡則直接覆蓋舊卡牌顯示新卡牌。
* 百家樂：共有五個刷牌位置，包含B1、B2、P1、P2及補牌。
* 龍虎：共兩個刷牌位置，包含T、D。

ex:
| 狀態 | 百家樂 | 龍虎 |
| -------- | -------- | -------- |
| 一開始狀態 | 方框標示B1、B2、P1、P2及補牌位置|方框標示T、D的位置|
| 測試人員拿取卡牌測試刷卡 |B1、B2測試刷卡，B1顯示[黑桃6]；B2示[紅心2] |D位置測試刷卡，顯示[紅心2] |
| 測試人員再次確認刷卡 |B1再次刷卡卡牌為[菱形Q]，原本B1顯示[黑桃6]卡牌覆蓋為[菱形Q]<br>|D位置再次刷卡卡牌為[菱形Q]，原本顯示[紅心2]卡牌覆蓋為[菱形Q]<br>|

### <font color="#0089A7"> D 荷官資料 </font>
詳細資料由Key Server提供。
1. 標題：標題名稱顯示荷官
2. 荷官名字
3. 荷官照片
4. 荷官編號

* **輸入員工編號**
* 手動更換：點擊荷官照片，彈窗顯示[輸入員工編號]畫面，荷官用鍵盤輸入工號，點擊[確認]後彈窗關閉，荷官資料更新。點擊[清除]將清除已輸入的工號，如下圖所示。
* 刷卡輸入：荷官刷卡感應員工卡，系統自動更換員工編號。

### <font color="#0089A7"> E 視頻畫面 </font>
詳細資料由Key Server提供，分為子母畫面大的母畫面為國際版(XG)，小的子畫面為台灣版(HSG)。

### <font color="#0089A7"> F 倒時器 </font>
:warning: 後續需可修改秒數（以秒為單位）

新局後，依各遊戲開始倒數秒數，倒數至5秒後（含5秒），數字顏色變更為紅色，倒數結束後將顯示0秒，直至進入新局，如下圖。

* 百家樂：一般百家樂一局共25秒；極速百家樂一局共15秒。
* 龍虎：一局共20秒。
* 輪盤：一局共40秒。
* 骰寶：一局共20秒。
* 極速骰寶：一局共15秒。
* 色碟：一局共15秒。

| 起初狀態 | 倒數5秒後狀態 | 進行統計時狀態 |
| :--------: | :--------: | :--------: |
||||

### <font color="#0089A7"> G1 開獎區域 </font>

1. **未開牌狀態**：開始新局至下注倒數完畢前，皆顯示無結果方框。
* 百家樂
莊家為 B 閒家為 P ，共有六個開牌位置，包含B1、B2、B3(補牌)、P1、P2、P3(補牌)，每家最多發三張牌，如下圖。
* 龍虎
開牌位置共兩個，龍為 D 虎為 T ，如下圖。
* 輪盤
顯示開獎結果為兩碼數字，如下圖。
* 骰寶
開獎結果為三顆骰子，由左至右顯示D1、D2、D3，如下圖。
* 極速骰寶
開獎結果為一顆骰子，如下圖。
* 色碟
開獎結果為四顆鈕扣，如下圖。
2. **開牌狀態**
* 百家樂
下注倒數完畢後，荷官依照提示進行刷牌，由系統自動顯示卡牌，提示順序為P1、P2（同時方框閃爍提示）➜ B1、B2（同時方框閃爍提示）➜ B3或P3（依照補牌規則是否需要補第三張牌），如下圖。
* 閃爍提示
* 顯示卡牌
* 龍虎
下注倒數完畢後，荷官依照提示進行刷牌，提示順序為D ➜ T，由系統自動顯示卡牌，如下圖。
* 閃爍提示
* 顯示卡牌
* 輪盤
開牌號碼0至36，共37個號碼，號碼輸入皆為兩碼，且顯示號碼對應顏色，ex:00(綠色底)、01(紅色底)等。開始發球的狀態下，荷官才可輸入號碼，如下圖。
* 骰寶
開獎結果共三顆骰子，一至六面對應一點至六點，荷官只能輸入數字1-6，依據荷官輸入數字順序由左至右顯示，如下圖。
* 極速骰寶
開獎結果共一顆骰子，一至六面對應一點至六點，荷官只能輸入數字1-6，如下圖。
* 色碟
開獎結果共四顆紅白雙色的鈕扣，荷官僅需輸入<font color="ff5367"> 紅色 </font>鈕扣數量，白色鈕扣數量會由系統自動算出，ex:荷官輸入3，將顯示三顆紅點一顆白點。荷官在輸入狀態時需要鎖鍵盤，僅能輸入0至4的數字，如下圖。

3. **開牌結果**：荷官按下確認按鈕後，系統自動統計本局開牌結果，開牌結果覆蓋至卡牌之上。
* 百家樂
結算結果後，顯示開牌結果，顯示項目包含莊贏、閒贏、和。
* 龍虎
結算結果後，顯示開牌結果，顯示項目包含龍贏、虎贏、和。
* 輪盤
確認結果後，顯示開牌結果，顯示項目包含0-36。
* 骰寶
確認結果後，骰子由小至大左至右排序，上方顯示加總點數，包含3-18。
* 極速骰寶
確認結果後，顯示開牌結果，顯示項目包含1-6。
* 色碟
確認結果後，顯示開牌結果，加總點數包含0-4。

4. **手動改牌**
點擊「開牌方框」彈窗顯示「手動改牌」視窗，點擊  關閉「手動改牌」視窗。
* **百家樂**
點擊「卡牌方框」彈窗顯示「手動改牌」視窗，如下圖。
 (點擊)➜ 彈窗顯示 
1. 改牌範圍：需變更的卡牌，可變更卡牌包含P1、P2、P3、B1、B2、B3。
2. 選擇改牌範圍：為一副52張卡牌。點擊「所選卡牌」後彈窗關閉，「卡牌方框」顯示「所選卡牌」，若再次選擇卡牌則直接覆蓋現有卡牌顯示新卡牌。

* **龍虎**
點擊「卡牌方框」彈窗顯示「手動改牌」視窗，如下圖。
 (點擊)➜ 彈窗顯示 
1. 改牌範圍：需變更的卡牌，可變更卡牌包含D、T。
2. 選擇改牌範圍：為一副52張卡牌。點擊「所選卡牌」後彈窗關閉，「卡牌方框」顯示「所選卡牌」，若再次選擇卡牌則直接覆蓋現有卡牌顯示新卡牌。

* **輪盤**
點擊「方框」彈窗顯示「手動改牌」視窗，如下圖。
 (點擊)➜ 彈窗顯示 
1. 改牌範圍：開牌數字。
2. 選擇改牌範圍：為0-36，共37個數字。點擊「所選數字」後彈窗關閉，「數字方框」顯示「所選數字」，若再次選擇數字則直接覆蓋現有數字顯示新數字。

* **骰寶**
點擊「骰子方框」彈窗顯示「手動改牌」視窗，如下圖。
 (點擊)➜ 彈窗顯示 
1. 改牌範圍：共三顆骰子，變更範圍包含D1、D2、D3。
2. 選擇改牌範圍：為骰1至骰6。點擊「所選骰子」後彈窗關閉，「骰子方框」顯示「所選骰子」，若再次選擇骰子則直接覆蓋現有骰子顯示新骰子。

* **極速骰寶**
點擊「方框」彈窗顯示「手動改牌」視窗，如下圖。
 (點擊)➜ 彈窗顯示 
1. 左側方格：變更的骰子。
2. 右側骰子：為骰1至骰6。點擊「所選骰子」後彈窗關閉，「骰子方框」顯示「所選骰子」，若再次選擇骰子則直接覆蓋現有骰子顯示新骰子。

* **色碟**
點擊「方框」彈窗顯示「手動改牌」視窗，如下圖。
 (點擊)➜ 彈窗顯示 
1. 左側方格：開牌的鈕扣。
2. 右側骰子：共五種開牌結果。點擊「所選結果」後彈窗關閉，「鈕扣方框」顯示「所選結果」，若再次選擇結果則直接覆蓋現有結果顯示新結果。ex: 原先結果為  再次點擊  後，則結果將由 更改為  。

### <font color="#0089A7"> G2 確認按鈕 </font>
上按鈕為確認；下按鈕為取消。唯有開牌狀態才可點擊按鈕，其餘狀態將不可點擊此區域。

| default | hover | active |
| :--------: | :--------: | :--------: |
|| | |

* 確認：有結果後，需點擊確認按鈕，結果才會送出進行結算。
* 取消
* 百家樂、龍虎：鎖定此按鈕，不可點擊。
* 輪盤、骰寶、極速骰寶、色諜：點擊取消按鈕，將清除先前輸入的結果，荷官可重新輸入結果。

### <font color="#0089A7"> H 打賞聊天室 </font>
1. 說明:於玩家前台，玩家於遊戲間聊天(每桌聊天內容不連通)該桌上桌荷官可查看玩家聊天內容，若玩家贈禮給該桌荷官時，不管贈禮金額、贈禮品項，皆顯示愛心給荷官看，只要讓荷官看到，他有收到打賞贈禮即可。
* 聊天室:僅保留8條訊息(字體大小➜暱稱18pt、內文20pt)，可看到玩家設定的暱稱、聊天內容、發出時間。
* 玩家贈禮:玩家贈禮給荷官時，於聊天室中間會顯示「梅子氣球贈送♥給您，記得謝謝」顯示3秒後消失，若有多個玩家一起贈送則新的在下舊的在上，每條提示皆顯示3秒後才消失。

---

## <font color="#0089A7"> 提示狀態說明 </font>

### <font color="#0089A7"> 遊戲流程 </font>
狀態不同對應秒數不同，後續皆需可修改秒數，以0.1秒為單位。
提示位置如下圖

1. 開始新局
統計秒數倒數完畢後，顯示此提示。
| 秒數 | 狀態顯示依據Server流程 |
|:----:|:--- |
| 圖示 | |

2. 開始發牌
* **百家樂、龍虎**：下注秒數倒數完畢後，顯示此提示。
| 秒數 | 直至確認開牌後 |
|:----:|:-- |
| 圖示 ||

* **輪盤**：下注秒數倒數完畢後，顯示此提示。第一局不限制顯示圖示Ａ或圖示Ｂ，下一局僅需顯示另一圖示，後續依此類推。
ex:若第一局顯示圖示Ａ，下一局將顯示圖示Ｂ，交替顯示；若第一局顯示圖示Ｂ，下一局將顯示圖示Ａ，交替顯示。
| 秒數 | 直至號碼確認後 ||
|:----:|:--- |:--- |
|圖示|圖示A<br>| 圖示B<br> |

* **骰寶、極速骰寶**：
下注秒數倒數完畢後，顯示此提示。
| 秒數 | 直至骰子數字確認後 |
|:----:|:---- |
| 圖示 ||

* **色碟**
==開始新局提示後，顯示此提示==，每局隨機提示搖摋次數，次數範圍為4-8下，文案為「請搖4下」，如下圖。
| 秒數 | 5秒 |
|:----:|:---|
| 圖示 ||

3. 統計完畢
結果確認送出後，顯示此提示。統計完畢下方會倒數5秒。
| 秒數 | 5秒倒數完畢 |
|:----:|:-- |
| 圖示 ||

4. 取消此局
當取消此局介面點擊確認後，顯示此提示。
| 秒數 | 狀態顯示依據Server流程 |
|:----:|:--- |
| 圖示 | |

### <font color="#0089A7"> 橫幅提示 </font>
1. 連贏提示：當遊戲結果連續開出三局以上(含三局)相同結果，本局結算完畢開新局前，系統將彈窗橫幅提示[已連續開出相同結果(3局)]，顯示==2秒==後隱藏，括號內顯示連續開牌的局數，如下圖。
ex:本局連續開出三局時，提示文案顯示「已連續開出相同結果(3局)」，下局再開出相同結果時，文案顯示「已連續開出相同結果(4局)」，後續依此類推。

各遊戲觸發條件
* 百家樂
開局結果為閒、莊、和。
* 龍虎
開局結果為龍、虎、和。
* 輪盤
數字0-36。
* 骰寶
三顆骰子組合，ex：2,5,6。
* 極速骰寶
點數1-6。
* 色碟
開牌結果小或大，小為0(4白)、1(1紅3白)；大為3(3紅1白)、4(4紅)。

2. 中場休息
當荷官按下中場休息按鈕，結果確認送出後，將顯示此提示，顯示==2秒==後隱藏，如下圖。

3. 紅卡提示
當荷官拿到紅卡並感應紅卡時，顯示橫幅提示[結算後，進入換靴]
，顯示==2秒==後隱藏，[中場休息]變更為[等待結算完畢]，結算後顯示[進入新局]，現場荷官進行換靴，遊戲畫面顯示中場休息畫面。

---

## <font color="#0089A7"> 自動發牌 </font>
觸發：設定於內建的UI
預設每局下注時間：5秒