Les assistants à commande vocale sont rapidement devenus monnaie courante. De nombreux foyers disposent d'un Alexa ou d'un Google Home contrôlant tout, de l'éclairage aux médias, en passant par le chronométrage.
La technologie sur laquelle ces appareils fonctionnent est disponible --- au moins en partie --- pour tout le monde. Le SDK Assistant de Google vous permet d'utiliser le service sur vos propres appareils. Ce didacticiel explique comment configurer l'Assistant Google sur votre Raspberry Pi et activer vocalement une LED via des broches GPIO.
Vous aurez besoin :
Remarque : L'équipement pour ce tutoriel peut varier quelque peu. J'ai utilisé une webcam USB de rechange uniquement pour son microphone. Toute webcam ou microphone compatible devrait faire l'affaire, et il existe de nombreuses listes d'appareils compatibles Pi pour vous aider.
De plus, j'utilise la sortie 3,5 mm pour l'audio. HDMI et d'autres sources de sortie fonctionneront également, mais cela nécessitera des modifications de la configuration du son ci-dessous.
Branchez la webcam USB et le haut-parleur, et configurez le circuit LED si vous l'utilisez.
Ce tutoriel peut être suivi directement sur le Pi ou via une connexion SSH dans le Pi.
Les deux manières commencent dans le terminal, pour vérifier les paramètres sonores. Utilisez les commandes arecord -l et aplay -l pour lister les appareils disponibles.
L'image ci-dessus montre la webcam USB en tant que carte 1 et périphérique 0 . Notez les numéros de carte et de périphérique pour la sortie microphone et haut-parleur.
Maintenant, assurez-vous que vous êtes dans le /home/pi répertoire, créez un nouveau fichier et ouvrez-le dans nano :
sudo nano .asoundrc Le contenu de ce répertoire sera différent selon les numéros de carte et de périphérique que vous utilisez. C'est ici que vous pouvez choisir de privilégier la sortie HDMI plutôt que 3,5 mm si vous le souhaitez.
Lorsque vous avez entré votre version du code ci-dessus, appuyez sur Ctrl + X pour enregistrer et quitter.
Testez votre configuration en enregistrant et en lisant un court extrait :
Étape facultative : Si vous souhaitez modifier le volume d'entrée de votre microphone, ouvrez alsamixer et appuyez sur F6 pour passer d'un appareil à l'autre.
C'est ça! Le son est configuré.
Ouvrez le navigateur du Pi, sinon, si vous êtes connecté via SSH, ouvrez un navigateur localement. Accédez à Google Action Console et cliquez sur Nouveau projet. .
Ceci peut prendre un certain temps. Lorsque vous avez terminé, laissez la fenêtre active et ouvrez un nouvel onglet --- nous y reviendrons dans un instant.
Il y a quelques ajustements en ligne que vous devrez faire pour continuer. Accédez au site Web de l'API de l'Assistant Google et cliquez sur Activer .
Le projet nécessite également des autorisations d'activité. Accédez à votre panneau de contrôle d'activité et assurez-vous que les activités suivantes sont activées :
Vous pouvez maintenant passer à l'enregistrement de l'appareil.
De retour dans la console d'action, sélectionnez Enregistrement de l'appareil du panneau de gauche. Sous Produit créer un nom facile à retenir pour votre appareil. Le nom du fabricant n'est pas important (mais doit être présent) et sélectionnez Auto pour le type d'appareil.
Cliquez sur Enregistrer le modèle , et sur l'écran suivant, cliquez sur Télécharger les informations d'identification OAuth 2.0 . Cela télécharge un fichier JSON sur votre ordinateur. Si vous n'êtes pas familier avec les fichiers JSON, ne vous inquiétez pas, mais apprendre à utiliser JSON vaut la peine d'être fait pour l'avenir !
Le guide officiel de Google recommande de déplacer le fichier vers /home/pi , alors ouvrez le gestionnaire de fichiers et faites-le maintenant.
Étape supplémentaire pour les utilisateurs SSH :
Si vous utilisez SSH, vous aurez téléchargé le fichier JSON sur votre machine locale au lieu du Pi. Pour le transférer, ouvrez une fenêtre de terminal séparée sans connexion SSH. À partir de cette fenêtre, copiez le fichier JSON secret du client à l'aide de cette commande :
scp ~/Downloads/client_secret_client-id.json pi@raspberry-pi-ip-address:/home/pi/ Remplacez "raspberry-pi-ip-address" par l'adresse IP de votre Pi, et n'oubliez pas les deux-points avant le chemin. Si vous avez téléchargé le fichier JSON vers un autre emplacement, modifiez votre chemin local pour refléter cela. Entrez votre mot de passe lorsque vous y êtes invité et le fichier sera copié dans le répertoire d'accueil du Pi.
Revenez au terminal SSH et accédez à /home/pi . Entrez ls -l pour lister les fichiers du répertoire. Vous devriez voir le fichier JSON secret du client transféré.
Google recommande de travailler dans un environnement virtuel Python. Créez un nouvel environnement virtuel appelé env .
Si vous ne l'avez jamais fait auparavant, ce didacticiel vous aidera à apprendre à utiliser les environnements virtuels Python.
Installez les dernières versions de Pip, Setuptools et Wheel et activez votre environnement virtuel :
env/bin/python -m pip install --upgrade pip setuptools wheel
source env/bin/activer Google Assistant a certaines dépendances que vous devez installer dans l'environnement virtuel maintenant.
sudo apt-get install portaudio19-dev libffi-dev libssl-dev libmpg123-dev
Enfin, installez le SDK de l'Assistant Google, les exemples et l'outil OAuth.
python -m pip install --upgrade google-assistant-library
python -m pip install --upgrade google-assistant-sdk[exemples]
python -m pip install --upgrade google-auth-oauthlib [outil]
C'est tout ce qu'il faut pour être opérationnel. Si l'une des installations échoue, vérifiez soigneusement l'orthographe et l'espacement.
Utilisez l'outil google-auth-oauthlib[tool] avec le fichier JSON d'informations d'identification téléchargé précédemment pour authentifier votre Raspberry Pi.
google-oauthlib-tool --scope https://www.googleapis.com/auth/assistant-sdk-prototype \
--portée https://www.googleapis.com/auth/gcm \
--save --headless --client-secrets /home/pi/YOUR_CLIENT_SECRET_ID.json
Vous devrez remplacer YOUR_CLIENT_SECRET_ID par le fichier téléchargé, il vaut donc la peine de copier d'abord le nom du fichier. Cet ID client doit être correct. Ne changez pas le nom du fichier !
Vous devriez recevoir un message avec un lien, vous demandant de coller un code d'autorisation.
Cliquer sur le lien ouvre le navigateur. Vous serez invité à activer l'appareil sur votre compte Google. Copiez le code d'autorisation qui suit et collez-le dans la fenêtre de votre terminal.
Vous devriez recevoir une confirmation indiquant Credentials Saved:/home/pi… , ce qui signifie que le Pi a été autorisé avec succès avec votre compte Google.
Maintenant que tout est en place, il est temps de tester votre Pi Google Assistant. Exécutez l'assistant avec cette commande :
googlesamples-assistant-hotword --project-id mon-dev-projet --device-model-id mon-modèle
Vous devrez remplacer my-dev-project avec votre ID de projet (trouvé sous le rouage Paramètres de la console d'action). Votre identifiant de modèle d'appareil est répertorié dans la section Enregistrement de l'appareil de la console d'action.
Essaye le! Dites "OK Google" et posez une question. Vous pouvez voir la sortie du programme dans le terminal lorsque vous entendez la réponse :
C'est ça! Google Assistant est maintenant en cours d'exécution sur votre Raspberry Pi. Notez que si le volume de sortie est un peu faible, vous pouvez le modifier en disant "Hey Google, augmentez le volume à 80 %."
Il est possible de contrôler les lumières avec un Arduino et Siri, mais il existe une méthode plus simple. Si vous configurez une LED, vous pouvez utiliser l'Assistant Google pour la contrôler avec votre voix.
La configuration de Google Assistant pour qu'il fonctionne avec les broches GPIO est relativement simple, mais nécessite quelques étapes supplémentaires. Rendez-vous dans la console d'action Google et recherchez votre appareil sous Enregistrement de l'appareil. Cliquez dessus et ouvrez le menu des traits :
Activez le OnOff trait activé, puis cliquez sur Enregistrer.
Assurez-vous maintenant que vous êtes à l'intérieur de l'env environnement virtuel, clonez une version du SDK sur votre Pi en utilisant git :
clone git https://github.com/googlesamples/assistant-sdk-python
Comme il s'agit d'un environnement virtuel, vous devrez installer RPi.GPIO avant de continuer.
installation pip rpi.gpio
Maintenant, accédez au dossier contenant le hotword.py script.
cd assistant-sdk-python/google-assistant-sdk/googlesamples/assistant/library
Vous devrez ajouter quelques lignes au script hotword.py, alors ouvrez-le dans l'éditeur nano :
nano hotword.py
Sous les instructions d'importation, ajoutez les vôtres pour RPi.GPIO.
importer RPi.GPIO en tant que GPIO
Recherchez le process_event méthode. À la ligne 66, supprimez ou commentez l'instruction print et ajoutez une instruction if pour contrôler la LED.
#print('Do command', command, 'with params', str(params))
si commande =="action.devices.commands.OnOff":
si paramètres['on'] :
impression('---------------')
print('Led allumée')
impression('---------------')
GPIO.sortie(18, GPIO.HIGH)
autre:
impression('---------------')
print('Led éteinte')
impression('---------------')
GPIO.sortie(18, GPIO.BAS)
Cette logique contrôle la LED, mais jusqu'à présent, elle n'est pas configurée pour sortir. Configurez-le dans le main() fonction avant que la méthode process_event ne soit appelée.
GPIO.setmode(GPIO.BCM)
GPIO.setup(18, GPIO.OUT, initial=GPIO.LOW)
Maintenant, la broche GPIO est définie sur la sortie et s'initialise dans un état bas. Sauvegarder et quitter. Vous pouvez exécuter votre script modifié en passant votre numéro d'identification de modèle (trouvé dans la console d'action) comme argument.
python hotword.py --device-model-id VOTRE-MODEL-ID-ICI
La sortie du terminal est la même qu'avant et l'assistant fonctionnera en standard. Maintenant, cependant, lorsque vous dites "OK Google, activez", vous verrez une nouvelle sortie :
Remarque : L'image ci-dessus a été recadrée, montrant uniquement l'assistant entendant la demande, et la déclaration d'impression ajoutée au script.
Vous devriez aussi voir votre LED s'allumer !
Ce projet est une bonne introduction à l'utilisation des services de l'API Google. Maintenant que vous disposez d'un appareil doté de l'Assistant Google, essayez quelques-unes des meilleures commandes de Google Home :nous avons examiné d'excellents mini-jeux Google Home.