Difference between revisions of "Voice"
(→Technical: mostly more logging, but a few comments about SLVoiceAgent) |
m (→SLVoice: just formatting) |
||
Line 70: | Line 70: | ||
: [-p tcp] | : [-p tcp] | ||
: [-i <address>] application sends requests to this address | : [-i <address>] application sends requests to this address | ||
: [-o <address>] gateway sends responses and events to this address | : [-o <address>] gateway sends responses and events to this address | ||
: [-vo] vivox only functionality | : [-vo] vivox only functionality | ||
: [-ov] (undocumented and unused) | : [-ov] (undocumented and unused) | ||
Line 128: | Line 128: | ||
SLVoice logs commands with added default values for fields not sent by the viewer, for example, | SLVoice logs commands with added default values for fields not sent by the viewer, for example, | ||
:for Account.Login.1 the log includes fields | :for '''Account.Login.1''' the log includes fields | ||
::<AccountURI /> | ::<AccountURI /> | ||
::<ParticipantPropertyFrequency>10</ParticipantPropertyFrequency> | ::<ParticipantPropertyFrequency>10</ParticipantPropertyFrequency> | ||
::<EnableBuddiesAndPresence>false</EnableBuddiesAndPresence> | ::<EnableBuddiesAndPresence>false</EnableBuddiesAndPresence> | ||
:for Connector.Create.1 | :for '''Connector.Create.1''' | ||
::<AttemptStun>AttemptStunUnspecified</AttemptStun> | ::<AttemptStun>AttemptStunUnspecified</AttemptStun> | ||
::<MinimumPort>22860</MinimumPort> | ::<MinimumPort>22860</MinimumPort> | ||
::<MaximumPort>22892</MaximumPort> | ::<MaximumPort>22892</MaximumPort> | ||
:for Session.Create.1 | :for '''Session.Create.1''' | ||
::<Password /> | ::<Password /> | ||
::<JoinAudio>true</JoinAudio> | ::<JoinAudio>true</JoinAudio> | ||
Line 144: | Line 144: | ||
::<PasswordHashAlgorithm>ClearText</PasswordHashAlgorithm> | ::<PasswordHashAlgorithm>ClearText</PasswordHashAlgorithm> | ||
:for Session.Set3DPosition.1 | :for '''Session.Set3DPosition.1''' | ||
::<OrientationType>legacy</OrientationType> | ::<OrientationType>legacy</OrientationType> | ||
Revision as of 19:43, 9 September 2007
Voice is a feature that made its debut on its own grid and beta viewer in March of 2007[1].
Frequently Asked Questions
There's an exhaustive Voice FAQ which provides answers to many questions about the new voice feature.
Groups
The Voice Mentors group and Voice in SL: A Community Forum are advocacy and help groups for users having problems adjusting to the new system.
Technical
Voice in Second Life uses Vivox technology that is based on RTP (using the oRTP library), SIP (using the amsip library from Antisip), OpenAL, TinyXPath, OpenSSL, and libcurl for the transmission of voice data. The positional 3D audio is achieved with technology from DiamondWare. These technologies are contained in external daemon software that is started and stopped by the Second Life client.
The SecondLife viewer handles configuration, control, and display functions, but the voice streams (from the microphone and from the Vivox voice server) do not enter the viewer. Unfortunately the source code for the external SLVoice daemon is not available due to contractual obligations between Linden Labs and Vivox.
The executables can be found in the Program Files\SecondLife directory of the runtime and in the linden\indra\newview\vivox-runtime\(platform) directory of the source distribution.
- SLVoice.exe
- Thin wrapper around the Vivox SDK
- Launched when voice is enabled in SL
- Runs a TCP server that listens and replies to commands and queries using an XML format
- SLVoiceAgent.exe
- Actually called the DiamondWare Thin Voice Client
- Launched by SLVoice, but don't know under what conditions
- Unclear how this fits in the communication chain
- Not launched for normal proximity voice chat; don't know about group chat or P2P yet
- vivoxsdk.dll
- ortp.dll
- wrap_oal.dll
- OpenAL, a cross-platform 3D audio API
- Used by vivoxsdk.dll
- alut.dll
- The OpenAL Utility Toolkit (ALUT)
- Used by vivoxsdk.dll
- ssleay32.dll and libeay32
- From the OpenSSL Project, a collaborative effort to develop a robust, commercial-grade, full-featured, and Open Source toolkit implementing the Secure Sockets Layer (SSL v2/v3) and Transport Layer Security (TLS v1) protocols as well as a full-strength general purpose cryptography library.
- Used by SLVoiceAgent.dll
- tntk.dll and srtp.dll
- Part of the DiamondWare distribution
- Apparently not used
See also: Third Party Libraries
SLVoice
SLVoice is started from the viewer in SLVoiceClient::stateMachine() using:
- SLVoice.exe -p tcp -h -c -ll <VivoxDebugLevel, default -1>
usage: SLVoice [flags]
valid flags are:
- [-ll <log-level>] 0-5, or -1 for no logging
- [-lf <log-folder>]
- [-lp <log-file prefix>]
- [-ls <log-file suffix>]
- [-p tcp]
- [-i <address>] application sends requests to this address
- [-o <address>] gateway sends responses and events to this address
- [-vo] vivox only functionality
- [-ov] (undocumented and unused)
- [-c] (undocumented but used)
- [-h] (undocumented but used)
- [-r] (undocumented and unused)
SLVoice.exe was called vivox-gw.exe in the beta release, so you may still see some references to the old name.
IP Address
The SecondLife viewer uses IP address 127.0.0.1 (localhost), port 44124 to communicate with SLVoice, the voice client gateway.
It is possible to connect to a client gateway running on another host. This is useful for testing. According to comments in the source code: to do this, launch the gateway on a nearby host,
- SLVoice.exe -p tcp -i 0.0.0.0:44124
and modify the code in SLVoiceClient::stateMachine() to set the host IP address, mDaemonHost.
Logging
The logging for SLVoice is controlled by a viewer variable, VivoxDebugLevel. You can set it directly in your Documents and Settings\<user>\Application Data\SecondLife\user_settings\settings.xml file
- <!--Logging level to use when launching the vivox daemon-->
- <VivoxDebugLevel value="5 -lf myDirectory -lp myPrefix -ls .txt"/>
or you can set it from the viewer. To set it from the viewer, you have to enable the Client menu if you haven't already using Ctrl-Alt-D (not to be confused with Ctrl-Alt-Delete). Then select
- Client -> Debug Settings
to get the Debug Settings window. In the selection box, hit the triangle to bring up the list of debug variables and select VivoxDebugLevel. In the text entry box, you'll see the current value. Above it is the description, "Logging level to use when launching the Vivox daemon." You can set the level as you like. If you want the output to go somewhere other than the default location, you can enter it in the box as well, for example,
- 5 -lf myDirectory -lp myPrefix -ls .txt
If <log-folder> is a relative path, it is relative to the directory that SecondLife is running in, ususally C:\Program Files\SecondLife
The default folder is c:/Documents and Settings/<user>/Local Settings/Application Data/Vivox/logs. The default prefix is SLVoice and the default suffix is .txt.
The log file is named <log-file prefix>-<yyyy>-<mm>-<dd><log-file suffix>
The default on September 3, 2007, for example, would be: SLVoice-2007-09-03.txt
The <log-level> must be at least 2 to see INFO messages and 4 to see TRACE messages.
Whenever log level is other than "-1", there is also a log file written to LL_PATH_LOGS, which is usually set to c:/Documents and Settings/<user>/Application Data/SecondLife/logs,
with the <log-file prefix> "Connector," that contains log information for the Connector. This logging comes from vivoxsdk.dll which is used by SLVoice.exe. The content does not depend on the log level for SLVoice; the Connector.Create.1 request hardcodes the Connector log level at 10.
- There is apparently no Response sent to the viewer for Session.Set3DPosition.1
- SLVoice does not log ParticipantPropertiesEvent
- SLVoice does not log Account.Logout.1
- SLVoice may not log the Response to Connector.InitiateShutdown.1 but when it does it tends to spew tens of thousands (about ten per millisecond) of messages to the log.
- 17:11:38.988, 0x00001414, INFO , disconnectHandler Client Connection Closed - shutting down
- 17:11:38.988, 0x00001414, INFO , shutdownGateway Terminating Gateway Process
SLVoice logs commands with added default values for fields not sent by the viewer, for example,
- for Account.Login.1 the log includes fields
- <AccountURI />
- <ParticipantPropertyFrequency>10</ParticipantPropertyFrequency>
- <EnableBuddiesAndPresence>false</EnableBuddiesAndPresence>
- for Connector.Create.1
- <AttemptStun>AttemptStunUnspecified</AttemptStun>
- <MinimumPort>22860</MinimumPort>
- <MaximumPort>22892</MaximumPort>
- for Session.Create.1
- <Password />
- <JoinAudio>true</JoinAudio>
- <JoinText>false</JoinText>
- <PasswordHashAlgorithm>ClearText</PasswordHashAlgorithm>
- for Session.Set3DPosition.1
- <OrientationType>legacy</OrientationType>