# SetLocalNotification

## Description

Creates a local notification that will appear at some point in the future. Notifications are referenced by ID and can be overwritten by creating a new notification with the same ID as the notification you want to overwrite. If a notification triggers whilst the app is open then the notification will not appear and it will silently disappear from the list of scheduled notifications. If the app is not open then a notification will display to the user and tapping on it will open up your app. If you set the deeplink parameter then that URL will be sent to the app when the notification is tapped. The URL can be retrieved by using the GetURLSchemeText command. The datetime parameter should be specified in unix time, which is measured in seconds since 1st Jan 1970, you can use the command GetUnixTime to return the current date and time then modify it as needed. If the date and time is in the past then the notification will be ignored, it will not overwrite any existing notification. The ID must be in the range 1 to 100 inclusive.

## Definition

SetLocalNotification( iID, datetime, szMessage )

void agk::SetLocalNotification( int iID, int datetime, const char *szMessage )

SetLocalNotification( iID, datetime, szMessage, szDeepLink )

void agk::SetLocalNotification( int iID, int datetime, const char *szMessage, const char *szDeepLink )

## Parameters

- iID - The ID to use to reference this notification in future
- datetime - The date and time to show this notification in unix time
- szMessage - The message to display in the notification
- szDeepLink - The URL to send to the app if the notification is tapped