Exporter (0) Imprimer
Développer tout

mpns (objet)

Mis à jour: octobre 2014

Expose les fonctionnalités des services de notification Push Microsoft (MPNS) dans des scripts de serveur Microsoft Azure Mobile Services.

Cet objet contient les membres suivants :

Envoie une notification de retournement de vignette à un canal spécifique.

noteRemarque
La méthode sendFlipTile est uniquement prise en charge pour envoyer des notifications à Windows Phone 7.8 et versions ultérieures.

sendFlipTile(channel, payload, options)

 

Parameter Description

channel

Valeur d'URI de canal requise ou tableau de valeurs d'URI qui indique les canaux pour recevoir la notification.

payload

Objet JSON requis qui contient les informations de notification, qui incluent les champs suivants :

  • backgroundImage : URI de l'image d'arrière-plan de la vignette.

  • count : nombre qui s'affiche sur la vignette.

  • title : texte du titre de la vignette.

  • backBackgroundImage : URI de l'image qui est affichée au verso de la vignette.

  • backTitle : titre du verso de la vignette.

  • backContent : texte du verso de la vignette.

  • id ID d'une vignette secondaire associée.

  • smallBackgroundImage : URI de l'image d'arrière-plan de la vignette lorsqu'elle est réduite à une petite taille.

  • wideBackgroundImage : URI de l'image d'arrière-plan de la vignette développée à sa grande taille.

  • wideBackContent : contenu du verso de la vignette développée à sa grande taille.

  • wideBackBackgroundImage : URI pour que l'image soit sur le verso de la vignette lorsque celle-ci est développée à sa grande taille.

Pour plus d'informations sur le modèle de retournement de vignette, consultez Flip Tile template for Windows Phone 8.

options

Rappel utilisé pour capturer les résultats de la notification :

{
    success: success,
    error: error
}

success est la fonction qui est appelée après l'envoi de la notification et error est la fonction qui est appelée lorsqu'une erreur se produit.

Lorsque l'opération d'envoi de données réussit, un objet JSON est passé à la fonction success, rempli avec les informations suivantes :

{
    statusCode: http_status_code, 
    deviceConnectionStatus: 'connection_status', 
    notificationStatus: 'notification_status', 
    subscriptionStatus: 'subscription_status', 
    title: 'title_field', 
    pushType: 'flipTile', 
    tileTemplate: 'tile_template' 
}

Cet objet contient également les champs de toutes les options de notification Push fournies à MPNS.

Non défini.

Envoie une notification de vignette à un canal.

sendTile(channel, payload, options)

 

Parameter Description

channel

Valeur d'URI de canal requise ou tableau de valeurs d'URI qui indique les canaux pour recevoir la notification.

payload

Objet JSON requis qui contient les informations de notification, qui incluent les champs suivants :

  • backgroundImage : URI de l'image d'arrière-plan de la vignette.

  • count : nombre qui s'affiche sur la vignette.

  • title : texte du titre de la vignette.

  • backBackgroundImage : URI de l'image qui est affichée au verso de la vignette.

  • backTitle : titre du verso de la vignette.

  • backContent : texte du verso de la vignette.

  • id ID d'une vignette secondaire associée.

    La méthode est uniquement prise en charge pour envoyer des notifications à Windows Phone 7.5 et versions ultérieures.

Pour plus d'informations sur ce modèle de vignette, consultez Windows Phone OS 7.1 Tile template.

options

Rappel utilisé pour capturer les résultats de la notification :

{
    success: success,
    error: error
}

success est la fonction qui est appelée après l'envoi de la notification et error est la fonction qui est appelée lorsqu'une erreur se produit.

Lorsque l'opération d'envoi de données réussit, un objet JSON est passé à la fonction success, rempli avec les informations suivantes :

