EventEasy
接口版本 v1.0 Beta（預覽版）

第三方遊戲開發者接口規格

想讓你的遊戲上架 EventEasy.net，出現在活動主辦方的遊戲清單裡，並直接使用平台嘉賓資料？只要遵循以下三個步驟，就能無縫接入。

第三方遊戲接口而家係 Beta 預覽階段，正招募首批合作開發者。規格或會按測試結果調整。

1

進場

主辦方在活動中開啟遊戲，平台把「活動代碼、嘉賓身份、一次性授權碼」交給遊戲。

2

遊玩

遊戲在自己那邊運行，畫面、玩法、動畫都由第三方決定，平台只負責提供外框與資料。

3

回傳

遊戲結束後，把「誰玩了、結果是什麼、中了什麼獎」回傳平台，自動記錄到該嘉賓名下。

STEP 1

第三方要提供什麼

上架前，開發者需向平台提交以下資訊。平台會據此建立遊戲卡片，供主辦方在活動中選用。

遊戲名稱與縮圖

名稱、一句話介紹、一張 16:9 縮圖，會直接顯示在平台的遊戲清單卡片上。

遊戲網址（HTTPS）

一個公開可讀取的網址。平台會用這個網址把遊戲載入到活動頁中。

遊戲屬性

參與人數、遊戲時長、難度、類別，供主辦方篩選與了解。

支援能力宣告

是否讀取嘉賓資料、是否支援回傳結果、是否需要大螢幕、是否支援多輪。

接口版本號

標明依循的接口版本（目前 v1.0），方便日後升級不影響舊遊戲。

開發者聯絡資料

技術聯絡人與維護窗口，方便出問題時快速溝通。

STEP 2

平台會傳什麼給遊戲

主辦方開啟遊戲時，平台會把活動與嘉賓資訊，用網址參數的方式傳給遊戲頁面。

參數說明範例必填
eventCode活動代碼，用來識別是哪一場活動。EVT-2026-0318必填
eventName活動名稱，可顯示在遊戲畫面上。春酒暨年度頒獎晚宴選填
guestId嘉賓的唯一編號，回傳結果時要帶回。10248必填
guestName嘉賓姓名，遊戲可用來稱呼玩家。陳志明必填
guestTable嘉賓桌號，方便現場互動。T12選填
sessionToken一次性授權碼，證明這場遊戲有被平台授權，回傳時必須附上。st_9f3a2c…必填
locale語言，預設 zh-HK，亦可為 zh-CN、en。zh-HK選填
theme主題，light 或 dark，讓遊戲畫面與活動一致。dark選填
returnMode回傳方式，postMessage（嵌入）或 webhook（伺服器對伺服器）。postMessage必填
遊戲被載入的網址格式
https://your-game.com/play?eventCode=EVT-2026-0318&guestId=10248&guestName=%E9%99%B3%E5%BF%97%E6%98%8E&guestTable=T12&sessionToken=st_9f3a2c7e&locale=zh-HK&theme=dark&returnMode=postMessage
STEP 3

遊戲要回傳什麼

遊戲結束後，用 postMessage 把結果傳回平台（嵌入模式），或由伺服器 POST 到平台接口（webhook 模式）。

欄位型別說明
typestring固定為 eventeasy:game-result，平台靠這個辨識結果訊息。
versionstring接口版本，例如 1.0。
sessionTokenstring平台進場時給的授權碼，原封不動帶回，用於驗證身份。
guestIdstring玩遊戲的嘉賓編號。
gameIdstring第三方遊戲的識別碼。
statusstringfinished（完成）、abandoned（中途離開）。
prizestring中獎名稱，例如「二獎｜高級智能手錶」。
tierstring獎項等級，例如 頭獎、二獎、參加獎。
scorenumber分數或成績，非競賽類可填 0。
playedAtstring遊玩時間，ISO 格式。
遊戲端回傳結果的程式碼
window.parent.postMessage({
  type: 'eventeasy:game-result',
  version: '1.0',
  sessionToken: sessionToken,
  guestId: guestId,
  gameId: 'partner-lucky-wheel',
  status: 'finished',
  prize: '二獎｜高級智能手錶',
  tier: '二獎',
  score: 95,
  playedAt: new Date().toISOString()
}, '*');

安全規範

為保護嘉賓個人資料與活動資料，以下規則為上架必要條件。

每次進場發一個新的 sessionToken，用完即失效，避免他人冒用回傳假結果。

遊戲只能用該場活動的嘉賓資料，無法讀取其他活動或全站資料。

平台不提供電話、電郵等敏感資料，遊戲不應自行蒐集或儲存個人資料。

遊戲不可直接連線平台資料庫，所有結果一律經接口回傳，由平台驗證後入庫。

合作條款（Beta 版）

以下條款適用於所有喺 EventEasy.net 活動易平台上架嘅第三方遊戲。EventEasy.net 由 Vigor Advertising Strategy Co Ltd（下稱「平台」）營運。提交上架申請，即代表開發者同意以下條款。如有另外簽訂嘅書面合約，以書面合約為準。

