Utiliser l'application exemple Android

L'application exemple Android présente les fonctionnalités de base d'accès et de contrôle des appareils à l'aide des API Home pour les types d'appareils qu'elle prend en charge.

Une fois l'autorisation du compte terminée et une structure sélectionnée, l'application exemple charge tous les appareils locaux trouvés dans cette structure.

Si un appareil est dans une pièce, il s'affiche sous le nom de cette pièce. L'application exemple est compatible avec les types d'appareils suivants :

  • Éclairage avec température de couleur (allumer et éteindre, luminosité)
  • Capteur de contact (état booléen)
  • Lumière à intensité variable (allumée et éteinte, luminosité)
  • Serrure
  • Éclairage couleur étendu (allumer et éteindre, luminosité)
  • Interrupteur générique
  • Routeur de bordure Google
  • Appareil photo Google
  • Google Doorbell
  • Capteur de présence (détection de présence)
  • Lumière On/Off (allumer et éteindre, luminosité)
  • Interrupteur ON/OFF
  • Prise connectée (marche/arrêt)
  • Capteur marche/arrêt

Actions sur les appareils et automatisations existants

L'application exemple comporte deux onglets : Devices (Appareils) et Automations (Automatisations). Chaque onglet fournit des informations sur la structure et vous permet d'effectuer des tâches.

Onglet "Appareils"

L'onglet Appareils (figure 1) affiche les pièces de la structure (Backyard, Attic, Travel) et les appareils de chaque pièce, ainsi que l'état de chaque appareil. Pour afficher ou modifier les caractéristiques d'un appareil, appuyez sur son nom. L'écran de contrôle de cet appareil s'affiche (figure 2).

Pour ajouter un appareil à la structure, appuyez sur Ajouter un appareil dans l'onglet Appareils (figure 1), puis suivez les instructions pour ajouter un appareil avec ou sans QR code.

Onglet "Appareils" de l'application exemple des API Home.
Figure 1 : Écran de l'application exemple : vue de l'onglet "Appareils"
Commandes de contrôle des appareils de l'application exemple des API Home.
Figure 2 : Commandes de l'appareil de l'application exemple

Onglet "Automatisations"

L'onglet Automatisations (figure 3) affiche la liste de toutes les automatisations de la structure. Chaque automatisation affiche ses déclencheurs et ses actions. Plusieurs déclencheurs et actions sont acceptés.

Appuyez sur une automatisation pour afficher ses détails, comme illustré dans l'exemple de la figure 4. Dans cette vue détaillée, vous pouvez supprimer l'automatisation ou l'exécuter manuellement sans avoir besoin d'un déclencheur, à condition que le bouton Exécuter manuellement soit disponible pour cette automatisation.

Dans la vue détaillée d'une automatisation (figure 4), vous pouvez également activer ou désactiver l'automatisation en activant ou désactivant isActive. Le champ isValid est défini par le SDK et est défini sur false en cas de problème de compatibilité avec l'appareil ou la caractéristique, ou de tout autre problème.

Onglet "Automatisations" de l'application exemple des API Home.
Figure 3 : Vue de l'onglet "Automatisations"
Vue détaillée d'une automatisation sélectionnée.
Figure 4 : Vue détaillée d'une automatisation

Créer une automatisation

Pour créer une automatisation, appuyez sur le bouton Créer dans la vue de la liste des automatisations (figure 3). L'écran Nouvelle automatisation s'affiche (figure 5).

Utilisez les boutons + Ajouter un déclencheur et + Ajouter une action (figure 5) pour ajouter un ou plusieurs déclencheurs et actions à votre automatisation. Les figures 6 et 7 montrent des exemples de sélection d'un déclencheur et d'une action, respectivement. Une fois que vous avez effectué vos sélections et enregistré le déclencheur ou l'action, les boutons Mettre à jour le déclencheur et Supprimer le déclencheur s'affichent pour le déclencheur (et Mettre à jour l'action et Supprimer l'action pour l'action). Vous pouvez ainsi modifier le déclencheur ou l'action, ou les supprimer, avant d'enregistrer l'automatisation elle-même.

Une fois que vous avez ajouté des déclencheurs et des actions, vous pouvez revenir à l'écran Nouvelle automatisation et appuyer sur Créer une automatisation (figure 8).

Exemple d'écran d'application pour démarrer une nouvelle automatisation.
Figure 5 : Commencer à créer une automatisation
Exemple d'écran d'application permettant d'ajouter un déclencheur pour une automatisation.
Figure 6 : Ajouter un déclencheur à une automatisation
Exemple d'écran d'application pour ajouter une action à une automatisation.
Figure 7 : Ajouter une action à une automatisation
Exemple d'écran d'application pour créer une automatisation.
Figure 8 : Créer l'automatisation

Dépannage

L'application affiche des messages de boîte de dialogue pour certains événements courants qui peuvent se produire. Consultez les journaux adb pour savoir comment résoudre ces événements.

Si vous rencontrez des problèmes lors de l'utilisation de l'application exemple, consultez Dépannage pour Android.