Web Client

In case you feel uncomfortable with installing new software on your machine, or just prefer to use your browser to access the collaboration features, you can make use of the Lite Web Client we devised just for the scope.

This Web Client is completely JavaScript (jQuery) based, and as such should work fine with most of the existing browsers. We tested it with an extensive list of different browsers on different platforms, and everything went fine. Should you have any problem, make sure you check the Troubleshooting subsection at the end of this page, or contact us for help.

The functionality currently provided by the Web Client are the following:

  • Integrated VoIP (standard alternatives available as well)
  • Chatroom (including whispers/private messages)
  • Presentation Sharing
  • File Sharing
  • Whiteboard
  • Desktop Sharing (receive only)
  • Polling

The audio/video stream of a conference can be natively embedded in the Web Client by means of a Java applet: nevertheless, considering the standard nature of Meetecho, several other viable alternatives are provided to Web Client users to access the audio and/or video stream of each session. Specifically, both SIP and RTSP URIs are made available, which can be accessed by making use of third party software (or the browser itself, if enabled). This is especially useful in case you don't want or can't run Java applets in your browser.

 

Accessing the Web Interface

The Web Client can be accessed by pointing your browser to the following location:

 

You will be presented with a simple login form: just insert your credentials (username, password) and you will be authenticated at the conferencing system.

An additional, invite-based transparent login mechanism is also provided in some cases: this will especially be the case for IETF sessions, where only your e-mail address will be requested, and a new account automatically be created for you for the purpose.

 

The list of conferences

Once authenticated you will be presented with the default view of the Web Client.

The default view after the login process is the list of available conference sessions. Active sessions will be highlighted (green light), while currently empty sessions will not.

To join a specific conference session just click on the session you're interested to.

 

Joining a conference

As soon as you join a specific conference session, the view changes, and you are presented with a two-columns layout: on the left are the participants list and the chatroom, while on the right a tabbed view includes all the remaining features.

 

Chatroom and Participants List



The column on the left includes the conference session chatroom and the participants list.

The chatroom is public: just write something in the text area below it and press enter to send your message to the other participants. The chatroom will also include notifications related to other features (e.g. the current slide number, or a new file being shared).

 

 

 

 

 

 

Below it is the participants list. Every time another participant sends you a private message/whisper, a notification appears next to her/his nickname in the list.

 








Clicking on a specific participant will allow you to have a private conversation (whispers) with her/him. Clicking on the participant again (or pressing ESC while in the text area) will hide the related window, while keeping the chat history.

 

 

Tabs

The column on the right, instead, has a simple tabbed view of all the other available features, that is:

  • Presentation Sharing (Slides)
  • Whiteboard
  • Polling
  • File Sharing (Share File)
  • Desktop Sharing (receive only)
  • Media Stream alternatives (Audio/Video)

Just click on a tab to access the related feature: selecting a different tab will just hide the feature, not remove it. Each tab is automatically highlighted whenever something relevant happens to the related feature and the tab is not selected. Clicking on the tab to select it will clear the highlight.

The tab selected by default is "Slides" (Presentation Sharing), since it's the most commonly used.

 

Slides

The "Slides" tab provides the Presentation Sharing functionality. By accessing this tab, you'll be able to either watch an ongoing presentation (if available) or present one yourself. Clicking on the current slide (or the placeholder picture, in case there's no ongoing presentation) will change its zoom level.

To watch an ongoing presentation, just wait for any of the participants to upload one: the Web Client will automatically change slide when the presenter triggers it, so you won't have to do anything. The current slide will also be notified in the chatroom.

To actively present a presentation yourself, press the button on top: this will result in a transparent permission request. As soon as you're allowed to present, there are two ways to start a new presentation:

  1. Choosing a previously uploaded presentation: this will allow you to choose from one of the presentations the system is already aware of for this conference. This is especially useful when some or all of the presentations have been uploaded in advance, and allows for a very quick retrieval of the slides that have to be presented.
     
  2. Uploading a new presentation: this will allow you to choose a presentation from your files (any MS Office/OpenOffice/PDF document is allowed) and upload it. Once chosen, click on "Submit" to actually upload the slides. This will start the uploading process, followed by the server-side processing of the document. This option usually takes a bit longer than the previous alternative, since a real-time processing of the slides is needed before making them available within the conference.

Whichever option you choose, when the operation completes you will be presented with the first slide of the presentation, and numbered shortcuts on the upper side of the slide panel: just click on any number to trigger the related slide (e.g., clicking on "3" will change the current slide to 3) and every other participant will see that slide as well.

