이 페이지가 유용했습니까?
이 콘텐츠에 대한 여러분의 의견은 중요합니다. 의견을 알려주십시오.
추가 의견
1500자 남음
mpns 개체

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용 대칭 이동 타일 템플릿을 참조하세요.

매개 변수

Name Type 인수 설명

channel

문자열

장치 채널 URI입니다.

tags

문자열 | 배열

단일 태그 또는 태그 배열(쉼표로 구분된 목록, 공백 없음)입니다.

template

개체

등록 템플릿입니다.

속성

Name Type 설명

backgroundImage

문자열

타일 배경 이미지의 URI입니다.

count

문자열

타일에 표시되는 숫자입니다.

title

문자열

타일의 제목 텍스트입니다.

backBackgroundImage

문자열

타일의 뒷면에 표시되는 이미지의 URI입니다.

backTitle

문자열

타일 뒷면의 제목 텍스트입니다.

backContent

문자열

타일 뒷면의 텍스트입니다.

id

문자열

관련 보조 타일의 ID입니다.

smallBackgroundImage

문자열

작게 축소된 경우 타일 배경 이미지의 URI입니다.

wideBackgroundImage

문자열

크게 확대된 경우 타일 배경 이미지의 URI입니다.

wideBackContent

문자열

타일이 크게 확대된 경우 뒷면 타일의 콘텐츠입니다.

wideBackBackgroundImage

문자열

크게 확대된 경우 타일 뒷면에 표시할 이미지의 URI입니다.

options

개체

<옵션>

요청 옵션 또는 콜백입니다.

속성

Name Type 인수 설명

headers

개체

<옵션>

포함할 MPNS 헤더입니다.

callback

개체

<옵션>

successerror 콜백 함수를 지정하는 JSON 개체입니다.

createNativeRegistration(channel, tags, optionsOrCallback, callback)
기본 MPNS 등록을 만듭니다.

매개 변수

Name Type 인수 설명

channel

문자열

장치 채널 URI입니다.

tags

문자열 | 배열

단일 태그 또는 태그 배열(쉼표로 구분된 목록, 공백 없음)입니다.

optionsOrCallback

개체

<옵션>

요청 옵션 또는 콜백입니다.

callback

개체

<옵션>

successerror 콜백 함수를 지정하는 JSON 개체입니다.

createOrUpdateNativeRegistration(registrationId, channel, tags, optionsOrCallback, callback)
기본 MPNS 등록을 만들거나 업데이트합니다.

매개 변수

Name Type 인수 설명

registrationId

문자열

등록 식별자입니다.

channel

문자열

장치 채널 URI입니다.

tags

문자열 | 배열

단일 태그 또는 태그 배열(쉼표로 구분된 목록, 공백 없음)입니다.

optionsOrCallback

개체

<옵션>

요청 옵션 또는 콜백입니다.

callback

개체

<옵션>

successerror 콜백 함수를 지정하는 JSON 개체입니다.

createOrUpdateRawTemplateRegistration(registrationId, channel, tags, template, optionsOrCallback, callback)
사용자 지정 템플릿 등록을 만들거나 업데이트합니다.

매개 변수

Name Type 인수 설명

registrationId

문자열

등록 식별자입니다.

channel

문자열

장치 채널 URI입니다.

tags

문자열 | 배열

단일 태그 또는 태그 배열(쉼표로 구분된 목록, 공백 없음)입니다.

template

json

등록에 사용할 JSON 템플릿입니다.

optionsOrCallback

개체

<옵션>

요청 옵션 또는 콜백입니다.

속성

Name Type 인수 설명

headers

개체

<옵션>

포함할 MPNS 헤더입니다.

callback

개체

<옵션>

successerror 콜백 함수를 지정하는 JSON 개체입니다.

createRawTemplateRegistration(channel, tags, template, optionsOrCallback, callback)
사용자 지정 템플릿 등록을 만듭니다. 이 메서드를 사용하여 템플릿 형식을 완벽하게 제어합니다.

매개 변수

Name Type 인수 설명

channel

문자열

장치 채널 URI입니다.

tags

문자열 | 배열

단일 태그 또는 태그 배열(쉼표로 구분된 목록, 공백 없음)입니다.

template

json

등록에 사용할 JSON 템플릿입니다.

optionsOrCallback

개체

<옵션>

요청 옵션 또는 콜백입니다.

속성

Name Type 인수 설명

pnsCredentialName

개체

<옵션>

사용할 PNS 자격 증명입니다.

