本頁是否能提供幫助?
您對此內容的意見反應十分重要。 請告訴我們您的想法。
其他意見反應?
剩餘 1500 個字元
匯出 (0) 列印
全部展開

mpns 物件

更新日期: 2015年6月

可讓您使用 Azure 通知中樞,從 Microsoft Azure 行動服務 伺服器指令碼將推播通知傳送至 Windows Phone 8.0 或 Windows Phone 8.1 Silverlight 應用程式。

createFlipTileRegistration(channel, tags, template, options, callback)
使用翻轉磚範本建立註冊。(僅適用於 Windows Phone 7.8 版或更新版本。)如需詳細資訊,請參閱 Windows Phone 8 的翻轉磚範本

參數

名稱 型別 引數 描述

channel

字串

裝置通道 URI。

tags

字串 | 陣列

單一標記或標記的陣列 (以逗號分隔的清單,不含空格)。

template

物件

註冊範本。

屬性

名稱 型別 描述

backgroundImage

字串

磚的背景影像 URI。

count

字串

出現在磚上的數字。

title

字串

磚的標題文字。

backBackgroundImage

字串

顯示在磚後端的影像 URI。

backTitle

字串

磚後端的文字。

backContent

字串

磚後端的文字。

id

字串

相關次要磚的識別碼。

smallBackgroundImage

字串

磚縮小成小型時,背景影像的 URI。

wideBackgroundImage

字串

磚擴大成寬型時,背景影像的 URI。

wideBackContent

字串

磚擴大成寬型時,後面磚的內容。

wideBackBackgroundImage

字串

磚擴大成寬型時,位於磚後端的影像 URI。

options

物件

<選用>

要求選項或回呼。

屬性

名稱 型別 引數 描述

標頭

物件

<選用>

要納入的 mpns 標頭。

callback

物件

<選用>

一個指定 successerror 回呼函數的 JSON 物件。

createNativeRegistration(channel, tags, optionsOrCallback, callback)
建立原生 MPNS 註冊。

參數

名稱 型別 引數 描述

channel

字串

裝置通道 URI。

tags

字串 | 陣列

單一標記或標記的陣列 (以逗號分隔的清單,不含空格)。

optionsOrCallback

物件

<選用>

要求選項或回呼。

callback

物件

<選用>

一個指定 successerror 回呼函數的 JSON 物件。

createOrUpdateNativeRegistration(registrationId, channel, tags, optionsOrCallback, callback)
建立或更新原生 MPNS 註冊。

參數

名稱 型別 引數 描述

registrationId

字串

註冊識別碼。

channel

字串

裝置通道 URI。

tags

字串 | 陣列

單一標記或標記的陣列 (以逗號分隔的清單,不含空格)。

optionsOrCallback

物件

<選用>

要求選項或回呼。

callback

物件

<選用>

一個指定 successerror 回呼函數的 JSON 物件。

createOrUpdateRawTemplateRegistration(registrationId, channel, tags, template, optionsOrCallback, callback)
建立或更新自訂範本註冊。

參數

名稱 型別 引數 描述

registrationId

字串

註冊識別碼。

channel

字串

裝置通道 URI。

tags

字串 | 陣列

單一標記或標記的陣列 (以逗號分隔的清單,不含空格)。

template

json

註冊的 JSON 範本。

optionsOrCallback

物件

<選用>

要求選項或回呼。

屬性

名稱 型別 引數 描述

標頭

物件

<選用>

要納入的 mpns 標頭。

callback

物件

<選用>

一個指定 successerror 回呼函數的 JSON 物件。

createRawTemplateRegistration(channel, tags, template, optionsOrCallback, callback)
建立自訂範本註冊。使用此方法可完全掌控範本格式。

參數

名稱 型別 引數 描述

channel

字串

裝置通道 URI。

tags

字串 | 陣列

單一標記或標記的陣列 (以逗號分隔的清單,不含空格)。

template

json

