Düzenli bildirime genel bakış

Ayrıca yoklanan bildirimler olarak da adlandırılan düzenli bildirimler, bulut hizmetinden içerik indirerek kutucukları ve rozetleri sabit aralıklarla güncelleştirir. Düzenli bildirimleri kullanmak için istemci uygulama kodunuzun iki bilgi parçası sağlaması gerekir:

  • Windows'un uygulamanız için kutucuk veya rozet güncelleştirmelerini yoklaması için bir web konumunun Tekdüzen Kaynak Tanımlayıcısı (URI)
  • Bu URI'nin ne sıklıkta yoklanması gerektiği

Düzenli bildirimler, uygulamanızın minimum bulut hizmeti ve istemci yatırımıyla canlı kutucuk güncelleştirmeleri almasını sağlar. Düzenli bildirimler, aynı içeriği geniş bir hedef kitleye dağıtmak için iyi bir teslim yöntemidir.

Uyarı

Windows Uygulama SDK'sı push bildirimleri örneği, mevcut kanal kaydını ve push ile etkinleştirme davranışını gösterir. Bu sayfada açıklanan eski kutucuk veya rozet için periyodik yoklamayı uygulamaz.

 

Nasıl çalışır?

Düzenli bildirimler için uygulamanızın bir bulut hizmeti barındırması gerekir. Hizmet, uygulamayı yüklemiş olan tüm kullanıcılar tarafından düzenli aralıklarla yoklanır. Windows, saatte bir gibi her yoklama aralığında URI'ye bir HTTP GET isteği gönderir, isteğe yanıt olarak sağlanan istenen kutucuğu veya rozet içeriğini (XML olarak) indirir ve içeriği uygulamanın kutucuğunda görüntüler.

Düzenli güncelleştirmelerin anlık bildirimlerle kullanılamadığını unutmayın. Bildirim en iyi zamanlanmış veya anında iletme bildirimleriyle sunulur.

URI konumu ve XML içeriği

Yoklanacak URI olarak geçerli herhangi bir HTTP veya HTTPS web adresi kullanılabilir.

Bulut sunucusunun yanıtı indirilen içeriği içerir. URI'den döndürülen içerik Kutucuk veya Rozet XML şema belirtimine uygun olmalı ve UTF-8 kodlanmış olmalıdır. Bildirimin süre sonu veya etiketini belirtmek için tanımlı HTTP üst bilgilerini kullanabilirsiniz.

Yoklama Davranışı

Yoklamayı başlatmak için şu yöntemlerden birini çağırın:

Bu yöntemlerden birini çağırdığınızda, URI hemen yoklanır ve kutucuk veya rozet alınan içeriklerle güncelleştirilir. Bu ilk yoklamadan sonra, Windows istenen aralıkta güncelleştirmeleri sağlamaya devam eder. Siz açıkça durdurana kadar yoklama devam eder (TileUpdater.StopPeriodicUpdate), uygulamanız kaldırılır veya ikincil kutucuk söz konusu olduğunda kutucuk kaldırılır. Aksi takdirde, uygulamanız bir daha başlatılmasa bile Windows kutucuğunuzda veya rozetinizde yapılan güncelleştirmeleri yoklama işlemine devam eder.

Yinelenme aralığı

Yineleme aralığını yukarıda listelenen yöntemlerin parametresi olarak belirtirsiniz. Windows istenen şekilde yoklama yapmak için en iyi çabayı gösterse de aralığın kesin olmadığını unutmayın. İstenen yoklama aralığı Windows'un takdirine bağlı olarak 15 dakikaya kadar gecikebilir.

Başlangıç saati

İsteğe bağlı olarak, yoklamanın başlaması için günün belirli bir saatini belirtebilirsiniz. Kutucuk içeriğini günde bir kez değiştiren bir uygulama düşünün. Böyle bir durumda, bulut hizmetinizi güncelleştirdiğiniz zamana yakın bir anket yapmanızı öneririz. Örneğin, günlük alışveriş sitesi günün tekliflerini 08:00'de yayımlıyorsa, 08:00'in hemen ardından yeni kutucuk içeriğini yoklayın.

Bir başlangıç zamanı sağlarsanız, yönteme yapılan ilk çağrı içeriği hemen denetler. Ardından, sağlanan başlangıç saatinden itibaren 15 dakika içinde normal yoklama başlar.

Otomatik yeniden deneme davranışı

URI yalnızca cihaz çevrimiçi olduğunda yoklanır. Ağ kullanılabilir durumdaysa ancak URI ile herhangi bir nedenle bağlantı kurulamıyorsa, yoklama aralığının bu yinelemesi atlanır ve URI bir sonraki aralıkta yeniden yoklanır. Yoklama aralığına ulaşıldığında cihaz kapalı, uyku veya hazırda bekleme durumundaysa, cihaz kapalı veya uyku durumundan döndüğünde URI yoklanır.

Uygulama güncelleştirmelerini işleme

