Была ли эта страница полезной?
Ваш отзыв об этом контенте важен для нас. Расскажите нам о том, что вы думаете.
Дополнительный отзыв?
1500 символов осталось
Экспорт (0) Печать
Развернуть все

объект mpns

Обновлено: Июнь 2015 г.

Позволяет отправлять push-уведомления в приложение Windows Phone 8.0 или Windows Phone 8.1 Silverlight из скриптов сервера Мобильные службы Microsoft Azure с использованием концентраторов уведомлений Azure.

createFlipTileRegistration(канал, теги, шаблон, параметры, обратный вызов)
Создает регистрацию с шаблоном переворачивающейся плитки. (Только версия Windows Phone 7.8 или выше.) Дополнительную информацию см. в разделе Шаблон переворачивающейся плитки для Windows Phone 8.

Параметры

Название Type Аргумент Описание

channel

строка

URI канала устройства.

tags

строка | массив

Один тег или массив тегов (список с разделителями-запятыми, без пробелов).

template

объект

Шаблон регистрации.

Свойства

Название Type Описание

backgroundImage

строка

URI фонового изображения для плитки.

count

строка

Число, которое отображается на плитке.

заголовок

строка

Текст заголовка плитки.

backBackgroundImage

строка

URI изображения на обратной стороне плитки.

backTitle

строка

Текст заголовка для обратной стороны плитки.

backContent

строка

Текст для обратной стороны плитки.

id

строка

Идентификатор родственной вторичной плитки.

smallBackgroundImage

строка

URI для фонового изображения плитки при ее уменьшении до малого размера.

wideBackgroundImage

строка

URI для фонового изображения плитки при ее развертывании до широкого размера.

wideBackContent

строка

Содержимое обратной стороны плитки при ее развертывании до широкого размера.

wideBackBackgroundImage

строка

URI для изображения на обратной стороне плитки при ее развертывании до широкого размера.

options

объект

<необязательный>

Параметры запроса или обратный вызов.

Свойства

Название Type Аргумент Описание

заголовки

объект

<необязательный>

Включить заголовки mpns.

callback

объект

<необязательный>

JSON-объект, который задает функции обратного вызова success и error.

createNativeRegistration(канал, теги, optionsOrCallback, обратный вызов)
Создает собственную регистрацию MPNS.

Параметры

Название Type Аргумент Описание

channel

строка

URI канала устройства.

tags

строка | массив

Один тег или массив тегов (список с разделителями-запятыми, без пробелов).

optionsOrCallback

объект

<необязательный>

Параметры запроса или обратный вызов.

callback

объект

<необязательный>

JSON-объект, который задает функции обратного вызова success и error.

createOrUpdateNativeRegistration(registrationId, канал, теги, optionsOrCallback, обратный вызов)
Создает или обновляет собственную регистрацию MPNS.

Параметры

Название Type Аргумент Описание

registrationId

строка

Идентификатор регистрации.

channel

строка

URI канала устройства.

tags

строка | массив

Один тег или массив тегов (список с разделителями-запятыми, без пробелов).

optionsOrCallback

объект

<необязательный>

Параметры запроса или обратный вызов.

callback

объект

<необязательный>

JSON-объект, который задает функции обратного вызова success и error.

createOrUpdateRawTemplateRegistration(registrationId, канал, теги, шаблон, optionsOrCallback, обратный вызов)
Создает или обновляет настраиваемую регистрацию шаблона.

Параметры

Название Type Аргумент Описание

registrationId

строка

Идентификатор регистрации.

channel

строка

URI канала устройства.

tags

строка | массив

Один тег или массив тегов (список с разделителями-запятыми, без пробелов).

template

json

Шаблон JSON для регистрации.

optionsOrCallback

объект

<необязательный>

Параметры запроса или обратный вызов.

Свойства

Название Type Аргумент Описание

заголовки

объект

<необязательный>

Включить заголовки mpns.

callback

объект

<необязательный>

JSON-объект, который задает функции обратного вызова success и error.

createRawTemplateRegistration(канал, теги, шаблон, optionsOrCallback, обратный вызов)
Создает настраиваемую регистрацию шаблона. Используйте этот метод для полного управления форматом шаблона.

Параметры

Название Type Аргумент Описание

channel

строка

URI канала устройства.

tags

строка | массив

Один тег или массив тегов (список с разделителями-запятыми, без пробелов).

template

json

Шаблон JSON для регистрации.

optionsOrCallback

объект

<необязательный>

Параметры запроса или обратный вызов.

Свойства

Название Type Аргумент Описание

pnsCredentialName

объект

