Esporta (0) Stampa
Espandi tutto

oggetto mpns

Aggiornamento: giugno 2013

Espone la funzionalità Microsoft Push Notification Service (MPNS) negli script server dei Servizi mobili di Windows Azure.

L'oggetto contiene i membri seguenti:

sendFlipTile

Invia una notifica di tipo riquadro capovolto a un canale.

noteNota
Il metodo sendFlipTile è supportato solo per inviare notifiche a Windows Phone 7.8 e versioni successive.

Sintassi

sendFlipTile(channel, payload, options)

Parametri

 

Parameter Descrizione

channel

Valore URI di canale o matrice di valori URI obbligatoria che indica i canali in cui ricevere la notifica.

payload

Oggetto JSON richiesto che contiene le informazioni di notifica, inclusi i campi seguenti:

  • backgroundImage: URI dell'immagine di sfondo per il riquadro.

  • count: numero che viene visualizzato sul riquadro.

  • title - testo del titolo del riquadro.

  • backBackgroundImage: URI dell'immagine che viene visualizzata nella parte posteriore del riquadro.

  • backTitle: titolo per il lato posteriore del riquadro.

  • backContent: testo per il lato posteriore del riquadro.

  • id: ID di un riquadro secondario correlato.

  • smallBackgroundImage: URI dell'immagine di sfondo per il riquadro quando viene ridotto alle dimensioni minime.

  • wideBackgroundImage: URI dell'immagine di sfondo per il riquadro quando viene espanso alle dimensioni massime.

  • wideBackContent: contenuto per il riquadro posteriore quando viene espanso alle dimensioni massime.

  • wideBackBackgroundImage: URI per l'immagine da posizionare sul lato posteriore del riquadro quando viene espanso alle dimensioni massime.

Per ulteriori informazioni sul modello di riquadro capovolto, vedere Flip Tile template for Windows Phone 8.

options

Callback utilizzato per acquisire i risultati della notifica:

{
    success: success,
    error: error
}

dove success è la funzione chiamata dopo l'invio della notifica e error è la funzione chiamata quando si verifica un errore.

Quando l'operazione push ha esito positivo, la funzione success viene passata a un oggetto JSON popolato con le informazioni seguenti:

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

Questo oggetto contiene inoltre i campi per tutte le opzioni di notifica push fornite a MPNS.

Restituisce

Non definito.

sendTile

Invia una notifica di tipo riquadro a un canale.

Sintassi

sendTile(channel, payload, options)

Parametri

 

Parameter Descrizione

channel

Valore URI di canale o matrice di valori URI obbligatoria che indica i canali in cui ricevere la notifica.

payload

Oggetto JSON richiesto che contiene le informazioni di notifica, inclusi i campi seguenti:

  • backgroundImage: URI dell'immagine di sfondo per il riquadro.

  • count: numero che viene visualizzato sul riquadro.

  • title - testo del titolo del riquadro.

  • backBackgroundImage: URI dell'immagine che viene visualizzata nella parte posteriore del riquadro.

  • backTitle: titolo per il lato posteriore del riquadro.

  • backContent: testo per il lato posteriore del riquadro.

  • id: ID di un riquadro secondario correlato.

    Supportato solo per inviare notifiche a Windows Phone 7.5 e versioni successive.

Per ulteriori informazioni su questo modello di riquadro, vedere Windows Phone OS 7.1 Tile template.

options

Callback utilizzato per acquisire i risultati della notifica:

{
    success: success,
    error: error
}

dove success è la funzione chiamata dopo l'invio della notifica e error è la funzione chiamata quando si verifica un errore.

Quando l'operazione push ha esito positivo, la funzione success viene passata a un oggetto JSON popolato con le informazioni seguenti:

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

Questo oggetto contiene inoltre i campi per tutte le opzioni di notifica push fornite a MPNS.

Restituisce

Non definito.

sendToast

Invia una notifica di avviso di tipo popup a un canale.

Sintassi

sendToast(channel, payload, options)

Parametri

 

Parameter Descrizione

channel

Valore URI di canale o matrice di valori URI obbligatoria che indica i canali in cui ricevere la notifica.

payload

Oggetto obbligatorio che contiene le informazioni di notifica, simili alle seguenti:

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

Dove text1 e text2 sono stringhe di testo dell'avviso di tipo popup e param è un parametro URI facoltativo che specifica l'apertura di una pagina XAML nell'app, insieme a eventuali parametri di stringa di query.

Il campo param è supportato solo per inviare notifiche a Windows Phone 7.5 e versioni successive.

Per ulteriori informazioni sull'invio di una notifica di avviso di tipo popup, vedere Toasts for Windows Phone62d355e3-2cb6-4b16-97b9-76dec5e8b797.

options

Oggetto facoltativo utilizzato per acquisire i risultati della notifica:

{
    success: success,
    error: error
}

dove success è la funzione chiamata dopo l'invio della notifica e error è la funzione chiamata quando si verifica un errore.

Quando l'operazione push ha esito positivo, la funzione success viene passata a un oggetto JSON popolato con le informazioni seguenti:

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

Restituisce

Non definito.

sendRaw

Invia una stringa di notifica push non elaborata a un canale.

Sintassi

sendRaw(channel, payload, options)

Parametri

 

Parameter Descrizione

channel

Valore URI di canale o matrice di valori URI obbligatoria che indica i canali in cui ricevere la notifica.

payload

Stringa specifica dell'applicazione che viene recapitata al client senza modifiche.

{
    payload: 'raw notification string'
}

Dove payload è la stringa di notifica.

noteNota
Anziché specificare un oggetto nel parametro payload, è possibile specificare solo la stringa di notifica non elaborata invece di payload.

options

Oggetto facoltativo utilizzato per acquisire i risultati della notifica:

{
    success: success,
    error: error
}

dove success è la funzione chiamata dopo l'invio della notifica e error è la funzione chiamata quando si verifica un errore.

Quando l'operazione push ha esito positivo, la funzione success viene passata a un oggetto JSON popolato con le informazioni seguenti:

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

Restituisce

Non definito.

I Servizi per dispositivi mobili non richiedono la registrazione dell'app con MPNS per consentire l'utilizzo autenticato. Per questo motivo, non è possibile inviare oltre 500 messaggi per utente ogni giorno tramite MPNS.

Tramite lo script seguente viene utilizzato l'oggetto mpns per inviare notifiche di tipo riquadro capovolto a un'app 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);
                    }
                });
            });
        }
    });
}


}

Mostra:
© 2014 Microsoft