Vous ne le savez peut-être pas, depuis la version 0.56 d’Home Assistant, il est possible de contrôler votre installation grâce à Google Assistant et donc, à Google Home! Vous me direz que c’est déjà possible grâce à IFTTT. En effet, nous l’avions vu dans cet article mais cette fois, l’intégration se fait sans service tiers. De plus, elle est beaucoup moins longue à mettre en place, puisqu’il n’est pas nécessaire de paramétrer chaque action! Comme vous vous en doutez je n’ai pas attendu longtemps avant de mettre en place cette fonctionnalité. Aujourd’hui, je vous propose donc de partager avec vous les étapes de mise en place ainsi que les possibilités offertes par cette intégration.

Prés requis

Pour ce tuto, vous aurez besoin des éléments ci-dessous:

• Un raspberry pi ou un Intel NUC
• Une alimentation
• Une carte micro SD

De plus, il est nécessaire d’avoir une installation Home Assistant en version 0.56.x (ou Hass.io) accessible de l’extérieur et disposant d’un certificat SSL. Si vous n’avez pas encore d’installation valide, vous pouvez consulter les articles de ce dossier.

Actions on Google

Avant de démarrer, je vous présente actions on google.

Tout ce tuto va tourner autour de cette plate-forme mise en place par Google. En effet, cette dernière permet à n’importe quel développeur de construire sa propre application compatible Google Assistant. C’est donc grâce à ce système, qu’il est possible de rendre compatible un grand nombre de solutions telles qu’Home Assistant.

Cette plate-forme fournit tout ce qui est nécessaire afin de tester et de déployer votre application. Dans le cadre de ce tuto, nous n’irons pas plus loin que la phase de test. En effet, cette dernière permet d’utiliser votre création sur tous les appareils connectés via votre compte Google.

Création du projet

Dans un premier temps, il est nécessaire de créer un nouveau projet. Pour ce faire, rendez-vous à l’adresse https://console.actions.google.com et connectez-vous avec un compte Google.

Sur l’écran principal, vous devriez avoir un bouton Add/import project

Saisissez ensuite un nom de projet et sélectionnez votre pays.

Création des actions

Il est temps maintenant de lier ce projet et votre installation Home Assistant. Tout d’abord,  téléchargez gactions que vous trouverez à l’adresse suivante https://developers.google.com/actions/tools/gactions-cli . Sur votre pc, créez un dossier et placez-y ce fichier.

Dans ce même dossier, créez un fichier project.json et copiez/collez l’exemple ci-dessous en l’adaptant :

[js]
{
"actions": [{
"name": "actions.devices",
"deviceControl": {
},
"fulfillment": {
"conversationName": "automation"
}
}],
"conversations": {
"automation" :
{
"name": "automation",
"url": "https://[votre_adresse_home_assistant]/api/google_assistant"
}
},
"locale":"fr"
}
[/js]

Retournez sur https://console.actions.google.com, dans votre projet, cliquez sur Add Actions

Sélectionnez Actions SDK

Vous devriez voir l’écran suivant apparaître.

Maintenant nous allons mettre à jour l’application.

• Copiez la ligne ressemblant à gactions update –action_package PACKAGE_NAME –project…
• Remplacez PACKAGE_NAME par project.json
• Ouvrez un terminal et exécutez la commande dans le dossier de votre projet.

Vous devrez ensuite renseigner un code de sécurité. Pour l’obtenir:

• Entrez dans votre navigateur l’adresse affichée dans votre terminal après l’exécution de la commande précédente.
• Validez votre identité
• Entrez le code affiché après l’identification dans le terminal.

Si tout s’est bien passé, vous devriez avoir quelque chose de ce genre.

Sous l’étape nommée Action, vous verrez plusieurs autres intitulés. Je vous laisse libre de les remplir afin que votre projet soit valide. Il n’y a rien de compliqué, c’est uniquement des informations du type nom de l’application, langue, etc.

