---
# System prepended metadata

title: "\U0001F3AF 67999 彈珠賽車｜產品規格書 + API 整合文件（中文版）"
tags: ['67999']

---

# 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   | 隨機選號按鈕   | 系統自動產生下注組合，按下確認後即可參與比賽 |

![upload_4b8574e12ae822a75abc0d2834b2d366](https://hackmd.io/_uploads/SySecp0lel.png)

---

## 🧾 投注操作說明｜核心下注功能

### 🎮 主畫面下注區塊

| 編號 | 功能名稱       | 說明 |
|------|----------------|------|
| 1    | 球號選擇區     | 玩家可點選 1～10 號彈珠進行投注，點選球號時會有上跳動畫效果 |
| 2    | 分類投注區     | 提供「大 / 小 / 單 / 雙」選項，點擊時按鈕高亮顯示 |
| 3    | 重複下注按鈕   | 快速帶出上一局下注內容，進入彈窗確認送出 |
| 4    | 確認下注按鈕   | 開啟下注確認彈窗，顯示所有投注項目與金額明細 |
| 5    | 隨機下注按鈕   | 系統自動產生隨機組合，需點擊「確認下注」送出 |

![upload_76ba65b4fd9080d59787fa5d607a23e3](https://hackmd.io/_uploads/H14Z9T0lee.png)

---

### ✅ 確認下注彈窗

- 顯示所有已選投注內容與金額
- 操作選項：
  - Cancel：取消下注
  - OK：送出下注並進入比賽等待開獎

![upload_6a3cdc0c223660f039c5fccfb5695ac9](https://hackmd.io/_uploads/rJmM9pReeg.png)

---

### 🔁 重複下注彈窗

- 點擊「Repeat」按鈕後顯示
- 自動載入上一場投注內容，快速重複下注

![upload_7d37248a5d778b32b4f41ec395818bd2](https://hackmd.io/_uploads/rJ1m5pCxlx.png)

---

## 🎛️ 模式切換與功能側邊欄

| 項次 | 圖示 | 功能名稱       | 說明 |
|------|------|----------------|------|
| 1    | 🔲   | 路子展現       | 查看走勢圖（大/小 或 單/雙） |
| 2    | 📄   | 投注紀錄       | 檢視當前及當日下注明細 |
| 3    | 📊   | 開獎紀錄       | 歷史賽果與熱門號碼統計圖 |
| 4    | 🔄   | 螢幕旋轉       | 在直式與橫式畫面間切換 |
| 5    | ⚙️   | 系統設定       | 控制聲音與特效偏好設定 |

![upload_873d2f3881a9c9fb4e5f7494d312b443](https://hackmd.io/_uploads/HyZVc6Rllg.png)

---

## 📊 Mapway 走勢圖功能

| 編號 | 功能名稱     | 說明 |
|------|--------------|------|
| 1    | 展開按鈕     | 顯示走勢圖區塊 |
| 2    | 走勢區塊     | 顯示 High/Low 或 Odd/Even 開獎紀錄 |
| 3    | 關閉按鈕     | 關閉模組釋出空間 |
| 4    | 走勢圖展示   | 開獎結果走勢連線 |
| 5    | 模式切換     | 在 High/Low 與 Odd/Even 模式切換 |

![upload_5431a958005eab0e87b11befcaaa0d83](https://hackmd.io/_uploads/Hy2VcaAxgx.png)

---

## 📒 投注紀錄功能（Bet Record）

### 🎯 功能入口
點擊右側「投注紀錄」圖示打開彈窗

![upload_53f59524641bc576ece1c6b59af5aed0](https://hackmd.io/_uploads/ByKS96Celx.png)

---

### 📄 當前注單（Current Bets）

| 欄位 | 說明 |
|------|------|
| ▶️ | 點擊可回放該場比賽的實況影像與開獎結果 |
| NO. | 注單期號（含流水號） |
| Bet | 投注內容（球號／分類） |
| Amount | 投注金額 |

![upload_0bbb3a474e500d004e6676933eebb581](https://hackmd.io/_uploads/SJiREC0ell.png)

---

### 📊 當日注單（Today Bets）

| 欄位 | 說明 |
|------|------|
| ▶️ | 點擊可回放該場比賽的實況影像與開獎結果 |
| NO. | 注單期號（含流水號） |
| Bet | 投注內容（球號／分類） |
| Win/Lose | 輸贏狀態 |
| Amount | 損益金額 |

![upload_a125bc195a169cfb86200bce23337d72](https://hackmd.io/_uploads/BkNYHRCgge.png)


---

---

## 🧾 開獎紀錄功能｜Draw Record

### 📌 功能入口
玩家可透過右側功能列的「開獎紀錄圖示」進入查看歷史開獎資訊與統計趨勢圖。

![upload_fcedf4b8f44c9d1e60bceaf170dafdac](https://hackmd.io/_uploads/Hy5v9aAxll.png)

---

### 📂 歷史紀錄（History）

點選「History」頁籤，將顯示近期每場賽事的實際開獎結果，包含每一顆彈珠的名次排列。

| 欄位       | 說明                        |
|------------|-----------------------------|
| 比賽期號   | 如：04011055、04011046 等   |
| 彈珠順序   | 每場開獎結果，顯示 1～10 名順序 |

![upload_f8254579a995586a3a334d3c83d476fe](https://hackmd.io/_uploads/rJLu9TRexg.png)

---

### 📊 統計圖表（Statistics）

切換至「Statistics」頁籤後，將顯示以下內容：

- 分類統計（High / Low / Odd / Even）
- 彈珠號碼出現於名次（1st～5th）的次數分佈
- 可點選球號查看詳細統計（柱狀圖）
- 箭頭顯示球號上下名次變動趨勢

| 圖例說明 | 含義 |
|----------|------|
| 🔵 H     | 大（High） |
| 🔴 L     | 小（Low） |
| 🔵 O     | 單（Odd） |
| 🔴 E     | 雙（Even） |
| ⬆️⬇️     | 名次變動指示 |

![upload_a4f258ac87ffc90932b4bfa48251658d](https://hackmd.io/_uploads/BkpK9aAexg.png)

---

## 🔄 螢幕方向切換功能｜Screen Orientation Toggle

### 📌 功能說明

| 功能名稱         | 說明 |
|------------------|------|
| 螢幕方向切換     | 玩家可自由切換「直式」與「橫式」顯示，支援手動或自動旋轉 |

切換後畫面會自動重排下注區與直播區，提升使用者觀看體驗。

![upload_fd618243062ba83175c6bf5768507e96](https://hackmd.io/_uploads/rJ-oqTAeel.png)
![upload_d40b0c37b83b2077e79de42dcf93ccf9](https://hackmd.io/_uploads/rya5qTAegl.png)

---

## ⚙️ 系統設定選單｜Settings

玩家點擊右側功能欄「⚙ 設定圖示」後，可自訂偏好設定如下：

| 功能項目        | 說明 |
|-----------------|------|
| Anchor Voice    | 是否啟用主播語音 |
| Effects Voice   | 控制一般彈珠音效 |
| All Voice       | 總體靜音切換 |
| Winning Effects | 是否啟用中獎動畫提示 |

![upload_5c26a13e893705377db3faf1c402905c](https://hackmd.io/_uploads/SkNn9T0ggg.png)
![upload_93d5218df00b5fceaad59053bff1dfd2](https://hackmd.io/_uploads/Bkw25TClxe.png)

---

## 🧾 投注工具列功能說明｜下注效率輔助工具

### 🎯 投注輔助工具列

| 編號 | 功能名稱       | 說明 |
|------|----------------|------|
| 1    | 2X 倍注        | 將目前下注金額立即加倍 |
| 2    | 自訂金額       | 開啟輸入框手動輸入特定金額 |
| 3    | 清除下注內容   | 快速清除當前所有選項與金額 |

![upload_307a2fc61b56f690fecee31a4fb4925a](https://hackmd.io/_uploads/HkQacaClxg.png)
![upload_819fcc39f2868308ffc794fb96883cd6](https://hackmd.io/_uploads/SJ_dhTAxxg.png)


---

## 🏆 獲獎動畫展示（中獎提示）

若投注項目中獎，將觸發視覺動畫提示，提升成就感與參與感。

![upload_afab7e0eea91f3be86f3702512e99b7d](https://hackmd.io/_uploads/BkgboTRxxe.png)

---

## 📡 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"
  }
]

```