16
D1535805 User Guide In-Room Control for Touch10. Produced June 2017 for CE9.0. © 2015–2017 Cisco Systems, Inc. All rights reserved
Overview of Widgets
Widgets
About Widgets
The Touch10/DX In-Room Control panel is composed of user
interface elements called widgets. You can nd the complete
widget library in the right pane of the In-Room Control editor.
General tab: Buttons with custom text, group buttons, toggle
button, sliders, text elds and more.
Icons tab: Buttons with familiar symbols for Home, Power, Arrow
up/down/left/right, Camera controls, Loudspeaker controls,
Microphone control, Media player controls, and more.
Each of the widget type available are described on the
following pages, with emphasis on:
•
Commands that change the value of the widget
•
Events that are sent (pressed, changed, released, clicked) and
which actions trigger these events
•
Examples of commands and events, both in terminal output
mode and XML output mode.
Syntax and semantics for all events, commands and statuses that
are related to in-room controls (user interface extensions) are
included in the Command reference chapter.
The Widget Identier
All widgets on a Touch10/DX in-room control panel need a
unique identier, a WidgetID. The WidgetID may either be
dened by you, or assigned automatically. The WidgetID can be
any name or number; we recommend using a descriptive name
without special characters. The maximum number of characters
is 40.
The WidgetID is the programming link between Touch10/DX,
the video system, and the control system. The WidgetID will be
included in all events that are associated with a widget, and you
must use the same identier when you send commands to that
widget via the code that you write for your control system.
Group Identiers
One of the widgets, the Group button, has two types of
identiers: The WidgetID refers to the complete group of buttons,
while GroupIDs are unique identiers for the individual buttons
within the group.
Option 1 Option 2 Option 3
Widget_ID_groupbutton
Group_ID_one Group_ID_two Group_ID_three
A GroupID is assigned automatically, but can be dened by you
instead. A GroupID can be any name or number; we recommend
using a descriptive name without special characters. The
maximum number of characters is 255.