Attention ! Les nouveaux programmes Preview développeur seront bientôt disponibles. Inscrivez-vous ici et soyez l'un des premiers à essayer les nouveaux outils et donner votre avis.

Google Home Playground

Cloud à cloud    SDK Local Home    SDK de l'appareil

Google Home Playground est une application Web qui vous permet de simuler un projet de maison connectée en simulant une maison virtuelle avec des types d'appareils et des caractéristiques configurables. Google Home Playground vous permet de créer des appareils virtuels, de modifier leurs attributs et leurs états, de les afficher dans Google Home Graph, et d'importer ou d'exporter des configurations d'appareils.

Finaliser l'association du compte

Pour utiliser Google Home Playground, nous vous recommandons d'associer d'abord l'outil à votre compte. Ouvrez Google Home app (GHA) sur votre téléphone, puis suivez le processus d'association de compte:

  1. Cliquez sur l'icône Plus (+) dans l'angle supérieur gauche.
  2. Sélectionnez Configurer un appareil > Fonctionne avec Google.
  3. Recherchez l'action intitulée Google Home Playground.
  4. Sélectionnez l'action. GHA vous redirigera vers la page de connexion. Cliquez sur Se connecter avec Google et sélectionnez votre compte pour vous connecter.
  5. Cliquez sur le bouton Autoriser pour autoriser l'association du compte.
Cette figure illustre le parcours d'association de compte Google Home pour connecter Google Home Playground.

Une fois l'association du compte terminée, un ensemble d'appareils virtuels par défaut s'affiche sur le GHA pour que vous puissiez interagir.

Cette figure montre la liste des appareils par défaut qui s'affiche lorsqu'un utilisateur associe Google Home Playground à son compte.

Se connecter

Lancez Google Home Playground en cliquant sur le bouton ci-dessous:

Lancer Playground

Cliquez sur Sign in with Google (Se connecter avec Google). Veillez à vous connecter avec le compte que vous avez utilisé dans GHA pour associer le compte.

Cette figure montre l'état initial de Google Home Playground et le bouton de connexion en haut à droite.

Une fois que vous êtes connecté, Google Home Playground affiche les appareils virtuels stockés dans Home Graph.

Cette figure montre la liste des appareils, les informations sur les appareils et la zone de journalisation dans la vue par défaut de Google Home Playground.

L'interface utilisateur Web comprend trois panneaux:

  • La liste des appareils affiche tous vos appareils virtuels. Vous pouvez sélectionner un appareil virtuel spécifique pour afficher ses informations et créer des appareils virtuels via ce panneau.
  • Informations sur l'appareil : présente les informations sur l'appareil virtuel sélectionné. Vous pouvez également modifier ces informations et supprimer l'appareil virtuel sélectionné via le panneau.
  • Zone de journal affiche les journaux d'interaction entre Google Home Playground et Home Graph. Vous pouvez développer les journaux pour inspecter les charges utiles de requête et de réponse à des fins de dépannage.

Appareil virtuel

Afficher les informations sur les appareils virtuels

Dans le panneau Liste des appareils, sélectionnez l'appareil virtuel que vous souhaitez afficher. Les informations affichées dans le panneau Informations sur l'appareil sont réparties dans cinq onglets:

  • Informations générales:propriétés de premier niveau de l'appareil, y compris son type, son ID et son nom.
  • Traits:caractéristiques compatibles de l'appareil.
  • Attributs:caractéristiques de l'appareil
  • États:tous les états de l'appareil.
  • SUV:configuration de la validation utilisateur secondaire de l'appareil.

Modifier les informations des appareils virtuels

En plus d'afficher les informations d'un appareil virtuel, vous pouvez également modifier directement ses informations stockées dans Home Graph via le panneau Informations sur l'appareil.

Modifier les caractéristiques acceptées

  1. Sélectionnez l'onglet Traits (Traits), puis cliquez sur le bouton Edit (Modifier).
  2. Le panneau pop-up présente les caractéristiques actuellement compatibles avec l'appareil et les caractéristiques disponibles à ajouter. Utilisez les boutons flèche (arrow_forward/arrow_back) pour ajouter ou supprimer des caractéristiques compatibles avec l'appareil.
  3. Lorsque vous avez terminé de mettre à jour les caractéristiques prises en charge, cliquez sur Enregistrer. Les caractéristiques mises à jour seront appliquées à Home Graph.
  4. Vous pouvez consulter ces mises à jour des caractéristiques dans la zone de journal.
Cette figure montre l'outil d'expérience utilisateur permettant d'ajouter ou de supprimer des caractéristiques compatibles sur un appareil sélectionné dans Google Home Playground.

Modifier les attributs de l'appareil

  1. Sélectionnez l'onglet Informations générales/attributs, puis modifiez l'attribut pour les caractéristiques compatibles avec l'appareil.
  2. Une fois les modifications terminées, appuyez sur Entrée. Les modifications apportées à vos attributs seront appliquées à Home Graph.
  3. Vous pouvez afficher ces attributs mis à jour dans la zone de journal.

Modifier les états des appareils

  1. Sélectionnez l'onglet States (États) et modifiez l'état directement. Les changements d'état seront appliqués à Home Graph.
  2. Vous pouvez afficher ces changements d'état dans la zone de journal.

Ajouter une validation d'utilisateur secondaire à un appareil virtuel

