Alexa-API Documentation

alexaapi icon

Installation du Plugin Alexa-API

Installer le Plugin depuis le Market

installationalexaapi1

installationalexaapi3

Note sur les versions :

Vous avez le choix entre la version Stable ou la version Beta.

Beaucoup de nouvelles fonctionnalités sont toujours plus présentes sur la Beta que sur la Stable mais elles sont en test.

Si vous ĂȘtes joueur et curieux, vous pouvez installer la version BĂ©ta.

Nota  Vous n’avez pas besoin d’installer Jeedom en Beta (c’est plutĂŽt dĂ©conseillĂ© d’ailleurs) pour installer le plugin en BĂ©ta.

Vous pouvez assez facilement passer d’une version Beta Ă  une version Stable et rĂ©ciproquement, il suffit de rĂ©installer par dessus l’autre version.

installationalexaapi4

Activer le Plugin

installationalexaapi5

Recharger les dépendances

installationalexaapi6

Générer manuellement le cookie Amazon

installationalexaapi7

S’identifier sur la pop-up d’Amazon

installationalexaapi8

Fermer la fenĂȘtre dĂšs que le Cookie Amazon est crĂ©Ă©.

Lancer le Daemon s’il ne se lance pas tout seul

installationalexaapi9

 

Lancer le SCAN

installationalexaapi10

Les devices apparaissent, aller dans un device et dans Commandes lancer un Speak pour tester

Et voilĂ , Alexa parle en moins de 5 min !!

Mise Ă  jour ou Changement de version

Que faire ?

Le plugin et son API Ă©tant vivants (Amazon n’ayant pas documentĂ© l’API se permet de modifier au fil de l’eau ses protocoles), les mises Ă  jour permettent d’apporter des corrections dans les liens entre le plugin et le serveur Amazon.

Trois solutions pour avoir une installation opérationnelle :

  • Supprimer tous les Ă©quipements Amazon et leurs commandes et les recrĂ©er
  • Forcer la mise Ă  jour de toutes les commandes
  • Lancer un SCAN qui dĂ©tecte les nouveaux Ă©quipements ou les nouvelles commandes

Le choix entre ces trois solutions dépend du nombre de scénarios que vous avez développés grùce au Plugin Alexa-API. En effet, la premiÚre solution supprime tous les devices et toutes les commandes, elle supprimera donc celles-ci dans vos scénarios. La seconde solution est plus respectueuse de vos scénarios car elle mettra à jour vos commandes sans les supprimer et donc vos scénarios seront intacts mais si elle ne fonctionne pas, vous devrez utiliser la solution 1.

Solution 1 : Supprimer tous les équipements et leurs commandes et les recréer

C’est le mode le plus propre et le plus optimisĂ© puisque vous repartez avec une installation comme neuve des devices et de leurs commandes.

Pour se faire, il faut utiliser le bouton boutonalexaapi1

Attention, cette fonction supprime tous les équipements et leurs commandes, vous perdez donc tous les liens dans vos scénarios.

Solution 2 : Forcer la mise Ă  jour de toutes les commandes

C’est le mode le plus simple et sans risque puisque vos Ă©quipements et leurs commandes ne sont pas supprimĂ©s. Ce forçage n’impacte donc pas vos scĂ©narios.

Pour se faire, il faut utiliser le bouton boutonalexaapi2

Si vous ne souhaitez pas lancer le forçage de mise Ă  jour sur toutes les commandes de tous les Ă©quipements, vous pouvez le lancer sur un seul Ă©quipement (et donc sur toutes ses commandes). Pour cela, rendez vous sur l’équipement concernĂ© et cliquez sur :

boutonalexaapi3

Solution 3 : Le SCAN

boutonalexaapi4

Notez enfin que le scan peut ĂȘtre lancĂ© Ă  tout moment, il n’impacte pas les Ă©quipements dĂ©jĂ  dĂ©tectĂ©s ni les commandes existantes, par contre, il recrĂ©e tous les nouveaux devices ou les devices supprimĂ©s. Il recrĂ©e Ă©galement toutes les nouvelles commandes ou les commandes supprimĂ©es.

Les Ă©crans de gestion

Screenshot 2019 10 27 Alexaapi Jeedom

Scan