註冊的 JSON 範本。

optionsOrCallback

物件

<選用>

要求選項或回呼。

屬性

名稱 型別 引數 描述

pnsCredentialName

物件

<選用>

要使用的 pns 認證。

標頭

物件

<選用>

要納入的 mpns 標頭。

callback

物件

<選用>

一個指定 successerror 回呼函數的 JSON 物件。

createTileRegistration(channel, tags, template, options, callback)
使用磚範本建立註冊。如需詳細資訊,請參閱 Windows Phone 磚範本

參數

名稱 型別 引數 描述

channel

字串

裝置通道 URI。

tags

字串 | 陣列

單一標記或標記的陣列 (以逗號分隔的清單,不含空格)。

template

物件

註冊範本。

屬性

名稱 型別 描述

backgroundImage

字串

磚的背景影像 URI。

count

字串

出現在磚上的數字。

title

字串

磚的標題文字。

backBackgroundImage

字串

顯示在磚後端的影像 URI。

backTitle

字串

磚後端的文字。

backContent

字串

磚後端的文字。

id

字串

相關次要磚的識別碼。

options

物件

<選用>

要求選項或回呼。

屬性

名稱 型別 引數 描述

標頭

物件

<選用>

要納入的 mpns 標頭。

callback

物件

<選用>

一個指定 successerror 回呼函數的 JSON 物件。

createToastRegistration(channel, tags, template, options, callback)
使用快顯通知範本建立新註冊。如需詳細資訊,請參閱 Windows Phone 8 的快顯通知

參數

名稱 型別 引數 描述

channel

字串

裝置通道 URI。

tags

字串 | 陣列

單一標記或標記的陣列 (以逗號分隔的清單,不含空格)。

template

物件

註冊的本文範本。

屬性

名稱 型別 描述

text1}

字串

Text1 元素的值。

text2

字串

Text2 元素的值。

param

字串

提供給快顯通知的選用參數。(僅適用於 Windows Phone 7.5 版或更新版本。)

lang

字串

繫結元素的語言值。

options

物件

<選用>

要求選項或回呼。

屬性

名稱 型別 引數 描述

標頭

物件

<選用>

要納入的 mpns 標頭。

callback

物件

<選用>

一個指定 successerror 回呼函數的 JSON 物件。

listRegistrationsByChannel(channel, optionsOrCallback, callback)
依通道 URI 擷取註冊。

參數

名稱 型別 引數 描述

channel

字串

裝置通道 URI。

optionsOrCallback

物件

<選用>

要求選項或回呼函數。其他屬性會傳入作為標頭。

屬性

名稱 型別 引數 描述

top

物件

<選用>

指定要從呼叫中取得的最大註冊數目。

skip

物件

<選用>

指定要在呼叫中略過的註冊數目。

callback

物件

<選用>

一個指定 successerror 回呼函數的 JSON 物件。

send(tags, payload, targetName, notificationClass, optionsOrCallback, callback)
傳送自訂 MPNS 通知。如果您要完全掌控裝載,請使用此方法。

參數

名稱 型別 引數 描述

tags

陣列 | 字串

單一標記、標記運算式或標記的陣列。

payload

字串

訊息的 XML 裝載。

targetName

字串

目標名稱。

notificationClass

字串

通知類別。

optionsOrCallback

物件

<選用>

要求選項或回呼。

屬性

名稱 型別 引數 描述

標頭

物件

<選用>

要納入的 mpns 標頭。

callback

物件

一個指定 successerror 回呼函數的 JSON 物件。

sendFlipTile(tags, payload, options, callback)
傳送翻轉磚通知。(僅適用於 Windows Phone 7.8 版或更新版本。)如需詳細資訊,請參閱 Windows Phone 8 的翻轉磚範本

參數

名稱 型別 引數 描述

tags

陣列 | 字串

標記識別碼的逗號分隔清單或陣列。

payload

物件

訊息裝載。

屬性

名稱 型別 描述

