Guida introduttiva: Visualizzazione degli aggiornamenti di riquadri e notifiche nella schermata di blocco (app di Windows Runtime)

[ 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 ]

In questo argomento viene illustrato come abilitare l'app per mostrare notifiche e notifiche di tipo riquadro nella schermata di blocco. Non esiste una procedura speciale per l'invio di una notifica alla schermata di blocco. Le notifiche visualizzate sulla schermata di blocco sono le stesse che vengono visualizzate sulla schermata Start. Le notifiche di tipo avviso popup vengono visualizzate sulla schermata di blocco senza impostazioni specifiche.

Prerequisiti

Per comprendere questo argomento, devi disporre di:

• Conoscenza operativa di termini e concetti correlati a riquadri e notifiche. Per altre informazioni, vedi Riquadri, notifiche e avvisi.
• Familiarità con lo schema XML per riquadri. Per altre informazioni, vedi Schema del riquadro.
• 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 riquadro predefinito esistente per l'app, definito nel manifesto dell'app. Per altre informazioni, vedi Guida introduttiva: Creazione di un riquadro predefinito tramite l'editor del manifesto di Visual Studio.
• Familiarità con XML e la relativa manipolazione tramite API Document Object Model (DOM).

Istruzioni

1. Dichiarare il tipo di presenza della schermata di blocco per l'app

Le funzionalità di blocco schermo sono dichiarate nel file package.appxmanifest dell'app. Se usi l'editor del manifesto di Visual Studio, devi solo scegliere l'opzione Notifiche schermata di blocco appropriata nella scheda Applicazione.

L'esempio seguente mostra l'XML incluso nel file package.appxmanifest dopo la scelta dell'opzione. L'elemento LockScreen viene aggiunto come nodo figlio dell'elemento VisualElements del manifesto.

L'XML mostrato qui è anche quello usato se stai creando direttamente il file package.appxmanifest, all'esterno di Visual Studio. Per altre informazioni, vedi Come creare manualmente un manifesto del pacchetto.

<VisualElements 
    ...
    <LockScreen Notification="badge" BadgeLogo="images\logo-lockscreen.png"/>
    ...
</VisualElements>

<VisualElements 
    ...
    <LockScreen Notification="badgeAndTileText" BadgeLogo="images\logo-lockscreen.png"/>
    ...
</VisualElements>

2. Dichiarare un'immagine logo della notifica

L'esempio seguente illustra la dichiarazione XML dell'attributo BadgeLogo dell'elemento LockScreen. Tieni presente che questo valore viene in genere impostato tramite Visual Studio Express e non manualmente. Per informazioni sui requisiti dell'immagine, vedi Panoramica della schermata di blocco.

<VisualElements 
    ...
    <LockScreen Notification="badge" BadgeLogo="images\logo-lockscreen.png"/>
    ...
</VisualElements>

3. Dichiarare un'attività in background

Un'app presente nella schermata di blocco deve dichiarare uno dei tipi di attività in background che seguono:

• Canale di controllo (solo Windows)
• Timer
• Notifica push

In Visual Studio questo valore è impostato nella pagina Dichiarazioni dell'editor del manifesto.

1. Scegli "Attività di background" dall'elenco a discesa.
2. Fai clic sul pulsante Aggiungi.
3. Seleziona gli elementi appropriati dall'elenco Proprietà e aggiungi tutte le informazioni aggiuntive richieste dalle scelte effettuate.

Nell'XML del manifesto questo valore viene dichiarato nell'elemento BackgroundTasks.

Per altre informazioni sulle attività in background, vedi il white paper Introduzione alle attività in background.

4. Specificare un logo grande

Se scegli il valore badgeAndTileText nel passaggio 1, devi specificare un logo grande come parte del riquadro predefinito dell'app. Se l'utente ha impostato il riquadro nella schermata di blocco e ha scelto di visualizzare lo stato dettagliato, viene usato un riquadro grande. I riquadri grandi e medi non sono usati nella schermata di blocco, pertanto le notifiche inviate senza un'associazione ampia non vengono visualizzate sulla schermata di blocco.

Puoi specificare un'immagine logo grande tramite l'editor del manifesto di Visual Studio o nel codice XML del manifesto come mostrato qui.

<VisualElements 
    ...
    <DefaultTile ShortName="Tiles JS" ShowName="allLogos" WideLogo="images\tile-sdk.png"/>
    ...
</VisualElements>

Riepilogo e passaggi successivi

Dopo aver completato i passaggi sopra, il riquadro può essere visualizzato nella schermata di blocco se viene scelto dall'utente. Dopo la procedura dettagliata illustrata in questo argomento l'app viene elencata come app con schermata di blocco nelle Impostazioni del dispositivo. L'utente ha la possibilità di scegliere quali delle app mostrare nella schermata di blocco e per quali di esse visualizzare lo stato dettagliato tramite testo.

Argomenti correlati

Panoramica della schermata di blocco

Esempio di app nella schermata di blocco

Linee guida ed elenco di controllo per i riquadri e le notifiche