# 67999 彈珠賽車｜產品規格書 + API 整合文件（中文版）
---
## 🎯 產品總覽｜67999 彈珠賽車 & 主播直播
**67999 彈珠賽車 & 主播直播** 是一款高度互動的遊戲平台，結合真人直播解說與分級下注機制，打造沉浸式娛樂體驗。
其中，**彈珠賽車** 遊戲融合實體物理軌道與即時影像串流，玩家可透過選號或分類方式參與投注，並觀賞彈珠實際於賽道上運行的過程。賽果完全依據物理運動結果產生，無任何隨機數生成（RNG）介入，強化公平性與信任感。
平台支援多語系與多幣值設定，具備完整 **API 串接機制** 與 **即時結算回調功能**，可靈活對接至全球 iGaming 營運架構，並支援包網部署、快速上線。
---
## 🧱 一、核心規格設計（Game Specification）
### 1. 遊戲類型
- 真人串流 + 實體物理彈珠比賽
- 主播互動解說強化參與感
- 遊戲結果完全基於真實物理運動
### 2. 遊戲流程
- 玩家下注 → 倒數計時 → 彈珠發射 → 冠軍產生 → 系統派彩
### 3. 賽道與彈珠
- 賽道形式：多彎道 + 高架坡段，平均賽時 50–60 秒
- 彈珠數量：10 顆，編號 1 至 10，顏色標示清晰辨識
### 4. 投注規則
- **單號投注**：預測哪顆彈珠贏得比賽
- **大小投注**：編號 1–5 為「小」、6–10 為「大」
- **單雙投注**：奇數/偶數編號彈珠為勝
### 5. 賠率設計（抽水率約 5%）
- 單號投注：1 賠 1.95
- 分類投注（大小／單雙）：1 賠 1.95
### 6. 投注介面功能
- 金額快捷選擇（+/-、2X）、重複下注、隨機下注
- 顯示比賽進行中畫面與倒數計時同步
---
## 🖥️ UI介面說明｜彈珠賽車下注頁面
### 1. 主畫面介紹
| 項次 | 功能名稱 | 說明 |
|------|----------------|------|
| 1 | 賽道直播畫面 | 顯示實體彈珠於賽道上即時運行，具備影像與聲音 |
| 2 | 玩家餘額顯示 | 顯示玩家目前錢包可用餘額 |
| 3 | 功能列選單 | 包含會員資料、通知中心與語言切換等快捷入口 |
| 4 | 主播畫面 | 顯示真人主播影像，可進行互動與導覽說明 |
| 5 | 模式切換鈕 | 展開右側功能選單（投注紀錄、設定、走勢圖等） |
| 6 | 下注區縮放 | 控制下注區展開與收合，適用不同裝置畫面配置 |
| 7 | 選號投注區 | 點選編號 1～10 進行單號投注（Pick your Champion） |
| 8 | 分類投注區 | 提供「大 / 小」、「單 / 雙」投注選項，賠率固定 |
| 9 | 金額調整工具 | 可手動輸入下注金額，或透過 + / -、2X 倍數等快速設定 |
| 10 | 重複下注按鈕 | 快速複製前一局下注內容，節省操作時間 |
| 11 | 確認下注按鈕 | 提交當前下注選項，完成投注動作 |
| 12 | 隨機選號按鈕 | 系統自動產生下注組合，按下確認後即可參與比賽 |
---
## 🧾 投注操作說明｜核心下注功能
### 🎮 主畫面下注區塊
| 編號 | 功能名稱 | 說明 |
|------|----------------|------|
| 1 | 球號選擇區 | 玩家可點選 1～10 號彈珠進行投注，點選球號時會有上跳動畫效果 |
| 2 | 分類投注區 | 提供「大 / 小 / 單 / 雙」選項，點擊時按鈕高亮顯示 |
| 3 | 重複下注按鈕 | 快速帶出上一局下注內容，進入彈窗確認送出 |
| 4 | 確認下注按鈕 | 開啟下注確認彈窗，顯示所有投注項目與金額明細 |
| 5 | 隨機下注按鈕 | 系統自動產生隨機組合，需點擊「確認下注」送出 |
---
### ✅ 確認下注彈窗
- 顯示所有已選投注內容與金額
- 操作選項：
- Cancel：取消下注
- OK：送出下注並進入比賽等待開獎
---
### 🔁 重複下注彈窗
- 點擊「Repeat」按鈕後顯示
- 自動載入上一場投注內容，快速重複下注
---
## 🎛️ 模式切換與功能側邊欄
| 項次 | 圖示 | 功能名稱 | 說明 |
|------|------|----------------|------|
| 1 | 🔲 | 路子展現 | 查看走勢圖（大/小 或 單/雙） |
| 2 | 📄 | 投注紀錄 | 檢視當前及當日下注明細 |
| 3 | 📊 | 開獎紀錄 | 歷史賽果與熱門號碼統計圖 |
| 4 | 🔄 | 螢幕旋轉 | 在直式與橫式畫面間切換 |
| 5 | ⚙️ | 系統設定 | 控制聲音與特效偏好設定 |
---
## 📊 Mapway 走勢圖功能
| 編號 | 功能名稱 | 說明 |
|------|--------------|------|
| 1 | 展開按鈕 | 顯示走勢圖區塊 |
| 2 | 走勢區塊 | 顯示 High/Low 或 Odd/Even 開獎紀錄 |
| 3 | 關閉按鈕 | 關閉模組釋出空間 |
| 4 | 走勢圖展示 | 開獎結果走勢連線 |
| 5 | 模式切換 | 在 High/Low 與 Odd/Even 模式切換 |
---
## 📒 投注紀錄功能（Bet Record）
### 🎯 功能入口
點擊右側「投注紀錄」圖示打開彈窗
---
### 📄 當前注單（Current Bets）
| 欄位 | 說明 |
|------|------|
| ▶️ | 點擊可回放該場比賽的實況影像與開獎結果 |
| NO. | 注單期號（含流水號） |
| Bet | 投注內容（球號／分類） |
| Amount | 投注金額 |
---
### 📊 當日注單（Today Bets）
| 欄位 | 說明 |
|------|------|
| ▶️ | 點擊可回放該場比賽的實況影像與開獎結果 |
| NO. | 注單期號（含流水號） |
| Bet | 投注內容（球號／分類） |
| Win/Lose | 輸贏狀態 |
| Amount | 損益金額 |
---
---
## 🧾 開獎紀錄功能｜Draw Record
### 📌 功能入口
玩家可透過右側功能列的「開獎紀錄圖示」進入查看歷史開獎資訊與統計趨勢圖。
---
### 📂 歷史紀錄（History）
點選「History」頁籤，將顯示近期每場賽事的實際開獎結果，包含每一顆彈珠的名次排列。
| 欄位 | 說明 |
|------------|-----------------------------|
| 比賽期號 | 如：04011055、04011046 等 |
| 彈珠順序 | 每場開獎結果，顯示 1～10 名順序 |
---
### 📊 統計圖表（Statistics）
切換至「Statistics」頁籤後，將顯示以下內容：
- 分類統計（High / Low / Odd / Even）
- 彈珠號碼出現於名次（1st～5th）的次數分佈
- 可點選球號查看詳細統計（柱狀圖）
- 箭頭顯示球號上下名次變動趨勢
| 圖例說明 | 含義 |
|----------|------|
| 🔵 H | 大（High） |
| 🔴 L | 小（Low） |
| 🔵 O | 單（Odd） |
| 🔴 E | 雙（Even） |
| ⬆️⬇️ | 名次變動指示 |
---
## 🔄 螢幕方向切換功能｜Screen Orientation Toggle
### 📌 功能說明
| 功能名稱 | 說明 |
|------------------|------|
| 螢幕方向切換 | 玩家可自由切換「直式」與「橫式」顯示，支援手動或自動旋轉 |
切換後畫面會自動重排下注區與直播區，提升使用者觀看體驗。
---
## ⚙️ 系統設定選單｜Settings
玩家點擊右側功能欄「⚙ 設定圖示」後，可自訂偏好設定如下：
| 功能項目 | 說明 |
|-----------------|------|
| Anchor Voice | 是否啟用主播語音 |
| Effects Voice | 控制一般彈珠音效 |
| All Voice | 總體靜音切換 |
| Winning Effects | 是否啟用中獎動畫提示 |
---
## 🧾 投注工具列功能說明｜下注效率輔助工具
### 🎯 投注輔助工具列
| 編號 | 功能名稱 | 說明 |
|------|----------------|------|
| 1 | 2X 倍注 | 將目前下注金額立即加倍 |
| 2 | 自訂金額 | 開啟輸入框手動輸入特定金額 |
| 3 | 清除下注內容 | 快速清除當前所有選項與金額 |
---
## 🏆 獲獎動畫展示（中獎提示）
若投注項目中獎，將觸發視覺動畫提示，提升成就感與參與感。
---
## 📡 API 接入與結算流程（Game API Guide）
### 🔐 認證機制（Authentication）
所有 API 請求須包含授權 Header（可為 token-based 或簽章驗證）。
---
### 🟢 Start Game API
`POST /api/v1/game/start`
#### ✅ Request
```json
{
"user_token": "USER123456",
"game_code": "67999",
"credit": 100
}
🟡 Game Callback API
當比賽結束後，平台將自動回傳結果至客戶設定的 callback URL。
POST to
https://your.callback.url
```
📦 Payload
```json
{
"user_token": "USER123456",
"game_code": "67999",
"game_session_id": "MRUN_20250507_000123",
"result": {
"winner_ball": 6,
"ranking": [6, 2, 8]
},
"win_amount": 195,
"bet_amount": 100,
"play_time": "2025-05-07T09:41:15+08:00"
}
```
🔵 Game Report API
GET /api/v1/game/report?start_at=YYYY-MM-DDTHH:mm:ss&end_at=YYYY-MM-DDTHH:mm:ss
Response
json
複製
編輯
```jsonld
[
{
"user_token": "USER123456",
"game_code": "67999",
"game_session_id": "MRUN_20250507_000123",
"result": {
"winner_ball": 6,
"ranking": [6, 2, 8]
},
"win_amount": 195,
"bet_amount": 100,
"play_time": "2025-05-07T09:41:15+08:00"
}
]
```
Sign in with Wallet
Connect another wallet