win8_livetile_notification_begin(template);
Argument | Description |
---|---|
template | The template that the live tile notification should use (a string, see Live Tile Templates) |
Returns: N/A
To create a Live Tile notification you must use several GameMaker: Studiofunctions, starting with this one. This function takes a "template" and prepares GameMaker: Studio to fill it with the
necessary information (using the rest of the Live Tile functions), before pushing it to Windows 8 using the win8_livetile_notification_end() function.
You can find a list of templates here and a complete overview for each one can be found from the Microsoft help pages
here.
Live Tile notifications can be queued so that they show one after another, but to do that you must define each of them individually using the Windows 8 functions calling the "begin" and "end" functions each
time (you can't call "begin" and then define 4 different notifications then "end" to push them to Windows 8).
NOTE: You can only queue up to 5 Live Tile notifications, and you must have activated queuing with the function
win8_livetile_queue_enable.
var expiryTime;
expiryTime = date_current_datetime();
expiryTime = date_inc_minute(expiryTime, 5);
win8_livetile_notification_begin("TileSquarePeekImageAndText01");
win8_livetile_notification_expiry(expiryTime);
win8_livetile_notification_tag("tag0");
win8_livetile_notification_text_add("Current Score = " + string(score));
win8_livetile_notification_image_add("ms-appx:///" + working_directory + "ScoreTile.png");
win8_livetile_notification_end();
The above code will push a new Live Tile notification through to Windows 8, with some text and an image, and the tile will be shown for 5 minutes.