Google Home Playground

API Home    du SDK Local Home    cloud-to-cloud

Le 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 états, les afficher dans Google Home Graph, et importer ou exporter des configurations d'appareils.

Procédez à l'association avec votre compte

Pour utiliser Google Home Playground, nous vous recommandons d'associer d'abord l' outil à votre compte. Ouvrez l'Google Home app (GHA) sur votre téléphone et suivez la procédure d'association de compte décrite dans Associer des appareils connectés tiers dans l'application Google Home.

  1. Recherchez l'intégration intitulée Google Home Playground.
  2. Sélectionnez l'intégration. L'icône GHA vous redirige vers la page de connexion. Cliquez sur Se connecter avec Google et sélectionnez votre compte pour vous connecter.
  3. Cliquez sur le bouton Autoriser pour autoriser l'association de comptes.
Cette figure montre la procédure d'association de compte de l'application Google Home pour connecter Google Home Playground.

Une fois que vous avez effectué l'association avec votre compte, un ensemble d'appareils virtuels par défaut s'affiche dans GHA. Vous pouvez interagir avec.

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

Se connecter

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

Lancer Playground

Cliquez sur Se connecter avec Google. Assurez-vous de vous connecter avec le même compte que celui utilisé dans GHA pour associer votre compte.

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

Une fois 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 de la vue par défaut de Google Home Playground.

L'interface utilisateur Web se compose de 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 à l'aide de ce panneau.
  • Les informations sur l'appareil affichent les informations sur l'appareil virtuel sélectionné. Vous pouvez également modifier ces informations et supprimer l'appareil virtuel sélectionné depuis le panneau.
  • La zone de journalisation 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 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 classées dans cinq catégories :

  • Informations générales : propriétés générales de l'appareil, y compris le type, l'ID et le nom de l'appareil.
  • Caractéristiques : caractéristiques compatibles de l'appareil.
  • Attributs : attributs spécifiques aux caractéristiques 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

Outre l'affichage des informations sur 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 compatibles

  1. Sélectionnez l'onglet Caractéristiques , puis cliquez sur le bouton Modifier.
  2. Dans le panneau pop-up, vous pouvez voir 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 les caractéristiques compatibles de l'appareil.
  3. Lorsque vous avez terminé de mettre à jour les caractéristiques compatibles, cliquez sur Enregistrer. Les caractéristiques mises à jour seront appliquées à Home Graph.
  4. Vous pouvez consulter les mises à jour des caractéristiques dans la section Zone de journalisation.
Cette figure montre l'outil UX 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 Attributs, puis modifiez l'attribut des caractéristiques compatibles avec l'appareil.
  2. Une fois que vous avez terminé, appuyez sur Entrée. Les modifications apportées à l'attribut seront appliquées à Home Graph.
  3. Vous pouvez consulter ces attributs mis à jour dans la section Zone de journalisation.

Modifier les états de l'appareil

  1. Sélectionnez l'onglet États , puis modifiez l'état directement. Les modifications apportées à l'état seront appliquées à Home Graph.
  2. Vous pouvez consulter ces modifications d'état dans la section Zone de journalisation.

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

Vous pouvez ajouter une VSU aux appareils virtuels et configurer son type de défi et son comportement correspondant sur chaque appareil. Vous pouvez ajouter une VSU aux appareils virtuels et configurer son type de défi et son comportement correspondant sur chaque appareil.

Configurer la VSU 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 , puis configurez les éléments suivants :
    • Activé : indique si la VSU est activée ou désactivée (aucun défi) sur l’appareil.
    • Type de défi : indique si la VSU nécessite un accusé de réception explicite (ackNeeded) ou un code secret (pinNeeded).
    • Code : code secret valide.
    • Gestion du code incorrect : indique s'il faut demander à l'utilisateur de réessayer lorsque le code est incorrect et, le cas échéant, l'erreur à renvoyer.
Cette figure montre l'outil UX permettant d'activer les caractéristiques de validation de l'utilisateur secondaire sur un appareil sélectionné dans Google Home Playground.

Identifier les appareils qui activent la VSU

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

Cette figure montre les appareils pour lesquels il est recommandé d'activer la validation secondaire de l'utilisateur.

La liste suivante de caractéristiques nécessite la VSU :

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 effectuées, le nouvel appareil est ajouté à Home Graph.
Cette figure montre l'outil UX 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 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 la suppression de l'appareil confirmée, l'appareil est supprimé de Home Graph.
Cette figure montre l'outil UX 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 É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-collez votre réponse de synchronisation, puis cliquez sur Enregistrer pour appliquer les modifications et voir comment elle fonctionne dans l'écosystème Google Home.

Cette figure montre la fenêtre permettant de modifier la réponse de synchronisation.

Importer et exporter des appareils virtuels

Pour résoudre les problèmes ou les reproduire, vous pouvez exporter vos appareils virtuels avec leurs états dans un fichier, puis le partager avec d'autres personnes afin qu'elles puissent importer et répliquer vos appareils virtuels.

Cette figure montre l'outil UX 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 des appareils virtuels dans un fichier.
  2. Saisissez le nom du fichier que vous souhaitez exporter, puis cliquez sur OK.
  3. Une fois le nom de 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 le fichier à importer confirmé, Google Home Playground importe les appareils virtuels avec les états du fichier, puis met à jour les informations et les états des appareils importés dans Home Graph.

Inspecter les journaux d'interactions

Lorsque vous interagissez avec les appareils virtuels, Google Home Playground applique automatiquement vos modifications à Home Graph. Les interactions avec Home Graph sont enregistrées dans le panneau Zone de journalisation, où vous pouvez développer chaque entrée pour inspecter les Home Graph charges utiles de requête et de réponse 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 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 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 forme de point d'interrogation en haut à droite affiche la liste actuelle des types et des caractéristiques d'appareils compatibles avec Google Home Playground.

Cette figure montre l'outil UX permettant d'ajouter un nouveau type d'appareil dans Google Home Playground.

Signaler des problèmes

Nous aimerions avoir votre avis. Signalez les problèmes rencontrés à l'aide de l' icône en forme de point d'exclamation feedback en haut à droite.

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