This fails:
fbinstant.choose_context(nil, callback)

This works:
fbinstant.choose_context("{}", callback)

Returning a set makes it easier to check if a certain function is supported or not:

local supported_apis = fbinstant.get_supported_apis()
if supported_apis["getInterstitialAdAsync"] then
   -- load/show interstitial
end

Or maybe even utility functions such as fbinstant.is_ads_supported() would be event better?

There's a version of the API which returns dummy results, not require connection to Facebook for testing, may be useful to support somehow

https://www.defold.com/manuals/extensions-script-api/

Something like this for mock.lua

local info = sys.get_sys_info()

if info.system_name == "HTML5" then
	local domain = html5.run("window.location.hostname")
	if domain == "localhost" then
		fbinstant = nil
	end
end


if fbinstant then return end
fbinstant = {
	mock = true
}

...

Current target is 6.0 but 6.1 is latest release

https://developers.facebook.com/docs/games/instant-games/sdk/fbinstant6.1

you make a lot of allocations on js side, but never free() the memomry after push to lua.

Too many leaderboard requests can produce an error like this, causing the callback to never fire:

FBInstant_PlatformSetLeaderboardScoreAsync - error: Game called too many leaderboard APIs too quickly. Reduce the rate of requests in order to avoid being rate-limited.

It's still in private beta? Could test and see if it works anyway. Main thing is all of the appids need to belong to the same business on Facebook API.

More info: https://forum.defold.com/t/facebook-instant-error/45624

It triggers "success=true" when the share dialog has been opened. This means there is no way of knowing if the user shared or cancelled the share dialogue.

Defold example is currently broken as activity store api has been disabled

Example here

https://origincache.facebook.com/developers/resources/?id=tic-tac-toe.zip

I can help make changes / set it up later

Needed for checking the platform to even attempt to display ads or not

{{exe-name}} needs to be replaced with {{DEFOLD_BINARY_PREFIX}}

Is there a debug problem with them?

Some ad related links

https://www.facebook.com/groups/instantgamedevelopers/permalink/768548260008002/

https://www.facebook.com/groups/instantgamedevelopers/permalink/768509343345227/

https://www.facebook.com/audiencenetwork/news-and-insights/rewarded-video-best-practices?hc_location=ufi

https://www.adcolony.com/blog/2016/08/12/rewarded-video-making-the-most-of-value-exchange/

fbinstant.log_event(event_name, value_to_sum, parameter_json)

If "value_to_sum" or "parameters" are omitted the operation fails.

These parameters are optional in the JavaScript version of the API:
https://developers.facebook.com/docs/games/instant-games/sdk/fbinstant6.0

There is locale in user but may be useful to get it directly too

is fbinstant.get_player_stats() work only with one value per time?

Original example is:

FBInstant.player
  .getStatsAsync(['level', 'zombiesSlain'])
  .then(function(stats)) {
    console.log('stats are loaded');
    var level = data['level'];
    var zombiesSlain = data['zombiesSlain'];
  });

I’m trying to load Facebook instant game ads several times using two placement IDs using bellow functionality,

-- Preload ad unit
function load_ad_unit(ad_unit_id)
    print("loading ad unit...")
    fbinstant.load_interstitial_ad(
        ad_unit_id,
        function(self, success)
            if success then
                print("Ad unit successfully loaded ")
            else
                print("Ad unit doesn't loaded ", ad_unit_id)
            end
        end
    )
end

-- Show ad unit
function show_ad_unit(ad_unit_id)
    fbinstant.show_interstitial_ad(
        ad_unit_id,
        function(self, success)
            if success then
                print("Ad unit successfully opened ", ad_unit_id)
                -- * I put this here because `show_interstitial_ad`
                -- handles removing the ad instance
                load_ad_unit(ad_unit_id)
            else
                print("Ad unit doesn't opened ", ad_unit_id)
            end
        end
    )
end

function on_message(self, message_id, message, sender)
    if message_id == hash("NEW_GAME") then
        load_ad_unit("<ad_unit_id>")
    elseif message_id == hash("ON_PRESS") then
        show_ad_unit("<ad_unit_id>")
    end
end

But this only works once at the beginning of the game when I press a button. For the second time, it won't work. Below are errors that occur in most situations,

> FBInstant_PlatformShowInterstitialAdAsync - unable to find ad. Did you load it?
> FBInstant_PlatformLoadInterstitialAdAsync - error a {code: "ADS_NO_FILL", message: "No fill"}
> FBInstant_PlatformLoadInterstitialAdAsync - error a {code: "ADS_TOO_MANY_INSTANCES", message: "Too many ad instances"}

This issue is from the forum: https://forum.defold.com/t/facebook-instant-games-ads-not-loading-more-than-once/43392

And all operations on the leaderboards themselves: https://developers.facebook.com/docs/games/instant-games/sdk/fbinstant6.0#leaderboard

Also happens in Chrome so may be easier to debug there.

Other non-Defold based games on Android show loading progress. Loading progress of Defold based games does work on iOS.

And checkCanPlayerMatchAsync( )

Rewarded video does not loading. Request throws:
code: "CLIENT_UNSUPPORTED_OPERATION"
message: "Client does not support the message: getrewardedvideoasync"

The payload passed to fbinstant.update() must include an image. This is typically a screenshot or some other visuals that show the current progress of the game.

Add a function to properly base64 encode and format the image value.

Look into Canvas.toDataURL and also dig into the Defold-Screenshot extension on HTML5.

Blank/empty image:

"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAADElEQVQImWNgoBMAAABpAAFEI8ARAAAAAElFTkSuQmCC"

There are plenty of error codes that could get exposed and several functions that throw these. The callback functions currently only return true/false to indicate success/failure but could include the error code as a second argument.

Currently the communication from Lua to JS via C requires complex data structures (Lua tables) to be serialized to JSON in Lua before passed on as a string to the extension and deserialized again in Javascript. The same process but in reverse goes for complex responses from Javascript back to Lua.

The preferred solution is to pass Lua tables to C and let the C code serialize to JSON. Currently there's no support for serializing a Lua table to JSON from C.

Task: Evaluation of JSON parsers in C. Integrate with extension.

• https://github.com/zserge/jsmn
• https://github.com/nlohmann/json
• https://github.com/kazuho/picojson
• And possibly others

Perhaps Lua table to JSON and back again should be part of the DMSDK?

Lua version accepts a single key only while JS version accepts array of keys

If board is full it will say it's a draw even though there was a winner.

Testing new chat bots should work again, can add to example at some point for XOXO

Forum thread: https://forum.defold.com/t/contextual-leaderboards-on-facebook-instant/44989

https://developers.facebook.com/blog/post/2018/05/01/in-app-purchases-instant-game-platform/
https://developers.facebook.com/docs/games/instant-games/guides/in-app-purchases

Mock lacks some supported api functions: Discovered so far are load_rewarded_video and show_rewarded_video

Maybe want to translate these through to Defold extension versions?

This would help add external libraries and functionality which relies on updateProgress and/or initializeAsync outside the actual game.

https://forum.defold.com/t/customising-fbinstant-engine-template/64090/17