Bienvenue dans le Centre des développeurs Google Home, la nouvelle destination pour apprendre à développer des actions pour la maison connectée. Remarque : Vous continuerez à créer des actions dans la console Actions.

Google Home Playground

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

SDK des appareils

Google Home Playground is a web application that allows you to simulate a smart home project by simulating a virtual home with configurable device types and traits. The Home Playground allows you to create virtual devices, modify the device attributes and states, view these devices in Google Home Graph , and import or export device configurations.

Finaliser l'association du compte

Pour utiliser Home Playground, nous vous recommandons d'associer d'abord l'outil à votre compte. Ouvrez le Google Home app (GHA) on your phone, and go through the account linking process:

  1. Cliquez sur l'icône plus (+) 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 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 illustration montre le parcours d'association de compte de l'application Google Home pour connecter Google Home Playground.

Une fois l'association de comptes terminée, un ensemble d'appareils virtuels par défaut s'affiche sur le GHA avec lequel vous pouvez interagir.

Cette figure montre la liste d'appareils qui s'affiche par défaut lorsqu'un utilisateur associe Google Home Playground à 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 effectuer l'association.

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

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

Cette figure présente la liste des appareils, des informations sur les appareils 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 spécifique pour afficher ses informations et créer des appareils virtuels via ce panneau.
  • Informations sur l'appareil : affiche les informations sur l'appareil virtuel sélectionné. 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.

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 du panneau Informations sur l'appareil sont réparties dans cinq onglets:

  • Informations générales:propriétés de premier niveau de l'appareil, telles que son type, son ID et son nom.
  • Traits:les caractéristiques de l'appareil sont acceptées.
  • Attributs:attributs spécifiques aux caractéristiques de l'appareil.
  • États:tous les états des appareils.
  • SUV:configuration de la validation de l'utilisateur secondaire de l'appareil.

Modifier les informations de l'appareil virtuel

En plus de consulter les informations d'un appareil virtuel, vous pouvez également modifier directement les 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 affiche 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 acceptées, cliquez sur Enregistrer. Les caractéristiques mises à jour seront appliquées à Home Graph.
  4. Vous pouvez consulter ces modifications dans la zone du journal.
Cette illustration montre l'outil d'expérience utilisateur permettant d'ajouter ou de supprimer des caractéristiques compatibles avec 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 acceptées par l'appareil.
  2. Une fois les modifications terminées, appuyez sur Entrée pour que les modifications apportées aux attributs soient appliquées à Home Graph.
  3. Vous pouvez consulter ces attributs mis à jour dans la zone du journal.

Modifier les états de l'appareil

  1. Sélectionnez l'onglet États, puis modifiez directement l'État. Les changements d'état seront appliqués à Home Graph.
  2. Vous pouvez consulter ces changements d'état dans la zone du journal.

Ajouter une validation de l'utilisateur secondaire à un appareil virtuel

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

Configurer un SUV sur l'appareil

  1. Dans le panneau Liste des 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é (sans question) sur l'appareil.
    • Type de défi:indique si un SUV nécessite un accusé de réception explicite (ackNeeded) ou un numéro d'identification personnel (pinNeeded).
    • Code:code valide.
    • Traitement du code incorrect:lorsque le code est incorrect, s'il faut redemander à l'utilisateur et, dans le cas contraire, répondre par erreur.
Cette illustration montre l'outil d'expérience utilisateur permettant d'activer les caractéristiques de validation d'utilisateurs secondaires sur un appareil sélectionné dans Google Home Playground.

Identifier les appareils compatibles avec le SUV

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

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

La liste de caractéristiques suivante 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 sera ajouté à Home Graph.
Cette illustration montre 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 aurez confirmé la suppression de l'appareil, il sera 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 illustration montre 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 les appareils virtuels dans un fichier.
  2. Saisissez le nom du fichier que vous souhaitez 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 journal, où vous pouvez développer chaque entrée pour inspecter les charges utiles de requête et de réponse Home Graph de l'API.

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 à 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 et les caractéristiques d'appareils compatibles

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

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

Commentaires et signaler des problèmes

Votre avis nous intéresse. Faites-nous part de vos commentaires en cliquant sur l'icône représentant un émoticône sentiment_Satisfaction en haut à droite, ou signalez des problèmes à l'aide de l'icône de point d'exclamation feedback.

Cette illustration montre les icônes permettant d'envoyer des commentaires et de signaler les problèmes dans Google Home Playground.