即時遊戲 SDK

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

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

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

v8.0 版（僅適用於零權限遊戲）

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

變更記錄

FBInstant.overlayViews：新增的模組，用來建立和管理用於零權限遊戲的特效層檢視 iframe。
移除大頭貼和名稱 API：這些 API 用於傳回大頭貼、目前玩家或其朋友的名稱；但為了滿足零權限模型的要求，這些 API 現已移除。您可改用特效層檢視來顯示相關資訊。

v7.1 版

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

變更記錄

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

7.0 版

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

變更記錄

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

6.3 版

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

變更記錄

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