Contents
Text LinkText LinkText Link
Overview
This is step-by-step guide shows you how best to integrate a CasaTunes system, configured in “System Mode” with RTI Integration Designer 11 using APEX and either the Coral UI Music Player template (default), or the RTI Music template.
“System Mode” vs “Streamer Mode”?
You can configure your CasaTunes music server to operate in one of two modes:
System Mode: In this mode, your CasaTunes music server provides one or more CasaTunes Media Player streams AND controls a CasaTunes supported audio matrix. CasaTunes supports more than 60 different CasaTunes and third party matrices, including the RTI-AD-4/8/4x/8x and the new RTI AD DSP matrices (AD-46-100, AD-810-100, and AD-1616). The primary advantages of this mode are:
- You can use the CasaTunesX App in addition to the RTI panels, keypads and remotes. The CasaTunesX App provides significantly more functionality, as an audio-only App.
- Provides a single point of contact for your whole house music support. CasaTunes Support is recognized as an industry best, and for its quick resolution of customer problems.
Streamer Mode: When in Streamer Mode, the CasaTunes music server provides one or more CasaTunes Media Player streams only. Control of the audio matrix is provided by RTI using an RTI third party audio matrix driver.
This step-by-step guide assumes your music server is configured in “System Mode” and your CasaTunes music server is controlling the audio matrix. A separate guide is available covering Streamer Mode integration.
RTI Coral UI Templates
RTI provides several “canned” music templates you can use with the Coral UI. CasaTunes works with both the Music Player template and the RTI Music template.
The Music Player template is the simplest of the music templates. It offers the following features:
- Now Playing information, which displays information about the currently playing music. This includes cover art, progress bar, song meta-data, thumbs up/down, and control over repeat and shuffle.
- Transport Controls , including moving to the previous/next song, and pausing, playing or stopping play back
- Browse & Select Music view, which allows the user to browse and select the music to listen to
- Favorites, allows the user to select a favorited selection
The RTI Music template provides a super set of the functionality provided by the Music Player template. Additional features include:
- Queue Functionality (if available). Includes viewing the current queue, selecting an item in the queue to play, clearing the queue, and saving the queue as a playlist
- View and select one of My Favorites (CasaTunes playlists)
- Support to search for music
This Music Player template is the easiest to integrate, and is a good template to use if you are new to RTI, or your customers will primarily be using the CasaTunesX App to listen to music.
Pre-requisites
- Set up your CasaTunes system first. CasaTunes reads your CasaTunes music server configuration to automatically configure the driver properties for the CasaTunes driver in Integration Designer
- Make sure your CasaTunes system is powered on and on the same network segment as the RTI controller
- Make sure you download the latest version of the CasaTunes RTI APEX driver for RTI from the CasaTunes web site
Step-by-step instructions
- Setup your CasaTunes system using the CasaTunesX App, including all rooms, sources, room groups (optional), airplay speakers (optional) and music services.
- In Integration Designer, select add workspace item
- Select your RTI processor
- Add your rooms. Recommend you add your rooms in the same order as the rooms are listed in the CasaTunesX App, under Settings > System Setup > Rooms
- Add rooms for any room groups or airplay speakers
- Add your RTI controllers to Global or specific rooms
- In the Drivers tab, change the library option to USER and add the CasaTunes Driver (Make sure the driver version is 5.00 or later).
- Under “CasaTunes Driver”, expand Player and add a player to the Global space for each CasaTunes Media Player (or stream) listed in the CasaTunesX App, under Settings > System Setup > Sources. We recommend naming the player to match the name in CasaTunes. Note: Only add a player for each source in CasaTunesX whose Source Type is “CasaTunes Media Player”. Adding players to the Global space, ensures a player can be used in all rooms.
- Close the workspace
- Select the CasaTunes Driver from the workspace tree
- Select the Discover and Sync CasaTunes menu item. The driver will automatically discover all the CasaTunes music servers on the network, and configure the driver properties based on your music server configuration. By default, the driver discovery feature will setup the driver properties for the Selected Music Server, or for the music server called CASASERVER, if this is a new project. If you have more than one music server, you can select the music server to use from the drop down in Selected Music Server
- Add Rooms, AirPlay Rooms and Room Groups to control. Select Add Workspace Item. Select the Drivers tab. Select the room to add a device to in the left hand panel, and assign the Zone, Zone AirPlay or Zone Group to the selected room. Repeat for each Zone, Zone AirPlay and Zone Group to configure. Make sure Set as room audio source is checked
- Program the Power Zone Off Driver Events
When using the CasaTunesX App and powering off a room, we need to inform the System Manager that the power for the room has changed. We do this using the System “room off” macro.
In the workspace, under Drivers, select CasaTunes Driver
Select Driver Events
For all “Power Off for roomname” events, add the System “room off” macro.
- Select your RTI processor
- Select your RTI processor
- Select your RTI processor
- Select your RTI processor
- Select your RTI processor
RTI Coral UI Templates
Lorem - dolor sit amet, consectetur adipiscing elit. Suspendisse varius enim in eros elementum tristique. Duis cursus, mi quis viverra ornare, eros dolor interdum nulla, ut commodo diam libero vitae erat. Aenean faucibus nibh et justo cursus id rutrum lorem imperdiet. Nunc ut sem vitae risus tristique posuere.
Note