<необязательный>

Учетные данные PNS для использования.

заголовки

объект

<необязательный>

Включить заголовки mpns.

callback

объект

<необязательный>

JSON-объект, который задает функции обратного вызова success и error.

createTileRegistration(канал, теги, шаблон, параметры, обратный вызов)
Создает регистрацию с шаблоном плитки. Дополнительные сведения см. в разделе Шаблон плитки Windows Phone.

Параметры

Название Type Аргумент Описание

channel

строка

URI канала устройства.

tags

строка | массив

Один тег или массив тегов (список с разделителями-запятыми, без пробелов).

template

объект

Шаблон регистрации.

Свойства

Название Type Описание

backgroundImage

строка

URI фонового изображения для плитки.

count

строка

Число, которое отображается на плитке.

заголовок

строка

Текст заголовка плитки.

backBackgroundImage

строка

URI изображения на обратной стороне плитки.

backTitle

строка

Текст заголовка для обратной стороны плитки.

backContent

строка

Текст для обратной стороны плитки.

id

строка

Идентификатор родственной вторичной плитки.

options

объект

<необязательный>

Параметры запроса или обратный вызов.

Свойства

Название Type Аргумент Описание

заголовки

объект

<необязательный>

Включить заголовки mpns.

callback

объект

<необязательный>

JSON-объект, который задает функции обратного вызова success и error.

createToastRegistration(канал, теги, шаблон, параметры, обратный вызов)
Создает новую регистрацию с шаблоном всплывающего уведомления. Дополнительные сведения см. в разделе Всплывающие уведомления для Windows Phone 8.

Параметры

Название Type Аргумент Описание

channel

строка

URI канала устройства.

tags

строка | массив

Один тег или массив тегов (список с разделителями-запятыми, без пробелов).

template

объект

Шаблон текста регистрации.

Свойства

Название Type Описание

text1}

строка

Значение элемента Text1.

text2

строка

Значение элемента Text2.

параметр

строка

Необязательные параметры для всплывающего уведомления. (Только версия Windows Phone 7.5 или выше.)

lang

строка

Значение языка элемента привязки.

options

объект

<необязательный>

Параметры запроса или обратный вызов.

Свойства

Название Type Аргумент Описание

заголовки

объект

<необязательный>

Включить заголовки mpns.

callback

объект

<необязательный>

JSON-объект, который задает функции обратного вызова success и error.

listRegistrationsByChannel(канал, optionsOrCallback, обратный вызов)
Извлекает регистрации по URI канала.

Параметры

Название Type Аргумент Описание

channel

строка

URI канала устройства.

optionsOrCallback

объект

<необязательный>

Параметры запроса или функция обратного вызова. Дополнительные свойства передаются как заголовки.

Свойства

Название Type Аргумент Описание

наибольшее

объект

<необязательный>

Определяет максимальное количество регистраций для получения из вызова.

skip

объект

<необязательный>

Определяет количество регистраций для пропуска в вызове.

callback

объект

<необязательный>

JSON-объект, который задает функции обратного вызова success и error.

send(теги, полезные данные, targetName, notificationClass, optionsOrCallback, обратный вызов)
Отправляет настраиваемое уведомление MPNS. Используйте этот метод для полного управления полезными данными.

Параметры

Название Type Аргумент Описание

tags

массив | строка

Один тег, выражение тегов или массив тегов.

payload

строка

Полезные данные XML для сообщения.

targetName

строка

Имя цели.

notificationClass

строка

Класс уведомления.

optionsOrCallback

объект

<необязательный>

Параметры запроса или обратный вызов.

Свойства

Название Type Аргумент Описание

заголовки

объект

<необязательный>

Включить заголовки mpns.

callback

объект

JSON-объект, который задает функции обратного вызова success и error.

sendFlipTile(теги, полезные данные, параметры, обратный вызов)
Отправляет уведомление с переворачивающейся плиткой. (Только версия Windows Phone 7.8 или выше.) Дополнительную информацию см. в разделе Шаблон переворачивающейся плитки для Windows Phone 8.

Параметры

Название Type Аргумент Описание

tags

массив | строка

Список с разделителями-запятыми или массив идентификаторов тегов.

payload

объект

Полезные данные сообщения.

Свойства

Название Type Описание

backgroundImage

строка

URI фонового изображения для плитки.

count

строка

Число, которое отображается на плитке.

заголовок

строка

Текст заголовка плитки.

backBackgroundImage

строка

URI изображения на обратной стороне плитки.

backTitle

строка

Текст заголовка для обратной стороны плитки.

backContent

строка

Текст для обратной стороны плитки.

