インスタントゲームSDK

このセクションでは、インスタントゲームJavaScript SDKのAPIリファレンスを紹介します。新規のゲームを開発するなら、常に最新バージョンのSDKを使用することをおすすめします。下のボタンをクリックして、最新バージョンのSDKリファレンスをご覧ください。

インスタントゲームSDKのリファレンスバンドル構成のリファレンス

インスタントゲームSDKの現在サポートされているバージョンについては、更新履歴を参照してください。

バージョン 8.0 (ゼロアクセス許可ゲームのみ)

インスタントゲームSDK v8.0のリファレンスドキュメントをご覧ください

更新履歴

FBInstant.overlayViews: ゼロアクセス許可に使われるオーバーレイビューiFramesを作成して管理するための新しいモジュールが追加されました。
プロフィール写真と名前のAPIの削除: 現在のプレイヤーまたはその友達のプロフィール写真と名前を返すAPIが、ゼロアクセス許可モデルに適合させるために削除されました。代わりに、オーバーレイビューを使ってこの情報をレンダリングできます。

バージョン7.1

インスタントゲームSDK v7.1のリファレンスドキュメントをご覧ください

更新履歴

動画コンテンツのネイティブレンダリング: アプリが動画コンテンツをネイティブでレンダリングできるように、APIが追加されました。
リワードインタースティシャルAPI: リワードインタースティシャルは、新しい広告表示フォーマットで、インスタントゲームの開発者はそこから収益を得ることができます。ユーザーが広告を見ることをオプトインする動画リワードとは異なり、リワードインタースティシャルは、通常のインタースティシャル広告の代わりに表示され、ユーザーはオプトアウトすることができます。動画を最後まで見ると、ゲーム内のリワードを受け取ります。
トップバナー広告: 開発者がゲームのトップにバナー広告を表示できるようにします。

バージョン7.0

インスタントゲームSDK v7.0のリファレンスドキュメントをご覧ください

更新履歴

カスタムの招待: プレイヤーはMessengerから新しいプレイヤーをゲームに招待できます。[新しいプレイヤーを招待]セクションがプレイヤーに表示され、そのゲームをまだプレイしていない友達を確認できます。[招待する]をクリックすると、ゲームをプレイするためのメッセージを友達に送信できます。複数の招待を同時に送信することもできます。詳しくは、こちらのガイドをご覧ください。
触覚フィードバック: インスタントゲームは、AndroidとiOSデバイスで、バイブレーターが連動する触覚フィードバックをサポートするようになりました。
トーナメントAPI: インスタントトーナメントは、新規のプレイヤーを獲得したり、トーナメント期間中(デフォルトで7日間)プレイヤーのエンゲージメントを維持したりするための良い方法です。プレイヤーは自分のタイムラインでリーダーボードをシェアし、友達に挑戦への参加を促すことができます。ニュースフィードの配信が、参加したプレイヤーによって再びシェアされると、トーナメントが友達グラフの中ですばやく拡散され、短期間でより多くのプレイヤーを獲得できるようになります。
統計APIの削除: より柔軟なプレイヤーデータAPIにするために削除されました。
postSessionScoreの削除postSessionScoreAsyncを代わりに提供しています。これにより、このAPIを使って発生したダイアログのユーザーアクションについてより詳細な情報を得ることができます。
shareAsyncとupdateAsyncの未使用のパラメーターの削除INTENTパラメーターは使用されていなかったため、shareAsyncから削除しました。また、カスタム更新をコンテキストセッションごとに1つに制限するポリシーがあるため、updateAsyncからIMMEDIATE_CLEAR戦略も削除しました。
トップバナー広告: 開発者がゲームのトップにバナー広告を表示できるようにします。

バージョン6.3

インスタントゲームSDK v6.3のリファレンスドキュメントをご覧ください

更新履歴

(新) FBInstant.postSessionScore: このAPIにより、ゲームはFacebookに、現在のゲームセッションのプレイヤーのスコアを提供できます。Facebookはこれらのスコアシグナルをさまざまなプラットフォーム統合で使用して、プレイヤーがゲームを発見したり、ゲームで競争したり、ゲームに再エンゲージしたりしやすくします。
オフラインのマッチメイク: 以前はマッチメイクが同期的だったため、プレイヤーが待っている間はゲームをプレイできませんでした。このリリースで、非同期のオプション "matchPlayerAsync" が追加されました。オフラインマッチングを開始したプレイヤーは、グループスレッドに直ちに追加されます。ほかのプレイヤーが参加するのを待つ間、プレイヤーはゲームを離れることができます。まだゲーム内にいる場合、マッチングが成功するとそのプレイヤーが追加され、マッチングしたスレッドのコンテキストに切り替わります。
データAPIで "initializeAsync" 後にプレイヤー、コンテキスト、ロケール、エントリポイントのデータにアクセス可能に: プリゲーム開始時のデータAPIへのアクセスを刷新しています。例えば、ゲームの読み込み中に、プレイヤーのロケールやエントリポイントのデータにアクセスできるようになりました。これにより、ゲームの読み込み中の副画面が不要になり、全体的な読み込み要件が軽減されます。この変更は現在ウェブで提供されています。モバイルでは、以下のリリースから提供されます: FB for Android v219、Messenger for Android v213、FB for iOS v222、Messenger for iOS v216。古いモバイルリリースでは、前の動作になります。"startGameAsync" が解決した後に変更されている値がないか必ずチェックしてください。