Due to the ongoing consolidation of the gaming ecosystem at Facebook, we have introduced important changes to the Web Games on Facebook and Facebook Gameroom platforms that might affect your games. To learn more read our blog post.
Now that you have all the tools you need, it's time to build, configure and test your game in Facebook Gameroom.
You should create a Test App for development, and switch back to your Production App when you are ready to release your game.
In your App Dashboard, click the drop-down arrow next to your app name. Select the Create Test App button to create a Test App. The Test App is created with a snapshot of your Production App's settings. Changes made in either app will not affect the other app.
You should note the following differences between Test Apps and normal (Production) apps:
Normal (Production) App
Go to File > Build Settings, then select Facebook as your Platform and click Switch Platform.
Click Player Settings and enter your AppID.
Configure the resolution and window settings to the following:
Note: If you don't see Facebook listed as a Platform, it means that the required Facebook libraries are not installed in the editor. Rerun the installer to install the missing modules, and make sure you select Facebook Games Build Support to add the component.
See Install Unity with Facebook Games for more information.
A Windows machine is required to fully test the game.
Select the Facebook platform and click Build And Run. This will launch your game locally in Facebook Gameroom.
Click on your profile icon at the top right corner of the screen.
Select [DEV] Debug Unity, and open the local .exe file that you have built.
You may also launch your game locally via the following command:
(Only for approved, uploaded .zip files)
Once you have uploaded a .zip for the first time, you will need to submit it for App Review. Make sure that you do not see the following message in your hosting card:
After approval, your game should be visible to all admins and developers of your app. Configure this in the Roles section of the App Dashboard.
Type the App Name in the search bar of Gameroom to find your app:
Facebook offers free hosting for games up to 5 GB per .zip binary. For any extra assets, you will need to handle the hosting and downloading in your game.
For more information on Facebook Hosting, you may take a look at the documentation.
Once you are satisfied with your testing, prepare your game for upload to Facebook Hosting. In Build Settings, select Package build for uploading.
This step will package your game by zipping up the data directory and game executable (shown below), creating a .zip file. If you are manually creating a .zip file, make sure that the .exe and data folder are in the root of the zip.
If you have installed Unity with Facebook Games, you can upload the build directly from the Unity Editor. Follow Option A if you have the Unity. Otherwise, you should follow Option B to manually upload your build via the App Dashboard.
Open the App Dashboard in your browser:
Under Canvas Hosting, click the Get Asset Upload Access Token button.
Copy your Upload Access Token:
In the Unity Editor, under Player Settings > Publishing Settings, paste your Upload Access Token:
Under Build Settings, enter an upload comment and click Upload last build to Facebook. If this button is disabled, you need to select Package build for uploading and click Build again.
Your build should now appear in the App Dashboard with your upload comment.
In Web Hosting > Facebook Gameroom, click the Upload Version button.
In the latest Chrome or Firefox, you will see the following upload dialog:
Choose the directory containing your game executable and data folder, and we will handle the zip and processing on your behalf.
On unsupported browsers, you will see the following upload dialog:
Choose your .zip file to upload instead.
Once the upload finishes, click the star button to push your game to production.
Now that your game is built and tested, it's time to launch it to Facebook Gameroom.