即時遊戲 SDK
本節說明即時遊戲 JavaScript SDK 的 API 參考資料。建議您一律使用最新版 SDK 開始新遊戲。請點擊下方按鈕，查看最新版的 SDK 參考資料：
即時遊戲 SDK 參考資料組合包配置參考資料請參閱目前支援之即時遊戲 SDK 版本的變更紀錄：
7.1 版
變更紀錄
- 轉譯原生影片內容：新增應用程式 API，以原生方式轉譯影片。
- 獎勵式插頁 API：獎勵式插頁是一種新的廣告顯示格式，供即時遊戲開發人員用於營利。獎勵式插頁不同於開放用戶選擇觀看廣告的獎勵式影片，而是會取代一般插頁廣告，用戶可以選擇不看。觀看完整廣告的用戶可以得到遊戲獎勵。
- 置頂橫幅廣告：允許開發人員在其遊戲頂部顯示橫幅廣告。
7.0 版
變更紀錄
- 自訂邀請玩家可以透過 Messenger 邀請新玩家一起玩遊戲。玩家會看見一個「邀請新玩家」區塊，並且可以在這個區段邀請尚未玩過遊戲的朋友。玩家點擊「邀請」後，系統會將玩遊戲的訊息傳送給玩家的朋友。玩家一次可以傳送多則邀請。這裡的指南詳細說明相關資訊。
- 觸覺回饋即時遊戲現在支援有整合式震動器的 Android 和 iOS 裝置提供觸覺回饋。
- 淘汰賽 API 即時遊戲淘汰賽是開發新玩家的絕佳利器，也能協助您在淘汰賽期間（預設是 7 天）吸引玩家持續參與互動。玩家會將排行榜分享到自己的動態時報，並提醒朋友加入挑戰。在動態消息的宣傳搭配參與玩家的轉分享下，淘汰賽有機會在朋友圈當中迅速散播，有利於在短時間內吸引更多玩家加入遊戲。
- 移除統計資料 API 我們為了提供更有彈性的玩家資料 API 而移除了這些統計資料。
- 移除 postSessionScore 我們將改為提供
postSessionScoreAsync，因為後者能針對用戶操作提供更好的資訊，適用於透過這項 API 叫用的對話。 - 移除 shareAsync 和 updateAsync 中用不到的參數 我們已移除
shareAsync中的 INTENT 參數，因其為用不到的參數。我們也已移除updateAsync中的 IMMEDIATE_CLEAR 策略，因為我們已有另一項政策是限制每個內容連線階段只能自訂更新一次。 - 置頂橫幅廣告：允許開發人員在其遊戲頂部顯示橫幅廣告。
6.3 版
變更紀錄
- （新功能）FBInstant.postSessionScore 這項 API 允許遊戲將玩家在目前這個遊戲連線階段的分數提供給 Facebook。Facebook 會將這些分數訊號運用於不同的平台整合功能，協助玩家探索、比賽以及重新開始遊戲互動。
- 離線配對舊版的離線配對是同步進行，會導致玩家在等待期間無法玩遊戲。這一版的「matchPlayerAsync」增加了一個非同步選項。玩家一旦開始進行離線配對，就會立刻受邀進入一個群組對話串，而玩家在等待更多玩家加入的期間內也可以離開遊戲。與他人配對之後，倘若尚未離開遊戲，玩家就會受邀進入並切換到配對完成之對話串的背景資訊。
- 推出「initializeAsync」之後，開始可以存取玩家、背景資訊、地區設定和進入點的資料我們將恢復在遊戲開始前存取資料 API 的功能！例如，您現在可以在遊戲載入階段查閱玩家的地區設定或進入點資料。這樣應該能幫助您減少遊戲的次要載入畫面以及整體載入條件。網頁版的這項變更現在已經生效，行動版開放時間則以下列版本的時間為準：FB for Android 219 版、Messenger for Android 213 版、FB for iOS 222 版、Messenger for iOS 216 版。舊的行動版會出現原本的行為因此請務必查看任何在「startGameAsync」解決之後更新過的值。