Cisco Touch10 User Manual

28
D1535805 User Guide In-Room Control for Touch10. Produced June 2017 for CE9.0. © 2015–2017 Cisco Systems, Inc. All rights reserved
Events
Command Reference
UserInterface Extensions Widget Action
Sent by the video system when someone uses one of the
controls on the user interface (in-room control panel).
Equivalent to the UserInterface Extensions Event Type event.
Depending on the action type, this event is equivalent to one of
these events:
•
UserInterface Extensions Event Pressed
•
UserInterface Extensions Event Changed
•
UserInterface Extensions Event Released
•
UserInterface Extensions Event Clicked Events
<Event>
<UserInterface item=”1”>
<Extensions item=”1”>
<Widget item=”1”>
< A c t io n ite m = ”1”>
<WidgetId item=”1”>WidgetId</WidgetId>
<Value item=”1”>Value</Value>
<Type item=”1”>Type</Type>
</Action>
</Widget>
</Extensions>
</UserInterface>
</Event>
in which:
WidgetId : String (0, 40)
The unique identier for the widget that triggered the event.
Value : String (0, 255)
The value of the widget. The range of allowed values depends on
the widget type.
Type : <Pressed/Changed/Released/Clicked>
Pressed: Sent when a widget is rst pressed.
Changed: Sent when changing a widget’s value (only for toggle
buttons and sliders).
Released: Sent when a widget is released (even if moving the
nger out of the widget before releasing it).
Clicked: Sent when a widget is clicked (pressed and released
without moving the nger out of the widget).
UserInterface Extensions Widget LayoutUpdated
Sent by the video system when the conguration le for the user
interface extensions has been updated, i.e. when exporting a
new conguration from the in-room control editor to the video
system.
*e UserInterface Extensions Widget LayoutUpdated
or
<Event>
<UserInterface item=”1”>
<Extensions item=”1”>
<Widget item=”1”>
<LayoutUpdated item=”1”/>
</Widget>
</Extensions>
</UserInterface>
</Event>

Cisco Touch10 Specifications

General

Display Size	10.1 inches
Resolution	1280 x 800 pixels
Touch Technology	Capacitive
Connectivity	Ethernet, Wi-Fi
Power	Power over Ethernet (PoE)
Mounting	Tabletop or wall mount
Processor	ARM-based processor
Compatibility	Cisco video conferencing systems

Summary

Introduction

Definition of Terms

Defines key terms used in the document related to video systems and control.

In-Room Controls

Explains how to customize the Touch 10/DX user interface for peripheral control.

What Is In-Room Control?

More About How In-Room Control Works

Creating a User Interface

Creating a User Interface for the Touch10

Guides on creating custom user interface panels for peripheral controls on the Touch10/DX.

Launch the In-Room Control Editor

Steps to access and start the In-Room Control Editor via the web interface.

A Tour of the In-Room Control Editor

Provides an overview of the In-Room Control Editor interface and its functionalities.

Application Programming Interface (API)

API for Programming In-Room Controls

Details how to connect to the video system and communicate using the API.

API for Programming In-Room Controls (Cont.)

Covers events for widget actions, distinguishing between terminal and XML output modes.

API for Programming In-Room Controls (Cont.)

Explains events for panel updates and page opening/closing.

API for Programming In-Room Controls (Cont.)

Discusses commands and statuses for widgets, including SetValue.

Widgets

Overview of Widgets

Introduces widgets as user interface elements and explains widget identifiers.

Switch

Describes the two-state switch widget, its events, and commands.

Slider

Details the slider widget for value selection, its events, and commands.

Button

Covers the button widget, its states, events, and commands.

Group Button

Explains the group button widget for linked selections, events, and commands.

Icon Button

Describes icon buttons, their behavior, events, and commands, similar to text buttons.

Spinner

Details the spinner widget for stepping through values, its events, and commands.

Text

Explains the text widget for displaying information, its events, and commands.

Directional Pad

Describes the directional pad widget, its buttons, events, and use cases.

Spacer

Explains the spacer widget as a layout tool with no associated events or commands.

Command Reference

Events

Details the various events sent by the video system for widget actions.

Events (Cont.)

Continues the description of events, including Widget Action and LayoutUpdated.

Commands

Lists and explains commands like SetValue, UnsetValue, and Clear.

Statuses

Explains how to retrieve widget status using the xStatus command.

Use of a Video Switch

Using a 3rd Party Video Switch to Extend the Number of Video Sources Available

Explains how to configure and use external video switches with the Cisco codec.

Command Details

Provides details on commands for managing external video sources.

Video Switch Example

Illustrates a practical setup and configuration for using a video switch.

Troubleshooting

Using the Development Tools on the Web Interface for Troubleshooting

Guides on using web interface tools like Log and Widget State Overview for troubleshooting.

Tips and Tricks

Recommended Best Practice

Offers best practices for event feedback, widget initialization, and panel updates.

Recommended Best Practice (cont.)

Continues best practices with examples for lights, temperature, blinds, and buttons.

Who Has Access?

Granting Access to In-Room Control Editor and Extensions API

Explains administrator rights and user account creation for accessing the editor.

Room Simulator

Running the Simulator

Provides instructions on how to launch and use the In-Room Control simulator.