If for any reason you want to pass the control of the presentation to another participant in the conference, select the related option on top of the slides: a dropdown menu containing a list of all the participants will be presented. Choose the participant you want to be the new presenter, and then press "Ok". This will present the participant with a popup request: in case she/he accepts to control the slides, the control will be passed to the new presenter and you will become a simple viewer. Of course, this also applies to you in case someone else presented the slides and then wanted to pass the control to you.

In case you want to annotate the current slide, press the "Send slide to whiteboard" button: this will send the current slide to a new tab of the whitebarding tool, thus allowing you and other participants to annotate the slides (see the next section for more details). Sending a slide to the whiteboard is only allowed to the presenter.

To stop the presentation and allow other participants to present another one, just click on "Stop".

 

Whiteboard

The Web Client also allows you to draw on a shared whiteboard: just choose the form you want to draw, color, stroke, and so on, and then start drawing on the canvas. Everything you draw will be drawed with the other participants exploiting the functionality.

This feature is particularly useful for collaborative editing, e.g. to share ideas on possible diagrams and so on.

As anticipated in the Slides section, it is also possible to automatically import the current slide from an ongoing presentation in a new whiteboard tab, e.g. to annotate the slide or to foster discussion. This would open a new tab in the whiteboard, and set the current slide as background image: from that moment, it's possible to annotate the slides, e.g. highlighting points, marking points to be modified, adding text comments, shapes, and so on.

 

Polling

Using this tab you'll be able to both create a new anonymous poll and participate to polls created by other users.

To create a new poll yourself, press the first button, and then follow the directives. You'll have to specify the question to ask other participants (e.g. "Do you think we need that?"), and then add as many options as you deem needed: you'll be able to add more options by clicking on the plus sign next to the latest option. Choose whether you want the poll to be single choice (only a single option may be selected) or multiple choice (more options can be sent in a single vote), and then click on the button below to finally create the poll. The server will then take care of forwarding the poll to all the active participants, and handle the votes and final results.

Whenever a new poll is created by a participant in the conference (including you), this tab will be highlighted, and the poll will be presented as a form. The related question will be presented, together with the available options: according to the poll nature, the options will be either single or multiple choice. To participate to the poll, just select the options you desire, and then press the button below to send your vote. Each vote is anonymous, as are the results.

As soon as the poll has been completed, the results will be presented graphically.

 

Share File

This tab allows you to share a file with the other participants in the conference.

To share a file, just press the button and wait for the permission to upload from the server: as soon as it arrives, you will be allowed to pick a file from your computer. Any file type can be chosen, as long as it is not too large. Once you've chosen the file you want to share, click on submit and the Web Client will take care of the rest.

As soon as the file has been shared, a notification will be sent on the chatroom: this applies to files being shared by other participants than yourself as well. Besides, the file will also be added to the "Share File" tab for a quick reference to all the shared files. Clicking on the shared file will allow you to download it and save it wherever you want.

 

 

Desktop Sharing

This feature is made available in the Web Client as a low-framerate image slideshow. We're currently working on making the same stream available as an RTSP video stream as well.

Whenever someone using a Meetecho Desktop Client shares her/his desktop, a server-side conversion is started in order to make the current desktop sharing session available as a low framerate slideshow. A notification is then provided in the chat, as depicted in the screenshot.

In order to watch the Desktop Sharing session, just go to the Desktop Sharing tab, and the playout will automatically start. Please notice that, due to some buffering, the slideshow may not be immediately available: for the same reason, when playing the slideshow may suffer a few seconds delay compared to the actual screencasting.

No active Desktop Sharing functionality is planned in the near future in the Web Client: if you want to share your own desktop with the other participants, please use the Desktop Client.

 

Audio/Video

Audio and Video are supported within the system via several alternatives:

  • Do you only need to listen?
    Then the streaming solution is probably the best and easiest approach! A live RTSP stream is always available, so just grab a media player (e.g. VideoLan Client) and listen to what's happening. Check the middle part of this section for more details.
     
  • Do you also need to make questions and/or show your video?
    Then you can either exploit the embedded audio/video functionality or access the media stream by means of a SIP or PSTN (landline number) phone. Whichever option better suits you, you'll end up in the conference mix and will be able to participate: all options are described in detail in this section.

 