Permet de lancer automatiquement la détection de tous vos devices, vous pouvez le lancer quand vous le souhaitez, il ne supprime jamais de device ou de commande, pas de risque.

Configuration

C’est tout le moteur de paramĂ©trage. si quelque chose ne semble pas assez intuitif, merci de nous le signaler, nous le documenterons ou le rendrons plus simple.

Santé

Donne des indications sur la santé de vos équipements

Routines

Donne la liste des routines enregistrées sur votre compte Amazon et permet de les lancer manuellement

Rappels/Alarmes

Donne la liste de vos alarmes ou rappels, permet de les supprimer. La dĂ©sactivation manuelle ne fonctionne pour l’instant plus.

Historique

C’est tout l’historique de l’activitĂ© de vos Ă©quipements Amazon, donne l’indication de succĂšs le cas Ă©chĂ©ant.

RequĂȘteur Info

Réservé aux utilisateurs avertis, il permet de questionner le serveur Amazon

RequĂȘteur Action

RĂ©servĂ© aux utilisateurs trĂšs avertis, il permet de lancer des requĂȘtes brutes au serveur Amazon

Les tuiles

A ce jour, chaque équipement peut générer 3 tuiles.

  • La tuile principale de l’équipement avec ses intĂ©ractions avec vous, vos ordres de speak, les alarmes/rappels, le volume et la possibilitĂ© de lancer les routines
  • La tuile du player multimĂ©dia
  • La tuile de la playlist en cours

La tuile de l’Ă©quipement principal

widgetprincipal

A : C’est la derniĂšre intĂ©raction avec vous, notez que vous pouvez rĂ©cupĂ©rer cette information et l’utiliser dans un scĂ©nario.

B : Vous pouvez lancer une routine en la sélectionnant dans la liste déroulante

C : Le volume, notez qu’il se met Ă  jour si vous modifiez le volume sur l’appareil. (Le volume d’un groupe est imposĂ© Ă  tous les devices du groupe)

D/E/F : C’est la prochaine alarme, alarme musicale ou rappel.

G : C’est un formulaire qui permet de faire parler Alexa.

La tuile du player multimédia

widgetplayer

La tuile de la playlist en cours

widgetplaylist

Commandes simples

Principe

Les commandes simples sont préinstallées à la détection des devices, vous disposez ainsi de commandes immédiatement utilisables.

Les commandes prĂ©installĂ©es peuvent ĂȘtre utilisĂ©es en l’état dans des scĂ©narios.

Sachez que toutes les commandes peuvent faire l’objet d’une adaptation personnelle, les utilisateurs avertis pourront crĂ©er leurs commandes et les personnaliser grĂące aux paramĂštres possibles de chaque commande.

Cette documentation ne s’attarde que peu sur les commandes simples car leur utilisation est rĂ©flĂ©chie pour ĂȘtre intuitive, par contre, les commandes complexes sont dĂ©taillĂ©es dans le prochain chapitre.

Prochaine Alarme

Prochaine Alarme Musicale

Prochain Minuteur

Prochain Rappel

Ces 4 commandes INFO fonctionnent de la mĂȘme maniĂšre.

Elles sont mises Ă  jour automatiquement par le plugin (par MQTT et par CRON)

Le résultat est donné au format suivant : 2019-12-02 21:10:00

Si vous le voulez dans un autre format 2110 par exemple, un tuto explique comment faire.

Faire parler Alexa en SSML

Amazon a intĂ©grĂ© le SSML Ă  ses Ă©quipements et cela permet de rendre extrĂȘmement naturel la maniĂšre de parler. Vous pouvez personnaliser davantage les phrases en fournissant des dĂ©tails sur les pauses, ainsi que la mise en forme audio des acronymes, des dates, des heures, des abrĂ©viations
, vous pouvez Ă©galement choisir la langue de lecture, une citation ou une expression en langue Ă©trangĂšre pourra ainsi ĂȘtre lue avec l’accent Ă©tranger dans un texte de votre langue d’origine.

Contrairement aux autres commandes permettant de faire parler Alexa, sur cette commande, le choix a Ă©tĂ© fait de respecter scrupuleusement la syntaxe du protocole SSML, balises comprises. Il faudra donc utiliser les balises d’ouverture et de fermeture et ĂȘtre rigoureux dans la maniĂšre de coder ces phrases.

