Difference between revisions of "Facebook Instant Games"

From GiderosMobile
 
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
<languages />
 
 
<!-- GIDEROSOBJ:Facebook Instant Games -->
 
<!-- GIDEROSOBJ:Facebook Instant Games -->
'''<translate>Supported platforms</translate>:''' [[File:Platform html5.png]]<br/>
+
'''Supported platforms:''' [[File:Platform html5.png]]<br/>
'''<translate>Available since</translate>:''' Gideros 2018.3<br/>
+
'''Available since:''' Gideros 2018.3<br/>
  
=== <translate>Description</translate> ===
+
=== Description ===
 
Adds Facebook Instant Games framework to your project.
 
Adds Facebook Instant Games framework to your project.
  
Line 11: Line 10:
 
# Tick the Facebook Instant Game tickbox when exporting to HTML5, you can also specify the percentage indicator that the game will show it has loaded before you take control.
 
# Tick the Facebook Instant Game tickbox when exporting to HTML5, you can also specify the percentage indicator that the game will show it has loaded before you take control.
 
# Require the FBInstant library code, see the example below.
 
# Require the FBInstant library code, see the example below.
 
  
 
You can upload, debug and test your game by creating a player and uploading to Facebook servers as a game. The player will interact with the Gideros Studio similar to any other player.
 
You can upload, debug and test your game by creating a player and uploading to Facebook servers as a game. The player will interact with the Gideros Studio similar to any other player.
Line 22: Line 20:
 
Please refer to the https://developers.facebook.com/docs/games/instant-games/getting-started/quickstart original Facebook documentation for more information about testing and uploading.
 
Please refer to the https://developers.facebook.com/docs/games/instant-games/getting-started/quickstart original Facebook documentation for more information about testing and uploading.
  
 +
'''note:''' the official Facebook documentation mentions having to wait for initializeAsync, with Gideros this has already been done for you before your game starts.
  
'''note:''' the official Facebook documentation mentions having to wait for initializeAsync, with Gideros this has already been done for you before your game starts.
+
=== Old Documentation (Obsolete) ===
 +
[[* Initialisation and Core]]
  
=== <translate>Classes</translate> ===
+
=== Classes ===
 
<div style="column-count:2;-moz-column-count:2;-webkit-column-count:2">
 
<div style="column-count:2;-moz-column-count:2;-webkit-column-count:2">
[[Special:MyLanguage/FBInstant|FBInstant]] ''<translate>Facebook Instant Games Initialisation and Core.</translate>''<br/><!-- GIDEROSOBJ:FBInstant Facebook Instant Games Initialisation and Core. -->
+
[[FBInstant]] ''Facebook Instant Games Initialisation and Core''<br/><!--GIDEROSOBJ:FBInstant Facebook Instant Games Initialisation and Core-->
[[Special:MyLanguage/FBInstant.context|FBInstant.context]] ''<translate>Contains functions and properties related to the current game context.</translate>''<br/><!-- GIDEROSOBJ:FBInstant.context Contains functions and properties related to the current game context. -->
+
[[FBInstant.context]] ''contains functions and properties related to the current game context''<br/><!--GIDEROSOBJ:FBInstant.context contains functions and properties related to the current game context-->
[[Special:MyLanguage/FBInstant.payments|FBInstant.payments]] ''<translate>Contains functions and properties related to payments and purchases of game products.</translate>''<br/><!-- GIDEROSOBJ:FBInstant.payments Contains functions and properties related to payments and purchases of game products. -->
+
[[FBInstant.payments]] ''contains functions and properties related to payments and purchases of game products''<br/><!--GIDEROSOBJ:FBInstant.payments contains functions and properties related to payments and purchases of game products-->
[[Special:MyLanguage/FBInstant.player|FBInstant.player]] ''<translate>Contains functions and properties related to the current player.</translate>''<br/><!-- GIDEROSOBJ:FBInstant.player Contains functions and properties related to the current player. -->
+
[[FBInstant.player]] ''contains functions and properties related to the current player''<br/><!--GIDEROSOBJ:FBInstant.player contains functions and properties related to the current player-->
 
</div>
 
</div>
  
 
{{GIDEROS IMPORTANT LINKS}}
 
{{GIDEROS IMPORTANT LINKS}}

Latest revision as of 01:18, 21 September 2022

Supported platforms: Platform html5.png
Available since: Gideros 2018.3

Description

Adds Facebook Instant Games framework to your project.

You need to do two things to target Facebook Instant Games:

  1. Tick the Facebook Instant Game tickbox when exporting to HTML5, you can also specify the percentage indicator that the game will show it has loaded before you take control.
  2. Require the FBInstant library code, see the example below.

You can upload, debug and test your game by creating a player and uploading to Facebook servers as a game. The player will interact with the Gideros Studio similar to any other player.

The only restriction with the player is that it only works on the computer viewing the html5 game (localhost) - this would normally rule out actual phones but there is a workaround for Android:

  1. Connect your Android phone to your computer using ADB.
  2. Type in this command in a command console shell (Windows) or terminal (Mac): adb reverse tcp:15001 tcp:15001
  3. The Android device now will see the Gideros Studio when testing the game when a player is launched from within Facebook Messenger.

Please refer to the https://developers.facebook.com/docs/games/instant-games/getting-started/quickstart original Facebook documentation for more information about testing and uploading.

note: the official Facebook documentation mentions having to wait for initializeAsync, with Gideros this has already been done for you before your game starts.

Old Documentation (Obsolete)

* Initialisation and Core

Classes

FBInstant Facebook Instant Games Initialisation and Core
FBInstant.context contains functions and properties related to the current game context
FBInstant.payments contains functions and properties related to payments and purchases of game products
FBInstant.player contains functions and properties related to the current player