SoundDialog 2.2

Category / Domain : C3D3 PLUGIN
SCOL Voy@ger Compatibility : V 3.5 or above
Update : 2000/05

Function

This plugin makes it possible for users in the same 3D cell to talk with one another in person. Only avatars located in the same zone (a sphere) can talk. The number of users who can talk depends on the connection speed.

The use of this plugin implies the ownership by the client of a microphone and a headphone or loudspeakers. User specifies the type of connection via the "connectionSpeed" menu. Then an avatars list able to have a chat with the client will be posted.

To have a vocal chat, the client must have the state of the plugin set to "ON". Press on "Record" to speak (a single person is speaking at the same time). If a guest is speaking, the button "Play" will be in "ON" mode. The login of the speaking avatar is displayed in a field of the interface.

Configuration


Figure 1 : SoundDialog plugin Interface

(1) : Refresh period => Time in ms between two refreshes for users accessible in the sound dialog's chat area (500 by default). It allows to take into account entering/outgoing avatars of this sphere.

(2) : sphere radius => All the users in a sphere with a diameter DMsphere are accessible by the sound dialog (1000 by default).

(3) : AutoStart => If ticked, the plugin is activated at the the starting-up (by default value is 0, so deactivated). When the client activates or deactivates the Sound Dialog module, a configuration file is created to save the state of the announcer and so to use it at the next access to the site by the client (parameter autostart is not used any more when a configuration file exists)

(4) : Record On => Name of the bitmap to display when the user is speaking (default bitmap = Dms/3d/plugins/SoundDialog/recon.bmp)

(5) : Record Off => Name of the bitmap to display when the user does not speak (default bitmap = Dms/3d/plugins/SoundDialog/recoff.bmp)

(6) : Play On => Name of the bitmap to display when someone speaks (default bitmap = Dms/3d/plugins/SoundDialog/playon.bmp)

(7) : Play Off => Name of the bitmap to display when nobody speaks (default bitmap = Dms/3d/plugins/SoundDialog/playoff.bmp)

(8) : Play Mute => Name of the bitmap to display when the sound dialog is muted (default bitmap = Dms/3d/plugins/SoundDialog/playmute.bmp)

Implementation

Action Function
module.event à C3D3.instance.enableRec Starts recording (=ButtonRec activated)
module.event à C3D3.instance.disableRec Stops recording (=ButtonRec deactivated)
module.event à C3D3.instance.on Activates the sound dialog (=ButtonPlay activated)
module.event à C3D3.instance.off Deactivates the sound dialog (=ButtonPlay deactivated)
module.event à C3D3.instance.ignoreFlag
module.event à C3D3.instance.IgnLogOut
IgnoreFlag, IgnLogout : if the user wants to use the Ignore functions,
these actions must be connected to an Ignore module.

Event Function
C3D3.instance.clickOn à module Action Event produced when the user activates the Sound Dialog module
C3D3.instance.clickOff à module Action Event produced when the user deactivates the Sound Dialog module

Zone Function Interface Assignment
C3D3.instance.Info Name of the user which is speaking Client Yes
C3D3.instance.ButtonRec Button used to send sound to the other persons (start recording) Client Yes
C3D3.instance.ButtonPlay Active or deactivate sound at the client Server / Client Yes