Макросы

Макрос — это небольшая программа JavaScript, которая запускается локально на вашем устройстве. Например, вы можете запрограммировать свое устройство на автоматический ответ на входящие вызовы с определенных номеров.

Макросы могут запускать команды интерфейса прикладного программирования (API) для ваших устройств, а также для сторонних систем.

Все активные макросы выполняются на устройстве в одном процессе, называемом Runtime. Из веб-интерфейса устройства вы можете запускать и останавливать среду выполнения по мере необходимости. Runtime изолирован в песочнице, а код надежно изолирован от стандартного программного обеспечения устройства.

Вы можете управлять макросами из Control Hub или из редактора макросов в веб-интерфейсе устройства. Чтобы настроить макросы из Control Hub, вам необходимо сначала включить подготовку макросов для ваших устройств.

В Control Hub вы можете просмотреть изменения, внесенные в макросы, в истории устройства .

Расширения пользовательского интерфейса

Расширение пользовательского интерфейса — это настраиваемая кнопка или панель, которую вы создаете самостоятельно и добавляете на сенсорный экран своего устройства. Например, добавьте кнопку «Быстрый набор» для вызова часто используемого номера или запрограммируйте свое устройство на автоматический ответ на вызовы с определенных номеров.

Расширения пользовательского интерфейса также могут управлять сторонними периферийными устройствами, такими как освещение, жалюзи и видеопереключатели. Когда видеоустройство и периферийные устройства управляются из одного и того же пользовательского интерфейса, вы получаете единообразный пользовательский опыт в конференц-зале. Связь со сторонними системами управления осуществляется через сторонний API.

Открытая платформа позволяет вам создавать настройки, соответствующие вашим существующим рабочим процессам; таким образом, позволяя вам создавать дополнительную ценность помимо основного предложения Webex.

Вот некоторые примеры:

  • Отображение пользовательских данных веб-сервера на главном экране.

  • Сообщение о проблемах в тикет-систему.

  • Сбор акустических данных из помещения и отправка их на веб-сервер, где они могут быть отображены на графике.

  • Управление сторонними периферийными устройствами, такими как освещение, жалюзи и видеокоммутаторы.

Вы можете создавать расширения пользовательского интерфейса с помощью Редактора расширений пользовательского интерфейса в веб-интерфейсе устройства.

Включение подготовки макросов дает вам доступ для чтения и записи к макросам для каждого устройства из Control Hub. После включения все устройства, зарегистрированные в общем режиме, будут загружать свои макросы в Control Hub. Затем администраторы могут редактировать исходный код макроса, загружать локальные копии и загружать макросы на другие устройства.

Чтобы включить подготовку макросов, перейдите в раздел Устройства > Настройки > Макросы в Control Hub и включите Разрешить Control Hub управлять макросами.


  • Имейте в виду, что все макросы будут храниться и зашифрованы в облаке Cisco. Если ваши макросы содержат конфиденциальные данные, не следует включать подготовку макросов Control Hub.

  • Предоставление макросов Control Hub применимо только к устройствам в общем режиме.


Сначала необходимо включить подготовку макросов Control Hub, как описано выше.

Предоставление макросов осуществляется для одного устройства. Чтобы обмениваться макросами между устройствами, вы можете загрузить макрос с одного устройства, а затем загрузить его на другое устройство.

Чтобы получить доступ к макросам для устройств в общем режиме:

  1. В представлении клиента в https://admin.webex.com перейдите к Устройства и выберите устройство, которое вы хотите настроить.

  2. Перейдите в Конфигурации и выберите Макросы.


Панель «Макросы устройства Control Hub»

Отсюда вы можете:

  • Создание, редактирование и удаление макросов.

  • Загружайте и скачивайте макросы (*.js).

  • Включите или отключите макросы.

  • Сохраните изменения.

  • Просмотр журналов макросов.


Если кто-то одновременно редактировал одни и те же макросы из другого веб-сайта, вам будет предложена возможность загрузить копию вашей версии, отказаться от вашей версии или перезаписать другую версию.

Редактор макросов предоставляет редактор кода, инструменты ведения журналов и элементы управления для быстрого тестирования макросов.


Редактор макросов

Войдите в веб-интерфейс устройства, используя учетные данные администратора , и перейдите к Настройки > Редактор макросов. Отсюда вы можете:

  • Создание, редактирование и удаление макросов.

  • Импортируйте или экспортируйте макросы (*.js).

  • Включите или отключите макросы.

  • Просмотрите журналы отладки.

  • Сохраните изменения (Ctrl+S).


    Если кто-то одновременно отредактировал один и тот же макрос из другого веб-сайта, вам будет предложена возможность загрузить копию вашей версии, отменить изменения или перезаписать другую версию.

Редактор расширений пользовательского интерфейса предоставляет инструменты для создания:

  • Кнопки действий — кнопка, добавленная на домашнюю страницу. Кнопку действия можно запрограммировать на выполнение действий при нажатии пользователем.

  • Панели. Панель управления может содержать множество элементов пользовательского интерфейса (например, кнопки, текстовые поля, переключатели, ползунки), каждый из которых можно запрограммировать для выполнения действий. Это позволит вам объединить собственную группу элементов управления в одном месте.

  • Веб-приложения — ярлык веб-приложения, добавленный на домашнюю страницу. Веб-приложение запустит предварительно определенную веб-страницу в полноэкранном режиме. Это доступно на всех устройствах с Web Engine (т. е. устройствах серий Board и Desk, за исключением DX).

Войдите в веб-интерфейс устройства с помощью Администратор, RoomControl, или Интегратор учетные данные и перейдите к Кастомизация > Редактор расширений пользовательского интерфейса.


Редактор расширений интерфейса пользователя

Отсюда вы можете:

  • Добавьте, загрузите, загрузите или удалите расширение пользовательского интерфейса.

  • Создавайте и настраивайте множество типов элементов управления.

  • Установите расширение пользовательского интерфейса в активное или неактивное состояние.

  • Определите, когда расширение пользовательского интерфейса будет видно.

  • Экспортируйте расширения пользовательского интерфейса на видеоустройство или в файл на своем компьютере.

Чтобы подключить расширение пользовательского интерфейса к макросу, вам необходимо использовать уникальный Идентификатор для предмета. Например, идентификатор вашего переключателя может быть «lights_on». Затем вы должны написать макрос, который отслеживает нажатия на экран, и когда он обнаруживает, что кнопка «lights_on» была нажата, он выдает желаемую команду (например, включение/выключение света).

Примеры подключения расширений пользовательского интерфейса к макросам см. здесь.

Дополнительные источники информации

Узнайте больше о создании макросов и расширений пользовательского интерфейса на:

Посетить Сообщество разработчиков Cisco для совместной работы если вам нужна помощь с макросами и сторонним кодом.

Ссылаться на Конфигурации устройств для комнатных и настольных устройств, а также плат Webex для получения информации о том, как получить доступ к локальному веб-интерфейсу.