Prenez seulement garde à la langue que vous sélectionnez et choisissez bien comme catégorie Home Control. Arrêtez vous au point Account linking que nous verrons à la fin de cet article.

Configuration de Home Assistant

Passons maintenant au réglage côté Home Assistant. Dans un premier temps, nous allons générer deux clés de sécurité qui vous seront demandées par le composant. Il s’agit en réalité de deux chaînes de caractères qui doivent être complexes et longues.

Pour ce faire, j’ai utilisé https://www.random.org/strings/ et je me suis arrangé pour avoir 120 caractères par chaîne.

Mettez les de côté et ouvrez votre fichier de configuration (configuration.yaml pour rappel). Ajoutez-y les lignes suivantes, en indiquant:

• le nom de votre projet
• les deux chaînes de caractères que vous venez de générer.

[js]
google_assistant:
project_id: [Votre nom de projet]
client_id: [Première chaîne de caractères générée]
access_token: [Deuxième chaîne de caractères générée]
exposed_domains:
– switch
– light
– group
[/js]

Enfin, redémarrez Home Assistant pour que votre configuration soit prise en compte.

Account linking

Maintenant, nous allons mettre en place l’authentification entre Actions on Google et Home Assistant. Pour ce faire, retour sur https://console.actions.google.com/, ouvrez votre projet et rendez-vous directement à la dernière étape Account linking.

• Cliquez sur ADD

• Choisissez un grant type implicit

• Ensuite il vous sera demandé de remplir le client ID et une Authorization URL. Pour le premier paramètre, il s’agit de la première chaîne de caractères que vous avez généré tout à l’heure. Quand à l’URL, elle est de la forme https://[votre_adresse_home_assistant]/api/google_assistant/auth.

• Remplissez l’écran suivant comme sur l’exemple

• Enfin, la dernière étape consiste à indiquer la procédure de test. Cette étape est nécessaire uniquement si vous souhaitez déployer publiquement l’application ce qui n’est pas notre cas. Vous pouvez donc y mettre n’importe quoi.

Configuration de Google Assistant

Voilà, notre application Actions on Google est terminée. Nous arrivons bientôt au bout de nos efforts ! La dernière étape est très simple, elle consiste à ajouter votre nouveau composant à votre Google Assistant.

Pour ce faire c’est très simple:

• Sur votre smartphone, ouvrez l’application home.
• Allez dans le menu et cliquez sur plus de paramètres.
• Plus bas sur cet écran, vous devriez avoir un bouton Commandes relatives à la maison, cliquez dessus.
• Ici, vous devriez normalement  avoir une liste répertoriant tous les appareils que vous avez déjà configurés.
• Cliquez sur + en bas à droite de l’écran pour en ajouter un nouveau.
• Vous devriez normalement y voir votre projet Actions on Google fraîchement créé! ([test] home up dans mon cas)

Cliquez sur celui-ci afin de l’ajouter. Vous pourrez ensuite modifier les noms/alias et assigner des pièces à tous les éléments remontés par votre installation Home Assistant !

Conclusion

C’est fini pour aujourd’hui. Vous pouvez dès à présent contrôler des appareils jusque là incompatibles. Par exemple, à la fin de la vidéo d’introduction, vous verrez qu’il est possible de contrôler des périphériques connectés en 433 Mhz via votre Google Home (à condition qu’il soit disponible dans Home Assistant, pour en savoir plus allez voir cet article).

Bien qu’il y ait beaucoup d’étapes, cette intégration reste assez simple. De plus, le composant semble assez puissant et très paramétrable. Nous verrons probablement plus en détail ce dernier dans de prochains articles surtout qu’Home Assistant nous promet des améliorations pour la version 0.57.

En attendant, si vous souhaitez en savoir plus, la documentation officielle est assez bien fournie (Pour la release c’est ici et pour le composant c’est là). J’espère que cet article vous a plu, n’hésitez pas à réagir en commentaire ! A bientôt.