Voici des exemples :




Yé m'appel Conchita. yé fé lé ménache partou dans la maichon.

ou


Bonjour je peux lire du SSML.
Je peux faire une pause .
Un chiffre cardinal 10.
en ordinal 10.
ou digit 10.

ou encore

Bonjour, je suis un fantĂŽme

Quelques liens intéressants :

Lancer une annonce (donc sur tous les appareils)

A ce jour, nous ne savons pas encore exploiter la commande “Annonce” prĂ©sente dans l’appli smartphone Alexa, mais nous pouvons faire la mĂȘme chose grĂące Ă  la la commande “Parler Ă  Alexa”

Ainsi, pour faire une annonce “Le facteur est passĂ©, il faut faire (dans un scĂ©nario) :

  • Commande Parler Ă  Alexa
  • Mettre le message dans Message Alexa annonce le facteur est passĂ©

Commandes complexes

Principe

Les commandes simples (paragraphe précédent) sont préinstallées à la détection des devices, vous disposez ainsi de commandes immédiatement utilisables.

Les commandes complexes sont accessibles aux utilisateurs expérimentés et leur utilisation est bien plus difficile mais elles sont bien plus puissantes.

Notez que les commandes simples peuvent ĂȘtre personnalisĂ©es. Elles deviendront des commandes complexes.

Pour cela, utilisez le bouton (sous le tableau des commandes) :

boutonajoutercommandeaction

Vous pouvez vous aider des commandes prĂ©installĂ©es pour en copier la syntaxe et utilisez la documentation ci dessous pour connaitre toutes les options possibles. Si vous souhaitez une autre fonction, un autre format ou que vous ne trouvez pas votre bonheur, contacter l’équipe de crĂ©ation du plugin, il y aura toujours une solution pour vous.

Nota : Pour que la commande “Ajouter une commande action” soit active, il faut cocher cette case dans la configuration du plugin :

Screenshot 2019 12 14 Alexa API Jeedom

alarm?when=#when#&recurring=#recurring#&sound=#sound#

Cette commande permet d’ajouter une alarme au device dans lequel est crĂ©Ă©e la commande.

Voici les options :

  • when=YYYY-MM-DD HH24:MI:SS

exemple : 2019-12-31 21:36:00

Notez que les alarmes sont diffĂ©rentes des rappels et doivent ĂȘtre dans un crĂ©neau de 24h (une alarme pour le 31/12 au mois d’avril est impossible contrairement aux Rappels)

Ainsi, si aucune rĂ©currence n’est programmĂ©e (par le paramĂštre recuring), seule l’heure est prise en compte, le jour est ignorĂ© par Amazon.

  • recurring=#recurring#

La programmation de ce paramĂštre est bien plus aisĂ© par un scĂ©nario puisqu’une liste dĂ©roulante vous permet de facilement choisir la rĂ©currence. Mais cela peut ĂȘtre fait manuellement dans une commande action avec le codage suivant :

P1D=Tous les jours
XXXX-WD=En semaine
XXXX-WE=Week-ends
XXXX-WXX-1=Chaque lundi
XXXX-WXX-2=Chaque mardi
XXXX-WXX-3=Chaque mercredi
XXXX-WXX-4=Chaque jeudi
XXXX-WXX-5=Chaque vendredi
XXXX-WXX-6=Chaque samedi
XXXX-WXX-7=Chaque dimanche

  • sound=#sound#

Il s’agit du son de l’alarme, #sound# peut ĂȘtre remplacĂ© par :

system_alerts_melodic_01 pour Alarme simple
system_alerts_melodic_01 pour Timer simple
system_alerts_melodic_02 pour A la dérive
system_alerts_atonal_02 pour MĂ©tallique
system_alerts_melodic_05 pour Clarté
system_alerts_repetitive_04 pour Comptoir
system_alerts_melodic_03 pour Focus
system_alerts_melodic_06 pour Lueur
system_alerts_repetitive_01 pour Table de chevet
system_alerts_melodic_07 pour Vif
system_alerts_soothing_05 pour Orque
system_alerts_atonal_03 pour LumiĂšre du porche
system_alerts_rhythmic_02 pour Pulsar
system_alerts_musical_02 pour Pluvieux
system_alerts_alarming_03 pour Ondes carrées

reminder?text=#message#&when=#when