headers

개체

<옵션>

포함할 MPNS 헤더입니다.

callback

개체

<옵션>

successerror 콜백 함수를 지정하는 JSON 개체입니다.

createTileRegistration(channel, tags, template, options, callback)
타일 템플릿을 사용하여 등록을 만듭니다. 자세한 내용은 Windows Phone 타일 템플릿을 참조하세요.

매개 변수

Name Type 인수 설명

channel

문자열

장치 채널 URI입니다.

tags

문자열 | 배열

단일 태그 또는 태그 배열(쉼표로 구분된 목록, 공백 없음)입니다.

template

개체

등록 템플릿입니다.

속성

Name Type 설명

backgroundImage

문자열

타일 배경 이미지의 URI입니다.

count

문자열

타일에 표시되는 숫자입니다.

title

문자열

타일의 제목 텍스트입니다.

backBackgroundImage

문자열

타일의 뒷면에 표시되는 이미지의 URI입니다.

backTitle

문자열

타일 뒷면의 제목 텍스트입니다.

backContent

문자열

타일 뒷면의 텍스트입니다.

id

문자열

관련 보조 타일의 ID입니다.

options

개체

<옵션>

요청 옵션 또는 콜백입니다.

속성

Name Type 인수 설명

headers

개체

<옵션>

포함할 MPNS 헤더입니다.

callback

개체

<옵션>

successerror 콜백 함수를 지정하는 JSON 개체입니다.

createToastRegistration(channel, tags, template, options, callback)
알림 템플릿을 사용하여 새 등록을 만듭니다. 자세한 내용은 Windows Phone 8의 알림을 참조하세요.

매개 변수

Name Type 인수 설명

channel

문자열

장치 채널 URI입니다.

tags

문자열 | 배열

단일 태그 또는 태그 배열(쉼표로 구분된 목록, 공백 없음)입니다.

template

개체

등록의 본문 템플릿입니다.

속성

Name Type 설명

text1}

문자열

Text1 요소의 값입니다.

text2

문자열

Text2 요소의 값입니다.

param

문자열

알림에 제공되는 선택적 매개 변수입니다. Windows Phone 7.5 이상 버전에만 해당합니다.

lang

문자열

바인딩 요소의 언어 값입니다.

options

개체

<옵션>

요청 옵션 또는 콜백입니다.

속성

Name Type 인수 설명

headers

개체

<옵션>

포함할 MPNS 헤더입니다.

callback

개체

<옵션>

successerror 콜백 함수를 지정하는 JSON 개체입니다.

listRegistrationsByChannel(channel, optionsOrCallback, callback)
채널 URI로 등록을 검색합니다.

매개 변수

Name Type 인수 설명

channel

문자열

장치 채널 URI입니다.

optionsOrCallback

개체

<옵션>

요청 옵션 또는 콜백 함수입니다. 추가 속성이 헤더로 전달됩니다.

속성

Name Type 인수 설명

top

개체

<옵션>

호출에서 가져올 최대 등록 수를 지정합니다.

skip

개체

<옵션>

호출에서 건너뛸 등록 수를 지정합니다.

callback

개체

<옵션>

successerror 콜백 함수를 지정하는 JSON 개체입니다.

send(tags, payload, targetName, notificationClass, optionsOrCallback, callback)
사용자 지정 MPNS 알림을 보냅니다. 페이로드를 완벽하게 제어하려는 경우 이 메서드를 사용합니다.

매개 변수

Name Type 인수 설명

tags

배열 | 문자열

단일 태그, 태그 식 또는 태그 배열입니다.

payload

문자열

메시지의 XML 페이로드입니다.

targetName

문자열

대상 이름입니다.

notificationClass

문자열

알림 클래스입니다.

optionsOrCallback

개체

<옵션>

요청 옵션 또는 콜백입니다.

속성

Name Type 인수 설명

headers

개체

<옵션>

포함할 MPNS 헤더입니다.

callback

개체

successerror 콜백 함수를 지정하는 JSON 개체입니다.

sendFlipTile(tags, payload, options, callback)
대칭 이동 타일 알림을 보냅니다. Windows Phone 7.8 이상 버전에만 해당합니다. 자세한 내용은 Windows Phone 8용 대칭 이동 타일 템플릿을 참조하세요.

매개 변수

Name Type 인수 설명

tags

배열 | 문자열

태그 식별자의 쉼표로 구분된 목록 또는 배열입니다.

payload

개체

메시지 페이로드입니다.

속성

Name Type 설명

