Google Home Playground

Cloud-à-cloud    SDK d'accueil local    API d'accueil

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.

Finaliser l'association de votre compte

Pour utiliser Google Home Playground, nous vous recommandons d'abord d'associer l'outil à votre compte. Ouvrez l'application Google Home app (GHA) sur votre téléphone et suivez la procédure de liaison de compte décrite dans Connecter des appareils domotiques 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 redirigera vers la page de connexion. Cliquez sur Se connecter avec Google, puis sélectionnez votre compte pour vous connecter.
3. Cliquez sur le bouton Authorize pour autoriser la liaison du compte.

Une fois l'association de compte terminée, un ensemble d'appareils virtuels par défaut s'affiche dans GHA pour que vous puissiez interagir avec eux.

Se connecter

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

Lancer le terrain de jeu

Cliquez sur Sign in with Google (Se connecter avec Google). Assurez-vous de vous connecter avec le même compte que celui utilisé dans GHA pour finaliser l'association de compte.

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

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 à partir de ce panneau.
• Informations sur le périphérique présente les informations du périphérique virtuel sélectionné. Vous pouvez également modifier ces informations et supprimer l'appareil virtuel sélectionné depuis 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 du périphérique virtuel

Dans le panneau Liste des appareils, sélectionnez l'appareil virtuel que vous souhaitez afficher. Dans le panneau Liste des périphériques, sélectionnez le périphérique virtuel que vous souhaitez afficher. Le panneau Infos sur l'appareil affiche les informations classées dans cinq onglets :

• Informations de base : propriétés de niveau supérieur du périphérique, y compris le type, l’identifiant et le nom du périphérique.
• Traits: caractéristiques prises en charge par 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 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 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 caractéristiques actuellement compatibles avec l'appareil et celles que vous pouvez ajouter. Utilisez les boutons flèche (arrow_forward/arrow_back) pour ajouter ou supprimer des traits compatibles pour l'appareil.
3. Une fois la mise à jour des caractéristiques prises en charge terminée, cliquez sur Enregistrer, et les caractéristiques mises à jour seront appliquées à Home Graph.
4. Vous pouvez consulter ces mises à jour de caractéristiques dans la zone Log.

Modifier les attributs de l'appareil

1. Sélectionnez l'onglet Attributs et modifiez l'attribut pour les caractéristiques prises en charge par le périphérique.
2. Une fois les modifications effectué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 Log.

Modifier les états de l'appareil

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

Ajouter une vérification d'utilisateur secondaire à l'appareil virtuel

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

Configurer la VSU sur l'appareil

1. Dans le panneau Liste des périphériques, sélectionnez le périphérique 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 la VSU est activée ou désactivée (aucune validation requise) sur l'appareil.
   • Type de défi : si le SUV nécessite une confirmation explicite (ackNeeded) ou un numéro d’identification personnel (pinNeeded).
   • Code : code valide.
   • Gestion d'un code PIN incorrect : lorsque le code PIN est incorrect, s'il faut redemander à l'utilisateur et, sinon, l'erreur à répondre.

Identifier les appareils qui permettent d'activer la VSU

Dans le panneau de la liste des appareils , une icône de touche s'affiche à côté de chaque appareil compatible SUV.

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

• ArmDisarm
• LockUnlock
• OpenClose
• Redémarrer
• SoftwareUpdate

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.

Supprimer un appareil virtuel

1. Dans le panneau Liste des appareils, sélectionnez l'appareil que vous souhaitez supprimer. Ensuite, dans le Informations sur l'appareil panneau, sélectionnez le Informations de base onglet et ensuite, dans le Informations sur l'appareil panneau, sélectionnez le Informations de base onglet et cliquez Retirer 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, celui-ci sera supprimé de Home Graph.

Éditeur de réponse synchrone

Vous pouvez valider ou modifier votre réponse de synchronisation dans Google Home Playground. Cliquez sur Éditeur de réponse de synchronisation pour ouvrir un IDE intégré.

Modifiez, ou copiez et collez, votre réponse de synchronisation et cliquez sur Enregistrer pour appliquer les modifications afin de voir comment cela fonctionne dans l'écosystème Google Home.

Importer et exporter des appareils virtuels

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

Exporter les périphériques virtuels vers un fichier

1. Cliquez sur file_download pour exporter les périphériques 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échargera le fichier des périphériques virtuels exportés.

Importer des appareils virtuels à partir d'un fichier

1. Cliquez sur upload_file pour importer des périphériques 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 importera les appareils virtuels avec les états du fichier et mettra à jour les informations et les états des appareils importés dans Home Graph.

Consulter 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
}

Afficher les types et les traits d'appareils compatibles

L'icône point d'interrogation aide en haut à droite affichera le type de périphérique actuel et la liste des caractéristiques prises en charge par 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.