Cette commande permet d’ajouter un rappel au device dans lequel est crĂ©Ă©e la commande.

Voici les options :

  • when=YYYY-MM-DD HH24:MI:SS

exemple : 2019-12-31 21:36:00

  • text=#message#

Vous avez la possibilité de donner un titre à votre rappel.

whennextalarm?position=1&status=ON&format=hour

Nota : Cette commande est masquĂ©e, c’est elle qui donne le rĂ©sultat dans la commande info : Next Alarm Hour

Cette commande permet de renvoyer la prochaine alarme du device dans lequel est créée la commande.

Attention, cette commande est une commande ACTION, elle doit ĂȘtre reliĂ©e Ă  une commande INFO qui affichera le rĂ©sultat, regardez l’explication en dessous de la description des options.

Voici les options :

position=x

  • Mettre 1 pour la prochaine alarme
  • 2 pour la suivante
  • et ainsi de suite

Par défaut, position=1 si non spécifié

status=x

  • Mettre ON pour prendre en compte uniquement  les alarmes actives
  • Mettre OFF pour prendre en compte uniquement les alarmes inactives
  • Mettre ALL pour prendre en compte toutes les alarmes

Par défaut, status=ON si non spécifié

format=x

  • Mettre hour pour avoir un rĂ©sultat au format HH:MM (Attention, cet affichage est dangereux dans le cas oĂč vous programmez des alarmes au dela de 24h, cela est possible avec les rĂ©pĂ©titions)
  • Mettre hhmm pour avoir un rĂ©sultat au format HHMM
  • Mettre full pour avoir un affichage dĂ©taillĂ© yyyy-MM-dd’T’HH:mm:ss.SSS

Par défaut, format=hhmm si non spécifié

Nota : Si vous avez besoin d’un autre format, n’hĂ©sitez pas Ă  me le demander, je l’ajouterai dans la prochaine version.

Création de la commande INFO qui affichera le résultat de la commande whenNextAlarm

La commande INFO qui vous donnera le résultat de le la commande WhenNextAlarm sera créée automatiquement dÚs que le champ Nom de la commande Info se trouvant dans la colonne Résultat dans sera rempli.

Explication de l’interaction entre la commande ACTION et la commande INFO

  • Quand vous lancez la commande ACTION, le serveur Amazon est interrogĂ© et la rĂ©sultat est affectĂ© Ă  la commande INFO
  • Quand vous lancez la commande INFO, Jeedom vous donnera donc le rĂ©sultat de la commande ACTION correspondante

(Tout cela est conçu dans la mĂȘme logique que le plugin Virtual)

Nota : S’il n’y aura pas d’alarme prochaine, le serveur rĂ©pond “none”.

whennextmusicalalarm?position=1&status=ON&format=hour

Fonctionne comme whennextalarm mais pour les alarmes musicales.

musicalalarmmusicentity?position=1&status=ON

Fonctionne comme whennextmusicalalarm mais fournit l’information MusicEntity qui correspond Ă  ce qui va ĂȘtre jouĂ© Ă  l’heure de l’alarme.

whennextreminder?position=1&status=ON

Nota : Cette commande est masquĂ©e, c’est elle qui donne le rĂ©sultat dans la commande info : Next Reminder Hour

Cette commande donne le prochain rappel, elle fonctionne exactement comme WhenNextAlarm.

deleteallalarms?type=alarm&status=all

Cette commande supprime tous les rappels et/ou alarmes du device dans lequel est créée la commande.

Voici les options :

type=x

  • Mettre alarm pour ne supprimer que les alarmes
  • Mettre reminder pour ne supprimer que les rappels
  • Mettre all pour supprimer les alarmes et les rappels

Par défaut, type=alarm si non spécifié

status=x

  • Mettre ON pour ne supprimer que les alarmes et/ou rappels actifs
  • Mettre OFF pour ne supprimer que les alarmes et/ou rappels inactifs
  • Mettre ALL pour supprimer toutes les alarmes et/ou rappels

Par défaut, status=ON si non spécifié

Nota : Pour que la suppression fonctionne, il faut que l’Alexa soit connectĂ© !!

history?maxRecordSize=50&recordType = ‘VOICE_HISTORY’

