推送視訊(WHIP/OBS)
視訊和牌局結果是分開的:結果由結果來源送進平台,視訊由現場以 WHIP 推到 elite,elite 再以 WebRTC 送到玩家的電腦版與手機版畫面。不論用哪一種結果來源,自己的桌的視訊都由你推流。
每張桌兩路
建桌時自動產生兩個推流名稱:
| 路 | 推流名稱 | 播放給 |
|---|---|---|
| 高清(HD) | elite_<桌檯 ID 小寫>_hd_<6 碼亂碼> | 電腦預設看這一路 |
| 標清(SD) | elite_<桌檯 ID 小寫>_sd_<同一組亂碼> | 手機預設看這一路 |
- 只推一路也可以:玩家會自動改看有畫面的那一路。例如只推高清,手機玩家也看高清;只推標清,電腦玩家也看標清。
- 兩路都推時,玩家可以在桌內的視訊選單(HD/SD)切換;選的那一路沒有畫面時一樣會自動改看另一路。
- 兩路可以是同一個畫面、不同解析度與碼率,例如標清用 854×480、約 1 Mbps,讓網路較慢的玩家也看得順。
- 玩家收到的就是你推送的畫質,平台不另外轉成其他畫質。
- 2026 年 10 月以前建的桌,推流名稱是
_pc_(高清)與_m_(標清),照樣使用;按「換一組推流名稱」會換成新的格式。
推流網址與推流金鑰
在 桌檯 → 桌檯管理 → 我的桌檯 按那張桌的「推流」,會看到高清(HD)與標清(SD)的推流名稱、推流網址,以及推流金鑰;桌檯 Workbench 的「此租戶的設定 → 視訊推流」也有同樣的兩個網址。推流網址的格式:
text
https://elite-ingest.ewin888.com/whip/<推流名稱>| 項目 | 誰可以看、誰可以改 | 規則 |
|---|---|---|
| 推流名稱、推流網址 | 有「桌檯設定」權限的帳號(系統設定、營運人員) | 「換一組推流名稱」:舊名稱立刻失效,玩家改看新的名稱,現場要馬上改用新的推流網址 |
| 推流金鑰(Bearer Token) | 顯示、複製、產生與「換一組」都只限系統設定角色 | 30 分鐘內要驗證過雙因子(登入時,或按「顯示」時輸入驗證碼);每一次顯示與更換都記在系統 → 操作稽核 |
- 推流金鑰一個商戶一把(
epk_開頭),所有自己的桌共用,而且只能推你自己的桌。還沒有金鑰時按「產生推流金鑰」。 - 「換一組」:舊金鑰立刻失效,所有推流軟體都要改用新金鑰;正在推流的畫面不會中斷,下一次開始推流時要用新金鑰。
- 推流資訊出現「平台的推流服務還在開通中」時,暫時無法推流。
- 唯讀展示帳號看到的推流名稱與推流網址是遮蔽的。
保管推流金鑰
推流金鑰只設定在推流電腦或編碼器上。外流時在「推流」視窗按「換一組」,再更新所有推流軟體。
OBS 設定
OBS Studio 30 以上內建 WHIP 輸出:
- 設定 → 串流(Settings → Stream):服務選 WHIP;伺服器貼推流網址(高清或標清);Bearer Token 貼推流金鑰。
- 設定 → 輸出(Settings → Output):關鍵幀間隔(Keyframe Interval)設 1 秒,玩家進桌比較快出畫面。OBS 的輸出模式選「進階」(Advanced)才看得到這個欄位。
- 按「開始串流」(Start Streaming)。
高清與標清是兩個獨立的 WHIP 推流:只推一路時一個 OBS 就夠;兩路都推要有兩個推流輸出,例如兩台推流電腦、兩個同時執行的 OBS,或能同時輸出兩路的硬體編碼器(一個 OBS 同時只推一路)。
其他編碼器:WHIP 端點填推流網址,驗證方式選 Bearer Token 並填推流金鑰。編碼器不能設定 Bearer Token 時,也可以用 X-Stream-Key 標頭,或把金鑰接在網址後面(?key=<push-key>);網址可能被編碼器或網路設備記錄下來,非必要不要用這種方式。
建議的編碼設定
平台的要求與建議
平台要求的只有 WHIP 與推流金鑰。關鍵幀間隔 1 秒是 Console 的建議;解析度與碼率平台沒有規定,下表其他各項都是建議,請依現場的網路與畫質需求調整。
| 項目 | 建議 | 原因 |
|---|---|---|
| 關鍵幀間隔 | 1 秒 | 玩家進桌後要等到下一個關鍵幀才出畫面,間隔越短越快 |
| 畫面比例 | 16:9 橫向,例如 1280×720 或 1920×1080 | 電腦版遊戲畫面以 16:9 設計 |
| 碼率 | 高清約 3 Mbps(1280×720 或 1920×1080);標清約 1 Mbps(854×480) | 官網的串流試算以約 1.5、3、5 Mbps 三檔估算;碼率直接決定每位玩家的流量與串流費 |
| 構圖 | 牌位與荷官的手放在畫面上方約 2/3 以內 | 電腦版畫面下方有投注面板與路單蓋在影像上 |
| 上傳頻寬 | 高於要推的各路碼率合計,並保留餘裕 | 頻寬不足時畫面會卡頓 |
德州撲克桌另外要把座位框對齊影像,見德州撲克的座位位置。
確認推流正常
- 推流軟體:OBS 開始推流後,狀態列顯示已連線、碼率穩定、沒有持續掉幀。
- 推流被拒:elite 的推流入口回應下列錯誤(推流軟體通常只顯示連線失敗,細節看它的日誌):
| HTTP | code | 原因 | 處理 |
|---|---|---|---|
| 401 | INVALID_PUSH_KEY | 沒有帶推流金鑰、格式不對,或金鑰已經換過 | Bearer Token 貼上目前的推流金鑰 |
| 404 | STREAM_NOT_FOUND | 推流名稱不存在:名稱換過、桌已移除,或不是你的桌 | 改用 Console 顯示的推流網址 |
| 404 | NOT_FOUND | 推流網址格式錯誤 | 網址應為 …/whip/<推流名稱> |
| 403 | TENANT_DISABLED | 帳戶已停用 | — |
| 503 | PUSH_UNAVAILABLE | 平台的推流服務暫時無法使用 | 稍後再試 |
| 502 | UPSTREAM_ERROR | 視訊服務暫時連不上 | 稍後再試 |
- 德州撲克桌:我的桌檯 → 編輯 → 座位位置(電腦版) 的背景是這張桌視訊的即時快照(先拿高清,沒有畫面再拿標清),按「重新擷取畫面」就能確認有畫面。
- 玩家畫面:桌開放後,用你自己的測試會員分別以電腦與手機進桌,確認有畫面;兩路都推時可以在視訊選單切換 HD/SD 各看一次。工具列的「HD」標示代表正在看高清。桌內的視訊訊號圖示(綠、黃、紅)依實際播放狀態顯示;在電腦版把滑鼠停在圖示上,可以看到解析度、每秒幀數(fps)與丟包率。
串流費
- 串流費依玩家觀看的流量計算:推流(上傳到 elite)不計費,沒有人看的時候也不計費。
- 每位玩家看 1 小時的流量約為「碼率(Mbps)× 0.45 GB」:約 3 Mbps 時約 1.35 GB。
- 單價在撰寫時(2026 年 9 月)是每 GB 0.09 USD,目前價格以 Console 方案與帳單 → 方案 與官網價格區為準;以 0.09 USD 計,一位玩家看 1 小時約 0.12 USD。
- 標清用較低的碼率,可以降低手機玩家(預設看標清)的流量。
- 其他商戶啟用你提供的桌時,他們的玩家觀看的流量算他們的。
- 免費展示方案的視訊限同時 3 人觀看、每次最長 30 分鐘;預付額度用完而且不在寬限期時,視訊會暫停播放。
計費方式與試算範例見開放與費用。