id

строка

Идентификатор родственной вторичной плитки.

smallBackgroundImage

строка

URI для фонового изображения плитки при ее уменьшении до малого размера.

wideBackgroundImage

строка

URI для фонового изображения плитки при ее развертывании до широкого размера.

wideBackContent

строка

Содержимое обратной стороны плитки при ее развертывании до широкого размера.

wideBackBackgroundImage

строка

URI для изображения на обратной стороне плитки при ее развертывании до широкого размера.

optionsOrCallback

объект

<необязательный>

Параметры запроса или обратный вызов.

Свойства

Название Type Аргумент Описание

заголовки

объект

<необязательный>

Включить заголовки mpns.

callback

объект

JSON-объект, который задает функции обратного вызова success и error.

sendTile(теги, полезный данные, optionsOrCallback, обратный вызов)
Отправляет уведомление с плиткой. Дополнительные сведения см. в разделе Шаблон плитки Windows Phone.

Параметры

Название Type Аргумент Описание

tags

массив | строка

Список с разделителями-запятыми или массив идентификаторов тегов.

payload

объект

Полезные данные сообщения.

Свойства

Название Type Описание

backgroundImage

строка

URI фонового изображения для плитки.

count

строка

Число, которое отображается на плитке.

заголовок

строка

Текст заголовка плитки.

backBackgroundImage

строка

URI изображения на обратной стороне плитки.

backTitle

строка

Текст заголовка для обратной стороны плитки.

backContent

строка

Текст для обратной стороны плитки.

id

строка

Идентификатор родственной вторичной плитки.

optionsOrCallback

объект

<необязательный>

Параметры запроса или обратный вызов.

Свойства

Название Type Аргумент Описание

заголовки

объект

<необязательный>

Включить заголовки mpns.

callback

объект

JSON-объект, который задает функции обратного вызова success и error.

sendToast(теги, полезные данные, параметры, обратный вызов)
Отправляет всплывающее уведомление. Дополнительные сведения см. в разделе Всплывающие уведомления для Windows Phone 8.

Параметры

Название Type Аргумент Описание

tags

массив | строка

Список с разделителями-запятыми или массив идентификаторов тегов.

payload

объект

Полезные данные сообщения.

Свойства

Название Type Описание

text1}

строка

Значение элемента Text1.

text2

строка

Значение элемента Text2.

параметр

строка

Необязательные параметры для всплывающего уведомления. (Только версия Windows Phone 7.5 или выше.)

lang

строка

Значение языка элемента привязки.

optionsOrCallback

объект

<необязательный>

Параметры запроса или обратный вызов.

Свойства

Название Type Аргумент Описание

заголовки

объект

<необязательный>

Включить заголовки mpns.

callback

объект

JSON-объект, который задает функции обратного вызова success и error.

updateFlipTileRegistration(registrationId, канал, теги, шаблон, optionsOrCallback, обратный вызов)
Обновляет существующую регистрацию с шаблоном переворачивающейся плитки. (Только версия Windows Phone 7.8 или выше.) Дополнительную информацию см. в разделе Шаблон переворачивающейся плитки для Windows Phone 8.

Параметры

Название Type Аргумент Описание

registrationId

строка

Идентификатор регистрации.

channel

строка

URI канала устройства.

tags

строка | массив

Один тег или массив тегов (список с разделителями-запятыми, без пробелов).

template

объект

Шаблон регистрации.

Свойства

Название Type Описание

backgroundImage

строка

URI фонового изображения для плитки.

count

строка

Число, которое отображается на плитке.

заголовок

строка

Текст заголовка плитки.

backBackgroundImage

строка

URI изображения на обратной стороне плитки.

backTitle

строка

Текст заголовка для обратной стороны плитки.

backContent

строка

Текст для обратной стороны плитки.

id

строка

Идентификатор родственной вторичной плитки.

smallBackgroundImage

строка

URI для фонового изображения плитки при ее уменьшении до малого размера.

wideBackgroundImage

строка

URI для фонового изображения плитки при ее развертывании до широкого размера.

wideBackContent

строка

Содержимое обратной стороны плитки при ее развертывании до широкого размера.

wideBackBackgroundImage

строка

URI для изображения на обратной стороне плитки при ее развертывании до широкого размера.

optionsOrCallback

объект

<необязательный>

Параметры запроса или обратный вызов.

Свойства

Название Type Аргумент Описание

заголовки

объект

<необязательный>

Включить заголовки mpns.

callback

объект

<необязательный>

JSON-объект, который задает функции обратного вызова success и error.

