|
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.
 Warning
From November 2020, Apple uses a different format for managing Push notifications. A new syntax must be used to send notifications on iPhone/iPad. To use this new syntax, you must use WINDEV / WEBDEV 25 "Update 4" (250090). In version "Update 4", syntax 1 will cause a compilation error.
Example of code to send a notification on iOS. This code can be used up to version 250089F.
// 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
Example of code to send a notification on iOS. This code can be used from version 250090 onwards.
// 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"
MyResult is boolean
MyResult = NotifPushSend(MyNotification, TokensSend, ...
"applecertif.cer", "", BundleIDName, typeServiceIOSRelease)
IF MyResult = False THEN
Trace(ErrorInfo())
END
Syntax
iPhone/iPad: Send a notification (up to version 250089F) 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 (obtained from Apple) for the application push notifications. For more details, see Conditions required for the Push notifications in iOS. 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). |
 Versions 25 and later
iPhone/iPad: Sending a notification (from version 250090) Hide the details
<Result> = NotifPushSend(<Notification> , <Tokens> , <Identification> , <Password> , <TopicID> , <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>: Character string (with quotes) Full path of the file containing the certificate for the application push notifications (obtained from Apple). See Conditions required for the Push notifications in iOS for more details. <Password>: Ansi character string (with quotes) Password of the file containing the certificate for Push notifications. If the file does not have a password, use an empty string (""). This parameter must correspond to an ANSI character string. <TopicID>: Character string (with quotes) Bundle identifier specified in the "General" section of the Xcode project generation wizard. <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). |
 New in version 25
iPhone/iPad: Sending a notification (from version 250090) Hide the details
<Result> = NotifPushSend(<Notification> , <Tokens> , <Identification> , <Password> , <TopicID> , <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>: Character string (with quotes) Full path of the file containing the certificate for the application push notifications (obtained from Apple). See Conditions required for the Push notifications in iOS for more details. <Password>: Ansi character string (with quotes) Password of the file containing the certificate for Push notifications. If the file does not have a password, use an empty string (""). This parameter must correspond to an ANSI character string. <TopicID>: Character string (with quotes) Bundle identifier specified in the "General" section of the Xcode project generation wizard. <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). |
iPhone/iPad: Sending a notification (from version 250090) Hide the details
<Result> = NotifPushSend(<Notification> , <Tokens> , <Identification> , <Password> , <TopicID> , <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>: Character string (with quotes) Full path of the file containing the certificate for the application push notifications (obtained from Apple). See Conditions required for the Push notifications in iOS for more details. <Password>: Ansi character string (with quotes) Password of the file containing the certificate for Push notifications. If the file does not have a password, use an empty string (""). This parameter must correspond to an ANSI character string. <TopicID>: Character string (with quotes) Bundle identifier specified in the "General" section of the Xcode project generation wizard. <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 laterPlatform 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 22Platform 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: The supported services are:
Versions 22 and laterGoogle Firebase (Google GCM is supported for backward compatibility. Firebase is recommended by Google). New in version 22Google 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.
|
Business / UI classification : Business Logic Component : wd250device.dll
This page is also available for…
|
|
|
| |
| Click [Add] to post a comment |
|
| |
|
| |
| |
| |
| |
| |
| |
| | |
| |