backgroundImage

字串

磚的背景影像 URI。

count

字串

出現在磚上的數字。

title

字串

磚的標題文字。

backBackgroundImage

字串

顯示在磚後端的影像 URI。

backTitle

字串

磚後端的文字。

backContent

字串

磚後端的文字。

id

字串

相關次要磚的識別碼。

smallBackgroundImage

字串

磚縮小成小型時,背景影像的 URI。

wideBackgroundImage

字串

磚擴大成寬型時,背景影像的 URI。

wideBackContent

字串

磚擴大成寬型時,後面磚的內容。

wideBackBackgroundImage

字串

磚擴大成寬型時,位於磚後端的影像 URI。

optionsOrCallback

物件

<選用>

要求選項或回呼。

屬性

名稱 型別 引數 描述

標頭

物件

<選用>

要納入的 mpns 標頭。

callback

物件

一個指定 successerror 回呼函數的 JSON 物件。

sendTile(tags, payload, optionsOrCallback, callback)
傳送磚通知。如需詳細資訊,請參閱 Windows Phone 磚範本

參數

名稱 型別 引數 描述

tags

陣列 | 字串

標記識別碼的逗號分隔清單或陣列。

payload

物件

訊息裝載。

屬性

名稱 型別 描述

backgroundImage

字串

磚的背景影像 URI。

count

字串

出現在磚上的數字。

title

字串

磚的標題文字。

backBackgroundImage

字串

顯示在磚後端的影像 URI。

backTitle

字串

磚後端的文字。

backContent

字串

磚後端的文字。

id

字串

相關次要磚的識別碼。

optionsOrCallback

物件

<選用>

要求選項或回呼。

屬性

名稱 型別 引數 描述

標頭

物件

<選用>

要納入的 mpns 標頭。

callback

物件

一個指定 successerror 回呼函數的 JSON 物件。

sendToast(tags, payload, options, callback)
傳送快顯通知。如需詳細資訊,請參閱 Windows Phone 8 的快顯通知

參數

名稱 型別 引數 描述

tags

陣列 | 字串

標記識別碼的逗號分隔清單或陣列。

payload

物件

訊息裝載。

屬性

名稱 型別 描述

text1}

字串

Text1 元素的值。

text2

字串

Text2 元素的值。

param

字串

提供給快顯通知的選用參數。(僅適用於 Windows Phone 7.5 版或更新版本。)

lang

字串

繫結元素的語言值。

optionsOrCallback

物件

<選用>

要求選項或回呼。

屬性

名稱 型別 引數 描述

標頭

物件

<選用>

要納入的 mpns 標頭。

callback

物件

一個指定 successerror 回呼函數的 JSON 物件。

updateFlipTileRegistration(registrationId, channel, tags, template, optionsOrCallback, callback)
使用翻轉磚範本更新現有的註冊。(僅支援 Windows Phone 7.8 版或更新版本。)如需詳細資訊,請參閱 Windows Phone 8 的翻轉磚範本

參數

名稱 型別 引數 描述

registrationId

字串

註冊識別碼。

channel

字串

裝置通道 URI。

tags

字串 | 陣列

單一標記或標記的陣列 (以逗號分隔的清單,不含空格)。

template

物件

註冊範本。

屬性

名稱 型別 描述

backgroundImage

字串

磚的背景影像 URI。

count

字串

出現在磚上的數字。

title

字串

磚的標題文字。

backBackgroundImage

字串

顯示在磚後端的影像 URI。

backTitle

字串

磚後端的文字。

backContent

字串

磚後端的文字。

id

字串

相關次要磚的識別碼。

smallBackgroundImage

字串

磚縮小成小型時,背景影像的 URI。

wideBackgroundImage

字串

磚擴大成寬型時,背景影像的 URI。

wideBackContent

字串

磚擴大成寬型時,後面磚的內容。

wideBackBackgroundImage

字串

磚擴大成寬型時,位於磚後端的影像 URI。