backgroundImage

문자열

타일 배경 이미지의 URI입니다.

count

문자열

타일에 표시되는 숫자입니다.

title

문자열

타일의 제목 텍스트입니다.

backBackgroundImage

문자열

타일의 뒷면에 표시되는 이미지의 URI입니다.

backTitle

문자열

타일 뒷면의 제목 텍스트입니다.

backContent

문자열

타일 뒷면의 텍스트입니다.

id

문자열

관련 보조 타일의 ID입니다.

smallBackgroundImage

문자열

작게 축소된 경우 타일 배경 이미지의 URI입니다.

wideBackgroundImage

문자열

크게 확대된 경우 타일 배경 이미지의 URI입니다.

wideBackContent

문자열

타일이 크게 확대된 경우 뒷면 타일의 콘텐츠입니다.

wideBackBackgroundImage

문자열

크게 확대된 경우 타일 뒷면에 표시할 이미지의 URI입니다.

optionsOrCallback

개체

<옵션>

요청 옵션 또는 콜백입니다.

속성

Name Type 인수 설명

headers

개체

<옵션>

포함할 MPNS 헤더입니다.

callback

개체

successerror 콜백 함수를 지정하는 JSON 개체입니다.

sendTile(tags, payload, optionsOrCallback, callback)
타일 알림을 보냅니다. 자세한 내용은 Windows Phone 타일 템플릿을 참조하세요.

매개 변수

Name Type 인수 설명

tags

배열 | 문자열

태그 식별자의 쉼표로 구분된 목록 또는 배열입니다.

payload

개체

메시지 페이로드입니다.

속성

Name Type 설명

backgroundImage

문자열

타일 배경 이미지의 URI입니다.

count

문자열

타일에 표시되는 숫자입니다.

title

문자열

타일의 제목 텍스트입니다.

backBackgroundImage

문자열

타일의 뒷면에 표시되는 이미지의 URI입니다.

backTitle

문자열

타일 뒷면의 제목 텍스트입니다.

backContent

문자열

타일 뒷면의 텍스트입니다.

id

문자열

관련 보조 타일의 ID입니다.

optionsOrCallback

개체

<옵션>

요청 옵션 또는 콜백입니다.

속성

Name Type 인수 설명

headers

개체

<옵션>

포함할 MPNS 헤더입니다.

callback

개체

successerror 콜백 함수를 지정하는 JSON 개체입니다.

sendToast(tags, payload, options, callback)
알림 메시지를 보냅니다. 자세한 내용은 Windows Phone 8의 알림을 참조하세요.

매개 변수

Name Type 인수 설명

tags

배열 | 문자열

태그 식별자의 쉼표로 구분된 목록 또는 배열입니다.

payload

개체

메시지 페이로드입니다.

속성

Name Type 설명

text1}

문자열

Text1 요소의 값입니다.

text2

문자열

Text2 요소의 값입니다.

param

문자열

알림에 제공되는 선택적 매개 변수입니다. Windows Phone 7.5 이상 버전에만 해당합니다.

lang

문자열

바인딩 요소의 언어 값입니다.

optionsOrCallback

개체

<옵션>

요청 옵션 또는 콜백입니다.

속성

Name Type 인수 설명

headers

개체

<옵션>

포함할 MPNS 헤더입니다.

callback

개체

successerror 콜백 함수를 지정하는 JSON 개체입니다.

updateFlipTileRegistration(registrationId, channel, tags, template, optionsOrCallback, callback)
대칭 이동 타일 템플릿을 사용하여 기존 등록을 업데이트합니다. Windows Phone 7.8 이상 버전에서만 지원됩니다. 자세한 내용은 Windows Phone 8용 대칭 이동 타일 템플릿을 참조하세요.

매개 변수

Name Type 인수 설명

registrationId

문자열

등록 식별자입니다.

channel

문자열

장치 채널 URI입니다.

tags

문자열 | 배열

단일 태그 또는 태그 배열(쉼표로 구분된 목록, 공백 없음)입니다.

template

개체

등록 템플릿입니다.

속성

Name Type 설명

backgroundImage

문자열

타일 배경 이미지의 URI입니다.

count

문자열

타일에 표시되는 숫자입니다.

title

문자열

타일의 제목 텍스트입니다.

backBackgroundImage

문자열

타일의 뒷면에 표시되는 이미지의 URI입니다.

backTitle

문자열

타일 뒷면의 제목 텍스트입니다.

backContent

문자열

타일 뒷면의 텍스트입니다.

