快速開始
還沒看過的話,建議先讀概念與架構總覽——本頁假設你已經理解那裡講的架構。本頁是一條具體的 5 分鐘路徑:從「我有憑證了」到「我的遊戲跑完一局」。
前置條件
- 一個由平台管理團隊下發的廠商租戶 ID 和 HMAC 金鑰。金鑰必須只存在於伺服端——它用來給每次錢包呼叫簽名,絕不能洩露到瀏覽器。
- 你的遊戲執行在運營商頁面的 iframe 裡(即"shell")。你無法控制運營商何時、如何嵌入你,只能控制 iframe 內部發生的事情。
端到端流程
- Session token 會出現在你的啟動網址上。 你遊戲的頁面載入時,平台早已把
?session=<token>查詢參數拼在你註冊的啟動 URL 後面。你的瀏覽器客戶端如何讀出它、再交給你的後端,見取得 session token。 - 你的後端校驗 session。 你的遊戲啟動時,用這個 token 呼叫
ProviderClient#verifySession。它會校驗 token 並返回玩家標識、遊戲和運營商 ID、貨幣,以及針對這個(遊戲,運營商)組合解析出的 Central Config(RTP 標籤 + 下注限額)——詳見伺服端接入。 - 你的遊戲執行一局。 玩家下注 → 你的伺服端通過
ProviderClient#submitTransaction提交一筆BET交易(如果中獎再提交一筆WIN)。金額始終用最小貨幣單位(分),絕不用浮點數。 - 你的瀏覽器客戶端上報生命週期事件。 在 iframe 內部使用
GameBridge告知運營商的 shell 遊戲何時載入完成、下注何時開始/結束、玩家何時退出,並接收 shell 推送下來的餘額更新。
繼續閱讀伺服端接入。