Q-Sims - Add Voice Chat: Difference between revisions

From QNAPedia
Jump to navigation Jump to search
m 1 revision imported
 
No edit summary
Line 1: Line 1:
''by AdNovea - June 2009''<br>
<parsererror style="display: block; white-space: pre; border: 2px solid #c77; padding: 0 1em 0 1em; margin: 1em; background-color: #fdd; color: black">
'''[[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>
[[Image:Q-Sims Voice Inds.jpg|thumb|center|500px|Voice Chat activated]]
<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 -->
      <!-- <param name="alone-sound" value="conference/conf-alone.wav"/> -->
      ...
      <!-- File to play when you're alone (music on hold)-->
      <!-- <param name="moh-sound" value="$${hold_music}"/> -->
      <!-- File to play when you join the conference -->
      <!-- <param name="enter-sound" value="tone_stream://%(200,0,500,600,700)"/> [^] -->
      <!-- File to play when you leave the conference -->
      <!-- <param name="exit-sound" value="tone_stream://%(500,0,300,200,100,50,25)"/> [^] -->
      <!-- File to play when you ae ejected from the conference -->
      <!-- <param name="kicked-sound" value="conference/conf-kicked.wav"/> -->
      ...
</pre>
</blockquote>
<br>
</blockquote>
= Adjust sound levels =
<blockquote>
They are multiple sounds available in OpenSim and one shall adjust the different levels in order to get something audible.
<blockquote>
[[Image:Q-Sims Sounds.jpg|thumb|center|500px|Hippo viewer sound control panel]]
* '''Master''' : Overall sound level adjustment
* '''Music''' : Background music level control (''better be low'')
* '''Media''' : Video/Movie sound level
* '''Voice''' : Voice chat level (''must be medium'')
* '''Sounds''' : ???
* '''Ambient''' : e.g. the sound of the wind
* '''UI''' : All sounds associated to the Graphic User Interface
</blockquote>
</blockquote>
<br>
= Voice Chat manual installation =
<blockquote>
* Install the FreeSwitch QPKG
* redirect '''port 5060''' on your router
* Under the Q-Sims directory open the '''bin/OpenSim.ini''' file and modify the Freeswitch section as mentioned below (''<your_nas_internal_ip>''):
<blockquote><pre>
[FreeSwitchVoice]
; In order for this to work you need a functioning freeswitch pbx set
; up.  Configuration for that will be posted in the wiki soon.
enabled = true
;FreeSwitch server is going to contact us and ask us all
;sorts of things.
freeswitch_server_user = freeswitch
freeswitch_server_pass = password
freeswitch_api_prefix = /api
; this is the IP of your sim
freeswitch_service_server = <your_nas_internal_ip>
;freeswitch_service_port = 80
; this should be the same port the region listens on
freeswitch_service_port = 9000
freeswitch_realm = <your_nas_internal_ip>
freeswitch_sip_proxy = <your_nas_internal_ip>:5060
freeswitch_attempt_stun = false
freeswitch_stun_server = <your_nas_internal_ip>
freeswitch_echo_server = <your_nas_internal_ip>
freeswitch_echo_port = 50505
freeswitch_well_known_ip = <your_nas_internal_ip>
 
;Type the address of your http server here, hostname is allowed.  This is provided so you can specify a hostname
;This is used by client for account verification.  By default, it's the same as the freeswitch service server.
;opensim_well_known_http_address = Address_Of_your_SIM_HTTP_Server_Hostname_Allowed
 
freeswitch_default_timeout = 5000
freeswitch_subscribe_retry = 120
; freeswitch_password_reset_url =</pre></blockquote>
* 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">
<bindings>
<binding name="example">
<param name="gateway-url" value="http://<your_nas_internal_ip>:9000/api/freeswitch-config" bindings="directory"/>
<param name="disable-100-continue" value="true"/>
</binding>
<binding name="local">
<param name="gateway-url" value="http://<your_nas_internal_ip>:9000/api/freeswitch-config" bindings="dialplan"/>
<param name="disable-100-continue" value="true"/>
</binding>
</bindings>
</configuration></pre></blockquote>
* Enable FreeSwitch once Q-Sims is fully up and running
</blockquote>
<br>
<br>
[[Category:Communications]] [[Category:QPKG|Q]] [[Category:Q-Sims|Q]]

Revision as of 12:02, 29 July 2015

<parsererror style="display: block; white-space: pre; border: 2px solid #c77; padding: 0 1em 0 1em; margin: 1em; background-color: #fdd; color: black">

This page contains the following errors:

error on line 1 at column 2051: Unescaped '<' not allowed in attributes values

Below is a rendering of the page up to the first error.

</parsererror>

by AdNovea - June 2009
Q-Sims Homepage

Installation

  • 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)
File:Q-Sims Voice Chat Lands.jpg
Voice configuration on lands
  • 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