optionsOrCallback

物件

<選用>

要求選項或回呼。

屬性

名稱 型別 引數 描述

標頭

物件

<選用>

要納入的 mpns 標頭。

callback

物件

<選用>

一個指定 successerror 回呼函數的 JSON 物件。

updatesRawTemplateRegistration(registrationId, channel, tags, template, optionsOrCallback, callback)
更新原始範本註冊。

參數

名稱 型別 引數 描述

registrationId

字串

註冊識別碼。

channel

字串

裝置通道 URI。

tags

字串 | 陣列

註冊的標記。

template

json

註冊的範本。

optionsOrCallback

物件

<選用>

要求選項或回呼。

屬性

名稱 型別 引數 描述

標頭

物件

<選用>

要納入的 mpns 標頭。

etag

物件

<選用>

要納入的 etag。

callback

物件

一個指定 successerror 回呼函數的 JSON 物件。

updatesToastRegistration(registrationId, channel, tags, template, options, callback)
使用新的快顯通知範本更新現有的範本註冊。如需詳細資訊,請參閱 Windows Phone 8 的快顯通知

參數

名稱 型別 引數 描述

registrationId

字串

註冊識別碼。

channel

字串

裝置通道 URI。

tags

字串 | 陣列

註冊的標記。

template

物件

註冊的本文範本。

屬性

名稱 型別 描述

text1}

字串

Text1 元素的值。

text2

字串

Text2 元素的值。

param

字串

提供給快顯通知的選用參數。(僅適用於 Windows Phone 7.5 版或更新版本。)

lang

字串

繫結元素的語言值。

optionsOrCallback

物件

<選用>

要求選項或回呼。

屬性

名稱 型別 引數 描述

標頭

物件

<選用>

要納入的 mpns 標頭。

callback

物件

一個指定 successerror 回呼函數的 JSON 物件。

updateTileRegistration(registrationId, channel, tags, template, optionsOrCallback, callback)
使用磚範本更新現有的註冊。如需詳細資訊,請參閱 Windows Phone 磚範本

參數

名稱 型別 引數 描述

registrationId

字串

註冊識別碼。

channel

字串

裝置通道 URI。

tags

字串 | 陣列

單一標記或標記的陣列 (以逗號分隔的清單,不含空格)。

template

物件

註冊範本。

屬性

名稱 型別 描述

backgroundImage

字串

磚的背景影像 URI。

count

字串

出現在磚上的數字。

title

字串

磚的標題文字。

backBackgroundImage

字串

顯示在磚後端的影像 URI。

backTitle

字串

磚後端的文字。

backContent

字串

磚後端的文字。

id

字串

相關次要磚的識別碼。

optionsOrCallback

物件

<選用>

要求選項或回呼。

屬性

名稱 型別 引數 描述

標頭

物件

<選用>

要納入的 mpns 標頭。

callback

物件

<選用>

一個指定 successerror 回呼函數的 JSON 物件。

mpns 物件可用來將推播通知傳送至 Windows Phone 8 和 Windows Phone 8.1 Silverlight 應用程式。若要將推播通知傳送至 Windows Phone Store 8.1 應用程式,您必須使用 wns 物件。Windows Phone Store 8.1 應用程式不支援以通知中樞傳送 MPNS。

如需如何將推播通知從您的行動服務傳送至 Windows Phone 8 應用程式的範例,請參閱將推播通知新增至您的行動服務應用程式

行動服務不需要向 MPNS 註冊您的應用程式就能啟用驗證用法。因此,使用 MPNS 時,每位使用者每天不得傳送超過 500 個訊息。

下列指令碼會使用 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 });
                    }
                });
            }
        });      
}

Microsoft 正展開一份線上問卷調查,了解您對於 MSDN 網站的看法。 如果您選擇參加,您離開 MSDN 網站時即會顯示線上問卷調查。

您是否想要參加?
顯示:
© 2015 Microsoft