mod_conference

本文英文部分是来自https://freeswitch.org/confluence/display/FREESWITCH/mod_conference，中文部分是通过分析mod_conference的代码根据个人的理解整理而成。

关于作者

鼎鼎：cdevelop@qq.com qq:1280791187。 本文会不定期更新,最新版本在http://www.ddrj.com/fs/mod_conference.html。

配置

conference.conf.xml 范例

<configuration name="conference.conf" description="Standard Conference configuration">
 
  <advertise>
	[... config here ...]
  </advertise>
 
  <caller-controls>
    <group name="default">
	[... config here ...]
    </group>
  </caller-controls>
 
  <chat-permissions>
    <profile name="default">
	[... config here ...]
    </profile>
  </chat-permissions>    
 
  <profiles>
    <profile name="default">
	[... config here ...]
    </profile>
  </profiles>
 
 
</configuration>

advertise

<advertise>
  <room name="3001@$${domain}" status="FreeSWITCH"/>
</advertise>

添加room配置后，模块load时，会发送SWITCH_EVENT_PRESENCE_IN事件。详细参考下面实现代码：

if ((advertise = switch_xml_child(cfg, "advertise"))) {
	for (room = switch_xml_child(advertise, "room"); room; room = room->next) {
		char *name = (char *) switch_xml_attr_soft(room, "name");
		char *status = (char *) switch_xml_attr_soft(room, "status");
		switch_event_t *event;

		if (name && switch_event_create(&event, id) == SWITCH_STATUS_SUCCESS) {
			switch_event_add_header_string(event, SWITCH_STACK_BOTTOM, "proto", CONF_CHAT_PROTO);
			switch_event_add_header_string(event, SWITCH_STACK_BOTTOM, "login", name);
			switch_event_add_header_string(event, SWITCH_STACK_BOTTOM, "from", name);
			switch_event_add_header_string(event, SWITCH_STACK_BOTTOM, "force-status", status ? status : "Available");
			switch_event_add_header_string(event, SWITCH_STACK_BOTTOM, "rpid", "unknown");
			switch_event_add_header_string(event, SWITCH_STACK_BOTTOM, "event_type", "presence");
			switch_event_fire(&event);
		}
	}
}

caller-controls

配置会议控制按键，profile通过<param name="caller-controls" value="none"/>设置管理的caller-controls。none就是不使用控制按键，不设置时会使用default组。

Caller controls are used to modify the state of the conference, such as lowering the volume, mute a participant, and such. Below are the commands that can be assigned to digits and executed during a conference. The “moderator-controls” group provides additional controls for participants who enter the conference with the moderator flag set. See below.
Reserved Control Group Names

例子：

<caller-controls>
  <group name="default">
    <control action="mute" digits="0"/>
    <control action="deaf mute" digits="*"/>
    <control action="energy up" digits="9"/>
    <control action="energy equ" digits="8"/>
    <control action="energy dn" digits="7"/>
    <control action="vol talk up" digits="3"/>
    <control action="vol talk zero" digits="2"/>
    <control action="vol talk dn" digits="1"/>
    <control action="vol listen up" digits="6"/>
    <control action="vol listen zero" digits="5"/>
    <control action="vol listen dn" digits="4"/>
    <control action="hangup" digits="#"/>
  </group>
</caller-controls>

详细配置

profiles

You can specify a number of different profiles in the profiles section, these will let you easily apply a number of settings to a conference. Please note that the profiles are not conference rooms, but define settings that are later applied to conference rooms. The dialplan section in this document will describe how you create conference rooms and apply these profile settings.

profiles structure

<profiles>
  <profile name="default">
    <param name="paramName" value="paramValue"/>
  </profile>
</profiles>

You can have any number of tags, and each can have any number of tags up to the entire set of parameters.

Conference Profile Parameters

You may specify the conference profile parameters listed below. Keep in mind that if TTS is enabled all audio-file params beginning with ‘say:’ will be considered text to say with TTS. A TTS module must be loaded by FreeSWITCH for this to work.