Yoklama URI'nizi değiştiren bir uygulama güncellemesi yayınlarsanız, kutucuklarınızın yeni URI'yi kullandığından emin olmanız için StartPeriodicUpdate'i yeni URI ile çağıran günlük bir zaman tetikleyicisi arka plan görevi eklemeniz gerekir. Aksi takdirde, kullanıcılar uygulama güncelleştirmenizi alır ancak uygulamanızı başlatmazlarsa kutucukları eski URI'yi kullanmaya devam eder. Bu, URI artık geçersizse veya döndürülen yük artık mevcut olmayan yerel görüntülere başvuruyorsa görüntülenmeyebilir.

Karo ve rozet bildirimlerinin süresinin dolması

Varsayılan olarak, düzenli kutucuk ve rozet bildirimlerinin süresi, indirildikten üç gün sonra dolar. Bildirimin süresi dolduğunda içerik rozetten, kutucuktan veya kuyruktan kaldırılır ve artık kullanıcıya gösterilmez. İçeriğin ilgili olduğundan daha uzun süre kalıcı olmamasını sağlamak için, uygulamanız veya bildiriminiz için anlamlı bir zaman kullanarak tüm düzenli kutucuk ve rozet bildirimlerinde açık bir süre sonu ayarlamak en iyi yöntemdir. Açık bir süre sonu süresi, tanımlı yaşam süresine sahip içerik için gereklidir. Ayrıca bulut hizmetinize ulaşılamaz hale gelirse veya kullanıcı ağ bağlantısını uzun bir süre için keserse eski içeriğin kaldırılmasını sağlar.

Bulut hizmetiniz, yanıt yüküne X-WNS-Expires HTTP üst bilgisini ekleyerek bildirim için bir süre sonu tarihi ve saati ayarlar. X-WNS-Expires HTTP üst bilgisi HTTP tarih biçimine uygundur. Daha fazla bilgi için bkz. StartPeriodicUpdate veya StartPeriodicUpdateBatch.

Örneğin, bir borsanın etkin işlem gününde hisse senedi fiyat güncelleştirmesinin süre sonunu yoklama aralığınızın iki katı olarak ayarlayabilirsiniz (örneğin, yarım saatte bir yoklama yaparsanız alındıktan sonraki bir saat). Başka bir örnek olarak, bir haber uygulaması bir günlük haber kutucuğu güncelleştirmesi için uygun bir son kullanma süresi olduğunu belirleyebilir.

Bildirim kuyruğundaki düzenli bildirimler

bildirim döngüsüile düzenli kutucuk güncelleştirmelerini kullanabilirsiniz. Varsayılan olarak, Başlangıç ekranındaki bir kutucuk, yeni bir bildirimle değiştirilene kadar tek bir bildirimin içeriğini gösterir. Döngüyü etkinleştirdiğinizde, bir kuyrukta en fazla beş bildirim tutulur ve kutucuk bu bildirimler arasında döngü yapar.

Kuyruk beş bildirim kapasitesine ulaştıysa, sonraki yeni bildirim kuyruktaki en eski bildirimin yerini alır. Ancak bildirimlerinizde etiketleri ayarlayarak kuyruğun değiştirme ilkesini etkileyebilirsiniz. Etiket, yanıt yükündeki X-WNS-Tag HTTP üst bilgisinde belirtilen, en fazla 16 alfasayısal karakterden oluşan uygulamaya özgü, büyük/küçük harfe duyarlı olmayan bir dizedir. Windows, gelen bildirimin etiketini kuyrukta bulunan tüm bildirimlerin etiketleriyle karşılaştırır. Eşleşme bulunursa, yeni bildirim kuyruğa alınan bildirimi aynı etiketle değiştirir. Eşleşme bulunmazsa varsayılan değiştirme kuralı uygulanır ve yeni bildirim kuyruktaki en eski bildirimin yerini alır.

Çeşitli zengin bildirim senaryoları uygulamak için bildirim kuyruğa alma ve etiketlemeyi kullanabilirsiniz. Örneğin, bir hisse senedi uygulaması her birinin farklı bir hisse senedi hakkında ve her birinin bir hisse senedi adıyla etiketlenmiş olduğu beş bildirim gönderebilir. Bu, kuyruğun aynı hisse senedi için tarihi geçmiş olan iki bildirim içermesini önler.

Daha fazla bilgi için bkz. Bildirim Kuyruğu Kullanımı.

Bildirim kuyruğu etkinleştirme

Bildirim kuyruğu uygulamak için önce kutucuğunuz için kuyruğu etkinleştirin (bkz. Yerel bildirimlerle bildirim kuyruğu kullanma). Kuyruğu etkinleştirme çağrısının uygulamanızın ömrü boyunca yalnızca bir kez yapılması gerekir, ancak uygulamanız her başlatıldığında çağrılmasında bir sakınca yoktur.

Aynı anda birden fazla bildirim için yoklama

Windows'un kutucuğunuz için indirmesini istediğiniz her bildirim için benzersiz bir URI sağlamanız gerekir. StartPeriodicUpdateBatch yöntemini kullanarak, bildirim kuyruğuyla kullanmak üzere aynı anda en fazla beş URI sağlayabilirsiniz. Her bir URI, aynı anda veya yakın bir zamanda, tek bir bildirim yükü için sorgulanır. Anket yapılan her URI kendi sona erme süresi ve etiket değerini döndürebilir.

  • Last updated on