Exportar (0) Imprimir
Expandir todo

mpns (objeto)

Actualizado: junio de 2013

Expone la funcionalidad del Servicio de notificaciones de inserción de Microsoft (MPNS) en scripts de servidor de Servicios móviles de Windows Azure.

Este objeto contiene los miembros siguientes:

sendFlipTile

Envía una notificación de voltear mosaico a un canal determinado.

noteNota
El método sendFlipTile solo se admite para enviar notificaciones a Windows Phone 7.8 y versiones posteriores.

Sintaxis

sendFlipTile(channel, payload, options)

Parámetros

 

Parámetro Descripción

channel

Valor de URI de canal o matriz de valores de URI necesarios que indican los canales que van a recibir la notificación.

payload

Objeto JSON necesario que contiene la información de notificación, que incluye los campos siguientes:

  • backgroundImage: URI de la imagen de fondo del mosaico.

  • count: número que aparece en el mosaico.

  • title: texto del título del mosaico.

  • backBackgroundImage: URI de la imagen que se muestra en la parte posterior del mosaico.

  • backTitle: título del lado posterior del mosaico.

  • backContent: texto del lado posterior del mosaico.

  • id: identificador de un mosaico secundario relacionado.

  • smallBackgroundImage: URI de la imagen de fondo del mosaico cuando se reduce a su tamaño pequeño.

  • wideBackgroundImage: URI de la imagen de fondo del mosaico cuando se expande a su tamaño ancho.

  • wideBackContent: contenido del mosaico de atrás cuando el mosaico se expande a su tamaño ancho.

  • wideBackBackgroundImage: URI de la imagen que va a estar en la parte posterior del mosaico cuando el mosaico se expande a su tamaño ancho.

Para obtener más información sobre la plantilla de voltear mosaico, vea Flip Tile template for Windows Phone 8.

options

Devolución de llamada que se emplea para capturar los resultados de la notificación:

{
    success: success,
    error: error
}

Donde success es la función a la que se llama cuando se envía la notificación y error es la función a la que se llama cuando se produce un error.

Cuando la operación de inserción se realiza correctamente, se pasa a la función success un objeto JSON que se rellena con la información siguiente:

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

Este objeto también contiene campos para todas las opciones de notificación de inserción proporcionadas a MPNS.

Devuelve

Sin definir.

sendTile

Envía una notificación de mosaico a un canal.

Sintaxis

sendTile(channel, payload, options)

Parámetros

 

Parámetro Descripción

channel

Valor de URI de canal o matriz de valores de URI necesarios que indican los canales que van a recibir la notificación.

payload

Objeto JSON necesario que contiene la información de notificación, que incluye los campos siguientes:

  • backgroundImage: URI de la imagen de fondo del mosaico.

  • count: número que aparece en el mosaico.

  • title: texto del título del mosaico.

  • backBackgroundImage: URI de la imagen que se muestra en la parte posterior del mosaico.

  • backTitle: título del lado posterior del mosaico.

  • backContent: texto del lado posterior del mosaico.

  • id: identificador de un mosaico secundario relacionado.

    Solo se admite para enviar notificaciones a Windows Phone 7.5 y versiones posteriores.

Para obtener más información sobre esta plantilla de mosaico, vea Windows Phone OS 7.1 Tile template.

options

Devolución de llamada que se emplea para capturar los resultados de la notificación:

{
    success: success,
    error: error
}

Donde success es la función a la que se llama cuando se envía la notificación y error es la función a la que se llama cuando se produce un error.

Cuando la operación de inserción se realiza correctamente, se pasa a la función success un objeto JSON que se rellena con la información siguiente:

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

Este objeto también contiene campos para todas las opciones de notificación de inserción proporcionadas a MPNS.

Devuelve

Sin definir.

sendToast

Envía una notificación del sistema a un canal.

Sintaxis

sendToast(channel, payload, options)

Parámetros

 

Parámetro Descripción

channel

Valor de URI de canal o matriz de valores de URI necesarios que indican los canales que van a recibir la notificación.

payload

Objeto necesario que contiene la información de notificación, que es similar a lo siguiente:

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

Donde text1 y text2 son las cadenas de texto y param es un parámetro de URI opcional que especifica una página XAML que se abrirá en su aplicación, junto con los parámetros de cadena de consulta.

El campo param solo se admite para enviar notificaciones a Windows Phone 7.5 y versiones posteriores.

Para obtener más información acerca de cómo enviar una notificación del sistema, vea Toasts for Windows Phone62d355e3-2cb6-4b16-97b9-76dec5e8b797.

options

Objeto opcional que se emplea para capturar los resultados de la notificación:

{
    success: success,
    error: error
}

Donde success es la función a la que se llama cuando se envía la notificación y error es la función a la que se llama cuando se produce un error.

Cuando la operación de inserción se realiza correctamente, se pasa a la función success un objeto JSON que se rellena con la información siguiente:

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

Devuelve

Sin definir.

sendRaw

Envía una cadena de notificación sin procesar a un canal.

Sintaxis

sendRaw(channel, payload, options)

Parámetros

 

Parámetro Descripción

channel

Valor de URI de canal o matriz de valores de URI necesarios que indican los canales que van a recibir la notificación.

payload

Cadena específica de la aplicación que se entrega al cliente sin modificación alguna.

{
    payload: 'raw notification string'
}

Donde payload es la cadena de notificación.

noteNota
En lugar de proporcionar un objeto al parámetro payload, puede proporcionar únicamente la cadena de notificación sin formato en lugar de payload.

options

Objeto opcional que se emplea para capturar los resultados de la notificación:

{
    success: success,
    error: error
}

Donde success es la función a la que se llama cuando se envía la notificación y error es la función a la que se llama cuando se produce un error.

Cuando la operación de inserción se realiza correctamente, se pasa a la función success un objeto JSON que se rellena con la información siguiente:

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

Devuelve

Sin definir.

Servicios para móviles no requiere que registre la aplicación con MPNS para habilitar el uso autenticado. Por ello, no puede enviar más de 500 mensajes por usuario cada día con MPNS.

En el script siguiente se usa el objeto mpns para enviar notificaciones de voltear mosaico a una aplicación de 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:
© 2014 Microsoft