Cloud-to-cloud SDK Local Home SDK de l'appareil
Google Home Playground est une application Web qui simule un projet de maison connectée avec des caractéristiques et des types d'appareils configurables. Vous pouvez créer des appareils virtuels, modifier leurs attributs et états, afficher ces appareils dans Google Home Graph, et importer ou exporter leurs configurations.
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, puis suivez la procédure d'association de compte:
- 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. GHA vous redirigera vers la page de connexion. Cliquez sur Sign in with Google (Se connecter avec Google) et sélectionnez votre compte pour vous connecter.
- Cliquez sur le bouton Autoriser pour autoriser l'association des comptes.
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.
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 effectuer l'association.
Une fois que vous êtes connecté, Google Home Playground affiche les appareils virtuels stockés dans Home Graph.
L'UI 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 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 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 onglets:
- Informations de base:propriétés de premier niveau de l'appareil, y compris le type, l'ID et le nom.
- Caractéristiques:caractéristiques 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 caractéristiques acceptées
- Sélectionnez l'onglet Caractéristiques, puis cliquez sur le bouton Modifier.
- 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 caractéristiques compatibles pour l'appareil. - Lorsque vous avez terminé de mettre à jour les caractéristiques acceptées, cliquez sur Save (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 Attributes (Attributs), puis modifiez l'attribut pour les caractéristiques compatibles avec l'appareil.
- Une fois les modifications effectuées, appuyez sur Entrée pour appliquer vos modifications d'attribut à Home Graph.
- Vous pouvez consulter ces attributs mis à jour dans la section du journal.
Modifier les états de l'appareil
- Sélectionnez l'onglet États et modifiez directement l'État. Les changements d'état seront appliqués à Home Graph.
- 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 aux appareils virtuels et configurer son type de test et le comportement correspondant sur chaque appareil. Vous pouvez ajouter un SUV aux appareils virtuels et configurer son type de test et le comportement correspondant sur chaque appareil.
Configurer la VSU sur l'appareil
- Dans le panneau Liste des appareils, sélectionnez l'appareil virtuel que vous souhaitez configurer.
- Dans le panneau Informations sur l'appareil, sélectionnez l'onglet VSU et configurez les éléments suivants :
- Enabled (Activé) : indique si le SUV est activé ou désactivé (sans défi) sur l'appareil.
- Type de défi:indique si la VSU nécessite une confirmation explicite (ackNeeded) ou un numéro d'identification personnelle (pinNeeded).
- PIN:code valide.
- Gestion d'un code incorrect:lorsque le code est incorrect, demander à l'utilisateur de nouveau et, si ce n'est pas le cas, répondre avec l'erreur.
Identifier les appareils compatibles SUV
Dans le panneau Liste des appareils, une icône de clé clé s'affiche à côté de chaque appareil compatible SUV.
La liste de caractéristiques suivante nécessite 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 générales, sélectionnez l'onglet Informations générales. 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 que vous aurez confirmé la suppression de l'appareil, celui-ci 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éponse de synchronisation) pour ouvrir un IDE intégré.
Modifiez ou copiez-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.
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 partager ce fichier avec d'autres utilisateurs pour importer et répliquer vos appareils virtuels.
Exporter des appareils virtuels vers un fichier
- Cliquez sur pour exporter des appareils virtuels dans un fichier.
- Saisissez le nom du fichier à 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 à partir d'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 importera les appareils virtuels dont les états sont ceux du fichier, et mettra à 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 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 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. |
Afficher les types et caractéristiques d'appareils compatibles
L'icône d'aide en forme de point d'interrogation en haut à droite affiche le type d'appareil et la liste de caractéristiques actuellement compatibles avec Google Home Playground.
Signaler des problèmes
Votre avis nous intéresse ! Des problèmes sont survenus lors de l'utilisation de l'icône en forme de point d'exclamation commentaires en haut à droite.
