Facebookでゲームを起動するユースケース

このドキュメントでは、アプリダッシュボード上のFacebookでゲームを起動するユースケースを使って、アプリを作成しカスタマイズする方法を示します。デスクトップとモバイルデバイスの両方で、プレイヤーがフィードやMessengerのスレッドから直接見つけてプレイできるゲームを起動します。このユースケースでは、インスタントゲームとGamingへのFacebookログインを使います。

このガイドは、開発者がMetaでアプリを作成するための要件を事前に確認し、満たしていることを前提としています。

ステップ2: ユースケースを選択する

[Facebookでゲームを起動]ユースケースを選択します。

説明の右にあるシェブロンをクリックすると、このユースケースでほかにできること、およびこのユースケースの要件について確認できます。

[次へ]ボタンをクリックします。

ステップ3. アプリの詳細

• アプリの名前
• この特定のアプリに関して連絡を受けるのに使用するメールアドレス

任意で、ドロップダウンメニューを使用して、このアプリを既存のビジネスアカウントにリンクできます。このリンクは、後日追加することもできます。

[アプリを作成]をクリックして、アプリの詳細を保存します。

ステップ4. このアプリをカスタマイズする

[Facebookでゲームを起動]ユースケースを見ると、以下のものがユースケースに追加されていることが分かります。

• GamingへのFacebookログイン
• インスタントゲーム
• gaming_profileアクセス許可
• gaming_user_pictureアクセス許可

[Facebookでゲームを起動]の右側にある[カスタマイズ]ボタンをクリックして、自分のユースケースに合わせて以下の項目をカスタマイズします。

• 詳細 – タグライン、説明、画像やアイコン、ゲームプレビュー動画などを追加する
• ローカライズ – 最大104の言語にゲームコンテンツを翻訳する
• ウェブホスティング – ゲームクライアントコードを自社サーバーでホスティングするのではなく、Facebookに直接アップロードする
• ログイン設定 – ユーザーにアクセスしてもらうためのアクセス許可を追加する
• フィードバック – 最近90日間にプレイヤーが送信したフィードバックをすべて取得する

GamingへのFacebookログイン

設定

GamingへのFacebookログインにより、OAuth設定をコントロールできるようになり、承認取り消しコールバックURLとリダイレクトURI検証ツールを追加できます。

クイックスタート

GamingへのFacebookログインのクイックスタートにより、アプリにGamingへのFacebookログインを素早く実装することができます。

アクセス許可

インスタントゲームのユースケースで利用可能なアクセス許可と、それぞれのアクセス許可の全説明文と要件が記載されたリストが表示されます。

• email – アプリで利用者のメールアドレスが必要な場合に追加可能
• gaming_profile – 自動的に追加され、削除はできない
• gaming_user_locale – アプリで利用者のロケールが必要な場合に追加可能
• gaming_user_picture – 自動的に追加され、削除はできない

アプリにアクセス許可を追加すると、そのアクセス許可の次のステータスが表示されます。

• ライブモードの準備完了 – このアクセス許可はアプリレビューで承認されました
• テスト準備完了 – このアクセス許可を必要とするエンドポイントへのAPI呼び出しをテストできます
• 認証が必要 – このアクセス許可はまだアプリレビューで承認されていません

それぞれのアクセス許可を必要とするエンドポイントに対して行ったAPI呼び出しに成功した数も確認できます。

次のステップ

Facebookでゲームを起動するユースケースのカスタマイズが完了したので、アプリダッシュボードで追加のユースケースを追加したり、アプリの設定を更新したりすることができます。

参考情報

このドキュメントに記載されている概念、エンドポイント、アクセス許可の詳細については、以下のガイドをご覧ください。

• GamingへのFacebookログイン
• インスタントゲーム
• アクセス許可のリファレンス