updatesRawTemplateRegistration(registrationId, channel, tags, template, optionsOrCallback, callback)
Обновляет регистрацию необработанного шаблона.

Параметры

Название Type Аргумент Описание

registrationId

строка

Идентификатор регистрации.

channel

строка

URI канала устройства.

tags

строка | массив

Теги для регистрации.

template

json

Шаблон для регистрации.

optionsOrCallback

объект

<необязательный>

Параметры запроса или обратный вызов.

Свойства

Название Type Аргумент Описание

заголовки

объект

<необязательный>

Включить заголовки mpns.

etag

объект

<необязательный>

Еtag для включения.

callback

объект

JSON-объект, который задает функции обратного вызова success и error.

updatesToastRegistration(registrationId, канал, теги, шаблон, параметры, обратный вызов)
Обновляет существующую регистрацию шаблона новым шаблоном всплывающего сообщения. Дополнительные сведения см. в разделе Всплывающие уведомления для Windows Phone 8.

Параметры

Название Type Аргумент Описание

registrationId

строка

Идентификатор регистрации.

channel

строка

URI канала устройства.

tags

строка | массив

Теги для регистрации.

template

объект

Шаблон текста регистрации.

Свойства

Название Type Описание

text1}

строка

Значение элемента Text1.

text2

строка

Значение элемента Text2.

параметр

строка

Необязательные параметры для всплывающего уведомления. (Только версия Windows Phone 7.5 или выше.)

lang

строка

Значение языка элемента привязки.

optionsOrCallback

объект

<необязательный>

Параметры запроса или обратный вызов.

Свойства

Название Type Аргумент Описание

заголовки

объект

<необязательный>

Включить заголовки mpns.

callback

объект

JSON-объект, который задает функции обратного вызова success и error.

updateTileRegistration(registrationId, канал, теги, шаблон, optionsOrCallback, обратный вызов)
Обновляет существующую регистрацию с шаблоном плитки. Дополнительные сведения см. в разделе Шаблон плитки Windows Phone.

Параметры

Название Type Аргумент Описание

registrationId

строка

Идентификатор регистрации.

channel

строка

URI канала устройства.

tags

строка | массив

Один тег или массив тегов (список с разделителями-запятыми, без пробелов).

template

объект

Шаблон регистрации.

Свойства

Название Type Описание

backgroundImage

строка

URI фонового изображения для плитки.

count

строка

Число, которое отображается на плитке.

заголовок

строка

Текст заголовка плитки.

backBackgroundImage

строка

URI изображения на обратной стороне плитки.

backTitle

строка

Текст заголовка для обратной стороны плитки.

backContent

строка

Текст для обратной стороны плитки.

id

строка

Идентификатор родственной вторичной плитки.

optionsOrCallback

объект

<необязательный>

Параметры запроса или обратный вызов.

Свойства

Название Type Аргумент Описание

заголовки

объект

<необязательный>

Включить заголовки mpns.

callback

объект

<необязательный>

JSON-объект, который задает функции обратного вызова success и error.

Объект mpns используется для отправки push-уведомлений в приложения Windows Phone 8 и Windows Phone 8.1 Silverlight. Чтобы отправить push-уведомления в приложение Windows Phone Store 8.1, необходимо использовать объект wns. MPNS не поддерживается концентраторами уведомлений для приложений Windows Phone Store 8.1.

Пример отправки push-уведомления из мобильной службы в приложение Windows Phone 8 см. в разделе Добавление push-уведомлений в приложение мобильных служб.

Мобильные услуги не требует регистрации приложения в MPNS для включения проверки подлинности. Поэтому нельзя отправить более 500 сообщений в день с помощью MPNS.

Следующий скрипт использует объект mpns для отправки уведомлений с переворачивающейся плиткой приложениям Windows Phone 8.

function insert(item, user, request) {
// Define a payload for the Windows Phone toast notification.
var payload = '<?xml version="1.0" encoding="utf-8"?>' +
    '<wp:Notification xmlns:wp="WPNotification"><wp:Toast>' +
    '<wp:Text1>New Item</wp:Text1><wp:Text2>' + item.text + 
    '</wp:Text2></wp:Toast></wp:Notification>';

request.execute({
    success: function() {
        // If the insert succeeds, send a notification.
        push.mpns.send(null, payload, 'toast', 22, {
            success: function(pushResponse) {
                console.log("Sent push:", pushResponse);
                request.respond();
                },              
                error: function (pushResponse) {
                    console.log("Error Sending push:", pushResponse);
                    request.respond(500, { error: pushResponse });
                    }
                });
            }
        });      
}

Показ:
© 2015 Microsoft