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 scripts to start the voice bridge: In the developer's release there is a file lg3d-wonderland/build-tools/import/run-voice.xml. In the binary release, the file to edit is lg3d-wonderland/ant/run.xml.

Edit the file and in the "run-bridge" target add the following line

 <jvmarg value="-Dcom.sun.voip.server.VoIPGateways=<ip address of VoIP gateway>"/>   

If you also have a Sip Proxy add this line:

 <jvmarg value="-Dcom.sun.voip.server.SIPProxy=<proxyIPAddress"/>

Adding a Virtual Telephone

Telephone Administration

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>

   </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>

<-- This creates the navigation links to :  Home | Help | Index | etc.  -->

VNC Viewer Administration

<-- Your JavaDesktop? article goes here. Please try to include at least one sentence describing this topic. -->

<-- Also please try to include at least one sentence describing where each link goes. -->

<-- Please make sure some other page points to your new article so that others can find it! -->

<-- For more on how to write Javapedia articles please read the WritingArticles? page. -->

Summary

Adding a VNC Viewer to your world

The VNC Viewer is loaded into Wonderland using WFS. A sample WFS property file is provided in the wonderland-modules project on java.net:

https://wonderland-modules.dev.java.net/source/browse/*checkout*/wonderland-modules/trunk/src/modules/apps/2d/tightvncviewer/VNC-wlc.xml?content-type=text%2Fplain

To install the VNC Viewer, 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 VNC-wlc.xml to lg3d-wonderland/src/worlds/default-wfs/building-wld/DemoFloor-wld. The default property file loads the viewer at the starting point in the world. It should appear in front of your avatar when you enter the world.

Next, edit the file and customize the following properties:

The IP address or host name of the VNC server:

<void property="server">
    <string>192.168.0.1</string>
 </void> 

The VNC Viewer uses the default VNC port: 5900. If your VNC server is running on a non-standard port, change the port property:

<void property="port">
    <int>5900</int>
</void>

Specify the user name and password:

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

The size of the application is specified in units of pixels. Generally, it makes sense to use the actually resolution of the remote desktop as a starting point. The VNC Viewer will resize to maintain the correct aspect ratio of the remote desktop. Set the preferred size using the following properties:

<void property="preferredWidth">
    <int>1024</int>
</void> 
<void property="preferredHeight">
    <int>768</int>
</void> 

If you need to scale the VNC Viewer to be larger than normal size, use the pixelScale property rather than increasing the preferred size properties. Using pixelScale to scale the VNC session is faster because it uses the hardware scaling capabilities of your graphics card.

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

Deployment Tips

Things to be aware of when deploying the VNC Viewer application.

Application Properties

The VNC Viewer can be pre-configured by setting the following properties in the WFS property file: