Difference between revisions of "FBInstant.updateAsync"

From GiderosMobile
Line 8: Line 8:
 
  FBInstant.updateAsync(payload,callback)
 
  FBInstant.updateAsync(payload,callback)
 
</source>
 
</source>
'''payload''': (table) A payload that describes the update. ''''''<br/>
+
=== Parameters ===
'''callback''': (function) A function that will be called with two arguments: True when Facebook gives control back to the game or nil if the operation failed, and an error code if the function failed. ''''''<br/>
+
'''payload''': (table) A payload that describes the update. <br/>
 +
'''callback''': (function) A function that will be called with two arguments: True when Facebook gives control back to the game or nil if the operation failed, and an error code if the function failed. <br/>
 +
=== Examples ===
 +
'''Example'''<br/>
 +
<source lang="lua"><br />
 +
-- This will post a custom update. If the game is played in a messenger
 +
-- chat thread, this will post a message into the thread with the specified
 +
-- image and text message. And when people launch the game from this
 +
-- message, those game sessions will be able to access the specified blob
 +
-- of data through FBInstant.getEntryPointData().
 +
FBInstant.supdateAsync({action="CUSTOM",
 +
cta="Join The Fight",
 +
image=base64Picture,
 +
test={default="X just invased Y\'s village!",
 +
localizations={ ar_AR="X \u0641\u0642\u0637 \u063A\u0632\u062A \u0642\u0631\u064A\u0629 Y!",
 +
en_US="X just invaded Y\'s village!",
 +
el_LA="\u00A1X acaba de invadir el pueblo de Y!"}
 +
},
 +
template="VILLAGE_INVASION",
 +
data={myReplayData="..."+,
 +
strategy="IMMEDIATE",
 +
notification="NO_PUSH"}, function(result,error)
 +
    if result then
 +
-- closes the game after the update is posted.
 +
FBInstant.quit()
 +
end
 +
end)
 +
<br/></source>

Revision as of 11:44, 23 August 2018

Available since: Gideros 2018.3

Description


Informs Facebook of an update that occurred in the game. This will temporarily yield control to Facebook and Facebook will decide what to do based on what the update is. The returned promise will resolve/reject when Facebook returns control to the game.

 FBInstant.updateAsync(payload,callback)

Parameters

payload: (table) A payload that describes the update.
callback: (function) A function that will be called with two arguments: True when Facebook gives control back to the game or nil if the operation failed, and an error code if the function failed.

Examples

Example

<br />
-- This will post a custom update. If the game is played in a messenger
-- chat thread, this will post a message into the thread with the specified
-- image and text message. And when people launch the game from this
-- message, those game sessions will be able to access the specified blob
-- of data through FBInstant.getEntryPointData().
FBInstant.supdateAsync({action="CUSTOM",
	cta="Join The Fight",
	image=base64Picture,
	test={default="X just invased Y\'s village!",
		localizations={	ar_AR="X \u0641\u0642\u0637 \u063A\u0632\u062A \u0642\u0631\u064A\u0629 Y!",
						en_US="X just invaded Y\'s village!",
						el_LA="\u00A1X acaba de invadir el pueblo de Y!"}
		},
	template="VILLAGE_INVASION",
	data={myReplayData="..."+,
	strategy="IMMEDIATE",
	notification="NO_PUSH"}, function(result,error)
    if result then
		-- closes the game after the update is posted.
		FBInstant.quit()
	end
end)
<br/>