NotifPushSend (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Specific Mobile functions

Functions for phone management

See also

NotifPushSend (Function)

In french: NotifPushEnvoie

Sends a push notification to a mobile device (iOS or Android). This function can be used in a WINDEV application or in a WEBDEV site.

Example

// Send a push notification on iOS
TokensSend is array of Buffers
FOR i = 1 TO nbTokens
Add(TokensSend, tokens[i])
END

MyNotification is Notification
MyNotification..Message = "New notification"

MyCertificates is array of Certificates
MyCertificates = CertificateLoad("applecertif.cer", "")

MyResult is boolean
MyResult = NotifPushSend(MyNotification, TokensSend, ...
MyCertificates[1], typeServiceIOSRelease)

IF MyResult = False THEN
Trace(ErrorInfo())
END

Syntax

iPhone/iPad: Sending a notification Hide the details

<Result> = NotifPushSend(<Notification> , <Tokens> , <Identification> , <Server type>)

<Result>: Boolean

True if the sending was successful,
False otherwise. ErrorInfo is used to identify the error returned by the notification service.

<Notification>: Notification

Name of Notification variable corresponding to the notification to send.

<Tokens>: Array of buffers

Name of Array variable containing the list of tokens representing the devices onto which the notification will be sent.

<Identification>: Certificate

Name of Certificate variable used to identify the application on the APN service.
This variable represents the certificate for the push notifications of application (obtained beside Apple). See Conditions required for the Push notifications in iOS for more details. This certificate may have been loaded by CertificateLoad.

<Server type>: Integer constant

Type of server onto which the notification will be sent:
typeServiceIOSRelease Server of IOS release (APN).
typeServiceIOSTest Server of IOS test (APN).

Android: Sending a notification Hide the details

<Result> = NotifPushSend(<Notification> , <Tokens> , <Identification> , <Invalid tokens> [, <Platform>])

<Result>: Boolean

True if the sending was successful,
False otherwise. ErrorInfo is used to identify the error returned by the notification service. These errors can contain a list of invalid tokens that must be deleted from the token database.

<Notification>: Notification

Name of Notification variable corresponding to the notification to send.

<Tokens>: Array of buffers

Name of Array variable containing the list of tokens representing the devices onto which the notification will be sent.

<Identification>: Character string (with quotes)

Parameter for identifying the application on the GCM service (Google authorization key). A specific configuration is required to get this key. See Configuration required for the Push notifications in Android for more details.

<Invalid tokens>: Array of buffers

Name of the Array of Buffers variable. This parameter is filled with the list of invalid tokens returned by the server.

<Platform>: Optional Integer constant

Versions 22 and later
Platform that will be used to send the notification. The Android application that will receive he notifications must have been configured for this type of platform.
npeFirebase Firebase platform.
New platform for sending push notifications.
This platform must be used for the new projects (from WINDEV 22 Update 1) or for the projects that do not use the push notifications yet.
npeGCM
(Default value) Google Cloud Messaging platform.
Former Google solution for sending push notifications.
This platform must be used for the existing projects that already use the push notifications yet (projects created with a version earlier than WINDEV 22 Update 1)
New in version 22
Platform that will be used to send the notification. The Android application that will receive he notifications must have been configured for this type of platform.
npeFirebase Firebase platform.
New platform for sending push notifications.
This platform must be used for the new projects (from WINDEV 22 Update 1) or for the projects that do not use the push notifications yet.
npeGCM
(Default value) Google Cloud Messaging platform.
Former Google solution for sending push notifications.
This platform must be used for the existing projects that already use the push notifications yet (projects created with a version earlier than WINDEV 22 Update 1)
Platform that will be used to send the notification. The Android application that will receive he notifications must have been configured for this type of platform.
npeFirebase Firebase platform.
New platform for sending push notifications.
This platform must be used for the new projects (from WINDEV 22 Update 1) or for the projects that do not use the push notifications yet.
npeGCM
(Default value) Google Cloud Messaging platform.
Former Google solution for sending push notifications.
This platform must be used for the existing projects that already use the push notifications yet (projects created with a version earlier than WINDEV 22 Update 1)

Remarks

The push notification is sent to a notification service (Apple or Google) that redistributes this notification to a set of mobile devices.
The supported services are:
- Google GCM.
- Apple APN.
The supported services are:
- Versions 22 and later
  Google Firebase (Google GCM is supported for backward compatibility. Firebase is recommended by Google).
  New in version 22
  Google Firebase (Google GCM is supported for backward compatibility. Firebase is recommended by Google).
  Google Firebase (Google GCM is supported for backward compatibility. Firebase is recommended by Google).
- Apple APN.

Related Examples:

Cross-platform examples (WINDEV Mobile): WD Send Push

[ + ] This example is used to send push notifications on Android and iOS devices.

It retrieves the identifiers of the mobile devices in the HFSQL database of the "WD Push Server" example then it sends the notifications via NotifPushSend.

Component : wd240device.dll