Skip to content

快速開始

還沒看過的話,建議先讀概念與架構總覽——本頁假設你已經理解那裡講的架構。本頁是一條具體的 5 分鐘路徑:從「我有憑證了」到「我的遊戲跑完一局」。

前置條件

  • 一個由平台管理團隊下發的廠商租戶 ID 和 HMAC 金鑰。金鑰必須只存在於伺服端——它用來給每次錢包呼叫簽名,絕不能洩露到瀏覽器。
  • 你的遊戲執行在運營商頁面的 iframe 裡(即"shell")。你無法控制運營商何時、如何嵌入你,只能控制 iframe 內部發生的事情。

端到端流程

  1. Session token 會出現在你的啟動網址上。 你遊戲的頁面載入時,平台早已把 ?session=<token> 查詢參數拼在你註冊的啟動 URL 後面。你的瀏覽器客戶端如何讀出它、再交給你的後端,見取得 session token
  2. 你的後端校驗 session。 你的遊戲啟動時,用這個 token 呼叫 ProviderClient#verifySession。它會校驗 token 並返回玩家標識、遊戲和運營商 ID、貨幣,以及針對這個(遊戲,運營商)組合解析出的 Central Config(RTP 標籤 + 下注限額)——詳見伺服端接入
  3. 你的遊戲執行一局。 玩家下注 → 你的伺服端通過 ProviderClient#submitTransaction 提交一筆 BET 交易(如果中獎再提交一筆 WIN)。金額始終用最小貨幣單位(分),絕不用浮點數。
  4. 你的瀏覽器客戶端上報生命週期事件。 在 iframe 內部使用 GameBridge 告知運營商的 shell 遊戲何時載入完成、下注何時開始/結束、玩家何時退出,並接收 shell 推送下來的餘額更新。

繼續閱讀伺服端接入