Démarrage rapide : affichage des mises à jour des vignettes et des badges sur l’écran de verrouillage (applications Windows Runtime)

[ Cet article est destiné aux développeurs de Windows 8.x et Windows Phone 8.x qui créent des applications Windows Runtime. Si vous développez une application pour Windows 10, voir la Documentation ]

Cette rubrique explique comment autoriser votre application à afficher des notifications de badge et par vignette sur l’écran de verrouillage. Notez qu’il n’existe aucune procédure spéciale pour l’envoi de notification à l’écran de verrouillage. Les notifications affichées sur l’écran de verrouillage sont identiques à celles de l’écran d’accueil. Les notifications toast apparaissent sur l’écran de verrouillage sans paramètres spéciaux.

Prérequis

Conditions préalables à la compréhension de cette rubrique :

• Bonnes connaissances des termes et des concepts de vignette et de notification. Pour plus d’informations, voir Vignettes, badges et notifications.
• Bonne connaissance du schéma XML de vignette. Pour plus d’informations, voir Schéma des vignettes.
• Aptitude à créer une application élémentaire Windows Store en JavaScript à l’aide des API Windows Runtime. Pour plus d’informations, voir Créer votre première application du Windows Store en JavaScript.
• Vignette par défaut existante pour votre application, définie dans son manifeste. Pour plus d’informations, voir Démarrage rapide : création d’une vignette par défaut à l’aide de l’éditeur de manifeste de Microsoft Visual Studio.
• Bonne connaissance du langage XML et de sa manipulation via les API DOM (Document Object Model).

Instructions

1. Déclarer le type de présence sur l’écran de verrouillage pour votre application

Les fonctionnalités d’écran de verrouillage sont déclarées dans le fichier package.appxmanifest de votre application. Si vous utilisez l’éditeur de manifeste Visual Studio, choisissez l’option Notifications de verrouillage de l’écran appropriée sous l’onglet Application.

L’exemple suivant montre le code XML qui est inséré au fichier package.appxmanifest file suite au choix de l’option. L’élément LockScreen est ajouté comme nœud enfant de l’élément VisualElements du manifeste.

Le code XML est également celui utilisé pour créer le fichier package.appxmanifest directement, en dehors de Visual Studio. Pour plus d’informations, voir Comment créer un manifeste de package manuellement.

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

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

2. Déclarer une image de logo de badge

L’exemple suivant affiche la déclaration XML de l’attribut BadgeLogo de l’élément LockScreen. Notez qu’une fois encore, vous définissez généralement cette valeur par le biais de Visual Studio plutôt que manuellement. Pour plus d’informations sur les conditions requises liées aux images, voir Vue d’ensemble des applications d’écran de verrouillage.

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

3. Déclarer une tâche en arrière-plan

Une application présente sur l’écran de verrouillage doit déclarer l’un des types de tâches en arrière-plan suivant :

• Canal de contrôle (Windows uniquement)
• Timer
• Notification Push

Dans Visual Studio, cette valeur est définie dans la page Déclarations de l’éditeur de manifeste.

1. Choisissez « Tâches en arrière plan » dans la liste déroulante.
2. Cliquez sur le bouton Ajouter.
3. Sélectionnez les éléments appropriés dans la liste Propriétés et ajoutez toute information complémentaire requise par vos choix.

Dans le code XML du manifeste, cette valeur est déclarée dans l’élément BackgroundTasks.

Pour plus d’informations sur les tâches en arrière-plan, voir Présentation des tâches en arrière-plan.

4. Spécifiez un grand logo

Si vous choisissez la valeur badgeAndTileText dans l’étape 1, vous devez spécifier une image de grand logo comme faisant partie de la vignette par défaut de l’application. Si l’utilisateur a défini votre vignette sur l’écran de verrouillage et qu’il l’a choisie pour afficher l’état détaillé, une grande vignette est utilisée. Les vignettes moyennes et grandes ne sont pas utilisées sur l’écran de verrouillage, ainsi les notifications par vignette envoyées sans liaison large ne sont pas visibles sur l’écran de verrouillage.

Vous pouvez spécifier une image de grand logo par le biais de l’éditeur de manifeste Visual Studio ou dans le code XML du manifeste comme illustré ici.

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

Récapitulatif et étapes suivantes

Une fois que vous avez accompli les étapes ci-dessus, votre vignette peut maintenant s’afficher sur l’écran de verrouillage, si l’utilisateur le souhaite. À l’issue de la procédure détaillée dans cette rubrique, votre application est spécifiée comme application de l’écran de verrouillage dans les Paramètres de l’appareil. L’utilisateur peut ainsi choisir les applications qu’il souhaite afficher sur l’écran de verrouillage, puis celle parmi elles qui affichera l’état détaillé par le biais de texte.

Rubriques associées

Vue d’ensemble des écrans de verrouillage

Exemple d’applications d’écran de verrouillage

Recommandations et liste de vérification sur les vignettes et les badges