Le système d'interphone vidéo à reconnaissance faciale Anjielo TUYA peut publier des événements de périphérique (appels entrants, déverrouillage de serrure, reconnaissance faciale) via Tuya Cloud OpenAPI/Webhook.
Le système d'interphone vidéo à reconnaissance faciale Anjielo Smart Technology TUYA prend entièrement en charge le partage des événements de contrôle d'accès avec des plates-formes tierces de gestion de bâtiment via l'interface Tuya Cloud.
Le chemin d'implémentation technique spécifique est le suivant :
Mécanisme d'ouverture des données (intégration Cloud-to-Cloud) : Nos appareils sont basés sur la plateforme Tuya IoT et supportent un mode d'intégration "cloud-to-cloud" standard. Vous n'avez pas besoin d'opérer le matériel ; au lieu de cela, vous vous connectez à votre plateforme via la plateforme de développement Tuya Cloud.
Requête proactive : Vous pouvez obtenir de manière proactive le statut des appareils, les informations sur le personnel ou les enregistrements d'accès historiques en appelant l'OpenAPI de Tuya.
Push d'événements (Noyau) : Pour vos besoins "en temps réel" les plus importants (tels que les appels entrants, le déverrouillage de porte), le système supporte l'abonnement aux messages (Webhook). Lorsqu'un événement se produit, Tuya Cloud poussera de manière proactive les données (HTTP POST) à votre adresse de serveur spécifiée, sans que vous ayez besoin de faire du polling.
Données d'événement spécifiques pouvant être rendues publiques : Selon la définition officielle de la fonction de l'appareil par Tuya, les données suivantes peuvent être rendues publiques via l'interface cloud :
Événements d'accès : Inclut la méthode d'ouverture de porte (visage, mot de passe, carte, à distance), l'URL de l'image de capture faciale lors de l'ouverture de la porte, l'ID utilisateur, et si l'opération a réussi. Par exemple, le champ `way` retournera 4 lors de l'ouverture de la porte avec la reconnaissance faciale.
Événements d'interphone vidéo/appel : Supporte les rappels pour les appels de sonnette, les réponses, les raccrochages et les appels manqués.
Alarmes de contrôle d'accès : Inclut les alarmes d'effraction, les alarmes de flânerie et les alarmes de tentatives multiples de déverrouillage.
Pour le développement et le débogage, il est recommandé de procéder comme suit :
Créez un projet "Développement Cloud" sur la plateforme Tuya IoT et obtenez l'Access ID et l'Access Secret pour l'authentification de l'interface.
Configurez l'abonnement aux messages : Dans le projet de développement Cloud, définissez votre point de terminaison de réception de serveur HTTP et abonnez-vous aux messages pertinents tels que "Enregistrements de contrôle d'accès" et "Alarmes d'appareil".
Utilisez l'OpenAPI pour obtenir une liste d'appareils ou des pièces jointes d'images capturées.
Le point d'entrée de la documentation technique officielle d'intégration cloud-to-cloud de Tuya est le suivant. En raison de la longueur et de la mise à jour continue de la documentation principale, il est recommandé d'accéder directement à la plateforme de développement Tuya. Ci-dessous, Anjielo Smart Technology a compilé les chemins d'accès directs les plus cruciaux et l'index des documents pour votre référence :
I. Points d'entrée de la documentation principale
* **Documentation principale sur la connectivité Cloud-to-Cloud (votre point d'entrée principal)**
Adresse de la documentation : https://developer.tuya.com/cn/docs/iot/cloud_cloud_connection
Résumé : Présente l'architecture globale et les processus clés de la connectivité Cloud-to-Cloud (Création de produit → Définition de fonction → Développement d'appareil → Intégration d'API → Débogage et vérification), et comment les systèmes commerciaux tiers peuvent accéder à l'écosystème Tuya via OpenAPI.
* **Documentation du service d'abonnement aux messages (le cœur de l'implémentation du push d'événements)**
Adresse de la documentation : https://developer.tuya.com/cn/docs/iot/integrate-mq
Résumé : Explication détaillée de l'utilisation du SDK Tuya Pulsar pour recevoir les messages rapportés par les appareils (y compris les événements de contrôle d'accès, les événements d'alarme, etc.), y compris le code d'exemple Java, la configuration de l'environnement et la gestion des erreurs courantes.
Liste des API du service d'accès au Cloud
La documentation principale d'accès au Cloud contient des outils de débogage d'API et des descriptions d'interface complètes, y compris des capacités d'accès southbound telles que l'enregistrement d'appareils, la mise en ligne d'appareils et le rapport d'attributs.
II. Documents clés pour les scénarios de contrôle d'accès
Voici les documents spécialisés directement liés à votre système d'interphone intelligent de contrôle d'accès :
Documentation d'accès au contrôle d'accès d'interphone intelligent (version Android)
Adresse de la documentation : https://developer.tuya.com/cn/docs/iot/smart-access-control
Contenu principal :
Interface de rapport d'événements d'accès : Inclut le champ `way` (méthode d'ouverture de porte : 1 carte/2 mot de passe/4 visage/9 à distance, etc.), `imageId` (ID d'image capturée)
Flux d'appels vidéo : Rappels d'état d'appel, de réponse et de raccrochage
Interfaces de gestion des résidents/visages/cartes d'accès/codes QR/mots de passe
Documentation iOS de l'interphone intelligent Cloud
Adresse de la documentation : https://developer.tuya.com/cn/docs/iot/smart-access-control r.tuya.com/cn/docs/app-development/ios-saas-smart-community-speaker
Contenu principal : Protocole de communication entre l'application et les appareils de contrôle d'accès, énumération de l'état d'appel (appel en cours, appareil déconnecté, déconnexion par timeout, répondu, etc.)
III. Outils de développement et ressources auxiliaires
* Outil open source tuya-connector (pour une intégration cloud-to-cloud rapide)
Adresse GitHub : https://github.com/tuya/tuya-connector
Fonction : Fournit un client HTTP basé sur des annotations et un client d'abonnement aux messages, simplifiant le traitement sous-jacent tel que la signature, le chiffrement/déchiffrement et la mise en cache, vous permettant d'appeler l'OpenAPI comme s'il s'agissait d'une méthode locale.
Spécification de vérification de signature (essentiel pour la sécurité)
Toutes les requêtes de rappel sur la plateforme Tuya portent des signatures HMAC-SHA256, qui doivent être vérifiées côté serveur.
Paramètres clés : client-id, timestamp, sign, payload
Formule de vérification de signature : Chaîne à signer = client-id + timestamp + payload
Point d'entrée de l'outil de développement
Page d'accueil de la plateforme de développement Tuya IoT : https://developer.tuya.com/
Après vous être connecté, allez à "Développement Cloud" → "Projet Cloud" pour obtenir l'Access ID et l'Access Secret
IV. Ordre de lecture suggéré
Si c'est la première fois que vous travaillez avec l'intégration cloud-to-cloud, nous vous recommandons de lire dans l'ordre suivant :
Tout d'abord, lisez le document principal "Accès Cloud-to-Cloud" → Comprenez le processus global et les étapes d'activation
Ensuite, lisez "Service d'abonnement aux messages" → Maîtrisez le mécanisme de push d'événements (c'est la clé des appels de sonnette et des événements d'accès en temps réel)
Enfin, lisez "Accès au contrôle d'accès d'interphone visuel" → Comparez avec des points de données spécifiques (points DP) et les paramètres d'interface
Utilisez tuya-connector → Construisez rapidement une démo pour vérification
V. Canaux de support technique
Si vous rencontrez des problèmes spécifiques pendant l'intégration, vous pouvez obtenir de l'aide via les canaux suivants :
Forum des développeurs Tuya : https://tuyaos.com/ (Support technique officiel et discussions communautaires disponibles)
Soumettre un ticket de support : Après vous être connecté à la plateforme des développeurs Tuya, soumettez un ticket de support technique via la console.
