Agent-IC™ (EHX Profile)

Version 2.6

What is Agent-IC™ ?

Agent-IC is an app available on Android and IOS devices which enables them to operate as a mobile intercom client for Eclipse-HX matrix systems and for LQ devices .

This Guide is about the EHX profile. To learn about how to operate in LQ mode, select an LQ profile (as explained in the Getting started section) and come back.

The Android version is designed to operate on devices, both smart phones and tablets, running Android OS version 5.0 and up. You can run the App as soon as you download it from Google Play as it is pre-configured to connect to a demonstration Eclipse-HX system. This will allow you to use Agent-IC and experiment with its innovative and intuitive user interface.



Getting started

First thing you see when you launch Agent-IC is the startup screen.

On the startup screen there is a big round button in the center that connects Agent-IC to an Eclipse-HX system. The connection details (user name and system address) are displayed below the button. These let you know which matrix and user you will connect as when you tap the button.

You can select another profile (saved configuration) from the top bar. 2 LQ profiles and 2 EHX profiles can be selected from. Again, this guide is about Eclipse-HX profile.

To change settings of the currently selected profile, tap the settings icon on the top right of the navigation bar. (we will cover settings later)




Main Keysets screen

Once you are in, you will see the main Keysets screen. This is where the interesting stuff is.


The screen is made up of the status bar on top,


the Keysets region (15 or 24 keys depending on tablet size), small tablets have the option to scroll to see 24 keys


and the Reply key region at the bottom of the screen.




Keyset

A Keyset is a set of controls linked to a named audio resource on the Eclipse-HX system. This may include a Listen (green) and/or a Talk (red) key. Press and hold will activate the key but if you want the key to stay activated then you must use the swipe to latch gesture. From the Talk or Listen button, swipe towards the middle of the key.. To unlatch, repeat the same gesture. You may feel some vibration on your tablet if it supports haptic feedback.

When a key is activated, the background of the keyset changes color. Green means Listen is activated, Red means Talk is activated. The volume bar shows the volume that is set for incoming audio. The Options Menu will open a view to access additional functionality including volume adjustment.

The following are the possible tally icons. They will appear if certain conditions are met.

quaver: Vox, Red : In use, Check: Connected



Keyset Options Menu

The Keyset Options menu is shown when the 3 dots button is tapped. Here you will find a volume slider that allows you to change the volume of audio coming from the Eclipse-HX system. There is also a call button. The call signal is activated as soon as it is touched and deactivated when it is released.


The Options menu will close automatically after some delay upon a valid action, after a timeout, or after the close button (X) is tapped.





Troubleshooting


I'm unable to connect to the matrix

  1. Connection Parameters
  2. In Settings/Connections (insert icon) check:

    • Username
    • Password (passwords are case sensitive)
    • Eclipse system (this may be a name or an IP address)
    • Eclipse port (default 6001)

  3. Network Issues
  4. There may be a number of points where the network connection to the Eclipse-HX matrix frame has failed.

    • Can you Ping the Eclipse system? (Download a Ping app from Google Play Store).
    • If you can Ping the Eclipse system but cannot connect, the problem may be that the port Agent-IC uses on your local network is blocked. Check with your network administrator.
    • If the problem is not with the network, it may be that your network connection is not providing enough bandwidth to support Agent-IC (140 kb/s).

  5. Configuration issues
  6. Are you connecting to your own Eclipse system? If you are connecting to your own Eclipse matrix, and the issue is not with your local firewall (the port is closed) then check the following details with your Eclipse administrator:

    • Hardware: is an IVC-32-HX card installed and configured on the matrix?
    • Software: is the matrix running on Eclipse-HX 8.5 or above?
    • Eclipse configuration: is the Agent-IC client correctly configured in this system?
    • Role allocation: is another Role user still logged in to your Agent-IC client? EHX is Role based. A Role may have many users, but only one user can log in to the Agent-IC client at one time.

My audio quality is broken

This is caused by unreliable IP infrastructure.  Query your IP provider and make sure that your network resources are suitably configured.

I can hear an audio delay

This fault is due to the inherent delay between the matrix and Agent-IC. But certain devices may make it worst if they do not support low latency. Check your device capabilities under Settings.

I hear myself as an echo when talking to another audio source

Some devices do not support acoustic echo cancellation (AEC) when in speaker mode. If one party has a device that does not support AEC, make sure that he uses a headset. Ask the other party to check his device capabilities under Settings.

I need to prolong the battery life

Turn display off when not needed.
Add an extra battery pack to your device.
Close Agent-IC when not needed.
Enable the silence suppression feature in settings.

I need to take a call on my tablet using a VoIP Application (for example, Skype) while I’m using Agent-IC

Using a VoIP application may suspend or interrupt audio to Agent-IC. The Audio will resume when calls are terminated and/or when Agent-IC application comes back to foreground.

After using an Audio Application, agent-IC audio does not come back

When opening and playing audio on audio/video application such as Spotify or YouTube, Agent-IC will interrupt its own Audio. Bringing Agent-IC back to the foreground should re-activate Agent-IC audio (if Agent-IC was in background). If the 3rd party audio application is controlled from the status bar while Agent-IC is running in the foreground, the Speaker Mute button will automatically be activated.

I need another Agent-IC License

See Systems and License information in this guide.

For any other questions

Please consult the Clear-Com solution finder here: Clear-Com Solution Finder