ClearOne StreamNet Integration - Manual (Page 25)

Chapter 4: Overview of Services 19
Chapter 4: Overview of Services
The scope of this manual is to provide details on how to integrate a 3rd Party Controllers with a StreamNet IP-
Based Media Distribution system.
It is assumed that the user understands User Datagram Protocol (UDP), TCP and Unicast and multicast
addressing.
It is also assumed that the user has used the
StreamNet Dealer Setup tool to configure the StreamNet
system.
This chapter and the subsequent information in this document explain how to communicate with the StreamNet
system and integrate a 3rd Party Controller with a StreamNet system.
COmmUNICATING WITH THE STREAmNET SySTEm
The StreamNet protocol uses ASCII messages to communicate with services associated with the devices in
the StreamNet system. These messages are either control or status messages.
SERVICES
In the StreamNet system, system/device functions are grouped together into logical constructs called Services.
A single StreamNet device may host multiple services. All communication with StreamNet is addressed to one
or more of these services hosted by the individual devices.
ASCII messages are not addressed to devices but to these virtual services which reside on each device. This
scheme alleviates the need to know the IP addresses of every StreamNet device.
Service Names
Every service must have a unique name which can be used to address ASCII messages. Every service may
have a room name associated with it. Services may also be assigned to multiple group names. Service names,
room names and group names may all be used to address ASCII messages. If a room name is used as an
address, all services assigned to that room will react. If a group name is used, all services assigned to that
group will react. There is a special group name (All) to which all services will react.
Service Types
The following is a list of service types supported, although not all physical StreamNet devices support all the
listed services.
• Audio Renderer
Audio/Video Renderer •
• Audio Source
Audio/Video Source •
• Audio-only Stream Proxy
User Interface ( • UI)
• Intercom
General Purpose IO ( • GPIO)
• Root