Macro

Una macro è un piccolo programma JavaScript che viene eseguito localmente sul dispositivo. Ad esempio, è possibile programmare il dispositivo per rispondere automaticamente alle chiamate in arrivo da determinati numeri.

Le macro possono eseguire i comandi dell'API (Application Programming Interface) per i tuoi dispositivi e per i sistemi di terze parti.

Tutte le macro attive sono in esecuzione in un singolo processo sul dispositivo, denominato Runtime. Dall'interfaccia Web del dispositivo è possibile avviare e interrompere l'esecuzione, in base alle esigenze. Il runtime è in modalità sandbox e il codice viene rimosso in sicurezza dal software standard del dispositivo.

È possibile gestire le macro da Control Hub o dall'Editor di macro nell'interfaccia Web del dispositivo. Per configurare le macro da Control Hub, devi prima abilitare il provisioning macro per i tuoi dispositivi.

In Control Hub, puoi visualizzare le modifiche apportate alle macro nella cronologia del dispositivo.

Estensioni UI

Un'estensione UI è un pulsante o un pannello personalizzato creato dall'utente e aggiunto alla schermata touch del dispositivo. Ad esempio, aggiungere un pulsante "Chiamata rapida" per chiamare un numero utilizzato frequentemente o programmare il dispositivo per rispondere automaticamente alle chiamate di numeri specifici.

Le estensioni UI possono anche controllare periferici di terze parti, come luci, cieche e switch video. Se il dispositivo video e le periferiche sono controllate dalla stessa interfaccia utente, si ottiene un'esperienza utente congrue nel sala riunioni. La comunicazione con i sistemi di controllo di terze parti viene eseguita tramite l'API di terze parti.

La piattaforma aperta consente di creare personalizzazioni da collegare ai flussi di lavoro esistenti; consentendo quindi di creare valore aggiuntivo oltre l'offerta base di Webex.

Alcuni esempi sono:

  • Visualizzazione dei dati del server Web personalizzato sulla schermata principale.

  • Segnalazione di problemi a un sistema di ticket.

  • Raccolta dei dati acustici dalla sala e invio a un server Web in cui possono essere inviati.

  • Controllo di periferiche di terze parti, come luci, ciechi e scambiatori video.

È possibile creare le estensioni dell'interfaccia utente dall'Editor estensioni interfaccia utente nell'interfaccia Web del dispositivo.

Abilitando il provisioning macro si ottiene l'accesso in lettura e scrittura alle macro in base al dispositivo da Control Hub. Una volta abilitata, tutti i dispositivi registrati in modalità condivisa caricano le macro in Control Hub. Gli amministratori possono quindi modificare il codice sorgente delle macro, scaricare copie locali e caricare le macro su altri dispositivi.

Per abilitare il provisioning macro, vai a Dispositivi > Impostazioni > Macro in Control Hub e attiva Consenti a Control Hub di gestire le macro.


  • Tutte le macro in Control Hub sono memorizzate e crittografate, ma non utilizzando la chiave privata del cliente, in Cisco Cloud. Se le macro contengono dati riservati, non è necessario abilitare il provisioning macro di Control Hub.

  • Il provisioning di Control Hub delle macro si applica solo ai dispositivi in modalità condivisa.


Devi prima abilitare il provisioning delle macro in Control Hub come descritto sopra.

Il provisioning macro viene fornito su una base di singolo dispositivo. Per condividere le macro tra i dispositivi, è possibile scaricare una macro da un dispositivo e quindi caricarla su un altro dispositivo.

Per accedere alle macro per i dispositivi in modalità condivisa:

  1. Dalla vista cliente in https://admin.webex.com, vai a Dispositivi e seleziona il dispositivo che desideri configurare.

  2. Vai a Configurazioni e seleziona Macro.


Pannello Macro dispositivi Control Hub

Da qui, è possibile:

  • Creare, modificare ed eliminare macro.

  • Carica e scarica le macro (*.js).

  • Abilitare o disabilitare le macro.

  • Salvare le modifiche.

  • Visualizza i registri macro.


Se qualcuno ha modificato contemporaneamente le stesse macro da un'altra posizione Web, verranno visualizzate le opzioni per scaricare una copia della propria versione, eliminare la propria versione o sovrascrivere l'altra versione.

L'editor macro fornisce un editor di codice, strumenti di registrazione e controlli per un test rapido delle macro.


Macro Editor

Accedere all'interfaccia Web del dispositivo utilizzando le credenziali di Amministrazione e passare a Personalizzazione > Editor di macro. Da qui, è possibile:

  • Creare, modificare ed eliminare macro.

  • Importare o esportare macro (*.js).

  • Abilitare o disabilitare le macro.

  • Esaminare i registri di debug.

  • Salvare le modifiche (Ctrl+S)


    Se qualcuno ha modificato contemporaneamente la stessa macro da un'altra posizione Web, verranno visualizzate le opzioni per scaricare una copia della versione, eliminare la modifica o sovrascrivere l'altra versione.

L'Editor estensioni UI fornisce gli strumenti per la creazione di:

  • Pulsanti azione: un pulsante aggiunto alla home page. Il pulsante dell'azione può essere programmato per eseguire azioni quando un utente tocca il pulsante.

  • Pannelli: un pannello di controllo può contenere molti elementi dell'interfaccia utente (ad esempio, pulsanti, campi di testo, switch, cursori), tutti elementi che possono essere programmati per eseguire azioni. Ciò consente di combinare il proprio gruppo di controlli in una posizione comune.

  • App Web: un collegamento all'app Web aggiunto alla home page. L'app Web avvia una pagina Web predefinita in schermo intero. Questa opzione è disponibile su tutti i dispositivi con motore Web (ad esempio, dispositivi serie Board e Desk, ad esclusione di DX).

Accedere all'interfaccia Web del dispositivo utilizzando le credenziali Admin, RoomControl o Integrator e passare a Personalizzazione > Editor estensioni interfaccia utente.


Editor estensioni UI

Da qui, è possibile:

  • Aggiungere, caricare, scaricare o eliminare un'estensione UI.

  • Creare e configurare molti tipi di controlli .

  • Impostare un'estensione UI su attiva o inattiva.

  • Definire se l'estensione UI sarà visibile.

  • Esportare le estensioni DELL'interfaccia utente sul dispositivo video o su un file sul computer.

Per connettere un'estensione dell'interfaccia utente a una macro, è necessario utilizzare l'ID univoco per l'elemento. Ad esempio, l'ID per l'interruttore potrebbe essere "lights_on". Quindi, si potrebbe scrivere una macro che controlla gli indicatori di schermo e quando viene rilevato che il pulsante "lights_on" è stato toccato, si emettere il comando desiderato (ad esempio, attivare/disattivare le luci).

Per esempi di connessione delle estensioni dell'interfaccia utente alle macro, vedere qui.