Toute nouvelle commande en test qui va chercher l’historique.

  • maxRecordSize indique le nb d’enregistrement Ă  remonter (50 sur le plugin)
  • recordType est probablement le type d’enregistrement, VOICE_HISTORY est la valeur par dĂ©faut, on ne connait pas les autres valeurs possibles.

command?command=#command#

Cette commande envoie une commande au device dans lequel est créée la commande.

Deux maniùres d’utiliser cette commande :

  • Avec un scĂ©nario

En passant par un scénario, vous laissez command?command=#command# comme commande action et vous aurez une liste déroulante dans le scénario, la liste déroulante vous propose toutes les commandes possibles.

  • Avec une commande directe

Dans ce cas, c’est au niveau des commandes du device que vous allez crĂ©er une commande action par commande Ă  envoyer Ă  Alexa.

Vous utiliserez ainsi la syntaxe suivante : command?command=play pour lancer un play et command?command=pause pour faire une pause et ainsi de suite avec les commandes : pause play next prev fwd rwd shuffle repeat

Nota : STOP n’existe pas chez Amazon, il faut utiliser PAUSE

radio?station=#select#

Cette commande lance une station de radio sur le device dans lequel est créée la commande.

Pour une meilleure utilisation en Dashboard, cette commande a Ă©tĂ© simplifiĂ©e. On peut maintenant sĂ©lectionner la radio souhaitĂ©e plutĂŽt que de connaitre par cƓur le code (s0000) de la radio.

Ainsi, il faut dans un premier temps “configurer” ses stations de radio dans la partie commandes du player qui va la lire.

Screenshot 2019 11 08 Alexaapi Jeedom

Par défaut, sont configurés : s2960|Nostalgie;s6617|RTL;s6566|Europe1

Il suffit de respecter le format idStation1|Nomstation1;idStation2|Nomstation2

Une fois vos stations configurées, vous pourrez les choisir sur le widget de la radio :

radios

Les stations :

Pour trouver les id des stations, allez sur le site https://tunein.com/radio/home/

Vous choisissez votre radio, et pour avoir l’id, cliquez sur partager, vous verrez dans le lien quelque chose qui commence par un s suivi de chiffres, c’est l’id.

Notez que le plugin est capable de vous donner l’id de la station en cours de lecture, la procĂ©dure est identique Ă  TrackID, regardez ici

Utilisation d’une commande radio dans un scĂ©nario

Pour utiliser une commande radio dans un scĂ©nario, il faut ĂȘtre un utilisateur expĂ©rimentĂ© (dans la config) et savoir crĂ©er une nouvelle commande (dans le device player) :

Screenshot 2019 11 08 Alexa API Jeedom

Screenshot 2019 11 08 Alexa API Jeedom1

Sur cette nouvelle commande, on configure de maniùre trùs simple en figeant l’id de la station (ou en utilisant une variable), par exemple :

Screenshot 2019 11 08 Alexaapi Jeedom1

routine?routine=#select#

Cette commande lance la routine spécifiée.

Deux maniùres d’utiliser cette commande :

  • Avec un scĂ©nario

En passant par un scĂ©nario, vous laissez routine?routine=#select# comme commande action et dans le scĂ©nario, dans le champ “ID routine”, spĂ©cifiez l’identifiant de la routine, cf. paragraphe ci dessous pour trouver cet identifiant.

  • Avec une commande directe

Dans ce cas, c’est au niveau des commandes du device que vous allez crĂ©er une commande action.

Vous utiliserez ainsi la synthaxe suivante : routine?routine=xxxxx pour lancer la routine dont l’ID est xxxx

Pour trouver l’ID Routine :

Vous pouvez trouver facilement l’ID des routines en consultant l’écran “Routines” du plugin, derniĂšre colonne de droite.

playmusictrack?trackId=#select#

Cette commande lance la lecture de la piste de lecture Amazon music par son numéro de trackID.

Les trackID se configurent dans la commande action Ecouter une piste musicale dans votre Ă©quipement device, il s’agit d’une liste dĂ©roulante, donc avec la syntaxe suivante :

53bfa26d-f24c-4b13-97a8-8c3debdf06f0|Piste1;7b12ee4f-5a69-4390-ad07-00618f32f110|Piste2

Vous pouvez donc modifier vos pistes et leurs noms.

Screenshot 2019 11 03 Alexaapi Jeedom