1. 收入分成

  • 分成比例：預設平台佔 40%，開發者佔 60%。重點合作可以另外商議，以書面確認為準。
  • 分成基數：以該遊戲嘅淨收入計算，即係用戶實付金額扣除優惠折扣、退款同支付手續費之後嘅金額。
  • 定價：遊戲對主辦方嘅收費由開發者提出建議價，最終由平台定價。
  • 結算：每月結算一次，平台會提供上月結算單，列明使用次數、淨收入同應付分成。
  • 付款：上月分成於每月 15 日經 FPS 轉數快支付。
  • 最低付款額：累積分成滿 HK$1,000 先會付款，未滿嘅金額撥入下個月。
  • 對數：開發者對結算單有疑問，可以喺收到後 14 日內提出，雙方核對後調整。

2. 知識產權

  • 遊戲（包括程式、美術、音效、玩法）嘅知識產權仍然屬於開發者。
  • 開發者授權平台一項非獨家、免版稅嘅許可，喺遊戲上架期間，可以喺平台、網站、社交媒體同宣傳物料展示遊戲名稱、縮圖、截圖同簡介，用嚟介紹同推廣遊戲。遊戲下架後，平台會停止新增宣傳，已經發佈嘅內容唔使追溯刪除。
  • 開發者保證遊戲同提交嘅物料冇侵犯任何第三方嘅版權、商標或者其他權利。如因侵權引起索償，由開發者負責，並須彌償平台因此承擔嘅損失。
  • 平台提供嘅活動資料、嘉賓資料同遊戲結果，屬於平台同該活動主辦方。開發者只可以使用彙總、無法識別個人嘅統計數字（例如總遊玩次數、平均分數）去改善遊戲。

3. 私隱及個人資料

  • 開發者必須遵守香港《個人資料（私隱）條例》（第 486 章）。
  • 平台傳畀遊戲嘅資料，只可以用喺該場活動嘅遊戲運作，唔可以用嚟做其他用途，包括推廣或者建立用戶檔案。
  • 唔可以喺平台以外收集參加者資料，例如唔可以喺遊戲入面要求參加者留電話、電郵、社交媒體帳戶，或者要求另外登記。
  • 活動結束後30 日內，開發者須刪除所有由平台取得嘅活動同嘉賓資料，平台要求時須書面確認已刪除。
  • 唔可以將資料轉交、出售或者披露畀任何第三方。
  • 如發現資料外洩或者懷疑被盜用，須喺知悉後 72 小時內通知平台（eventeasynet@gmail.com），並配合調查同補救。

4. 內容守則

遊戲唔可以包含以下內容：

  • 賭博、真錢投注，或者可以兌換現金嘅虛擬籌碼；
  • 色情或者成人內容；
  • 暴力、血腥、仇恨、歧視或者騷擾內容；
  • 侵犯他人知識產權或者私隱嘅內容；
  • 誤導性嘅抽獎機制，例如顯示嘅中獎機會同實際唔同；
  • 惡意程式、廣告追蹤或者未經同意嘅追蹤碼；
  • 任何違反香港法律嘅內容。

遊戲設有獎品時，獎品同抽獎安排須符合香港法律同主辦方訂立嘅活動規則。

5. 下架及終止

  • 遇到以下情況，平台可以即時暫停或者下架遊戲，無須事先通知：違反本條款、遊戲出現故障、收到投訴，或者有保安風險。平台會盡量通知開發者原因，並畀機會修正。
  • 開發者可以隨時申請下架，須提前30 日書面通知。已經確認、排咗期嘅活動會照常使用該遊戲至活動完結。
  • 終止後，未結算嘅分成照常按第 1 條結算；第 2 條（知識產權保證）、第 3 條（私隱）及第 6 條（責任）繼續有效。

6. 責任

  • 平台以「現狀」提供接口同服務，唔保證服務永不中斷或者完全冇錯誤。
  • 開發者須自行負責遊戲嘅運作、故障、伺服器穩定同獎品邏輯。因遊戲本身問題引致主辦方或者嘉賓嘅損失，由開發者負責。
  • 本條款受香港法律管轄，雙方同意由香港法院處理爭議。
  • 平台可以修改本條款，修改前會喺本頁公佈並通知已上架開發者；繼續上架即代表接受修改後條款。

7. 聯絡

  • 開發者查詢：eventeasynet@gmail.com

上架流程

從申請到正式出現在遊戲清單，我哋會盡快聯絡你。

  1. 1填寫「遊戲上架申請表」，提交遊戲名稱、縮圖與網址。
  2. 2平台審核後，於測試活動中產生測試 sessionToken 進行對接。
  3. 3完成「進場讀參數 → 遊玩 → 回傳結果」三點驗證。
  4. 4通過後正式上架，即成為平台遊戲清單中的一款遊戲。

先看示範，再動手

我們準備了一個可實際操作的示範頁，完整展示「讀取嘉賓資料 → 遊玩 → 回傳結果」的流程，建議先看過再開始開發。

觀看整合示範前往上架申請