As anticipated, the Web Client does embed an integrated multimedia functionality: this functionality is made available by means of a Java applet which provides the integrated VoIP features. This means that, just by making use of this applet, it's possible to access the audio and video streams as an active participant by just using the browser.

 

Please notice that this applet-based functionality makes a few assumptions:

  1. That your browser correctly supports Java applets (something that can't always be given for granted);
  2. That your network allows VoIP traffic (specifically, RTP).

In order to test whether or not that's the case for you, visit the following page:

http://weblite.conf.meetecho.com/WebLite/echotest.jsp

which will allow you to start a typical echo test application using the same applet that would be used in the conferencing session. In case something doesn't work as it should, you will probably have to rely on one of the alternatives described in this section to access the multimedia stream. Of course, also please contact us to describe your issue, in order to help us tackle any potential problem that may occur to others as well.

 

IMPORTANT: If you're going to use Firefox on Mac OS, please be aware that due to some well known issues in the community about this configuration (LiveConnect doesn't work as it should) it is highly discouraged that you try launching the applet, since it may cause the applet to fail or even your browser to hang. So, only proceed if you feel brave enough!! :) As an alternative, you might try using Safari instead which should work fine. Also, make sure Java 1.6 is installed and working, since previous versions are known to give problems with applets as well.

 

For the above-mentioned reasons, the VoIP applet is not started by default: to enable it, click on the related button in the Audio/Video tab. In case you're only interested in the audio stream, uncheck the "Enable video" checkbox to make sure only audio is negotiated.

 

This will trigger a server-side media negotiation: if successful, the applet will be properly setup and placed on top of the chatroom. A permission request will be presented by the browser in order to launch the applet: this is a standard security policy for signed applets. Accept it in order to take advantage of the VoIP applet. Then, another popup will appear asking you if you want to block the media stream: again, this is a standard Java Applet security question but this time, of course, deny by clicking no, otherwise video won't be available.

The applet may take a while to initialize the first time it is ever started: this is because of the jars that need to be downloaded (slightly more than 1 MB) so just wait until it appears and starts working.

Once loaded, if you enabled video the applet will show you the video mix of the currently active participants in the conference, or a static logo picture if no one is contributing video to the mix.

For what concerns audio, by default the applet will put you in listen-only mode in the conference: you'll only be allowed to listen to the other active participants. In order to actively participate, you can make use of the "I want to talk!" button to transparently issue a floor request (i.e. ask for the permission to talk): the same button can be used to release the floor (i.e. mute yourself). Two sliders are provided in order to allow you to change the volume for both outgoing and/or ingoing audio, if needed.

For what concerns video, by default the applet will put you in watch-only mode in the conference. If for any reason you also want other participants to see you in the video mix, press the "Send video!" button (of course, this assumes you have a webcam and the applet supports it). As for audio, this will transparently send a floor request for video. If accepted, your contribution will be added to the mix. By default your own contribution will not be included in the mix you receive: if you want it to be included anyway, press the small "mirror" icon on the right side of the button.

You can stop the VoIP applet anytime by just pressing the related button in the Audio/Video tab: this will only stop the multimedia features, while all the other functionality will keep on working.

 

In case you feel uncomfortable with exploiting an applet in your browser, or your browser just doesn't support them, the Web Client is aware of other available media streams as well, which are also notified in the Audio/Video tab.

As it can be seen in the screenshot above, several standard alternatives are provided to access the multimedia stream associated with the conference, namely:

  • An Icecast-based mp3 streaming service (not always available);
  • An RTSP-based audio stream (the audio mix of the conference);
  • A SIP URI to actively participate to the conference;
  • One or more telephone numbers to actively participate the conference (not always available).

All these access points provide different viable alternatives to access the multimedia stream: you can just pick the one that most fits your needs, and open the stream using your favourite third-party software supporting the related protocol.

If you're just interested in listening to the live audio of the conference, the easiest approach is to just use any RTSP-capable player (e.g. VideoLan) to open the provided RTSP stream (the same applies to the mp3 stream, if available).

If instead you're also interested in actively participating to the audio/video discussion, you can use any SIP-capable softphone to access the provided URI to be connected to the audio/video mix. The screenshot below shows a call to the provided URI using Linphone on Linux (audio is G.711, video is H.263).

 

 

 

 

 

 

 

 

 

 

 

Since in Meetecho both audio and video are moderated via BFCP, we also enabled a DTMF-based interface to BFCP to allow you to make floor request using BFCP-unaware softphones. The following BFCP-related DTMF strings are supported:

  • * 5 1: request/release the audio floor (needed to speak);
  • * 5 2: request/release the video floor (needed to send your video);
  • * 5 3: enable/disable the mirror mode (your own video in the mix).

