Q-Sims - Add Voice Chat - Revision history

Glenn: + Category:Q-Sims

2015-10-26T10:56:49Z

+ Category:Q-Sims

Admin at 04:02, 29 July 2015

2015-07-29T04:02:12Z

Admin: 1 revision imported

2015-06-18T10:31:50Z

1 revision imported

New page

''by AdNovea - June 2009'' 
'''[[Q-Sims - The OpenSim metavers for QNAP|Q-Sims Homepage]]''' 
__TOC__

= Installation =
<blockquote>
* 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'''.
[[Image:Q-Sims_Voice_Chat_Prefs.jpg|thumb|center|500px|Voice configuration in the preferences]]
* Enable voice on your terrains ('''World/About land/Media''')
[[Image:Q-Sims_Voice_Chat_Lands.jpg|thumb|center|500px|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>
* '''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''</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>
 
If the Voice chat is correctly installed, you must: 
1- Hear the conference waiting music 
2- Have a TALK button on the bottom right of your viewer 
3- Have white halo over your head to tell the other that you have the voice chat capability enabled 
[[Image:Q-Sims Voice Inds.jpg|thumb|center|500px|Voice Chat activated]]
 
You shall start the different services in this order: 
<blockquote>
1- '''Mono''' 
2- '''Q-Sims''' (''and wait 2 minutes or more depending of your metavers size'') 
3- '''FreeSwitch''' 
</blockquote> 
''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>
 

= 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. 
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>
...


...








...
</pre>
</blockquote>
 
</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>
 
= 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>
 
 
[[Category:Communications]] [[Category:QPKG|Q]] [[Category:Q-Sims|Q]]

← Older revision		Revision as of 10:56, 26 October 2015
Line 21:		Line 21:
	*'''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''		*'''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></blockquote></blockquote>		</blockquote></blockquote></blockquote>
		+
		+	[[Category:Q-Sims]]

@@ 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>
 = Installation =
 <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>
 <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>