In the web cms we see country icons for each player, how do we get that image information so we can display that in our leader board's gui?
Each score entry contains a country property storing a two-letter country code. You'll find lots of free flag icon sets online that use the same code — an ideal case for a texture atlas!
When submitting a score, I want to pause (loop an animation, etc) until the submit score is finished. Is there any events, callbacks, etc, to let me know if the submit score was successful or an error occurred?
When you call "Flox.postScore", the score is added to the internal Flox request queue. That means that if the player is online, the score is sent right away. If he is not, or something goes wrong when sending the score, Flox will automatically retry once the player is online again. Even if the player closed the app completely and rebooted his/her device.
In other words: that process can't actually fail, it can only be delayed.
After submitting a score, is there any way to find out what position the player's score resulted in?
Unfortunately not, no. You can only check yourself when loading the leaderboard. (Flox stores the top 200 per leaderbaord/timescope.)
In a related matter, how can I tell if the Flox.init() call was successful or not? This way I can tell the user that leaderboards are currently unavailable, etc.
"Flox.init" can't fail, either, it works even when you're offline. If it's the first time you start up, all relevant data will be created offline; if you're coming back to the game, all relevant data was stored offline for subsequent starts.
In Flox, when something goes wrong, you'll always end up in an "onError" callback. If you're calling a method that doesn't have such a callback, it's always queued and retried. And even if you end up in an "onError" callback, it will often contain some cached data that you work with instead.
I hope that helps!