Autorisation du compte sur Android

Avant de procéder à l'autorisation du compte, assurez-vous de disposer des éléments suivants :

1. Le Google Home app (GHA) installé sur votre appareil mobile Android
2. Au moins l'un de ces types d'appareils compatibles pour l'application exemple dans la maison :
   • Lumière à température de couleur (allumée/éteinte, luminosité)
   • Capteur de contact (état booléen)
   • Lumière à intensité variable (allumée/éteinte, luminosité)
   • Serrure
   • Lumière à couleur étendue (allumée/éteinte, luminosité)
   • Interrupteur générique
   • Routeur de bordure Google
   • Appareil photo Google
   • Sonnette Google
   • Détecteur de présence (détection de présence)
   • Lumière allumée/éteinte (allumée/éteinte, luminosité)
   • Interrupteur allumé/éteint
   • Unité enfichable allumée/éteinte (allumée/éteinte)
   • Capteur allumé/éteint
3. Deux appareils pour tester l'exemple d'automatisation

Avant d'utiliser des appareils via les API Home, ils doivent être contrôlables depuis GHA.

Exécuter l'application exemple Android

Avant d'autoriser un compte, vérifiez que l'application exemple est configurée avec le champ d'application OAuth approprié pour votre projet. Par défaut, le code source de l'application exemple utilise le champ d'application https://www.googleapis.com/auth/home.platform.v2. De nombreuses fonctionnalités de l'application exemple sont limitées par le champ d'application home.platform.v2 et nécessitent l'approbation d'un partenaire pour y accéder. Pour autoriser et utiliser l'application exemple avec le champ d'application standard https://www.googleapis.com/auth/home.platform.selected.devices, remplacez manuellement par homePlatformScope dans HOME_PLATFORM_SCOPE_VERSION_1HomeModule.kt comme décrit dans Créer l'application.

Exécutez l'application exemple Android. La première fois que vous l'exécutez, vous êtes invité à autoriser l'accès à une maison sur votre compte Google. Cela accorde à l'application exemple l'autorisation d'accéder aux structures et aux appareils de cette maison et de les contrôler.

Si vous ne disposez pas de structure, l'utilisateur peut en créer une lors du flux d'autorisation sans avoir à utiliser GHA.

Le comportement d'autorisation par défaut de l'application diffère selon que l'application a été enregistrée ou non dans le Google Home Developer Console.

Si une application n'est pas enregistrée dans la Developer Console, elle sera dans un état non validé. Cette option est recommandée pour tester l'utilisation des API Home :

• Seuls les utilisateurs enregistrés en tant qu'utilisateurs test dans la console OAuth peuvent accorder des autorisations pour l'application. Une application non validée est limitée à 100 utilisateurs test.

• Une application non validée aura accès aux appareils de tous les types d'appareils compatibles avec OAuth pour les API Home (liste des types d'appareils dans la Developer Console). Tous les appareils d'une structure seront accordés.

Si une application est enregistrée dans la Developer Console et que l'accès à un ou plusieurs types d'appareils a été approuvé, et que la validation de la marque a été effectuée pour OAuth, elle sera dans un état validé. Cet état est requis pour lancer une application en production :

• Les limites d'utilisateurs test ne s'appliquent plus. N'importe quel utilisateur peut accorder une autorisation à l'application.
• L'utilisateur ne peut accorder une autorisation qu'aux types d'appareils approuvés dans la Developer Console.

Appuyez sur Autoriser l'accès à une maison choisie :

• Si des maisons sont associées à votre compte, choisissez-en une pour accorder l'autorisation. Si aucun appareil n'est trouvé dans la maison choisie, vous pouvez :
  1. Appuyez sur Autoriser l'accès à une autre maison pour sélectionner une autre maison.
  2. Configurez un appareil de votre choix dans cette maison à l'aide de l'application Google Home (AGH)Google Home app (GHA). N'oubliez pas que seuls ces types d'appareils sont compatibles avec le contrôle dans cette application exemple :
     • Lumière à température de couleur (allumée/éteinte, luminosité)
     • Capteur de contact (état booléen)
     • Lumière à intensité variable (allumée/éteinte, luminosité)
     • Serrure
     • Lumière à couleur étendue (allumée/éteinte, luminosité)
     • Interrupteur générique
     • Routeur de bordure Google
     • Appareil photo Google
     • Sonnette Google
     • Détecteur de présence (détection de présence)
     • Lumière allumée/éteinte (allumée/éteinte, luminosité)
     • Interrupteur allumé/éteint
     • Unité enfichable allumée/éteinte (allumée/éteinte)
     • Capteur allumé/éteint
• Si aucune maison n'est associée à votre compte, un écran s'affiche avec le message Aucune structure pour le compte sélectionné.
  1. Balayez vers l'arrière pour revenir à la vue Application exemple principale.
  2. Pour configurer une maison, utilisez l'GHA. Réessayez ensuite d'accorder une autorisation à l'application exemple.

Vous pouvez revenir au flux d'autorisations à tout moment en sélectionnant l'icône de profil account_circle en haut à droite de n'importe quel écran de l'application exemple.

Une fois que vous avez accordé l'autorisation à une maison équipée d'appareils, vous êtes redirigé vers la vue des appareils. Vous pouvez contrôler les appareils et observer les changements d'état via l'application exemple.