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

wns 개체

업데이트 날짜: 2015년 6월

Azure 알림 허브를 사용하여 Microsoft Azure 모바일 서비스 서버 스크립트에서 Windows 스토어 또는 유니버설 Windows 앱에 푸시 알림을 보낼 수 있습니다.

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

매개 변수

Name Type 인수 설명

channel

문자열

장치 채널 URI입니다.

tags

문자열 | 배열

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

options

개체

<옵션>

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

callback

개체

<옵션>

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

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

매개 변수

Name Type 인수 설명

registrationId

문자열

등록 식별자입니다.

channel

문자열

장치 채널 URI입니다.

tags

문자열 | 배열

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

options

개체

<옵션>

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

callback

개체

<옵션>

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

createOrUpdateRawTemplateRegistration(registrationId, channel, tags, template, optionsOrCallback, callback)
사용자 지정 템플릿 등록을 만들거나 업데이트합니다. 이 메서드를 사용하여 템플릿 형식을 완벽하게 제어합니다. X-WNS-Type 헤더도 지정해야 합니다(가능한 값: wns/toast, wns/tile, wns/badge, wns/raw).

매개 변수

Name Type 인수 설명

registrationId

문자열

등록 식별자입니다.

channel

문자열

장치 채널 URI입니다.

tags

문자열 | 배열

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

template

문자열

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

options

개체

<옵션>

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

속성

Name Type 인수 설명

pnsCredentialName

개체

<옵션>

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

headers

개체

<옵션>

포함할 WNS 헤더입니다.

callback

개체

<옵션>

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

createRawTemplateRegistration(channel, tags, template, optionsOrCallback, callback)
사용자 지정 템플릿 등록을 만듭니다. 이 메서드를 사용하여 템플릿 형식을 완벽하게 제어합니다. X-WNS-Type 헤더도 지정해야 합니다(가능한 값: wns/toast, wns/tile, wns/badge, wns/raw).

매개 변수

Name Type 인수 설명

channel

문자열

장치 채널 URI입니다.

tags

문자열 | 배열

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

template

문자열

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

options

개체

<옵션>

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

속성

Name Type 인수 설명

pnsCredentialName

개체

<옵션>

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

headers

개체

<옵션>

포함할 WNS 헤더입니다.

callback

개체

<옵션>

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

createTile*Registration(channel, tags, template, options, callback)
타일 템플릿을 사용하여 새 등록을 만듭니다. 타일 템플릿 카탈로그createTileSquarePeekImageAndText01Registration과 같은 각 타일 템플릿에 대한 메서드가 포함되어 있습니다.

매개 변수

Name Type 인수 설명

channel

문자열

장치 채널 URI입니다.

tags

문자열 | 배열

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

template

개체

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

속성

Name Type 설명

text{1..n}

문자열

text1과 같이 ID가 지정된 텍스트 요소의 값입니다. text* 속성의 번호는 타일 유형에 따라 다릅니다.

image{1..n}src

문자열

image1과 같이 ID가 지정된 이미지 요소의 src 특성입니다. image* 속성의 번호는 타일 유형에 따라 다릅니다.

image{1..n}alt

문자열

image1과 같이 ID가 지정된 이미지 요소의 alt 특성입니다. image* 속성의 번호는 타일 유형에 따라 다릅니다.

lang

문자열

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

options

개체

<옵션>

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

속성

Name Type 인수 설명

headers

개체

<옵션>

포함할 WNS 헤더입니다.

callback

개체

<옵션>

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

createToast*Registration(channel, tags, template, options, callback)
알림 템플릿을 사용하여 새 등록을 만듭니다. 알림 템플릿 카탈로그createToastText01Registration과 같은 각 알림 템플릿에 대한 메서드가 포함되어 있습니다.

매개 변수

Name Type 인수 설명

channel

문자열

장치 채널 URI입니다.

tags

문자열 | 배열

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

template

개체

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

속성

Name Type 설명

text{1..n}

문자열

text1과 같이 ID가 지정된 텍스트 요소의 값입니다. text* 속성의 번호는 알림 유형에 따라 다릅니다.

image{1..n}src

문자열

image1과 같이 ID가 지정된 이미지 요소의 src 특성입니다. image* 속성의 번호는 알림 유형에 따라 다릅니다.

image{1..n}alt

문자열

image1과 같이 ID가 지정된 이미지 요소의 alt 특성입니다. image* 속성의 번호는 알림 유형에 따라 다릅니다.

lang

문자열

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

options

개체

<옵션>

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

속성

Name Type 인수 설명

headers

개체

<옵션>

포함할 WNS 헤더입니다.

callback

개체

<옵션>

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

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

매개 변수

Name Type 인수 설명

channel

문자열

장치 채널 URI입니다.

options

개체

<옵션>

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

속성

Name Type 인수 설명

top

개체

<옵션>

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

skip

