Přehled pravidelných oznámení

Pravidelná oznámení, která se také označují jako dotazovaná oznámení, aktualizují dlaždice a odznáčky v pevném intervalu stažením obsahu z cloudové služby. Aby bylo možné používat pravidelná oznámení, musí kód klientské aplikace poskytnout dva údaje:

  • URI (Uniform Resource Identifier) webového umístění, na které se Windows dotazuje kvůli aktualizacím dlaždic nebo odznaků pro vaši aplikaci.
  • Jak často by měl být URI dotazován

Pravidelná oznámení umožňují vaší aplikaci získávat aktualizace živých dlaždic s minimálními investicemi do cloudových služeb a klientů. Pravidelná oznámení představují dobrou metodu doručení pro distribuci stejného obsahu široké cílové skupině.

Note

Ukázka nabízených oznámení Windows App SDK ukazuje aktuální registraci kanálu a chování nabízené aktivace. Neimplementuje zastaralé pravidelné zjišťování aktualizací dlaždic nebo odznaků popsané na této stránce.

 

Jak to funguje

Pravidelná oznámení vyžadují, aby vaše aplikace hostuje cloudovou službu. Služba bude pravidelně dotazována všemi uživateli, kteří mají aplikaci nainstalovanou. V každém intervalu dotazování, například jednou za hodinu, systém Windows odešle požadavek HTTP GET na identifikátor URI, stáhne požadovaný obsah dlaždice nebo odznaku (jako XML), který je poskytnutý jako odpověď na požadavek, a zobrazí obsah na dlaždici aplikace.

Upozorňujeme, že pravidelné aktualizace nelze použít s informačními oznámeními typu "toast". Informační zpráva je nejlepší doručovat prostřednictvím naplánovaných nebo nabízených oznámení.

Umístění identifikátoru URI a obsah XML

Jako identifikátor URI, který se má dotazovat, lze použít libovolnou platnou webovou adresu HTTP nebo HTTPS.

Odpověď cloudového serveru zahrnuje stažený obsah. Obsah vrácený z identifikátoru URI musí vyhovovat specifikaci schématu XML buď pro dlaždici, nebo pro odznáček, a musí být kódován v UTF-8. Definované hlavičky HTTP můžete použít k určení času vypršení platnosti nebo značky pro oznámení.

Chování dotazování

Voláním jedné z těchto metod zahájíte dotazování:

Při volání jedné z těchto metod je URI okamžitě dotazován a dlaždice nebo odznak se aktualizuje s přijatým obsahem. Po tomto počátečním hlasování systém Windows nadále poskytuje aktualizace v požadovaném intervalu. Dotazování pokračuje, dokud ho explicitně nezastavíte (s TileUpdater.StopPeriodicUpdate), vaše aplikace se odinstaluje nebo v případě sekundární dlaždice se dlaždice odebere. Jinak Windows průběžně kontroluje aktualizace pro vaši dlaždici nebo odznáček, i když se vaše aplikace nikdy znovu nespustí.

Doba návratnosti

Jako parametr výše uvedených metod zadáte interval opakování. Mějte na paměti, že přestože se systém Windows snaží provádět dotazování podle vašeho požadavku, interval není přesný. Požadovaný interval dotazování může být zpožděn až o 15 minut podle uvážení Windows.

Čas zahájení

Volitelně můžete zadat konkrétní denní čas, který se má zahájit dotazování. Představte si aplikaci, která změní obsah dlaždice jen jednou denně. V takovém případě doporučujeme, abyste prováděli dotazování těsně před tím, než aktualizujete cloudovou službu. Pokud e-shop publikuje nabídky dne v 8:00, ověřte nový obsah dlaždic krátce po 8:00.

Pokud zadáte počáteční čas, první volání metody si okamžitě vyžádá obsah. Pak se pravidelné dotazování spustí do 15 minut od zadaného času zahájení.

Automatické chování při opakování pokusu

Identifikátor URI se dotazuje jenom v případě, že je zařízení online. Pokud je síť dostupná, ale identifikátor URI nelze z nějakého důvodu kontaktovat, tato iterace intervalu dotazování se přeskočí a identifikátor URI se znovu dotazuje v dalším intervalu. Pokud je zařízení ve stavu vypnuto, v režimu spánku nebo hibernace při dosažení intervalu dotazování, identifikátor URI se dotazuje, když se zařízení vrátí ze stavu vypnuto nebo do režimu spánku.

Zpracování aktualizací aplikací

