'''[[Q-Sims - The OpenSim metavers for QNAP|Q-Sims Homepage]]''' <br> <br>
=== This page contains the following errors: ===
__TOC__
<div style="font-family:monospace;font-size:12px">error on line 1 at column 2051: Unescaped '<' not allowed in attributes values </div>
=== Below is a rendering of the page up to the first error. ===
</parsererror>
''by AdNovea - June 2009''<br/>'''[[Q-Sims_-_The_OpenSim_metavers_for_QNAP|Q-Sims Homepage]]'''<br/><br/>__TOC__
= Installation =
= Installation =
<blockquote>
<blockquote>
* 1-Download, 2-Install and do not Enable '''FreeSwitch''' QPKG.
*1-Download, 2-Install and do not Enable '''FreeSwitch''' QPKG.
* Redirect '''port 5060''' on your router
*Redirect '''port 5060''' on your router
* If Q-Sims FULL Edition is not yet installed and you intend to use it, you have nothing more to do. Proceed with the Q-Sims installation.<br>If Q-Sims FULL Edition is already installed and configured, you must re-run the Q-Sims FULL Edition QSA to configure FreeSwitch for Q-Sims (''update the freeswitch/conf/autoload_configs/xml_curl.conf.xml file''). Stop/Restart Q-Sims, wait and Enable FreeSwitch.
*If Q-Sims FULL Edition is not yet installed and you intend to use it, you have nothing more to do. Proceed with the Q-Sims installation.<br/>If Q-Sims FULL Edition is already installed and configured, you must re-run the Q-Sims FULL Edition QSA to configure FreeSwitch for Q-Sims (''update the freeswitch/conf/autoload_configs/xml_curl.conf.xml file''). Stop/Restart Q-Sims, wait and Enable FreeSwitch.
* Enable Voice chat in the '''Preferences/Voice chat'''.
*Enable Voice chat in the '''Preferences/Voice chat'''.
[[Image:Q-Sims_Voice_Chat_Prefs.jpg|thumb|center|500px|Voice configuration in the preferences]]
[[File:Q-Sims Voice Chat Prefs.jpg|thumb|center|500px|Voice configuration in the preferences]]
* Enable voice on your terrains ('''World/About land/Media''')
*Enable voice on your terrains ('''World/About land/Media''')
[[Image:Q-Sims_Voice_Chat_Lands.jpg|thumb|center|500px|Voice configuration on lands]]
[[File:Q-Sims Voice Chat Lands.jpg|thumb|center|Voice configuration on lands]]<blockquote>
*Enable '''Voice''' in each Land (''also referred as terrain or regions'') BUT also configure each parcel if you terrain has been divided.
<blockquote>
<blockquote>
* Enable '''Voice''' in each Land (''also referred as terrain or regions'') BUT also configure each parcel if you terrain has been divided.
*'''Voice: Use the Estate spatial channel''': There is a common channel for the whole region (''256x256 meters'') and you can chose to use it for your land/parcel voice chat
<blockquote>
*'''Voice: Use a private spatial channel''': A specific channel is created for your land/parcel
* '''Voice: Use the Estate spatial channel''': There is a common channel for the whole region (''256x256 meters'') and you can chose to use it for your land/parcel voice chat
*'''Sound: Restrict spatialized sound to this parcel''': Check it if you don't want the Voice chat to be accessible for visitor outside your parcel (''land sub division'') - ''function not yet implemented''
* '''Voice: Use a private spatial channel''': A specific channel is created for your land/parcel
</blockquote></blockquote></blockquote>
* '''Sound: Restrict spatialized sound to this parcel''': Check it if you don't want the Voice chat to be accessible for visitor outside your parcel (''land sub division'') - ''function not yet implemented''</blockquote>
[[Image:Q-Sims_Voice_restricted.jpg|thumb|center|500px|Voice Chat restricted to the parcel - On this snapshot the Voice chat is locked down (''locker button'') and the visitor speaking. Shall the voice level goes too high, the waves will turn red.]]
</blockquote>
<br>
If the Voice chat is correctly installed, you must:<br>
1- Hear the conference waiting music<br>
2- Have a TALK button on the bottom right of your viewer<br>
3- Have white halo over your head to tell the other that you have the voice chat capability enabled<br>
You shall start the different services in this order:<br>
<blockquote>
1- '''Mono'''<br>
2- '''Q-Sims''' (''and wait 2 minutes or more depending of your metavers size'')<br>
3- '''FreeSwitch'''<br>
</blockquote><br>
''NOTE: FreeSwitch will connect to your OpenSim server to retrieve the list of avatars. If the server is not started, FreeSwitch will fail to get this list and cannot work properly.''
</blockquote>
<br>
= Disable conference music and tones =
<blockquote>
By default, FreeSwitch broadcast waiting music in conference mode when only one attendee is present. Therefore, when only one avatar has Voice capability in the region, one will hear the waiting music. moreover whenever someone enter or leave the conferente there are specific tones.<br>
To disable all these sounds (''in order to let your background music instead'') you must edit the configuration file '''/usr/local/freeswitch/conf/autoload_configs/conference.conf.xml''' and comment the lines that refer to the waiting music and sounds:
<blockquote>
<pre>
...
<!-- File to play if you are alone in the conference -->
* Under the Freeswitch directory, open the '''conf/autoload_configs/xml_curl.conf.xml''' file and replace with the here below data updated with your parameters (''<your_nas_internal_ip>''). Change port 9000 to the correct value if needed.
<blockquote><pre>
<configuration name="xml_curl.conf" description="cURL XML Gateway">
1-Download, 2-Install and do not Enable FreeSwitch QPKG.
Redirect port 5060 on your router
If Q-Sims FULL Edition is not yet installed and you intend to use it, you have nothing more to do. Proceed with the Q-Sims installation. If Q-Sims FULL Edition is already installed and configured, you must re-run the Q-Sims FULL Edition QSA to configure FreeSwitch for Q-Sims (update the freeswitch/conf/autoload_configs/xml_curl.conf.xml file). Stop/Restart Q-Sims, wait and Enable FreeSwitch.
Enable Voice chat in the Preferences/Voice chat.
Voice configuration in the preferences
Enable voice on your terrains (World/About land/Media)
Enable Voice in each Land (also referred as terrain or regions) BUT also configure each parcel if you terrain has been divided.
Voice: Use the Estate spatial channel: There is a common channel for the whole region (256x256 meters) and you can chose to use it for your land/parcel voice chat
Voice: Use a private spatial channel: A specific channel is created for your land/parcel
Sound: Restrict spatialized sound to this parcel: Check it if you don't want the Voice chat to be accessible for visitor outside your parcel (land sub division) - function not yet implemented