[zoic21]

Alexa reçoit les changements des commandes d’information exposées par ASH, sans devoir interroger Jeedom au préalable. Cette PR dépend de jeedom/cloud-service#13.

Description

• Option Envoyer les changements d’état à Alexa, désactivée par défaut pour permettre un déploiement coordonné.
• Listeners sur les commandes info réellement associées aux capacités Alexa ; capture de la valeur et de la date de l’événement pour conserver les transitions rapides.
• Une seule file locale sur disque et envoi HTTP en arrière-plan, avec reprise par le cron minute. Le cloud envoie directement à Amazon et renvoie les erreurs temporaires au plugin : aucune file ni nouvelle table côté serveur.
• Déduplication locale des valeurs répétées et identifiant de rapport conservé pendant les reprises. Le serveur utilise les callbacks existants pour les comptes, boxes et groupes.
• Conversion d’état partagée entre interrogations et événements, horodatages UTC et instances normalisées.
• proactivelyReported activé seulement pour les capacités effectivement lisibles. La lecture d’état n’exécute pas les actions et les scènes restent exclues.
• Alexa.EndpointHealth est fourni dans les snapshots, avec proactivelyReported: false, car Jeedom ne fournit pas de signal immédiat fiable pour tous les changements de disponibilité.

Suggested changelog entry

Ajout de la remontée automatique des états vers Alexa, avec reprise des envois et horodatages UTC.

Documentation et déploiement

Voir la documentation ASH et la procédure Amazon/cloud-service. Déployer d’abord le serveur et les autorisations Amazon, puis activer l’option ASH et relancer une découverte Alexa.

Types of changes

• New feature
• Bug fix
• Documentation improvement

Validation

• 22 vérifications fonctionnelles PHP réussies avec un environnement Jeedom simulé : option inactive par défaut, listeners, états indisponibles, absence d’exécution d’actions, UTC, transitions ON/OFF, déduplication, reprise réseau, rotation de clé et nettoyage.
• Vérification syntaxique des 25 fichiers PHP du périmètre avec PHP 8.3 ; syntaxe compatible PHP 7.3.
• Tests de contrat, routage et stockage OAuth côté cloud-service dans la PR associée.

L’essai de bout en bout avec une skill et un compte Amazon de développement reste à réaliser avant publication.