Launch a Game on Facebook Use Case

This document shows you how to create and customize an app with the Launch a Game on Facebook use case on the Apps Dashboard. Launch a game that players can find and play directly in their Feed or Messenger conversations, on both desktop and mobile devices. This use case uses Instant Games and Facebook Login for Gaming.

This guide assumes that you have read and implemented the requirements for creating an app with Meta.

1. 開始應用程式建立程序

有許多方法可以建立應用程式。

如果您剛完成註冊流程，請點擊「建立第一個應用程式」按鈕
如果您在應用程式主控板中，請點擊右上角的「建立應用程式」
如果您在現有應用程式的主控板中，且想要建立新的應用程式，請選擇左上角的下拉式功能表，然後點擊「建立新應用程式」按鈕

Step 2: Select your use case

Select the Launch a game on Facebook use case.

You can click the chevron to the right of the description to view what else you can do with this use case and the requirements for this use case.

Click the Next button.

Step 3. App details

your app's name for your app
the email address to be used to contact you about this particular app

Optionally, you can link this app to an existing Business Account using the dropdown menu, or you can add this at a later date.

Click Create App to save your app's details.

Step 4. Customize this app

Under Launch a game on Facebook use case, you can see that the following have been added to your use case:

Facebook Login for Gaming
Instant Games
The gaming_profile permission
The gaming_user_picture permission

Click the Customize button to the right of Launch a game on Facebook to customize the following items for your use case:

Details – Add a tagline, description, images and icons, game preview videos, and more
Localize – Translate your game content in up to 104 languages
Web hosting – Upload your game client code directly to Facebook instead of hosting it on your own servers
Login settings – Add more permissions to ask users for access
Feedback – Get all feedback submitted from players within the last 90 days

Facebook Login for Gaming

Settings

Facebook Login for Gaming allows you to control oAuth settings, and add a deauthorization callback URL and redirect URI validator.

Quickstart

The Facebook Login for Gaming quickstart allows you to quickly implement Facebook Login for Gaming in your app.

Permissions

You will see a list of permissions that are available in the Instant Games use case with a full description and requirements for each.

email – Can be added if your app needs a person's email address
gaming_profile – Automatically added and can not be removed
gaming_user_locale – Can be added if your app needs a person's locale
gaming_user_picture – Automatically added and can not be removed

After you add a permission to your app, you can see the status for that permission:

Ready for live mode – This permission has been approved in App Review
Ready to Testing – You can test API calls to endpoints that require this permission
Verification Required – This permission has not yet been approved in App Review

You can also see the number of successful API calls you have made to endpoints that require each permission.

Next Steps

Now that you have successfully customized your Launch a game on Facebook use case, you can add additional use cases or update the settings for your app in the app Dashboard.