Macros

Une macro est un petit programme JavaScript qui s'exécute localement sur votre appareil. Par exemple, vous pouvez programmer votre appareil pour répondre automatiquement aux appels entrants provenant de numéros spécifiques.

Les macros peuvent exécuter des commandes d'interface de programmation d'applications (API) pour vos périphériques, ainsi que pour des systèmes tiers.

Toutes les macros actives s'exécutent en un seul processus sur l'appareil, appelé Runtime. À partir de l'interface Web de l'appareil, vous pouvez démarrer et arrêter le runtime, si nécessaire. Le runtime est en bac à sable (sandbox) et le code est isolé en toute sécurité du logiciel standard de l'appareil.

Vous pouvez gérer les macros à partir de Control Hub ou de l'éditeur de macros sur l'interface Web de l'appareil. Pour configurer des macros à partir de Control Hub, vous devez d'abord activer le provisionnement de macros pour vos appareils.

Dans Control Hub, vous pouvez voir les modifications apportées aux macros dans l'historique de l'appareil .

Extensions d'interface utilisateur

Une extension d'interface utilisateur est un bouton ou un panneau personnalisé que vous créez vous-même et que vous ajoutez à l'écran tactile de votre appareil. Par exemple, ajoutez un bouton "Numérotation rapide" pour appeler un numéro fréquemment utilisé ou programmez votre appareil pour répondre automatiquement aux appels provenant de numéros spécifiques.

Les extensions d'interface utilisateur peuvent également contrôler des périphériques tiers, tels que des lumières, des stores et des commutateurs vidéo. Lorsque le périphérique vidéo et les périphériques sont contrôlés à partir de la même interface utilisateur, vous bénéficiez d'une expérience cohérente dans la salle de conférence. La communication avec les systèmes de contrôle tiers se fait via le API tiers.

La plate-forme ouverte vous permet de créer des personnalisations qui s'attachent à vos flux de travail existants ; ainsi, vous permettant de créer de la valeur ajoutée au-delà de l'offre Webex de base.

En voici quelques exemples :

  • Affichage des données de serveur Web personnalisées sur l'écran principal.

  • Signaler les problèmes à un système de billetterie.

  • Collecter des données acoustiques de la pièce et les envoyer à un serveur Web où elles peuvent être tracées.

  • Contrôle des périphériques de fabricants tiers, tels que l'éclairage, les stores et les commutateurs vidéo.

Vous pouvez créer des extensions d'interface utilisateur à partir de l'éditeur d'extensions d'interface utilisateur de l'interface Web de l'appareil.

L'activation du provisionnement des macros vous donne un accès en lecture et en écriture aux macros appareil par appareil à partir de Control Hub. Une fois activé, tous les appareils enregistrés en mode partagé téléchargeront leurs macros dans Control Hub. Les administrateurs peuvent ensuite modifier le code source des macros, télécharger des copies locales et télécharger les macros sur d'autres périphériques.

Pour activer le provisionnement des macros, accédez à Périphériques > Paramètres > Macros dans Control Hub et activez Autoriser Control Hub à gérer les macros.


  • Toutes les macros de Control Hub sont stockées et chiffrées, mais pas à l'aide de la clé privée du client, dans le cloud Cisco. Si vos macros contiennent des données confidentielles, vous ne devez pas activer le provisionnement des macros Control Hub.

  • Le provisionnement des macros par Control Hub s'applique uniquement aux périphériques en mode partagé.


Vous devez d'abord activer le provisionnement des macros par Control Hub, comme décrit ci-dessus.

La configuration des macros est fournie sur une seule unité. Pour partager des macros entre appareils, vous pouvez télécharger une macro à partir d'un appareil, puis la télécharger sur un autre appareil.

Pour accéder aux macros des périphériques en mode partagé :

  1. Dans la vue client en https://admin.webex.com, accédez à Appareils et sélectionnez l'appareil que vous souhaitez configurer.

  2. Accédez à Configurations et sélectionnez Macros.


Panneau Macros du périphérique du concentrateur de contrôle

Vous pouvez alors :

  • Créer, modifier et supprimer des macros.

  • Chargez et téléchargez des macros (*.js).

  • Activer ou désactiver les macros.

  • Enregistrez vos modifications.

  • Afficher les journaux des macros.


Si quelqu'un a simultanément modifié les mêmes macros à partir d'un autre emplacement Web, vous aurez la possibilité de télécharger une copie de votre version, d'ignorer votre version ou d'écraser l'autre version.

L'éditeur de macros fournit un éditeur de code, des outils de journalisation et des contrôles pour tester rapidement les macros.


Éditeur de macros

Connectez-vous à l'interface Web de l'appareil à l'aide des informations d'identification admin et accédez à Personnalisation > Éditeur de macros. Vous pouvez alors :

  • Créer, modifier et supprimer des macros.

  • Importer ou exporter des macros (*.js).

  • Activer ou désactiver les macros.

  • Consultez les journaux de débogage.

  • Enregistrez vos modifications (Ctrl+S)


    Si quelqu'un a simultanément modifié la même macro à partir d'un autre emplacement Web, vous aurez des options pour télécharger une copie de votre version, ignorer votre modification ou écraser l'autre version.

L'Éditeur d'extensions d'interface utilisateur fournit des outils pour créer :

  • Boutons d'action - Un bouton ajouté à la page d'accueil. Le bouton d'action peut être programmé pour effectuer des actions lorsqu'un utilisateur appuie dessus.

  • Panneaux - Un panneau de configuration peut contenir de nombreux éléments d'interface utilisateur (par exemple, des boutons, des champs de texte, des commutateurs, des curseurs), qui peuvent tous être programmés pour effectuer des actions. Cela peut vous permettre de combiner votre propre groupe de contrôles dans un emplacement commun.

  • Web Apps – Raccourci d'application Web ajouté à la page d'accueil. L'application Web lancera une page Web prédéfinie en plein écran. Ceci est disponible sur tous les périphériques dotés d'un moteur Web (c'est-à-dire les périphériques Board et Desk Series, à l'exception de DX).

Connectez-vous à l'interface Web de l'appareil à l'aide des informations d'identification Admin, RoomControl ou Integrator et accédez à Customization > UI Extensions Editor.


Éditeur d'extensions de l'interface utilisateur

Vous pouvez alors :

  • Ajoutez, téléchargez, téléchargez ou supprimez une extension d'interface utilisateur.

  • Créez et configurez de nombreux types de contrôles.

  • Définissez une extension d'interface utilisateur sur active ou inactive.

  • Définissez quand l'extension d'interface utilisateur sera visible.

  • Exportez vos extensions d'interface utilisateur sur le périphérique vidéo ou dans un fichier de votre ordinateur.

Pour connecter une extension d'interface utilisateur à une macro, vous devez utiliser l'ID unique de l'élément. Par exemple, l'ID de votre basculement peut être "lights_on". Ensuite, vous écririez une macro qui surveillait les robinets d'écran et lorsqu'elle détectait que le bouton "lights_on" était tapé, elle émettait la commande souhaitée (par exemple, allumer / éteindre les lumières).

Pour obtenir des exemples de connexion d'extensions d'interface utilisateur à des macros, voir ici.

Pour en savoir plus sur la création de macros et d'extensions d'interface utilisateur, consultez :

Si vous avez besoin d'aide sur les macros et le code tiers, rendez-vous sur la site de la communauté de développeurs Cisco Collaboration.

Reportez-vous à la section Configuration des périphériques pour les périphériques de salle et de bureau et les cartes Webex pour plus d'informations sur l'accès à l'interface Web locale.