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'application (API) pour vos appareils, ainsi que pour des systèmes tiers.

Toutes les macros actives s'exécutent dans 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, selon vos besoins. Le Runtime est en sandbox et le code est isolé de manière sécurisée du logiciel standard de l'appareil.

Vous pouvez gérer les macros depuis Control Hub ou l' Éditeur de macros sur l'interface Web de l'appareil. Pour configurer les macros à partir de Control Hub, vous devez d'abord activer le provisionnement des 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 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 utilisateur cohérente dans la salle de réunion. La communication avec les systèmes de contrôle tiers se fait via le tiers API.

La plateforme ouverte vous permet de créer des personnalisations liées à vos flux de travail existants ; ainsi, vous permettant de créer une valeur supplémentaire au-delà de l'offre principale Webex.

Voici quelques exemples :

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

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

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

  • Contrôler des périphériques tiers, tels que des lumières, des stores et des mélangeurs vidéo.

Vous pouvez créer des extensions d'interface utilisateur à partir de l' éditeur d'extensions d'interface utilisateur dans 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és, tous les appareils enregistrés en mode partagé téléchargeront leurs macros sur Control Hub. Les administrateurs peuvent ensuite modifier le code source de la macro, télécharger des copies locales et télécharger les macros sur d'autres appareils.

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


  • Sachez que toutes les macros seront stockées et chiffrées dans le Cisco Cloud. 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 appareils en mode partagé.


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

Le provisionnement des macros est fourni sur la base d'un seul appareil. Pour partager des macros entre appareils, vous pouvez télécharger une macro depuis un appareil, puis la télécharger sur un autre appareil.

Pour accéder aux macros des appareils en mode partagé :

  1. Dans la vue client dans 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 de périphérique du Control Hub

À partir de là, vous pouvez :

  • Créez, modifiez et supprimez des macros.

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

  • Activez ou désactivez les macros.

  • Enregistrez vos modifications.

  • Afficher les journaux de macros.


Si quelqu'un a simultanément modifié les mêmes macros à partir d'un autre emplacement Web, des options vous seront proposées pour télécharger une copie de votre version, supprimer votre version ou écraser l'autre version.

L' éditeur de macros fournit un éditeur de code, des outils de journalisation et des commandes permettant de tester rapidement les macros.


Éditeur de macros

Connectez-vous à l'interface Web de l'appareil à l'aide des informations d'identification administrateur et accédez à Personnalisation > Éditeur de macros. À partir de là, vous pouvez :

  • Créez, modifiez et supprimez des macros.

  • Importez ou exportez des macros (*.js).

  • Activez ou désactivez 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, des options vous seront proposées pour télécharger une copie de votre version, annuler votre modification ou écraser l'autre version.

L' éditeur d'extensions d'interface utilisateur fournit des outils permettant de 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 l'appuie.

  • Panneaux - Un panneau de contrôle 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.

  • Applications Web – Un 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 appareils dotés d'un moteur Web (c'est-à-dire les appareils Board et Desk Series, à l'exclusion de DX).

Connectez-vous à l'interface Web de l'appareil en utilisant Administrateur, RoomControl, ou Intégrateur informations d'identification et accédez à Personnalisation > Éditeur d'extensions d'interface utilisateur.


Éditeur d'extensions d'interface utilisateur

À partir de là, vous pouvez :

  • Ajoutez, 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 de l'interface utilisateur sera visible.

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

Pour connecter une extension d'interface utilisateur à une macro, vous devez utiliser l'unique Identifiant pour l'article. Par exemple, l'identifiant de votre bascule peut être "lights_on". Ensuite, vous écririez une macro qui surveillait les pressions sur l'écran et lorsqu'elle détectait que le bouton "lights_on" était enfoncé, elle émettrait 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

Apprenez-en davantage sur la création de macros et d'extensions d'interface utilisateur à partir de :

Visiter le Communauté de développeurs Cisco Collaboration si vous avez besoin d'aide avec les macros et le code tiers.

Faire référence à Configurations des appareils pour les appareils de salle et de bureau et les cartes Webex pour plus d'informations sur la façon d'accéder à l'interface Web locale.