AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Funciones WLanguage / Funciones específicas para móviles / Funciones de teléfono
  • WLanguage Procedure llamado
  • Casos especiales
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
Permite la gestión de las notificaciones push en una aplicación WINDEV Mobile (Android o iOS).
iPhone/iPad Le aconsejamos que llame a esta función en la inicialización Process del proyecto porque debe ser ejecutada siempre que se inicie la aplicación.
Ejemplo
// Enable the push notifications
NotifPushEnable(RegisterPushNotif)
// Manage the registration
PROCEDURE RegisterPushNotif(Token is Buffer, NotifError is string)
IF Length(Token) > 0 THEN
// Informs the application server about the new identifier
SendIDOnServer(Token)
ELSE
// Process the error
END
Sintaxis
NotifPushEnable(<WLanguage procedure> [, <Options>])
<WLanguage procedure>: Nombre del procedimiento
Nombre del procedimiento WLanguage llamado cuando la aplicación recibe el identificador de registro del servicio Notification.
<Options>: Combinación de constantes opcionales de tipo Integer
Opciones de registro. Puede corresponder a una o más de las siguientes constantes:
notifPushAlertTypeLa aplicación móvil aceptará las notificaciones push en formato de alerta.
Android Constante no disponible.
notifPushAllNotif
(Valor predeterminado)
La aplicación móvil aceptará todo tipo de notificaciones push.
notifPushBadgeTypeLa aplicación móvil aceptará las notificaciones push en formato de tarjeta de identificación.
Android Constante no disponible.
notifPushSoundTypeLa aplicación móvil aceptará las notificaciones de sonido push.
Android Constante no disponible.

Atención: Estas opciones se tienen en cuenta durante la primera aplicación instalación. Entonces, el usuario puede modificar las Notification s aceptadas en el Centro Notification del dispositivo.
Observaciones

WLanguage Procedure llamado

El WLanguage Procedure llamado por NotifPushEnable debe tener la siguiente sintaxis:
PROCEDURE RegisterPushNotif(<Identifier> is Buffer, <Error> is string)
Este procedimiento se llama cuando se termina la inscripción al servicio de Notification.
Los parámetros de esta Procedure son los siguientes:
  • <Identificador>: Búfer "Token" correspondiente al identificador de registro devuelto por el servicio Notification. Este buffer debe ser transmitido a servidor de aplicaciones para que las notificaciones push puedan ser enviadas a la aplicación..
    Atención: Este búfer debe ser transmitido a la servidor de aplicaciones:
    • cuando su valor cambia en relación con la ejecución anterior de la aplicación. Para ello, su valor debe almacenarse en un archivo de datos de la aplicación o en un buffer en disco creado por fSaveBuffer o SaveParameter.
    • si la aplicación es iniciada por el usuario (y no por la llegada de un empujón Notification). ExeInfo determina si la aplicación se inicia cuando se recibe un Notification.
    Esta memoria intermedia puede estar vacía si se ha producido un error de registro durante la solicitud de registro.. En este caso, el parámetro se completará con el mensaje de error.

    iPhone/iPad El búfer que corresponde al identificador puede contener caracteres no imprimibles (por ejemplo, ceros binarios). Para enviar este búfer a una aplicación de terceros (para enviar notificaciones, por ejemplo), puede ser necesario convertir este búfer en hexadecimal (BufferToHexa) o en Base64 (Codifica) dependiendo del formato esperado por la aplicación. Si la aplicación que recupera los datos es una aplicación WINDEV/WEBDEV/WINDEV Mobile, tendrá que realizar la operación inversa Conversion(HexaToBuffer o Decodifique) para poder enviar las notificaciones.
  • <Error>: Cadena de caracteres que describe un error de registro. Este parámetro sólo se rellena si se ha producido un error durante la solicitud de registro.

Casos especiales

  • iPhone/iPad Esta función sólo puede ser llamada si la aplicación incluye un Certificate para las notificaciones push.
  • iPhone/iPad Si la función se llama varias veces durante la misma ejecución de la aplicación, sólo se tiene en cuenta la primera llamada.
  • Android El dispositivo se comunica con el servicio Notification de Google Cloud Messaging (GCM) utilizando los siguientes puertos: 5228, 5229 y 5230. Asegúrese de que su cortafuegos esté configurado en consecuencia.
  • Android Si no se pudo contactar con el servicio de notificaciones Google Cloud Messaging al llamar a la función NotifPushEnable (problema de conectividad de red, por ejemplo), la solicitud de suscripción se enviará automáticamente con un intervalo de tiempo cada vez mayor (máximo 1 hora) hasta que la solicitud se realice correctamente o se produzca un error. Por lo tanto, puede transcurrir mucho tiempo entre la llamada a la función NotifPushEnable y la llamada al procedimiento pasado como parámetro.
  • NotifPushEnable es asíncrono porque ejecuta una solicitud:
    • iPhone/iPad en el servidor de Apple para iOS.
    • Android en el servidor Google para Android.
      A partir de Android 12, se tarda más en obtener el Token al instalar o reinstalar una aplicación.. El WLanguage Procedure llamado por NotifPushEnable se puede ejecutar después de inicializar el proyecto o cuando se abre la primera ventana.
Clasificación Lógica de negocio / UI: Lógica de negocio
Componente: wd290android.jar
Versión mínima requerida
  • Versión 19
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 28/02/2024

Señalar un error o enviar una sugerencia | Ayuda local