Telephone Integration

Connecting to the Telephone Network

The voice bridge is configured to work with IP phones such as the SIP Communicator which comes with the voice bridge or any SIP IP Phone handset. In the latter case, the handset must be configured to use the voice bridge as the SIP Proxy and SIP Registrar.

No additional hardware is needed for phone calls unless the user wants to connect to the public switched telephone network. In that case, a SIP VoIP / PSTN gateway is required. The gateway must to connected to the IP network and also to the Phone system which is usually done via a T1 line.

We have used a Cisco 3745 Gateway voice VoIP^? modules. Asterisk can also be used as the gateway. See http://www.asterisk.org/ for more information on how to set up an Asterisk system. You can also use a third party provider such as Junction Networks. The jVoiceBridge wiki provides information on how to set this up.

Regardless of the type of gateway used, the voice bridge must be configured to use the gateway. This can be done in one of two ways. The first way configures the running voice bridge and must be redone each time the voice bridge is started:

telnet <voice bridge ip address> 6666
voipGateways=<ip address of VoIP gateway>
detach

If you have SIP Proxy you can specify that with

telnet <voice bridge ip address> 6666
defaultSipProxy=<ip address of SIP proxy>
detach

The second way requires editing the properties file: In the developer's release edit or create lg3d-wonderland/my.build.properties. In the binary release edit or create lg3d-wonderland/my.run.properties. Add the following lines to the appropriate file:

voicebridge.sip.gateways=<gateway IP address, alternate gateway IP address, ...>
voicebridge.sip.proxy=<IP Address of SIP Proxy>

You may also need to configure the gateway to allow access from the voice bridge and to forward incoming calls to the voice bridge. For information about configuring the gateway see the section on Configuring a SIP / VoIP to PSTN Gateway: http://wiki.java.net/bin/view/Communications/JVoiceBridge

Adding a Virtual Telephone

The virtual telephone is loaded into Wonderland using WFS. A sample WFS property file is provided here: ConferencePhoneWFSFile

To install the phone, copy the WFS property file to the WFS directory on your Wonderland server. For example, to install the viewer in the default Wonderland MPK20 world, copy the WFS file to lg3d-wonderland/src/worlds/default-wfs/building-wld/DemoFloor-wld.

Next, edit the file and customize the following properties:

The default setting for demoMode is true. This means that phone calls will be simulated. This setting can be changed dynamically in the phone dialog. Set it to false if you don't want the default to simulate calls.

   <void property="demoMode">
     <boolean>true</boolean>
    </void>

The password is used to unlock the phone and take it out of simulation mode. If there is no password property specified, the phone is always unlocked.

    <void property="password">
     <string>1234</string>
    </void>

phoneNumber is used to identify the phone. If there is a PSTN gateway configured to handle incoming calls, the caller will be prompted to enter the number of the phone to call.

    <void property="phoneNumber">
     <string>1</string>
    </void>

This is a jvoicebridge treatment to play when an incoming call asks for the list of phones. A treatment is either a .au audio file or "tts:" followed by text which FreeTTS wil convert from text to speech.

    <void property="phoneLocation">
     <string>tts:It is located on the demo floor</string>
    </void>

The zeroVolumeRadius is the radius at which the volume drops to zero. The fullVolumeRadius is the radius at which volume in which the volume level is full volume. XXX need to specify the units!

An avatar which is within the fullVolumeRadius will hear the person on the phone at full volume. The person on the phone will hear the avatar at full volume. As the avatar moves away from the phone outside the full volume radius, the volume will attenuate with distance. At the point where the avatar reaches the zero volume radius, the volume will drop to 0.

    <void property="zeroVolumeRadius">
      <double>.2</double>
    </void>

    <void property="fullVolumeRadius">
      <double>.1</double>
    </void>

The origin is the location within the WFS cell where the phone is to be placed. XXX Need to specify the units!

   </object>
  </void>
  <void property="origin">
   <void index="0">
    <double>4.0</double>
   </void>
   <void index="1">
    <double>0.7</double>
   </void>
   <void index="2">
    <double>0.0</double>
   </void>
  </void>

Once you've installed the file in the WFS directory, restart the Wonderland server, or use the Wonderland Manager application to reload WFS.