개체

<옵션>

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

callback

개체

<옵션>

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

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

매개 변수

Name Type 인수 설명

tags

배열 | 문자열

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

payload

문자열

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

type

문자열

메시지 유형입니다. 헤더 X-WNS-Type에 해당합니다(옵션: wns/raw, wns/tile, wns/toast).

optionsOrCallback

개체

<옵션>

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

속성

Name Type 인수 설명

headers

개체

<옵션>

포함할 WNS 헤더입니다.

callback

개체

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

sendBadge(tags, value, optionsOrCallback, callback)
wns/badge WNS 알림을 보냅니다.

매개 변수

Name Type 인수 설명

tags

배열 | 문자열

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

value

개체 | 문자열

미리 정의된 배지 문자를 지정하는 숫자 값 또는 문자열 값입니다. 숫자 값의 경우 유효한 정수를 사용할 수 있습니다. 값이 0이면 배지가 지워지고, 값이 1~99이면 지정된 숫자가 표시되며, 99보다 큰 값은 99+로 표시됩니다. 자세한 내용은 badge 요소 항목을 참조하세요.

optionsOrCallback

개체

<옵션>

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

속성

Name Type 인수 설명

headers

개체

<옵션>

포함할 WNS 헤더입니다.

callback

개체

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

sendRaw(tags, payload, optionsOrCallback, callback)
wns/raw WNS 알림을 보냅니다.

매개 변수

Name Type 인수 설명

tags

배열 | 문자열

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

payload

개체 | 문자열

원시 페이로드입니다.

optionsOrCallback

개체

<옵션>

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

속성

Name Type 인수 설명

headers

개체

<옵션>

포함할 WNS 헤더입니다.

callback

개체

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

sendTile*(tags, payload, options, callback)
타일 알림을 보냅니다. 타일 템플릿 카탈로그sendTileSquarePeekImageAndText01과 같은 각 타일 템플릿에 대한 메서드가 포함되어 있습니다.

매개 변수

Name Type 인수 설명

tags

문자열 | 배열

단일 태그 또는 태그 식입니다.

payload

개체

메시지 페이로드입니다. 여러 페이로드 매개 변수를 전달할 수 있습니다.

속성

Name Type 설명

text{1..n}

문자열

text1과 같이 ID가 지정된 텍스트 요소의 값입니다. text* 속성의 번호는 타일 유형에 따라 다릅니다.

image{1..n}src

문자열

image1과 같이 ID가 지정된 이미지 요소의 src 특성입니다. image* 속성의 번호는 타일 유형에 따라 다릅니다.

image{1..n}alt

문자열

image1과 같이 ID가 지정된 이미지 요소의 alt 특성입니다. image* 속성의 번호는 타일 유형에 따라 다릅니다.

lang

문자열

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

종류

문자열

일반 sendTile 메서드에서 사용됩니다.

options

개체

<옵션>

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

속성

Name Type 인수 설명

headers

개체

<옵션>

포함할 WNS 헤더입니다.

callback

개체

<옵션>

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

sendToast*(tags, payload, options, callback)
알림 메시지를 보냅니다. 알림 템플릿 카탈로그sendToastText01과 같은 각 알림 템플릿에 대한 메서드가 포함되어 있습니다.

매개 변수

Name Type 인수 설명

tags

문자열 | 배열

단일 태그 또는 태그 식입니다.

payload

개체

메시지 페이로드입니다.

속성

Name Type 설명

text{1..n}

문자열

text1과 같이 ID가 지정된 텍스트 요소의 값입니다. text* 속성의 번호는 알림 유형에 따라 다릅니다.

image{1..n}src

문자열

image1과 같이 ID가 지정된 이미지 요소의 src 특성입니다. image* 속성의 번호는 알림 유형에 따라 다릅니다.

image{1..n}alt

문자열

image1과 같이 ID가 지정된 이미지 요소의 alt 특성입니다. image* 속성의 번호는 알림 유형에 따라 다릅니다.

lang

문자열

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

options

개체

<옵션>

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

속성

Name Type 인수 설명

headers

개체

<옵션>

포함할 WNS 헤더입니다.

callback

개체

<옵션>

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

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

매개 변수

Name Type 인수 설명

registrationId

문자열

등록 식별자입니다.

channel

문자열

장치 채널 URI입니다.

tags

문자열 | 배열

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

template

문자열 | 배열

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

options

개체

<옵션>

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

속성

Name Type 인수 설명

pnsCredentialName

개체

<옵션>

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

headers

개체

<옵션>

포함할 WNS 헤더입니다.

etag

개체

<옵션>

포함할 etag입니다.

callback

개체

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

updateTile*Registration(registrationId, channel, tags, template, options, callback)
새 타일 템플릿을 사용하여 기존 템플릿 등록을 업데이트합니다. 타일 템플릿 카탈로그updadteTileSquarePeekImageAndText01Registration과 같은 각 타일 템플릿에 대한 메서드가 포함되어 있습니다.

