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 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 la procédure d'association de comptes:
- Cliquez sur l'icône plus (+) en haut à gauche.
- Sélectionnez Configurer un appareil > Fonctionne avec Google.
- Recherchez l'action intitulée Google Home Playground.
- Sélectionnez l'action pour que GHA vous redirige vers la page de connexion. Cliquez sur Se connecter avec Google, puis sélectionnez votre compte pour vous connecter.
- Cliquez sur le bouton Autoriser pour autoriser l'association de comptes.
Une fois l'association du compte effectué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:
Cliquez sur Sign in with Google (Se connecter avec Google). Veillez à vous connecter avec le compte que vous avez utilisé dans GHA pour associer les comptes.
Une fois connecté, Google Home Playground affiche les appareils virtuels stockés dans Home Graph.
L'UI Web se compose de trois panneaux:
- La section 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 présente les informations de 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'interaction entre Google Home Playground et Home Graph. Vous pouvez développer les journaux pour inspecter les charges utiles de la requête et de la 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. Le panneau Informations sur l'appareil affiche les informations dans cinq onglets:
- Informations de base:propriétés de niveau supérieur de l'appareil, y compris son type, son ID et son nom.
- Caractères:caractéristiques prises en charge de l'appareil.
- Attributs:attributs spécifiques aux caractéristiques de l'appareil.
- États:tous les états de l'appareil.
- SUV: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
- Sélectionnez l'onglet Traits, puis cliquez sur le bouton Modifier.
- 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 des caractéristiques compatibles pour l'appareil. - Lorsque vous avez terminé de mettre à jour les caractéristiques compatibles, cliquez sur Enregistrer. Les caractéristiques mises à jour seront appliquées à Home Graph.
- Vous pouvez consulter ces mises à jour de caractéristiques dans la Zone de journal.
Modifier les attributs de l'appareil
- Sélectionnez l'onglet Attributs, puis modifiez l'attribut pour les caractéristiques compatibles avec l'appareil.
- Une fois les modifications terminées, appuyez sur Entrée. Vos modifications d'attributs seront appliquées à Home Graph.
- Vous pouvez consulter ces attributs mis à jour dans la zone de journalisation.
Modifier les états de l'appareil
- Sélectionnez l'onglet États, puis modifiez l'état directement. Les modifications d'état seront appliquées à Home Graph.
- Vous pouvez consulter ces modifications d'état dans la zone de journalisation.
Ajouter une validation secondaire de l'utilisateur à un 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 le SUV sur l'appareil
- Dans le panneau Device list (Liste des appareils), sélectionnez l'appareil virtuel que vous souhaitez configurer.
- Dans le panneau Informations sur l'appareil, sélectionnez l'onglet SUV et configurez les éléments suivants :
- Enabled:indique si la VSU est activée ou désactivée (no challenge) sur l'appareil.
- Type de défi:indique si l'authentification à deux facteurs nécessite une confirmation explicite (ackNeeded) ou un code secret (pinNeeded).
- Code:code valide.
- Gestion d'un code PIN incorrect:lorsque le code PIN est erroné, s'il faut redemander à l'utilisateur et, dans le cas contraire, obtenir l'erreur de réponse.
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 SUV.
La liste suivante de caractéristiques nécessite un SUV:
Créer un appareil virtuel
- Dans le panneau Liste des appareils, cliquez sur Ajouter un appareil.
- 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.
- Une fois toutes les étapes terminées, le nouvel appareil est ajouté à Home Graph.
Supprimer un appareil virtuel
- 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 Supprimer l'appareil en bas.
- Confirmez la suppression de l'appareil dans l'alerte pop-up.
- Une fois la suppression de l'appareil confirmée, il sera supprimé de Home Graph.
É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éponses de synchronisation) pour ouvrir un IDE intégré.
Modifiez, ou copiez-collez, votre réponse de synchronisation, puis cliquez sur Enregistrer pour appliquer les modifications et voir comment cela fonctionne dans l'écosystème Google Home.
Importer et exporter des appareils virtuels
Pour résoudre ou reproduire des problèmes, vous pouvez exporter vos appareils virtuels avec leurs états dans un fichier, puis partager avec d'autres utilisateurs le fichier pour importer et répliquer vos appareils virtuels.
Exporter des appareils virtuels vers un fichier
- Cliquez sur pour exporter les appareils virtuels vers un fichier.
- Saisissez le nom du fichier que vous souhaitez exporter, puis cliquez sur OK.
- Une fois le nom du fichier saisi, le navigateur télécharge le fichier des appareils virtuels exportés.
Importer des appareils virtuels depuis un fichier
- Cliquez sur pour importer des appareils virtuels à partir d'un fichier.
- Sélectionnez le fichier que vous souhaitez importer, puis cliquez sur OK.
- Une fois que vous avez confirmé le fichier à importer, Google Home Playground importe les appareils virtuels avec les états du fichier, et 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 votre modification à 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 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
}
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. Pour connaître le format de chaque méthode, consultez la documentation de référence et la documentation de référence. |
response |
object |
Corps de la réponse de l'appel d'API Home Graph. Pour connaître le format de chaque méthode, consultez la documentation de référence et la documentation de référence. |
Afficher les types et les caractéristiques d'appareils compatibles
L'icône Aide en forme de point d'interrogation en haut à droite affiche le type d'appareil actuel et la liste des traits compatibles avec 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 feedback en haut à droite.