即時遊戲 SDK

在此章節中,我們會介紹即時遊戲 JavaScript SDK 的 API 參考資料。如果您要開始新遊戲,建議一律使用最新版本的 SDK。點擊下方的按鈕即可查看最新本的 SDK 參考資料:

即時遊戲 SDK 參考資料套裝配置參考資料

查看目前即時遊戲 SDK 支援版本的變更記錄:

7.1 版

前往查閱即時遊戲 SDK v7.1 版的參考資料文件

變更記錄

  1. 原生影片內容呈現:為應用程式新增 API,以便透過原生方式呈現影片內容。
  2. 獎勵式插頁廣告 API:獎勵式插頁廣告是一種全新的廣告顯示格式,方便即時遊戲開發人員用於營利。與需要用戶選擇觀看廣告的獎勵式影片不同,獎勵式插頁廣告將在常規插頁廣告位置顯示,而用戶可以選擇不予觀看。如果他們觀看完整段影片,將可獲得遊戲內獎勵。
  3. 頂部橫額廣告:讓開發人員在其遊戲頂部顯示橫額廣告。

7.0 版

前往查閱即時遊戲 SDK v7.0 版的參考資料文件

變更記錄

  1. 自訂邀請:玩家可透過 Messenger 邀請新玩家加入遊戲。玩家將會看到「邀請新玩家」區塊,其中列出哪些朋友尚未開始玩這個遊戲。玩家點擊「邀請」後,系統便會向其朋友傳送訊息,邀請他們玩遊戲。玩家可以一次傳送多個邀請。詳情請參閱我們此處的指南。
  2. 觸覺回應:即時遊戲現可在配備內置震動器的 Android 和 iOS 裝置上支援觸覺回應。
  3. 淘汰賽 API:即時淘汰賽可助您有效招攬新玩家,以及吸引玩家在預設為 7 天的淘汰賽期間持續與您的遊戲互動。玩家可將排行榜分享到其生活時報,並提示朋友參與挑戰。有了動態消息上的曝光率,再交由加入遊戲的玩家將消息轉貼出去,淘汰賽消息便能夠快速地在朋友關係網之中傳播開去,有助遊戲在短時間內招攬更多玩家。
  4. 移除統計資料 API:為了支援更靈活的玩家資料 API,這類 API 已被移除。
  5. 移除 postSessionScore:我們即將提供 postSessionScoreAsync 取而代之,以助更深入了解用戶針對透過此 API 發起的對話框採取了哪些動作。
  6. 移除 shareAsync 和 updateAsync 中未有使用的參數:我們已從 shareAsync 中移除未有使用的 INTENT 參數。此外,我們已從 updateAsync 移除 IMMEDIATE_CLEAR 策略,因為我們的政策將每個情境連線階段的自訂更新限制為一次。
  7. 頂部橫額廣告:讓開發人員在其遊戲頂部顯示橫額廣告。

6.3 版

前往查閱即時遊戲 SDK v6.3 版的參考資料文件

變更記錄

  1. (最新)FBInstant.postSessionScore:遊戲可以使用此 API 向 Facebook 提供玩家在目前遊戲連線階段中的分數。Facebook 將在多項平台整合中使用此類分數訊號,來幫助玩家探索和重新接觸遊戲,以及在遊戲中與其他玩家一較高下。
  2. 離線配對:先前的配對為同步操作,會在玩家等待期間封鎖遊戲。此版本在「matchPlayerAsync」中新增非同步選項。系統會立即將開始離線配對的玩家加入群組對話串,並且玩家可以在等待更多玩家加入遊戲期間退出遊戲。玩家如果在與其他玩家配對後仍身處遊戲當中,系統便會將其加入所配對的對話串,並且切換至相關對話串的情境。
  3. 現可在進行「initializeAsync」操作後查看玩家、情境、語言地區設定和進入點的資料 API:我們正在重新啟用在遊戲開始前存取資料 API 的功能!例如,您可以在遊戲載入期間存取玩家的語言地區設定或進入點資料。這樣有助減少您遊戲的再次顯示載入畫面和整體載入要求。此項變更現已在網頁版推出,並將由以下版本開始在流動版上推出:Android 版 Facebook v219、Android 版 Messenger v213、iOS 版 Facebook v222、iOS 版 Messenger v216。之前的流動版本會繼續呈現之前的行為,因此請確保在「startGameAsync」問題解決後檢查有沒有任何更新值。