IMPORTANT:Vous devez participer au programme Matter Beta pour commencer à développer des appareils et des applications Litter dans la Google Home Developer Console. S'inscrire maintenant

Aire de jeu domestique

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. Home Playground vous permet de créer des appareils virtuels, de modifier les attributs et les états des appareils, de les afficher dans Google Home Graph, ainsi que d'importer ou d'exporter des configurations d'appareil.

Finaliser l'association du compte

Pour utiliser Home Playground, nous vous recommandons d'associer l'outil à votre compte. Ouvrez Google Home app (GHA) sur votre téléphone et suivez la procédure d'association de compte:

  1. Cliquez sur l'icône + en haut à gauche.
  2. Sélectionnez Configurer un appareil > Fonctionne avec Google.
  3. Recherchez l'action intitulée Google Home Playground.
  4. Sélectionnez l'action pour que GHA vous redirige 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 processus d'association de comptes dans l'application Google Home pour connecter Google Home Playground.

Une fois l'association des comptes 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 Play à son compte.

Se connecter

Lancez 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 terminer l'association.

Cette illustration montre l'état initial de Google Home Playground et met en évidence le bouton de connexion situé dans l'angle supérieur droit.

Une fois connecté, Home Playground affiche les appareils virtuels stockés dans Home Graph.

Cette figure présente la liste des appareils, leurs informations et la zone de journalisation de 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 pour afficher ses informations et créer des appareils virtuels via ce panneau.
  • Informations sur l'appareil : présente les informations de l'appareil virtuel sélectionné, y compris les informations de base, les caractéristiques acceptées, les attributs de caractéristique et les États. Vous pouvez également modifier ces informations et supprimer l'appareil virtuel sélectionné via le panneau.
  • La zone de journal affiche les journaux d'interaction entre Home Playground et Home Graph. Vous pouvez développer les journaux pour inspecter les charges utiles de requêtes et de réponses à des fins de dépannage.

Afficher les informations sur les appareils virtuels

Dans le panneau Liste des appareils, sélectionnez l'appareil virtuel que vous souhaitez afficher. Le panneau Informations sur l'appareil affiche ses informations dans Home Graph, classées dans quatre 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 acceptées de l'appareil.
  • Attributs:attributs spécifiques à une caractéristique de l'appareil.
  • États:tous les États de l'appareil.

Modifier les informations de l'appareil virtuel

Outre la consultation des 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. Dans le panneau pop-up, vous pouvez voir les caractéristiques actuellement prises en charge par 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. Une fois les caractéristiques acceptées, cliquez sur Enregistrer. Les caractéristiques mises à jour seront appliquées à Home Graph.
  4. Vous pouvez consulter ces modifications 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 des caractéristiques compatibles avec votre appareil.
  2. Une fois les modifications terminées, appuyez sur Entrée. Les modifications apportées aux attributs seront appliquées à Home Graph.
  3. Vous pouvez consulter ces attributs mis à jour dans la zone de journal.

Modifier l'état des appareils

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

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 son nom. Vous pouvez également sélectionner un ensemble prédéfini d'appareils à ajouter.
  3. Une fois toutes les étapes terminées, le nouvel appareil sera 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, puis cliquez sur Icône CorbeilleSupprimer l'appareil en bas de la page.
  2. Confirmez la suppression de l'appareil dans l'alerte pop-up.
  3. Une fois que vous aurez confirmé la suppression de l'appareil, il sera supprimé de Home Graph.
Cette figure présente 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 et 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 présente l'outil d'expérience utilisateur permettant d'importer et d'exporter des appareils virtuels dans Google Home Playground.

Exporter des appareils virtuels dans un fichier

  1. Cliquez sur pour exporter les appareils virtuels dans un fichier.
  2. Saisissez le nom du fichier à exporter, puis cliquez sur OK.
  3. Une fois que vous avez saisi le nom du fichier, 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, Home Playground importe les appareils virtuels avec des états à partir du fichier, puis met à jour les informations et les états des appareils importés dans Home Graph.

Inspecter les journaux d'interaction

Lorsque vous interagissez avec des appareils virtuels, 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 d'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 caractéristiques et les types d'appareils compatibles

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

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

Envoyer des commentaires et signaler des problèmes

Votre avis nous intéresse. Pour nous faire part de vos commentaires, cliquez sur l'icône représentant un smiley sentiment_satisfait(e) en haut à droite, ou signalez un problème à l'aide de l'icône de point d'exclamation feedback.

Cette icône présente les icônes permettant d'envoyer des commentaires et de signaler des problèmes dans Google Home Playground.