Google Home Playground

SDK de l'appareil

Google Home Playground est une application Web qui simule un projet de maison connectée avec des types et des caractéristiques d'appareils configurables. Vous pouvez créer des appareils virtuels, modifier leurs attributs et leurs états, afficher ces appareils dans Google Home Graph, et importer ou exporter des configurations d'appareils.

Terminer l'association des comptes

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

  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. 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 des comptes.
Cette figure illustre le parcours d'association du compte de l'application Google Home permettant de connecter Google Home Playground.

Une fois l'association des comptes terminée, un ensemble d'appareils virtuels par défaut s'affiche sur GHA avec lesquels vous pouvez 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 terminer l'association.

Cette figure 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é, Google Home Playground affiche les appareils virtuels stockés dans Home Graph.

Cette figure montre la liste des appareils, leurs informations et la zone de journal 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 journalisation affiche les journaux d'interactions entre le Google Home Playground et le 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 infos sur l'appareil virtuel

Dans le panneau Liste des appareils, sélectionnez l'appareil virtuel que vous souhaitez afficher. 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 de base:propriétés de premier niveau de l'appareil, y compris le type, l'ID et le nom.
  • Caractéristiques:traits compatibles de l'appareil.
  • Attributs:attributs spécifiques de l'appareil.
  • États:tous les états de l'appareil.
  • VSU:configuration de la validation secondaire de l'utilisateur de l'appareil.

Modifier les informations sur l'appareil virtuel

En plus d'afficher 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 traits compatibles

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

Modifier les attributs de l'appareil

  1. Sélectionnez l'onglet Attributes (Attributs), puis modifiez l'attribut des caractéristiques compatibles avec l'appareil.
  2. Une fois les modifications terminées, appuyez sur Entrée. Les modifications apportées à l'attribut sont appliquées à Home Graph.
  3. Vous pouvez consulter ces attributs mis à jour dans la zone de journal.

Modifier les états des appareils

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

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

Vous pouvez ajouter un SUV à des appareils virtuels et configurer son type de défi et le comportement correspondant sur chaque appareil. Vous pouvez ajouter un SUV à des appareils virtuels et configurer son type de défi et le comportement correspondant sur chaque appareil.

Configurer le 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 VSU et configurez les paramètres suivants :
    • Enabled (Activé) : indique si la VSU est activée ou désactivée (sans question d'authentification) sur l'appareil.
    • Type de question: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 d'un code incorrect:s'il s'agit d'un mauvais code, s'il faut redemander l'accès à l'utilisateur et, si ce n'est pas le cas, répondre à l'erreur.
Cette figure montre l'outil d'expérience utilisateur permettant d'activer des traits secondaires de validation de l'utilisateur sur un appareil sélectionné dans Google Home Playground.

Identifier les appareils compatibles avec la VSU

Dans le panneau Liste des appareils, une icône de clé clé s'affiche à côté de chaque appareil compatible avec les 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 figure montre l'outil d'expérience utilisateur permettant d'ajouter un nouveau type d'appareil dans Google Home Playground.

Supprimer un appareil virtuel

  1. Dans le panneau Liste des appareils, sélectionnez celui que vous souhaitez supprimer. Ensuite, dans le panneau Informations générales sur l'appareil, sélectionnez l'onglet Informations générales. 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 le pop-up d'alerte.
  3. Une fois la suppression confirmée, l'appareil 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.

Éditeur de réponse de synchronisation

Vous pouvez valider ou mettre à jour votre réponse de synchronisation dans Google Home Playground. Cliquez sur Sync Response Editor (Éditeur de réponse de synchronisation) pour ouvrir un IDE intégré.

Cette figure montre le bouton permettant d'ouvrir l'éditeur de réponse de synchronisation.

Modifiez ou copiez et collez votre réponse de synchronisation, puis cliquez sur Save (Enregistrer) pour appliquer les modifications et découvrir son fonctionnement dans l'écosystème Google Home.

La figure ci-dessous montre la fenêtre permettant de modifier la réponse de synchronisation.

Importer et exporter des appareils virtuels

Pour résoudre ou reproduire des problèmes, vous pouvez exporter vos appareils virtuels avec leur état dans un fichier, puis partager ce fichier pour importer et répliquer vos appareils virtuels.

Cette figure 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 des appareils virtuels vers 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, Google Home Playground importe des appareils virtuels avec leurs états, 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 ayant 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 de la documentation de référence pour connaître le format de chaque méthode.
response object Corps de la réponse pour l'appel d'API Home Graph. Consultez la documentation de référence de la documentation de référence pour connaître le format de chaque méthode.

Afficher les types et caractéristiques d'appareil compatibles

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

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

Signaler des problèmes

Votre avis nous intéresse ! Signalez les problèmes rencontrés à l'aide de l'icône en forme de point d'exclamation commentaires en haut à droite.

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