Other DTMF strings are available as well:

  • * 4 8: lower the incoming audio volume;
  • * 6 8: increase the incoming audio volume;
  • * 7 8: lower the outgoing audio volume;
  • * 9 8: increase the outgoing audio volume.

Make sure your softphone sends DTMF tones via RTP, and not as sound or SIP INFO (which, in case you didn't know, is EVIL!), otherwise they won't be captured.

Instructions for accessing the media stream using a PSTN phone are exactly the same: to get the audio floor use the same DTMF string as documented above (*51).

 

 

Leaving a conference session

To leave an ongoing conference session, just click on the related button above the tabs, and you will be brought back to the conferences list.

 

Leaving the Web Client

To cleanly leave the Web Client (that is, without just closing the browser ;-) ), a link in the upper-right corner of the page allows you to logout from the system whenever you want to.

Should your session expire for any reason, the system will automatically remove you in case the account inactive for more than a minute: a refresh is handled automatically in the background by the Web Client itself.

 

Troubleshooting

The Web Client is completely JavaScript based: so, before attempting to access the Web Client, make sure JavaScript is enabled in your browser.

Specifically, it is based on a well-known JavaScript library called jQuery. This library takes care of as many as possible browser/OS-related incompatibilities JavaScript usually suffers from, but cannot possibly take care of them all. Besides, our Web Client scripts may add other incompatibilities as well. We have tested the Web Client with several different browsers on different OS, and usually everything worked as it should.

Nevertheless, there's still a chance that things may be broken on some other specific systems as well: should this happen to you, contact us to describe the issue, and help us improve the application!

 

  1. Your Web Client sucks!
    Hey that's not a question!
     
  2. I can't see any login form!
    The Web Client makes a heavy use of JavaScript, did you enable it in your browser? Besides, is your browser listed as supported by jQuery? A few browsers, as Konqueror for instance, don't seem to support the way jQuery animates objects. Try with a different browser as well, if available.
     
  3. I keep on being redirected to the login form!
    Make sure your browser is not configured to block session cookies for the Web Client website.
     
  4. I can't hear anything!
    The integrated VoIP is not started by default, did you start the VoIP applet in the Audio tab? If so, did you accept the request to allow the applet to be started? Is sound working in other applets? Did the echo test work? Make also sure you're not the only participant in the audio mix (since the server won't obviously include your own contribution in the mix sent to you), or that your firewall/NAT/ALG doesn't filter RTP traffic.
     
  5. When I open the applet, everything hangs and I get an error!
    What is your browser/OS configuration? Which version of Java is installed? Does the echo test work fine instead? If you're using Firefox on Mac OS, please be aware that due to some well known issues in the community about this configuration (LiveConnect doesn't work as it should) it is highly discouraged that you try launching the applet, since it may cause the applet to fail or even your browser to hang. As an alternative, you might try using Safari instead which should work fine. Also, make sure Java 1.6 is installed and working, since previous versions are known to give problems with applets as well.
     
  6. Why can't I send my video? I'm pretty and I want other people to see me!
    Using the applet, due to some JMF-related constraints at the moment video can only be sent on Linux and Windows machines: so, if you're using Mac OS, that's the reason, sorry... if instead you're on Linux/Windows, make sure the webcam is working and recognized by the applet. Refer to the video troubleshooting in the Desktop Client section for more system-specific details.
     
  7. I can't hear anything opening the RTSP stream!
    The RTSP stream is only enabled when there are active participants in the audio mix: if all the participants are only using the other tools (i.e. not the audio functionality), no audio stream will be available for streaming until someone joins the audio mix as well. If that's not your case, make sure your player supports RTSP and the G.711 alaw codec.
     
  8. I can't hear anything accessing the SIP URI!
    Has the call been successfully completed? In some cases, the call may be rejected or fail for some other reason. In case the call was successful, check the codecs enabled in your configuration for both audio and video: for what concerns audio, try falling back to the safest codecs (e.g. G.711, GSM); for video, try and force H.263 as a codec, and either QCIF or CIF as resolutions.
     
  9. The DTMF strings do nothing!
    How is your softphone sending DTMF digits? Make sure RFC2833 is being exploited (DTMF in RTP), since we don't handle audio signals and SIP INFOs.
     
  10. Other questions to follow...
    ... and we will answer them!