Pokud vydáte aktualizaci aplikace, která změní identifikátor URI dotazování, měli byste přidat denní úlohu na pozadí s časovým spouštěčem která volá StartPeriodicUpdate s novým identifikátorem URI, aby se zajistilo, že dlaždice používají nový identifikátor URI. Jinak platí, že pokud uživatelé obdrží aktualizaci vaší aplikace, ale nespustí ji, jejich dlaždice budou ještě stále používat starý identifikátor URI, který se nemusí zobrazit, pokud je identifikátor URI nyní neplatný, nebo pokud vrácená datová část odkazuje na místní obrázky, které už neexistují.

Vypršení platnosti oznámení o dlaždicích a odznáčcích

Ve výchozím nastavení platnost pravidelných oznámení o dlaždici a odznaku vyprší tři dny po jejich stažení. Po vypršení platnosti oznámení se obsah odebere z odznáčku, dlaždice nebo fronty a už se uživateli nezobrazuje. Osvědčeným postupem je nastavit explicitní dobu vypršení platnosti u všech pravidelných oznámení o dlaždicích a odznáček pomocí času, který dává smysl pro vaši aplikaci nebo oznámení, aby se zajistilo, že se obsah neuchovává déle, než je relevantní. Explicitní doba vypršení platnosti je nezbytná pro obsah s definovaným životním rozsahem. Zajišťuje také odebrání zastaralého obsahu, pokud je cloudová služba nedostupná nebo pokud se uživatel po delší dobu odpojí od sítě.

Vaše cloudová služba nastaví datum a čas vypršení platnosti oznámení zahrnutím hlavičky PROTOKOLU HTTPWNS-Expires X do datové části odpovědi. HTTP hlavička X-WNS-Expires odpovídá formátu HTTP-datum . Další informace naleznete v tématu StartPeriodicUpdate nebo StartPeriodicUpdateBatch.

Například během aktivního obchodního dne burzovního trhu můžete nastavit vypršení platnosti aktualizace ceny akcií na dvojnásobek intervalu dotazování (například jednu hodinu po potvrzení, pokud se dotazujete každou půlhodinu). V dalším příkladu může aplikace zpráv určit, že jeden den je vhodnou dobou vypršení platnosti pro denní aktualizaci dlaždice zpráv.

Pravidelná oznámení ve frontě oznámení

Pravidelné aktualizace dlaždic můžete používat s cyklováním oznámení . Dlaždice na úvodní obrazovce standardně zobrazuje obsah jednoho oznámení, dokud se nenahradí novým oznámením. Když povolíte cyklistiku, ve frontě se udržuje až pět oznámení a dlaždice je prochází.

Pokud fronta dosáhla své kapacity pěti oznámení, nahradí další nové oznámení nejstarší oznámení ve frontě. Nastavením značek u oznámení ale můžete ovlivnit zásady nahrazení fronty. Značka je řetězec nerozlišující velká a malá písmena až 16 alfanumerických znaků zadaný v X-WNS-Tag hlavičce HTTP v odpovědi. Systém Windows porovná značku příchozího oznámení se značkami všech oznámení, která už jsou ve frontě. Pokud se najde shoda, nové oznámení nahradí to oznámení ve frontě, které má stejnou značku. Pokud se nenajde žádná shoda, použije se výchozí pravidlo nahrazení a nové oznámení nahradí nejstarší oznámení ve frontě.

K implementaci různých scénářů pokročilých oznámení můžete použít označování a řazení do front. Například aplikace s akciemi může posílat pět oznámení, každá z nich o různých akciích a každá označená názvem akcií. Tím se zabrání tomu, aby fronta někdy obsahovala dvě oznámení pro stejnou skladovou položku, z nichž to starší je zastaralé.

Další informace najdete v tématu Použití fronty oznámení.

Povolení fronty oznámení

Pokud chcete implementovat frontu oznámení, nejprve povolte frontu pro svou dlaždici (viz Jak používat frontu oznámení s místními oznámeními). Volání pro povolení fronty musí být provedeno pouze jednou v průběhu životnosti vaší aplikace, ale při každém spuštění aplikace to není na škodu.

Dotazování na více než jedno oznámení najednou

Musíte zadat jedinečný identifikátor URI pro každé oznámení, které chcete, aby systém Windows stáhl pro vaši dlaždici. Pomocí metody StartPeriodicUpdateBatch můžete zadat až pět identifikátorů URI najednou pro použití s frontou oznámení. Každý identifikátor URI se dotazuje na jednu datovou část oznámení ve stejnou dobu nebo téměř najednou. Každý dotazovaný identifikátor URI může vrátit vlastní hodnotu vypršení platnosti a značky.

  • Last updated on