ClearOne StreamNet Integration - Manual (Page 40)

34 Technical Sales: 1.800.705.2103
USER INTERFACE (UI) SERVICE
Overview
A UI service handles all of the configuration and control for a particular user interface. Some common
functionality provided by UI services are:
Converting key press commands to other ASCII commands. 1.
Converting IR codes to key press commands or other ASCII commands. 2.
Forwarding commands to a subordinate UI component such as a keypad or Flash GUI. 3.
Unlike most other service types, UI services tend to have differing functionality from device to device.
INTERCOm SERVICE
Overview
Behind the scenes, the operation of the intercom service is very complex; but for basic intercom operation only
a few commands are required.
An Intercom session is like a conference call between two or more intercom zones. More than one simultaneous
session may exist for any zone. For simplicity, the StreamNet Intercom service completely manages multiple
Intercom sessions; the controller need not worry about the possibility of multiple sessions. It is possible for the
controller to take complete control of the Intercom sessions but that will not be covered here.
Currently there are three kinds of Intercom Sessions:
A. Station to Station(s) Session
This session type allows two-way communication between two or more intercom stations. When a user
presses the Push-to-Talk button their voice is transmitted to the other stations in the session. Communication
is half-duplex (Only one station may Transmit at a time.) This session will time out after a configurable time if
there is no activity.
b. Room monitoring Session
This session type allows stations in one or more rooms to listen to (monitor) another room. This not very
different from a Station to Station session except that in the room being monitored the microphone is on by
default. Stations can talk to the room being monitored by pressing their Push-to-Talk buttons. This session will
stay active until terminated.
C. Door Answering Session
This type of session is initiated when the DoorBell button of a DoorLinX is pressed. This session is very
similar to the Room Monitoring session. The Door station is room being monitored. The DoorLinX will play an
announcement MP3 file at the beginning of the session. This session will time out after after a configurable
time if there is no activity.
Station to Station
To start a Station to Station Session send the following command to the zone which is initiating the call:
#INTERCOm CREATE, “ID”, “audience”
This message is sent by a user interface or third party controller to an intercom service causing the intercom
service to create an intercom session between itself and the specified audience.
“ID” is the name of the session. It may be any string but should usually be the same as the “audience”. This
is the name of the session that should be displayed on the User Interface.
“audience” is the service, room or group whose participation is desired. The “audience” is an ASCII protocol
“ToAddress” which is used internally by the IC service to send out commands to start the session.