Exportar (0) Imprimir
Expandir Tudo

objeto mpns

Atualizado: fevereiro de 2015

Expõe a funcionalidade da Notificação por Push da Microsoft (MPNS) em scripts do servidor do Serviços Móveis do Microsoft Azure.

Esse objeto contém os seguintes membros:

Envia uma notificação de bloco invertido para um canal.

noteObservação
O método sendFlipTile tem suporte apenas para enviar notificações para o Windows Phone 7.8 e versões posteriores.

sendFlipTile(channel, payload, options)

 

Parâmetro Descrição

channel

Valor URI de canal obrigatório ou matriz de valores URI que indicam os canais para receberem a notificação.

payload

O objeto JSON necessário que contém as informações de notificação, que inclui os seguintes campos:

  • backgroundImage - o URI da imagem do plano de fundo para o bloco.

  • count - o número que aparece no bloco.

  • title - o texto do título do bloco.

  • backBackgroundImage – o URI da imagem que é mostrada no lado de trás do bloco.

  • backTitle – título para o lado de trás do bloco.

  • backContent – texto para o lado de trás do bloco.

  • id – ID de um bloco relacionado secundário.

  • smallBackgroundImage – o URI para a imagem de plano de fundo do bloco quando é reduzido ao seu tamanho pequeno.

  • wideBackgroundImage – o URI para a imagem de plano de fundo do bloco quando é expandido para seu tamanho maior.

  • wideBackContent - conteúdo do bloco de trás quando o bloco é expandido para seu tamanho maior.

  • wideBackBackgroundImage – o URI para que a imagem esteja no lado de trás do bloco quando ele é expandido para seu tamanho maior.

Para obter mais informações sobre o modelo de bloco invertido, consulte Flip Tile template for Windows Phone 8.

options

O retorno de chamada que é usado para capturar os resultados da notificação:

{
    success: success,
    error: error
}

Onde success é a função que é chamada depois que a notificação é enviada e error é a função que é chamada quando ocorre um erro.

Quando a operação de envio por push tiver êxito, a função success será passada para um objeto JSON que é preenchido com as seguintes informações:

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

Esse objeto também contém campos para todas as opções de notificação por push fornecidas para MPNS.

Indefinido.

Envia uma notificação de bloco para um canal.

sendTile(channel, payload, options)

 

Parâmetro Descrição

channel

Valor URI de canal obrigatório ou matriz de valores URI que indicam os canais para receberem a notificação.

payload

O objeto JSON necessário que contém as informações de notificação, que inclui os seguintes campos:

  • backgroundImage - o URI da imagem do plano de fundo para o bloco.

  • count - o número que aparece no bloco.

  • title - o texto do título do bloco.

  • backBackgroundImage – o URI da imagem que é mostrada no lado de trás do bloco.

  • backTitle – título para o lado de trás do bloco.

  • backContent – texto para o lado de trás do bloco.

  • id – ID de um bloco relacionado secundário.

    Tem suporte apenas para enviar notificações para o Windows Phone 7.5 e versões posteriores.

Para obter mais informações sobre esse modelo de bloco, consulte Windows Phone OS 7.1 Tile template.

options

O retorno de chamada que é usado para capturar os resultados da notificação:

{
    success: success,
    error: error
}

Onde success é a função que é chamada depois que a notificação é enviada e error é a função que é chamada quando ocorre um erro.

Quando a operação de envio por push tiver êxito, a função success será passada para um objeto JSON que é preenchido com as seguintes informações:

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

Esse objeto também contém campos para todas as opções de notificação por push fornecidas para MPNS.

Indefinido.

Envia uma notificação de sistema para um canal.

sendToast(channel, payload, options)

 

Parâmetro Descrição

channel

Valor URI de canal obrigatório ou matriz de valores URI que indicam os canais para receberem a notificação.

payload

O objeto necessário que contém as informações de notificação, que parecerá o seguinte:

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

Onde text1 e text2 são cadeias de caracteres de texto de notificação e param é um parâmetro de URI opcional que especifica uma página XAML para abrir em seu aplicativo, junto com alguns parâmetros de cadeia de caracteres da consulta.

O campo param tem suporte apenas para enviar notificações para o Windows Phone 7.5 e versões posteriores.

Para obter mais informações sobre como enviar uma notificação do sistema, consulte Toasts for Windows Phone62d355e3-2cb6-4b16-97b9-76dec5e8b797.

options

O objeto opcional que é usado para capturar os resultados da notificação:

{
    success: success,
    error: error
}

Onde success é a função que é chamada depois que a notificação é enviada e error é a função que é chamada quando ocorre um erro.

Quando a operação de envio por push tiver êxito, a função success será passada para um objeto JSON que é preenchido com as seguintes informações:

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

Indefinido.

Envia uma cadeia de caracteres de notificação por push bruta para um canal.

sendRaw(channel, payload, options)

 

Parâmetro Descrição

channel

Valor URI de canal obrigatório ou matriz de valores URI que indicam os canais para receberem a notificação.

payload

Uma cadeia de caracteres específica do aplicativo que é entregue ao cliente sem modificação.

{
    payload: 'raw notification string'
}

Onde payload é a cadeia de caracteres de notificação.

noteObservação
Em vez de fornecer um objeto para o parâmetro payload, você pode apenas fornecer a cadeia de caracteres de notificação bruta em vez de payload.

options

O objeto opcional que é usado para capturar os resultados da notificação:

{
    success: success,
    error: error
}

Onde success é a função que é chamada depois que a notificação é enviada e error é a função que é chamada quando ocorre um erro.

Quando a operação de envio por push tiver êxito, a função success será passada para um objeto JSON que é preenchido com as seguintes informações:

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

Indefinido.

O Serviços Móveis não exige que você registre seu aplicativo com MPNS para habilitar o uso autenticado. Por isso, você não pode enviar mais de 500 mensagens por usuário por dia usando MPNS.

O script a seguir usa o objeto de mpns para enviar notificações de bloco invertido para um aplicativo do 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);
                    }
                });
            });
        }
    });
}


}

Mostrar:
© 2015 Microsoft