id

문자열

관련 보조 타일의 ID입니다.

smallBackgroundImage

문자열

작게 축소된 경우 타일 배경 이미지의 URI입니다.

wideBackgroundImage

문자열

크게 확대된 경우 타일 배경 이미지의 URI입니다.

wideBackContent

문자열

타일이 크게 확대된 경우 뒷면 타일의 콘텐츠입니다.

wideBackBackgroundImage

문자열

크게 확대된 경우 타일 뒷면에 표시할 이미지의 URI입니다.

optionsOrCallback

개체

<옵션>

요청 옵션 또는 콜백입니다.

속성

Name Type 인수 설명

headers

개체

<옵션>

포함할 MPNS 헤더입니다.

callback

개체

<옵션>

successerror 콜백 함수를 지정하는 JSON 개체입니다.

updatesRawTemplateRegistration(registrationId, channel, tags, template, optionsOrCallback, callback)
원시 템플릿 등록을 업데이트합니다.

매개 변수

Name Type 인수 설명

registrationId

문자열

등록 식별자입니다.

channel

문자열

장치 채널 URI입니다.

tags

문자열 | 배열

등록에 사용할 태그입니다.

template

json

등록에 사용할 템플릿입니다.

optionsOrCallback

개체

<옵션>

요청 옵션 또는 콜백입니다.

속성

Name Type 인수 설명

headers

개체

<옵션>

포함할 MPNS 헤더입니다.

etag

개체

<옵션>

포함할 etag입니다.

callback

개체

successerror 콜백 함수를 지정하는 JSON 개체입니다.

updatesToastRegistration(registrationId, channel, tags, template, options, callback)
새 알림 템플릿을 사용하여 기존 템플릿 등록을 업데이트합니다. 자세한 내용은 Windows Phone 8의 알림을 참조하세요.

매개 변수

Name Type 인수 설명

registrationId

문자열

등록 식별자입니다.

channel

문자열

장치 채널 URI입니다.

tags

문자열 | 배열

등록에 사용할 태그입니다.

template

개체

등록의 본문 템플릿입니다.

속성

Name Type 설명

text1}

문자열

Text1 요소의 값입니다.

text2

문자열

Text2 요소의 값입니다.

param

문자열

알림에 제공되는 선택적 매개 변수입니다. Windows Phone 7.5 이상 버전에만 해당합니다.

lang

문자열

바인딩 요소의 언어 값입니다.

optionsOrCallback

개체

<옵션>

요청 옵션 또는 콜백입니다.

속성

Name Type 인수 설명

headers

개체

<옵션>

포함할 MPNS 헤더입니다.

callback

개체

successerror 콜백 함수를 지정하는 JSON 개체입니다.

updateTileRegistration(registrationId, channel, tags, template, optionsOrCallback, callback)
타일 템플릿을 사용하여 기존 등록을 업데이트합니다. 자세한 내용은 Windows Phone 타일 템플릿을 참조하세요.

매개 변수

Name Type 인수 설명

registrationId

문자열

등록 식별자입니다.

channel

문자열

장치 채널 URI입니다.

tags

문자열 | 배열

단일 태그 또는 태그 배열(쉼표로 구분된 목록, 공백 없음)입니다.

template

개체

등록 템플릿입니다.

속성

Name Type 설명

backgroundImage

문자열

타일 배경 이미지의 URI입니다.

count

문자열

타일에 표시되는 숫자입니다.

title

문자열

타일의 제목 텍스트입니다.

backBackgroundImage

문자열

타일의 뒷면에 표시되는 이미지의 URI입니다.

backTitle

문자열

타일 뒷면의 제목 텍스트입니다.

backContent

문자열

타일 뒷면의 텍스트입니다.

id

문자열

관련 보조 타일의 ID입니다.

optionsOrCallback

개체

<옵션>

요청 옵션 또는 콜백입니다.

속성

Name Type 인수 설명

headers

개체

<옵션>

포함할 MPNS 헤더입니다.

callback

개체

<옵션>

successerror 콜백 함수를 지정하는 JSON 개체입니다.

mpns 개체는 Windows Phone 8 및 Windows Phone 8.1 Silverlight 앱에 푸시 알림을 보내는 데 사용됩니다. Windows Phone 스토어 8.1 앱에 푸시 알림을 보내려면 wns 개체를 사용해야 합니다. MPNS는 Windows Phone 스토어 8.1 앱용 알림 허브에서 지원되지 않습니다.

모바일 서비스에서 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