매개 변수

Name Type 인수 설명

registrationId

문자열

등록 식별자입니다.

channel

문자열

장치 채널 URI입니다.

tags

문자열 | 배열

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

template

개체

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

속성

Name Type 설명

text{1..n}

문자열

text1과 같이 ID가 지정된 텍스트 요소의 값입니다. text* 속성의 번호는 타일 유형에 따라 다릅니다.

image{1..n}src

문자열

image1과 같이 ID가 지정된 이미지 요소의 src 특성입니다. image* 속성의 번호는 타일 유형에 따라 다릅니다.

image{1..n}alt

문자열

image1과 같이 ID가 지정된 이미지 요소의 alt 특성입니다. image* 속성의 번호는 타일 유형에 따라 다릅니다.

lang

문자열

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

options

개체

<옵션>

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

속성

Name Type 인수 설명

headers

개체

<옵션>

포함할 WNS 헤더입니다.

callback

개체

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

updateToast*Registration(registrationId, channel, tags, template, options, callback)
새 알림 템플릿을 사용하여 기존 템플릿 등록을 업데이트합니다. 알림 템플릿 카탈로그updateToastText01Registration과 같은 각 알림 템플릿에 대한 메서드가 포함되어 있습니다.

매개 변수

Name Type 인수 설명

registrationId

문자열

등록 식별자입니다.

channel

문자열

장치 채널 URI입니다.

tags

문자열 | 배열

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

template

개체

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

속성

Name Type 설명

text{1..n}

문자열

text1과 같이 ID가 지정된 텍스트 요소의 값입니다. text* 속성의 번호는 알림 유형에 따라 다릅니다.

image{1..n}src

문자열

image1과 같이 ID가 지정된 이미지 요소의 src 특성입니다. image* 속성의 번호는 알림 유형에 따라 다릅니다.

image{1..n}alt

문자열

image1과 같이 ID가 지정된 이미지 요소의 alt 특성입니다. image* 속성의 번호는 알림 유형에 따라 다릅니다.

lang

문자열

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

options

개체

<옵션>

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

속성

Name Type 인수 설명

headers

개체

<옵션>

포함할 WNS 헤더입니다.

callback

개체

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

모바일 서비스에서 Windows 앱으로 푸시 알림을 보내는 방법의 예제는 모바일 서비스 앱에 푸시 알림 추가(Windows 스토어 C#/Windows 스토어 JavaScript/유니버설 Windows C#/유니버설 Windows JavaScript)를 참조하세요.

모든 메서드는 undefined를 반환합니다.

payload 개체의 경우 특정 템플릿을 기반으로 필드의 이름과 순서를 지정할 때 다음 사항을 고려해야 합니다.

  • textN은 1부터 시작하는 문서 순서에서 N번째 문자열 값을 지정합니다.

  • imageNsrc는 1부터 시작하는 문서 순서에서 N번째 이미지의 URL을 지정합니다.

  • imageNalt는 1부터 시작하는 문서 순서에서 N번째 이미지의 alt 텍스트를 지정합니다.

  • 누락된 필드는 모두 빈 문자열로 간주됩니다.

  • 특정 템플릿에 필요하지 않은 추가 필드는 모두 무시됩니다.

sendRaw 메서드를 호출한 경우에는 알림 페이로드가 앱에 전달되며 UI에 표시되지 않습니다. 자세한 내용은 Raw notification overview (Windows Store apps)를 참조하세요.

다음 스크립트는 wns 개체에 대해 send 함수를 사용하여 Windows 스토어 앱에 알림 메시지를 보냅니다.

function insert(item, user, request) {
// Define a payload for the Windows Store toast notification.
var payload = '<?xml version="1.0" encoding="utf-8"?><toast><visual>' +    
    '<binding template="ToastText01">  <text id="1">' +
    item.text + '</text></binding></visual></toast>';

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

다음 스크립트는 sendRaw 개체의 wns 메서드를 호출하여 ToastImageAndText03 템플릿으로 서식이 지정된 알림 메시지를 보냅니다.

function insert(item, user, request) {
    request.execute({
        success: function() {
            // Write to the response and then send a raw notification in the background.
            request.respond();
            push.wns.sendRaw(null,'{ notification: raw, text: "Raw notification string" }' + 
            item.text, {
                success: function(pushResponse) {
                    console.log("Sent push:", pushResponse);
                }
            });
        }
    });
}

Microsoft는 MSDN 웹 사이트에 대한 귀하의 의견을 이해하기 위해 온라인 설문 조사를 진행하고 있습니다. 참여하도록 선택하시면 MSDN 웹 사이트에서 나가실 때 온라인 설문 조사가 표시됩니다.

참여하시겠습니까?
표시:
© 2015 Microsoft