Une fois la commande configurĂ©e, vous n’aurez plus qu’à utiliser la liste dĂ©roulante qui sera proposĂ©e, autant sur le Dashboard que dans les scĂ©narios

Comment trouver le trackID d’une piste Amazon-Music ?

Le plugine Alexa-API est capable de vous donner le trackID de la piste qui est en cours de lecture.

Pour cela, suivez ces Ă©tapes :

  • Allez dans les commandes de l’équipement que vous utilisez et cochez la case Afficher de la commande Amazon Music Id

amazonmusicidtrack

  • Une note de musique va apparaitre sur le Dashboard, sur la tuile de votre Ă©quipement, c’est ici qu’apparaitra l’ID
  • Lancez la musique et relevez l’information ainsi affichĂ©e

amazonmusicidtrack2

  • Vous gardez ou pas l’information sur votre dashboard, pour la supprimer, dĂ©cochez Afficher de la commande Amazon Music ID

Notez que cela fonctionne Ă©galement pour trouver l’ID d’une station de musique lançable avec radio?station=#select#

Il a Ă©tĂ© constatĂ© par contre que pour certaines playlist, l’ID ne remontait pas. Pour ĂȘtre certain de l’avoir, lancer uniquement la piste que vous souhaitez (et non dans une playlist).

Autres fonctionnalités

Modifier l’icone des players

Les images des tuiles des players sont les images envoyées par les serveurs des fournisseurs de musique.

Ces images sont des liens temporaires et donc vous pouvez vous retrouver avec des images vides. Cela donne cela :

tuile

Pour Ă©viter cela, les players ont Ă©tĂ© modifiĂ©s et en cas d’absence d’image, la miniature du lecteur est affichĂ©e, cela donne :

tuile2

Si vous souhaitez modifier l’image, il suffit de remplacer le fichier logourl.png qui se trouve dans :

plugins/alexaamazonmusic/core/config (par exemple, modifiez amazonmusic pour les autres players)

Utilisation de balises pour les interjections et les sons

Pour la fonctionnalitĂ© “Faire parler Alexa” mais cela fonctionne Ă©galement pour les autres mĂ©thodes pour faire parler Alexa, il est mis en place deux nouveautĂ©s. Les interjections et les sons de la bibliothĂšque.

  • Les interjections FR sont dĂ©crites ici, les autres pays ont aussi leur page.
  • Les sons de la bibliothĂšque sont dĂ©crits ici

Pour faciliter l’envoi de commandes, il a Ă©tĂ© imaginĂ© dans Alexa-API un systĂšme de balises.

Les sons de la bibliothĂšque Amazon

Par exemple, au lieu d’envoyer

on peut tout simplement ajouter

#animals/amzn_sfx_lion_roar_01#

Lancera le rugissement d’un lion.

Beaucoup d’ autres sons sont dans la bibliothùque de sons d’Amazon.

Les interjections

Sur un principe similaire aux sons de la bibliothĂšque, les interjections sont Ă  mettre entre balise #

Exemple :

EnchaĂźnement texte et interjection

Attention, contrairement aux sons qui peuvent ĂȘtre noyĂ©s dans les phrases, les interjections doivent ĂȘtre dans des phrases sĂ©parĂ©es, ainsi cet exemple ne fonctionnera pas :

Pour que l’interjection soit prise en compte, il faut la mettre dans une phrase sĂ©parĂ©e, donc ajouter un point :

Slider du Volume

Dans la version Avril 2021, le slider du volume a totalement été revu.

Le widget de Noodom (un trÚs grand merci à lui) a été refondu et intégré dans les widgets.

Le widget ressemblait Ă  :

(Utilisez Alexaapi/Volume_legacy maintenant pour avoir ce widget)

et il devient :

(Correspond maintenant Ă  Alexaapi/Volume)

L’encombrement est le mĂȘme pour ĂȘtre compatible avec les designs personnalisĂ©s de chacun.

Personnaliser le widget

Le widget est totalement personnalisable, il suffit d’utiliser les variables du widget NooSlider, une doc est disponible avec tous les paramùtres facultatifs.

Par défaut, les paramÚtres envoyés sont :

  • displayedValues = “0,20,40,60,80,100”
  • step = 10
  • width = 200
  • height = 50
  • handleSize =15
  • cursorLeftPos =50
  • cursorTopPos = 88
  • paramĂštre top non dĂ©finit par dĂ©faut, cf un peu plus bas.