{
    statusCode: http_status_code, 
    deviceConnectionStatus: 'connection_status', 
    notificationStatus: 'notification_status', 
    subscriptionStatus: 'subscription_status', 
    title: 'title_field', 
    pushType: 'tile', 
    tileTemplate: 'tile_template' 
}

Cet objet contient également les champs de toutes les options de notification Push fournies à MPNS.

Non défini.

Envoie une notification toast à un canal.

sendToast(channel, payload, options)

 

Parameter Description

channel

Valeur d'URI de canal requise ou tableau de valeurs d'URI qui indique les canaux pour recevoir la notification.

payload

Objet requis qui contient les informations de notification, qui doit être semblable au suivant :

{
    text1: 'Bold text:',
    text2: 'normal text',
    param: 'NewPage.xaml?item=5'
}

text1 et text2 sont les chaînes de texte de toast et param est un paramètre d'URI facultatif qui spécifie une page XAML à ouvrir dans votre application, ainsi que tous les paramètres de chaîne de requête.

Le champ param est uniquement pris en charge pour envoyer des notifications à Windows Phone 7.5 et versions ultérieures.

Pour plus d'informations sur l'envoi de notification toast, consultez Toasts for Windows Phone62d355e3-2cb6-4b16-97b9-76dec5e8b797.

options

Objet facultatif utilisé pour capturer les résultats de la notification :

{
    success: success,
    error: error
}

success est la fonction qui est appelée après l'envoi de la notification et error est la fonction qui est appelée lorsqu'une erreur se produit.

Lorsque l'opération d'envoi de données réussit, un objet JSON est passé à la fonction success, rempli avec les informations suivantes :

{ 
    statusCode: http_status_code, 
    deviceConnectionStatus: 'connection_status', 
    notificationStatus: 'notification_status', 
    subscriptionStatus: 'subscription_status', 
    text1: 'toast_text1', 
    text2: 'toast_text1', 
    pushType: 'toast' 
}

Non défini.

Envoie une chaîne de notification d'envoi de données brute à un canal.

sendRaw(channel, payload, options)

 

Parameter Description

channel

Valeur d'URI de canal requise ou tableau de valeurs d'URI qui indique les canaux pour recevoir la notification.

payload

Chaîne spécifique à l'application qui est fournie au client sans modification.

{
    payload: 'raw notification string'
}

payload est la chaîne de notification.

noteRemarque
Au lieu de fournir un objet au paramètre payload, spécifiez la chaîne de notification brute à la place de payload.

options

Objet facultatif utilisé pour capturer les résultats de la notification :

{
    success: success,
    error: error
}

success est la fonction qui est appelée après l'envoi de la notification et error est la fonction qui est appelée lorsqu'une erreur se produit.

Lorsque l'opération d'envoi de données réussit, un objet JSON est passé à la fonction success, rempli avec les informations suivantes :

{ 
    statusCode: http_status_code, 
    deviceConnectionStatus: 'connection_status', 
    notificationStatus: 'notification_status', 
    subscriptionStatus: 'subscription_status', 
    payload: 'payload_string', 
    pushType: 'raw' 
}

Non défini.

Mobile Services n'exige pas que vous inscriviez votre application auprès de MPNS pour activer l'utilisation authentifiée. Par conséquent, vous ne pouvez pas envoyer plus de 500 messages par utilisateur chaque jour à l'aide de MPNS.

Le script suivant utilise l'objet mpns pour envoyer des notifications de vignette à une application Windows Phone 8.

function insert(item, user, request) {
    request.execute({
        success: function() {
            request.respond();
            sendNotifications();
        }
    });


function sendNotifications() {
    var channelTable = tables.getTable('Channel');
    channelTable.read({
        success: function(channels) {
            channels.forEach(function(channel) {
                push.mpns.sendFlipTile(channel.uri, {
                    title: item.text
                }, {
                    success: function(pushResponse) {
                        console.log("Sent push:", pushResponse);
                    }
                });
            });
        }
    });
}


}

Afficher:
© 2014 Microsoft