Agent-IC™ (LQ 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 LQ profile. To learn about how to operate in EHX mode, select an EHX 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 LQ 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 when LQ Profile is selected.

On the startup screen there is a big round button in the center that allows you to connects Agent-IC to an LQ device. The connection details (user name and system address) are displayed below the button. These let you know which LQ 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 LQ profile.

To change settings, 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.



The status bar

The status bar gives you status information and general purpose buttons.

From left to right:

  • the disconnect button (will disconnect from LQ and return to the starting page);
  • the connected user;
  • the scrolling disable; will deactivate scrolling gesture
  • the speaker mute button; the microphone mute button (the mute buttons will light bright blue when activated);
  • and the settings button.



Keyset

A Keyset is a set of controls linked to an audio channel and defined as part of a role on the LQ system. The keyset can have up to 4 keys, 2 primary keys shown on the normal side and 2 secondary keys available in the option menu. Keys can be of the following types Listen, Talk , Call, Event1, Event2 or RMK.   Press and hold will activate the key but for the latchable keys (Listen and Talk), if you want the key to stay activated then you must use the swipe to latch gesture. From the Talk or Listen key, swipe towards the middle of the keyset. To unlatch, repeat the same gesture. You may feel some vibration on your tablet if it supports haptic feedback.

When a latchable key is activated, the background of the keyset changes color. Green means Listen is activated, Red means Talk is activated. This background is not visible when the latchable key are in the option menu. 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 Channel indicators represent Channel events or Call event .

The keyset status shows whether the channel is in listen or talk mode using green and red arrows like in the CCM

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 LQ system. This is also when you have access to the secondary keys that can be configured in a keyset. The same keys can be available as the ones defined for the primary keys. Swipe to latch is not available here so to latch a latchable key, you just need to tap on the button. They are configured as toggle button. The other actions are triggered on a tap as well but no latch will occur.


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



The Reply key region

The Reply region is where you find the Reply key and its associated actions. The Reply key is located on the right side and can be hidden when no call is present. You can disable the auto-hide feature in settings. Swiping the logo will display the Reply key momentarily.

This is what is displayed when the Reply key is revealed. The dimmed arrows are lit when calls are waiting and the clear icon (X) is lit if there is at least one call.


You can also see 2 bars (one green and one red) at the top of the Reply region. These serve as VU meters for incoming audio (green) and outgoing audio (red).

Reply key activated

This is the Reply key when it is active. It may be flashing an incoming call or not, but this state means that tapping and holding the key will activate Talk towards the destination.


This is the state of the key when it is pressed.




Profile quick access

For Android devices using the latest Android OS (7.0 and up), it is possible to launch Agent-IC directly with a pre-selected Profile from the launcher screen.


A Long press on the Agent-IC main Icon will display a menu allowing you to select either the EHX Profile 1 or the LQ Profile 1.

Moreover, you can drag those menu item to wherever you want on the launcher screen and create direct Application shortcut that you can use later with a single tap to launch Agent-IC with your preferred profile.



Settings

The Settings page allows you to change configurable options of the app, and most importantly, to configure the details needed to connect to an LQ system.

To connect to an LQ Device you must set the IP address of the LQ Device that you want to connect to. The port is usually 6001, but may be different if the system is behind a firewall. The user and password must match one configured in LQ CCM under Agent-IC accounts.



The Operation section allows to select a Role





The selected Role manages the keyset operation. The user can select a role only if the LQ CCM account configuration is not associated to a role. If not selected, the default role will be used.

More Settings

The Audio and Other settings sections are shown here.

The Audio section. You can select the network quality here.

In the Audio section, you can also enable the silence suppression feature for audio coming from LQ (default is ON).

The Other section includes several local features that can be enabled.

"Ringtone for Notification" controls sound on notification (currently only a call signal is considered a notification). "Enable Vibration ..." controls vibration of the device on the same notification. Finally, the "Reply always visible" sets the display of the Reply key, otherwise it may be visible only when there is an incoming call.

Other Section for future use.

Capabilities

The last section of the Settings page is read only.

Capabilities

The Echo Cancellation and Audio Latency capabilities as reported by your device are shown in this section. This section is read only.

The information contained here can be helpful when troubleshooting issues with audio such as echo or delay.

Troubleshooting


I'm unable to connect to LQ

  1. Connection Parameters

    In Settings/Connections section check:

    • Username
    • Password (passwords are case sensitive)
    • LQ system (this may be a name or an IP address)
    • LQ port (default 6001)
  2. Network Issues

    There may be a number of points where the network connection to the LQ System has failed.

    • Can you Ping the LQ system? (Download a Ping app from Google Play Store).
    • If you can Ping the LQ 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).
  3. Configuration issues

    Are you connecting to your own LQ system? If you are connecting to your own LQ device, and the issue is not with your local firewall (the port is closed) then check the following details with your System administrator:

    • Hardware: Is the LQ system properly powered and connected to an accessible network ?
    • Software: Is the LQ running on proper version for Agent-IC support (4.0 and up )?
    • LQ configuration: is the Agent-IC account and roles correctly configured in this system?

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 LQ and Agent-IC. But certain devices may make it worst if they do not support low latency or if the network quality is not good. 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.

For any other questions

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