Pour personnaliser votre widget, vous pouvez ajouter le paramùtre en Paramùtres optionnels widget de la commande action “Volume”, par exemple :

Revenir au précédent Widget

Dans l’hypothĂšse oĂč vous souhaitiez conserver l’ancien widget, pas de panique, il est toujours dans le plugin. SĂ©lectionner Volume_legacy 😉

Amélioration de la disposition du widget

Un paramĂštre top est disponible pour caler l’espacement haut du widget, il suffit de le spĂ©cifier ainsi :

Supprimer le logo haut-parleur

Si le petit logo du haut-parleur qui indique le son, hérité de la version précédente du plugin vous gÚne :

Pas de panique, il est tout simple de le supprimer, allez sur votre Ă©quipement, puis dans commandes, cliquez sur ce petit logo en question tout Ă  gauche, il va disparaitre et sauvegardez. Il n’est plus lĂ . (si “Volume” apparait, dĂ©cocher “Afficher le nom” dans les options du Widget)

Information Mute

Une nouvelle information arrive sur le widget des Ă©quipements Alexa.

C’est l’information Mute qui apparait quand on dit à Alexa : Alexa coupe le son.

 

One thought on “Alexa-API Documentation

  1. bonjour,

    j’ai suivi votre doc … sans succĂšs

    le cookie est créé mais rien
    je ferme, je scanne … rien
    je reviens sur la configuration, il me demande toujours de re-créer le cookie
    je le re-crĂ©e … toujours rien

    avez vous une idée de ce qui peut clocher ?

    ps) que veut dire “Configuration du plugin NB : Cette fonctionnalitĂ© n’est disponible que en local, pas Ă  distance !!

    1. bonjour,

      j’ai lu votre message … sans succĂšs
      j’ai relu .. mais rien
      j’ai cherchĂ© un Ă©lĂ©ment pouvant permettre de comprendre la question … rien
      j’ai relu pour trouver quel Ă©tait le problĂšme … rien
      j’ai cherchĂ© un indice pour savoir oĂč vous ĂȘtes bloquĂ© … sans succĂšs.

      Faites un effort si vous voulez de l’aide, je ne suis par ni Mme Irma ni Merlin l’enchanteur.

      SVP, consultez ce post : https://community.jeedom.com/t/comment-nous-aider-a-vous-aider-ou-comment-poser-une-bonne-question/34932
      et utilisez community pour le support.

      Bon courage, Ă  vos dispo sur Community.

      1. Bonsoir,
        J’ai exactement le mĂȘme problĂšme que Pascal.
        J’arrive a gĂ©nĂ©rer le cookie (message : Bravo, …), je sauvegarde
        mais le Demon reste en rouge. Pas de bouton “redemarrer” ???
        Le bouton apparait une fraction de seconde si on clique sur Sauvegarde mais impossible de cliquer dessus…
        Par contre, un message d’erreur apparait “http://192.168.0.10/index.php?v=d&m=alexaapi&p=alexaapi&id=alexaapi 90 Uncaught TypeError: Cannot read property ‘close’ of null”
        A chaque fois que je (re)lance un scan et/ou que je reviens au menu config, on me redemande de générer un cookie.
        Précision : je suis en V4 sur VM Delta

  2. Bonjour
    Depuis un moment j’ai un soucis avec Alexa-API. Le Daemon ne se lance pas et je ne semble pas connectĂ© Ă  Amazon. Je lance donc la fenĂȘtre d’authentification pour crĂ©er le cookie et, Ă  chaque fois, Amazon me dit “RĂ©initialisation du mot de passe requise – Pour votre sĂ©curitĂ©….etc.)
    Si je le fais et que je reviens donc pour crĂ©er le cookie avec le nouveau mot de passe, c’est Ă  nouveau une fenĂȘtre de rĂ©initialisation qui s’affiche. Du coup impossible d’utiliser le plugin…

  3. carrĂ©ment gĂ©nial, merci SIgnalou Domotique, t’es un chef !

    Juste un petit truc, dans le tuto il faut indiquer qu’il faut se rendre dans la page du plugin (et non configuraiton du plugin) pour lancer le scan , ca m’a perdu mais j’ai vite fini par comprendre ha ha ha. G E N I A L ET ENCORE MERCI

  4. Bonjour,

    je suis obligĂ© de regĂ©nĂ©rer chaque semaine le cookie Amazon. Est-ce normal ? cette Ă©tape ne peut-elle pas ĂȘtre automatisĂ©e ?

    Je suis Ă©galement preneur d’une rĂ©ponse Ă  la question posĂ©e prĂ©cĂ©demment : que veut dire « Configuration du plugin NB : Cette fonctionnalitĂ© n’est disponible que en local, pas Ă  distance !!

  5. Bonjour,
    Depuis quelques temps, le plugin ne fonctionne plus (alors que tout fonctionnait super bien, merci pour le temps passé au développement de ce plugin !).
    Je bloque lors de la gĂ©nĂ©ration du cookie, qui me dit systĂ©matiquement qu’il y a une erreur. Est-ce dĂ» Ă  la double authentification (le bug semble venir depuis que mon compte Amazon est passĂ© en double identification).
    Merci pour votre retour
    Vincent

    1. Bonjour,
      Pareil pour moi, cela fonctionnait, puis depuis quelques jours, plus rien…
      J’ai la double authentification, pour demander le code OTP j’ai ouvert une autre fenĂȘtre avec http://ip-jeedom:3457
      J’ai ensuite la confirmation avec Toad content, cela me met Bravo dans la config du plugin, mais le service tombe toujours aprĂ©s quelques secondes…
      Merci par avance pour vos contibutions, car ce pluin est top !
      Guillame

  6. Bonjour,

    Super plugin trĂšs pratique mais lorsqu’il est activĂ©, Alexa parle un peu trop. Je m’explique…

    J’utilise le plugin Hombridge pour lancer des scĂ©nario depuis Alexa. Mais lorsque Alexa-API est activĂ© Ă©galement, on dirait que cela remonte des infos Ă  Alexa et lorsque je lui dis par exemple “Alexa ouvre le portail” elle l’ouvre bien et rĂ©pond “OK”. Puis 1 seconde aprĂšs elle ajout” C’est fait, Maison – portail – fermĂ© visage souriant 0 pourcent”.
    Mon Ă©quipement dans jeedom s’appelle bien “portail” et est dans le groupe “Maison” mais je ne comprends pas pourquoi elle dit ça, ni pourquoi elle dit “fermĂ©”, et ni pourquoi elle ajoute “visage souriant 0%” .
    Si je désactive le plugin, ca ne le fait plus.
    Une idée de la cause de ce problÚme.
    Idem pour la lumiĂšre, elle ajoute “salon – lumiĂšres LED – ON”.

  7. Hello, dĂ©jĂ  c’est super tout ce que tu fais, merci beaucoup!!!
    Mais depuis la maj d’hier, mes appareils Alexa rĂ©agissent alĂ©atoirement Ă  des commandes du genre “alexa stop” (pour arrĂȘter la musique), et la elle me rĂ©pond Ok volet bas stop et elle descend le volet.
    C’est trĂšs Ă©trange car j’ai du dĂ©sactiver l’Alexa API pour revenir Ă  un fonctionnement normal de mes appareils. Je me servais beaucoup d’Alexa smart home et du plugin amazon music, mais j’ai du stopper malheureusement.
    Suis je le seul Ă  rencontrer des soucis depuis la maj?
    merci

  8. Bonjour,

    je viens d’installer le plugin mais malheureusement cela ne fonctionne pas. Le demon est bien lancĂ© et je me connecte a mon compte amazon pour la gestion du cookie. Mais lorsque j’appuis sur scan rien ne se produit, je viens de regarder dans les logs (alexaapi_node) j’ai cette erreur : Alexa-Remote: Cookie was set, but authentication invalid. alors que je me connecte sur le bon compte et le bon mot de passe (copier/coller du mot de passe pour ĂȘtre sur).

    Merci pour l’aide que vous m’apporterez

  9. Bonjour,

    cela fait deux jours que le demon de l’apply ne veut pas se lancer. j’ai tentĂ© de refaire le cookies mais ca Ă  l’air de coincer chez Amazon?

    Avez-vous des informations Ă  ce sujet?

    Merci.

Laisser un commentaire