TileUpdater.StartPeriodicUpdateBatch 메서드

정의

네임스페이스:

Windows.UI.Notifications

오버로드

StartPeriodicUpdateBatch(IIterable<Uri>, PeriodicUpdateRecurrence)	업데이트 프로그램의 바인딩된 타일에서 순환하는 일련의 시간 제한 업데이트를 시작합니다. 업데이트 콘텐츠는 지정된 URI(Uniform Resource Identifier)의 배열에서 검색되며, 첫 번째 업데이트는 즉시 발생하고 이후 주기적인 간격으로 후속 업데이트가 발생합니다. 참고 이 기능을 사용하려면 먼저 EnableNotificationQueue를 호출하여 타일의 알림 큐를 사용하도록 설정해야 합니다.
StartPeriodicUpdateBatch(IIterable<Uri>, DateTime, PeriodicUpdateRecurrence)	업데이트 프로그램의 바인딩된 타일에서 순환하는 일련의 시간 제한 업데이트를 시작합니다. 업데이트 콘텐츠는 지정된 시간에 업데이트가 시작되고 이후 주기적 간격으로 후속 업데이트가 발생하는 지정된 URI(Uniform Resource Identifier) 배열에서 검색됩니다. 참고 이 기능을 사용하려면 먼저 EnableNotificationQueue를 호출하여 타일의 알림 큐를 사용하도록 설정해야 합니다.

StartPeriodicUpdateBatch(IIterable<Uri>, PeriodicUpdateRecurrence)

업데이트 프로그램의 바인딩된 타일에서 순환하는 일련의 시간 제한 업데이트를 시작합니다. 업데이트 콘텐츠는 지정된 URI(Uniform Resource Identifier)의 배열에서 검색되며, 첫 번째 업데이트는 즉시 발생하고 이후 주기적인 간격으로 후속 업데이트가 발생합니다.

참고

이 기능을 사용하려면 먼저 EnableNotificationQueue를 호출하여 타일의 알림 큐를 사용하도록 설정해야 합니다.

public:
 virtual void StartPeriodicUpdateBatch(IIterable<Uri ^> ^ tileContents, PeriodicUpdateRecurrence requestedInterval) = StartPeriodicUpdateBatch;

/// [Windows.Foundation.Metadata.Overload("StartPeriodicUpdateBatch")]
void StartPeriodicUpdateBatch(IIterable<Uri> const& tileContents, PeriodicUpdateRecurrence const& requestedInterval);

[Windows.Foundation.Metadata.Overload("StartPeriodicUpdateBatch")]
public void StartPeriodicUpdateBatch(IEnumerable<System.Uri> tileContents, PeriodicUpdateRecurrence requestedInterval);

function startPeriodicUpdateBatch(tileContents, requestedInterval)

Public Sub StartPeriodicUpdateBatch (tileContents As IEnumerable(Of Uri), requestedInterval As PeriodicUpdateRecurrence)

매개 변수

tileContents

IIterable<Uri>

IEnumerable<Uri>

순환 타일 업데이트의 XML 콘텐츠를 검색할 최대 5개의 URI(Uniform Resource Identifier) 배열입니다. 배열에 URI(Uniform Resource Identifier)가 5개를 초과하는 경우 메서드가 실패합니다.

requestedInterval

PeriodicUpdateRecurrence

startTime의 초기 업데이트에 따라 새 타일 콘텐츠에 대해 URI(Uniform Resource Identifier)가 폴링되는 빈도입니다.

특성

OverloadAttribute

설명

주기적인 업데이트와 함께 알림 큐 사용

알림 큐를 사용하려면 먼저 다음 코드 줄을 사용하여 타일에 대해 알림 큐를 사용하도록 설정해야 합니다.

Windows.UI.Notifications.TileUpdateManager.createTileUpdaterForApplication().enableNotificationQueue(true);

이 API는 앱의 수명 동안 한 번만 호출해야 하지만 앱이 시작될 때마다 호출하는 데는 아무런 해가 없습니다.

주기적인 알림의 경우 각 알림에 대해 고유한 URL이 제공됩니다. 각 URL은 업데이트된 알림 콘텐츠에 대해 Windows에서 주기적으로 폴링됩니다. 각 URL에서 반환된 콘텐츠 페이로드에는 지원되는 모든 타일 크기에 대한 알림 XML 버전이 포함되어야 합니다. 폴링된 각 URL은 필요에 따라 고유한 만료 시간 및 태그 값을 반환할 수도 있습니다.

정기 업데이트에 대한 태그 지정 알림

알림 큐를 사용하도록 설정하면 타일이 최대 5개의 큐에 대기된 알림을 순환할 수 있습니다. 일반적으로 새 알림이 도착하면 가장 오래된 알림이 큐에서 대체됩니다. 그러나 특정 태그가 있는 새 알림이 큐의 위치에 관계없이 이전 알림을 동일한 태그로 바꾸도록 알림에 태그를 지정할 수 있습니다.

