ECS Android Toast for GameMaker Studio

Description updated 13-Dec-2022

The ECS Android Toast for GameMaker Studio contains multiple functions that allow you to show native Android toast messages in your games/applications

A toast provides simple feedback about an operation in a small popup. It only fills the amount of space required for the message (maximum 2 lines) and the current activity remains visible and interactive. Toasts automatically disappear after a timeout.

Thanks to this extension, if you are targeting Android R (API 30) or above you will also have the ability to see when the toast message is shown or hidden.
Currently, the available functions are:

• ECS_AndroidToast_allowsCallbacks: Used to determine if Android Toast callbacks can be setup. The minimun Android API version for beeing able to do so is API 30 (Android R).
• ECS_AndroidToast_quick: Creates and shows a toast instantly. The toast created by this method can't be modified later for reuse.
• ECS_AndroidToast_delete: Clears a previously created custom toast (if any) that has been created using ECS_AndroidToast_create.
• ECS_AndroidToast_show: Shows a previously created toast with ECS_AndroidToast_create. Returns true if everything went OK, false otherwise.
• ECS_AndroidToast_cancel: Ends the customizable toast message created with ECS_AndroidToast_create prematurely if its being shown. Returns true if everything went OK, false otherwise.
• ECS_AndroidToast_getDuration: Gets the current duration of the customizable toast message created with ECS_AndroidToast_create. 0.0 if there is no customizable toast message setup. 2000 (milis) if the duration is short. 3500 (milis) if the duration is long.
• ECS_AndroidToast_updateText: Updates the text of a customizable toast message created with ECS_AndroidToast_create. Returns true if the text was changed OK, false otherwise.
• ECS_AndroidToast_updateDuration: Updates the duration of a customizable toast message created with ECS_AndroidToast_create. Returns true if the text was changed OK, false otherwise.

If you are targeting Android API 30 (Android R) or above, you will also have access through the "Async Social" event to the callbacks from the toast messages, they will return a callback when they are starting to be shown or when they finish showing to the user.

This extension is heavily documented and brings some example objects that are not needed by the extension, they allow you to import and test on Android with no modificaitons.
The functions of this extension have been prepared to comply with the GMS JSDoc, so Feather will display you lots of help and tips when using them ;)

MANUAL You can see the manual for any of the published versions from this link. Also you can download the last manual version from the file download options in this page.

CURRENTLY SUPPORTED PLATFORMS - Android: support for all Android architecutres. Toast messages are avaialble since Android API 1 so you shouldn't have issues with the minimun API level, however, take into accout that if you want to have the async callbacks from the toast messages, you shpuld be targetting API>=30 (Android R).

For additional support don't hesitate to contact me at alejandroibrahimojea@gmail.com with the subject: "[ECS Android Toast for GMS] your topic where you need help"