Skip to main content

Verto Communicator

Click to expand Table of Contents

About

Verto Communicator is one example of web clients that can be implemented on top of mod_verto.

Dependencies

We'll use NodeJS based tools to be able to quickly run tests, lint, build and serve Verto Communicator.

Installing node and npm on a Mac could simple as running:

brew install npm

Or you can follow the instructions on NodeJS site.

The tools we'll need for now are:

npm install -g grunt grunt-cli bower

You can test Verto Communicator features via dialing "3500" number on server with vanilla config.

FreeSWITCH

Specific settings

livearray-json-status

You'll need to set flag livearray-json-status in your members-flags, for more info check mod_conference page.

livearray-json-status flag in your conference profile

<param name="conference-flags" value="video-floor-only|rfc-4579|livearray-sync|minimize-video-encoding|livearray-json-status"/> 

caller-controls

Edit you conference.conf.xml and make sure you have these caller-controls:

caller-controls for Verto Communicator

<caller-controls>    
<group name="default">
<control action="deaf mute" digits="**"/>
    <control action="mute" digits="0"/>
    <control action="vmute" digits="*0"/>
    <control action="vmute snap" digits="*1"/>
    <control action="vmute snapoff" digits="*2"/>
    <control action="energy up" digits="9"/>
    <control action="energy equ" digits="8"/>
    <control action="energy dn" digits="7"/>
    <control action="vol talk up" digits="3"/>
    <control action="vol talk zero" digits="2"/>
    <control action="vol talk dn" digits="1"/>
    <control action="vol listen up" digits="6"/>
    <control action="vol listen zero" digits="5"/>
    <control action="vol listen dn" digits="4"/>
    <control action="hangup" digits="#"/>
  </group>
</caller-controls>

Building for Production

After installing the dependencies, simply build it using:

cd verto_communicator
npm install
bower install
grunt build

The commands above with leave a dist/ folder on the currrent working directory with all the files necessary to deploy Verto Communicator minified. Just copy them over to any webserver and that's it.

Developing and Contributing

After installing the dependencies, let's setup the project:

cd verto_communicator
npm install
bower install
grunt serve

This will leave a server running on your local machine serving the necessary files to Verto Communicator to work. Just open Chrome and browse to: https://localhost:9001.

Languages

Verto Communicator now has i18n support. Currently we support:

  1. English - default
  2. Italy

The language detection is based on the browser language.

Adding translation

To add more languages you need to:

cd /usr/src/freeswitch/html5/verto/verto_communicator/src/
cp locales/locale-en.json locales/locale-yourlanguage.json

Translate the strings and register the new available language:

html5/verto/verto_communicator/src/vertoApp/vertoApp.module.js

$translateProvider
.useStaticFilesLoader({
prefix: 'locales/locale-',
suffix: '.json'
})
.registerAvailableLanguageKeys(['en', 'it', 'pt', 'fr'], {
'en': 'en',
'en_GB': 'en',
'en_US': 'en',
'it': 'it',
'it_IT': 'it',
'fr': 'fr',
'fr_FR': 'fr',
'fr_CA': 'fr',
'pt': 'pt',
'pt_BR': 'pt',
'pt_PT': 'pt'
})
.preferredLanguage('en')
.fallbackLanguage('en')
.determinePreferredLanguage()
.useSanitizeValueStrategy(null);

Add your language in the registerAvailableLanguageKeys function. All done.

See Also