태그는 알림에서 식별자로 설정할 수 있는 최대 16자의 선택적 문자열입니다. 새 알림이 이미 큐에 있는 알림과 동일한 태그를 사용하여 도착하는 경우 새 알림은 기본 선점 큐 동작에 속하지 않고 이전 알림을 대체합니다. 이렇게 하면 동일한 알림의 두 버전(그 중 하나는 오래된 알림)이 동시에 큐에 있는 경우를 방지할 수 있습니다.

주기적인 알림의 경우 알림의 콘텐츠도 포함하는 알림의 HTTP 응답 메시지의 X-WNS-Tag 헤더에 태그가 제공됩니다. 이 메시지는 알림의 URI(Uniform Resource Identifier)에 대한 시스템의 정기 호출에 대한 응답으로 전송됩니다. 헤더 이름과 태그 값은 대/소문자를 구분하지 않습니다.

예는 다음과 같습니다.

X-WNS-Tag: stockMSFT

정기 업데이트에 대한 만료 시간 설정

정기적인 알림은 기본적으로 3일 후에 만료됩니다. 알림 콘텐츠의 유용한 수명이 짧거나 더 긴 경우 각 알림의 만료 시간을 명시적으로 설정해야 합니다. 이렇게 하면 부실하거나 관련이 없는 콘텐츠가 큐에 남아 있는 것을 방지할 수 있습니다. 이는 사용자의 컴퓨터가 오랫동안 인터넷 연결을 끊는 경우에 특히 중요합니다.

예를 들어, 활성 거래 중에 주식 앱은 주식 가격 알림의 만료를 폴링 간격의 두 배로 설정하는 것이 좋습니다( 예: 반시간마다 업데이트를 폴링하는 경우 전송된 후 1시간 후에 만료되는 알림). 뉴스 앱의 경우 일별 주요 뉴스를 표시하는 타일에 대해 1일이 만료되는 것이 적절합니다.

주기적인 알림의 경우 만료 시간은 알림의 HTTP 응답 메시지의 X-WNS-Expires 헤더에 설정됩니다. 만료 시간은 다음 예제에 표시된 형식 중 하나를 사용하는 HTTP 날짜로 표현됩니다.

• 일, 06 1994년 11월 08:49:37 GMT
• 일요일, 06-11월 94 08:49:37 GMT
• 일 11월 6 08:49:37 1994

HTTP 날짜 형식에 대한 자세한 내용은 W3C(World Wide Web Consortium) 3 프로토콜 매개 변수 문서를 참조하세요.

알림 큐와 함께 사용되는 정기 알림의 전체 구현 예제는 푸시 및 정기 알림 샘플(보관됨)의 시나리오 3을 참조하세요.

추가 정보

• StartPeriodicUpdateBatch(IIterable<Uri>, DateTime, PeriodicUpdateRecurrence)
• StartPeriodicUpdate(Uri, DateTime, PeriodicUpdateRecurrence)
• 타일에 대해 정기 알림을 설정하는 방법
• 정기 알림에 대한 지침 및 검사 목록
• 타일 및 타일 알림 개요

StartPeriodicUpdateBatch(IIterable<Uri>, DateTime, PeriodicUpdateRecurrence)

업데이트 프로그램의 바인딩된 타일에서 순환하는 일련의 시간 제한 업데이트를 시작합니다. 업데이트 콘텐츠는 지정된 시간에 업데이트가 시작되고 이후 주기적 간격으로 후속 업데이트가 발생하는 지정된 URI(Uniform Resource Identifier) 배열에서 검색됩니다.

참고

이 기능을 사용하려면 먼저 EnableNotificationQueue를 호출하여 타일의 알림 큐를 사용하도록 설정해야 합니다.

public:
 virtual void StartPeriodicUpdateBatch(IIterable<Uri ^> ^ tileContents, DateTime startTime, PeriodicUpdateRecurrence requestedInterval) = StartPeriodicUpdateBatch;

/// [Windows.Foundation.Metadata.Overload("StartPeriodicUpdateBatchAtTime")]
void StartPeriodicUpdateBatch(IIterable<Uri> const& tileContents, DateTime const& startTime, PeriodicUpdateRecurrence const& requestedInterval);

[Windows.Foundation.Metadata.Overload("StartPeriodicUpdateBatchAtTime")]
public void StartPeriodicUpdateBatch(IEnumerable<System.Uri> tileContents, System.DateTimeOffset startTime, PeriodicUpdateRecurrence requestedInterval);

function startPeriodicUpdateBatch(tileContents, startTime, requestedInterval)

Public Sub StartPeriodicUpdateBatch (tileContents As IEnumerable(Of Uri), startTime As DateTimeOffset, requestedInterval As PeriodicUpdateRecurrence)

매개 변수

tileContents

IIterable<Uri>

IEnumerable<Uri>

순환 타일 업데이트의 XML 콘텐츠를 검색할 최대 5개의 URI(Uniform Resource Identifier) 배열입니다. 배열에 URI(Uniform Resource Identifier)가 5개를 초과하는 경우 메서드가 실패합니다.

