快速開始

本站面向運營商——也就是從 Moose 遊戲平台目錄裡為玩家嵌入遊戲的網站/應用。如果你還沒讀過，簡介與核心概念介紹了本站假設你已經具備的整體概念模型。

前置條件

• 一個運營商租戶 ID 和 HMAC 金鑰，在建立你的租戶時由平台管理團隊透過帶外管道下發。金鑰必須只存在於伺服端——它用來簽名你對平台發出的每一次呼叫，也用來驗證平台回調你的每一次呼叫，絕不能到達瀏覽器。
• 一個實作了平台錢包回調 API的錢包後端——平台會呼叫它來為玩家扣款/加款、查詢餘額。沒有它，REAL 模式就沒有可供結算的錢包（DEMO 模式不需要它——見啟動遊戲）。這通常是整個整合裡工作量最大的一部分——見實作錢包回調。
• 一個用來嵌入遊戲的頁面——通常是一個指向啟動 session 後拿到的 launchUrl 的 iframe。

端到端流程

1. 你的伺服端啟動一個 session。 簽名並呼叫 POST /v1/operator/games/launch，帶上玩家、遊戲和幣別。你會拿到 launchUrl 和 sessionToken。
2. 嵌入遊戲。 把 launchUrl 載入到你頁面的 iframe 裡。
3. 執行 shell。 針對文件化的橋接協議掛一個 postMessage 監聽器，接收遊戲的生命週期事件（載入完成、下注開始/結束、餘額耗盡、退出）——見 Shell 端橋接。
4. 結算交易。 隨著玩家下注和獲勝，平台會即時呼叫你的錢包回調 API，在你自己的系統裡為玩家扣款/加款——見實作錢包回調。

接下來：啟動遊戲會完整走一遍第 1 步，並附上一個完整的簽名範例。