Guida introduttiva: Impostazione di notifiche periodiche (HTML)
[ Questo articolo è rivolto agli sviluppatori per Windows 8.x e Windows Phone 8.x che realizzano app di Windows Runtime. Gli sviluppatori che usano Windows 10 possono vedere Documentazione aggiornata ]
Nota Se non usi JavaScript, vedi Guida introduttiva: Impostazione di notifiche periodiche (XAML).
In questo argomento viene illustrato come avviare il polling periodico di un URL per recuperare contenuto aggiornato per il riquadro dell'app.
È consigliabile che tutte le notifiche di cui è stato eseguito il polling usino l'intestazione di risposta X-WNS-Expires HTTP per impostare un tempo di scadenza esplicito. Per altre informazioni sull'impostazione dell'intestazione di risposta X-WNS-Expires, vedi TileUpdater.StartPeriodicUpdate o TileUpdater.StartPeriodicUpdateBatch.
Nota In questa Guida introduttiva manipolerai il contenuto della notifica direttamente mediante XML Document Object Model (DOM). Un approccio alternativo è disponibile tramite la libreria NotificationsExtensions, che presenta il contenuto XML come proprietà dell'oggetto, incluso Intellisense. Per altre informazioni, vedi Guida introduttiva: Uso della raccolta NotificationsExtensions nel codice. Per vedere il codice riportato in questa guida introduttiva usando NotificationsExtensions, vedi l'Esempio di notifiche push e periodiche.
Prerequisiti
- Conoscenza operativa di termini e concetti correlati a riquadri e notifiche. Per altre informazioni, vedi Riquadri, notifiche e avvisi.
- Familiarità con i concetti relativi alle notifiche periodiche (polling). Per altre informazioni, vedi Panoramica delle notifiche periodiche.
- Capacità di creare un'app di Windows Store di base in JavaScript usando le API Windows Runtime. Per ulteriori informazioni, vedi Creare la prima app di Windows Store scritta in JavaScript.
- Un servizio Web per ospitare il contenuto della notifica di tipo riquadro
Istruzioni
1. Crea o identifica un servizio Web per ospitare il contenuto XML del riquadro
A intervalli specificati, Windows esegue il polling al servizio Web indicato per recuperare contenuto aggiornato per il riquadro dell'app. Il servizio Web deve supportare il protocollo HTTP. A fini di testing, puoi inoltre configurare un servizio Web, ad esempio Microsoft Internet Information Services (IIS) nel computer locale per verificare il codice XML.
2. Inserisci il file XML dei contenuti del riquadro in un percorso accessibile dal Web
Il servizio Web ospiterà il contenuto XML del riquadro. Per iniziare, ospita l'XML del riquadro illustrato qui nel tuo sito Web. Salva il contenuto come file denominato Tile.xml e inserisci il file nel server in un percorso accessibile dal Web, ad esempio http://www.fabrikam.com/tile.xml. I contenuti del documento XML devono usare una codifica UTF-8 ed essere conformi allo schema del riquadro. Devi aggiornare questo XML con una frequenza almeno pari all'intervallo di ricorrenza specificato per il polling.
<tile>
<visual version="2">
<binding template="TileSquare150x150Text04" fallback="TileSquareText04">
<text id="1">Hello world!</text>
</binding>
</visual>
</tile>
3. Iniziare gli aggiornamenti periodici (singolo URL)
In questo esempio viene illustrato come avviare il polling di un singolo URL per il nuovo contenuto una volta ogni ora. Questo codice usa una variabile definita in precedenza e chiamata polledUrl, che è una stringa che specifica l'URL di cui eseguire il polling.
var notifications = Windows.UI.Notifications;
var recurrence = notifications.PeriodicUpdateRecurrence.hour;
var url = new Windows.Foundation.Uri(polledUrl);
notifications.TileUpdateManager.createTileUpdaterForApplication().startPeriodicUpdate(url, recurrence);
4. Iniziare gli aggiornamenti periodici (più URL)
In alternativa al passaggio precedente, Windows è in grado di eseguire il polling di un massimo di cinque URL diversi per fornire un set di contenuti che viene visualizzato a rotazione nella coda di notifica del riquadro.
In questo esempio viene illustrato come avviare il polling di più URL per il nuovo contenuto una volta ogni ora. Devi innanzitutto abilitare la coda di notifica, se non lo hai già fatto in precedenza. Nota che enableNotificationQueue si può richiamare solo una volta dopo che l'utente installa l'app o crea un riquadro secondario. Questo codice di esempio usa una variabile definita precedentemente, denominata urisToPoll, che è una matrice degli oggetti Windows.Foundation.Uri.
Nota Gli aggiornamenti periodici dei riquadri supportano il tag notifica che fa parte della logica delle sostituzioni per la coda notifiche. Il servizio può impostare il tag su ogni notifica specificando l'intestazione di risposta HTTP X-WNS-Tag. Per altre informazioni sull'uso dei tag e della coda di notifica, vedi Come usare la coda notifiche con le notifiche locali. Per altre informazioni sull'uso dell'intestazione di risposta HTTP X-WNS-Tag con le notifiche periodiche, vedi TileUpdater.startPeriodicUpdateBatch.
var notifications = Windows.UI.Notifications;
var recurrence = notifications.PeriodicUpdateRecurrence.hour;
notifications.TileUpdateManager.createTileUpdaterForApplication().enableNotificationQueue(true);
notifications.TileUpdateManager.createTileUpdaterForApplication().startPeriodicUpdateBatch(urisToPoll, recurrence);
Riepilogo e passaggi successivi
In questa guida introduttiva ti è stata illustrata la procedura per impostare una notifica di riquadro periodica.Puoi usare la stessa tecnica per le notifiche di badge.
Argomenti correlati
Esempio di notifiche push e periodiche