startTime

DateTime DateTimeOffset

새 콘텐츠에 대해 초기 URI(Uniform Resource Identifier)를 폴링해야 하는 시간입니다.

requestedInterval

PeriodicUpdateRecurrence

startTime의 초기 업데이트에 따라 새 타일 콘텐츠에 대해 URI(Uniform Resource Identifier)가 폴링되는 빈도입니다.

특성

OverloadAttribute

설명

주기적인 업데이트와 함께 알림 큐 사용

알림 큐를 사용하려면 먼저 다음 코드 줄을 사용하여 타일에 대해 알림 큐를 사용하도록 설정해야 합니다.

Windows.UI.Notifications.TileUpdateManager.createTileUpdaterForApplication().enableNotificationQueue(true);

이 API는 앱의 수명 동안 한 번만 호출해야 하지만 앱이 시작될 때마다 호출하는 데는 아무런 해가 없습니다.

주기적인 알림의 경우 각 알림에 대해 고유한 URL이 제공됩니다. 각 URL은 업데이트된 알림 콘텐츠에 대해 Windows에서 주기적으로 폴링됩니다. 각 URL에서 반환된 콘텐츠 페이로드에는 지원되는 모든 타일 크기에 대한 알림 XML 버전이 포함되어야 합니다. 폴링된 각 URL은 필요에 따라 고유한 만료 시간 및 태그 값을 반환할 수도 있습니다.

정기 업데이트에 대한 태그 지정 알림

알림 큐를 사용하도록 설정하면 타일이 최대 5개의 큐에 대기된 알림을 순환할 수 있습니다. 일반적으로 새 알림이 도착하면 가장 오래된 알림이 큐에서 대체됩니다. 그러나 특정 태그가 있는 새 알림이 큐의 위치에 관계없이 이전 알림을 동일한 태그로 바꾸도록 알림에 태그를 지정할 수 있습니다.

태그는 알림에서 식별자로 설정할 수 있는 최대 16자의 선택적 문자열입니다. 새 알림이 이미 큐에 있는 알림과 동일한 태그를 사용하여 도착하는 경우 새 알림은 기본 선점 큐 동작에 속하지 않고 이전 알림을 대체합니다. 이렇게 하면 동일한 알림의 두 버전(그 중 하나는 오래된 알림)이 동시에 큐에 있는 경우를 방지할 수 있습니다.

주기적인 알림의 경우 알림의 콘텐츠도 포함하는 알림의 HTTP 응답 메시지의 X-WNS-Tag 헤더에 태그가 제공됩니다. 이 메시지는 알림의 URI(Uniform Resource Identifier)에 대한 시스템의 정기 호출에 대한 응답으로 전송됩니다. 헤더 이름과 태그 값은 대/소문자를 구분하지 않습니다.

예는 다음과 같습니다.

X-WNS-Tag: stockMSFT

정기 업데이트에 대한 만료 시간 설정

타일은 기본적으로 3일 후에 만료됩니다. 알림 콘텐츠의 유용한 수명이 짧거나 더 긴 경우 각 알림의 만료 시간을 명시적으로 설정해야 합니다. 이렇게 하면 부실하거나 관련이 없는 콘텐츠가 큐에 남아 있는 것을 방지할 수 있습니다. 이는 사용자의 컴퓨터가 오랫동안 인터넷 연결을 끊는 경우에 특히 중요합니다.

예를 들어, 활성 거래 중에 주식 앱은 주식 가격 알림의 만료를 폴링 간격의 두 배로 설정하는 것이 좋습니다( 예: 반시간마다 업데이트를 폴링하는 경우 전송된 후 1시간 후에 만료되는 알림). 뉴스 앱의 경우 일별 주요 뉴스를 표시하는 타일에 대해 1일이 만료되는 것이 적절합니다.

주기적인 알림의 경우 만료 시간은 알림의 HTTP 응답 메시지의 X-WNS-Expires 헤더에 설정됩니다. 만료 시간은 다음 예제에 표시된 형식 중 하나를 사용하는 HTTP 날짜로 표현됩니다.

• 일, 06 1994년 11월 08:49:37 GMT
• 일요일, 06-11월 94 08:49:37 GMT
• 일 11월 6 08:49:37 1994

HTTP 날짜 형식에 대한 자세한 내용은 W3C(World Wide Web Consortium) 3 프로토콜 매개 변수 문서를 참조하세요.

알림 큐와 함께 사용되는 정기 알림의 전체 구현 예제는 푸시 및 정기 알림 샘플(보관됨)의 시나리오 3을 참조하세요.

추가 정보

• StartPeriodicUpdateBatch(IIterable<Uri>, PeriodicUpdateRecurrence)
• StartPeriodicUpdate(Uri, DateTime, PeriodicUpdateRecurrence)
• 타일에 대해 정기 알림을 설정하는 방법
• 정기 알림에 대한 지침 및 검사 목록
• 타일 및 타일 알림 개요