Vous pouvez ajouter un SUV à des appareils virtuels et configurer le type d'authentification et le comportement correspondant sur chaque appareil.

Configurer un SUV sur l'appareil

  1. Dans le panneau Liste d'appareils, sélectionnez l'appareil virtuel que vous souhaitez configurer.
  2. Dans le panneau Informations sur l'appareil, sélectionnez l'onglet SUV et configurez les éléments suivants :
    • Activé:indique si le SUV est activé ou désactivé (aucun défi) sur l'appareil.
    • Type de défi:indique si le SUV nécessite un accusé de réception explicite (ackNeeded) ou un numéro d'identification personnel (pinNeeded).
    • Code:code valide.
    • Gestion des codes incorrects:lorsqu'il s'agit d'un code incorrect, indiquez si l'utilisateur doit se poser à nouveau la question et, dans le cas contraire, si l'erreur est requise.
Cette figure montre l'outil d'expérience utilisateur permettant d'activer les caractéristiques de validation des utilisateurs secondaires sur un appareil sélectionné dans Google Home Playground.

Identifier les appareils qui permettent le SUV

Dans le panneau Liste des appareils, une icône en forme de clé key s'affiche à côté de chaque appareil compatible avec SUV.

Cette figure présente les appareils recommandés pour activer la validation secondaire de l'utilisateur.

La liste suivante de caractéristiques nécessite un SUV:

Créer un appareil virtuel

  1. Dans le panneau Liste des appareils, cliquez sur Ajouter un appareil.
  2. Dans le panneau pop-up, sélectionnez le type d'appareil et saisissez le nom de votre nouvel appareil. Vous pouvez également sélectionner un ensemble prédéfini d'appareils à ajouter.
  3. Une fois toutes les étapes terminées, le nouvel appareil est ajouté à Home Graph.
Cette figure illustre l'outil d'expérience utilisateur permettant d'ajouter un type d'appareil dans Google Home Playground.

Supprimer un appareil virtuel

  1. Dans le panneau Liste des appareils, sélectionnez l'appareil que vous souhaitez supprimer. Ensuite, dans le panneau Informations sur l'appareil, sélectionnez l'onglet Informations générales et cliquez sur Icône CorbeilleSupprimer l'appareil en bas.
  2. Confirmez la suppression de l'appareil dans l'alerte pop-up.
  3. Une fois que vous avez confirmé la suppression de l'appareil, celui-ci est supprimé de Home Graph.
Cette figure montre l'outil d'expérience utilisateur permettant de supprimer un type d'appareil virtuel dans Google Home Playground.

Importer et exporter des appareils virtuels

Pour résoudre les problèmes ou reproduire les problèmes, vous pouvez exporter vos appareils virtuels avec leur état dans un fichier, puis le partager avec d'autres utilisateurs pour importer et répliquer vos appareils virtuels.

Cette figure illustre l'outil d'expérience utilisateur permettant d'importer et d'exporter des appareils virtuels dans Google Home Playground.

Exporter des appareils virtuels vers un fichier

  1. Cliquez sur pour exporter des appareils virtuels vers un fichier.
  2. Saisissez le nom du fichier que vous souhaitez exporter, puis cliquez sur OK.
  3. Une fois le nom du fichier saisi, le navigateur télécharge le fichier des appareils virtuels exportés.

Importer des appareils virtuels à partir d'un fichier

  1. Cliquez sur pour importer des appareils virtuels à partir d'un fichier.
  2. Sélectionnez le fichier que vous souhaitez importer, puis cliquez sur OK.
  3. Une fois que vous avez confirmé le fichier à importer, Google Home Playground importe les appareils virtuels avec les états du fichier, et met à jour les informations et les états des appareils importés dans Home Graph.

Inspecter les journaux d'interaction

Lorsque vous interagissez avec les appareils virtuels, Google Home Playground applique automatiquement votre modification à Home Graph. Les interactions avec Home Graph sont enregistrées dans le panneau Zone de journal, où vous pouvez développer chaque entrée pour inspecter les charges utiles de requête et de réponse de l'API Home Graph.

Chaque entrée de journal est un tableau JSON contenant des éléments de la structure suivante:

{
  "uri": string,
  "request": object,
  "response": object
}
Champs Type Description
uri string URL de l'appel d'API Home Graph.
request object Corps de la requête de l'appel d'API Home Graph. Consultez la documentation de référence pour connaître le format de chaque méthode.
response object Corps de la réponse de l'appel d'API Home Graph. Consultez la documentation de référence pour connaître le format de chaque méthode.

Afficher les types d'appareils et les caractéristiques compatibles

L'icône du point d'interrogation aide en haut à droite affiche le type d'appareil et la liste de caractéristiques compatibles avec Google Home Playground.

Cette figure illustre l'outil d'expérience utilisateur permettant d'ajouter un type d'appareil dans Google Home Playground.

Commentaires et problèmes

Votre avis nous intéresse ! N'hésitez pas à nous faire part de vos commentaires. Pour ce faire, cliquez sur l'icône représentant un smiley sentiment_satisfaction en haut à droite, ou signalez-nous le problème à l'aide de l'icône en forme de point d'exclamation feedback.

Cette icône montre les icônes permettant de signaler et de signaler les problèmes dans Google Home Playground.