Asterisk - The Open Source Telephony Project  21.4.1
conf_state_single.c
Go to the documentation of this file.
1 /*
2  * Asterisk -- An open source telephony toolkit.
3  *
4  * Copyright (C) 2012, Terry Wilson
5  *
6  * Terry Wilson <twilson@digium.com>
7  *
8  * See http://www.asterisk.org for more information about
9  * the Asterisk project. Please do not directly contact
10  * any of the maintainers of this project for assistance;
11  * the project provides a web site, mailing lists and IRC
12  * channels for your use.
13  *
14  * This program is free software, distributed under the terms of
15  * the GNU General Public License Version 2. See the LICENSE file
16  * at the top of the source tree.
17  */
18 
19 /*! \file
20  *
21  * \brief Confbridge state handling for the SINGLE state
22  *
23  * \author\verbatim Terry Wilson <twilson@digium.com> \endverbatim
24  *
25  * \ingroup applications
26  */
27 
28 /*** MODULEINFO
29  <support_level>core</support_level>
30  ***/
31 
32 #include "include/confbridge.h"
33 #include "include/conf_state.h"
34 
35 static void join_unmarked(struct confbridge_user *user);
36 static void join_marked(struct confbridge_user *user);
37 static void leave_unmarked(struct confbridge_user *user);
38 static void transition_to_single(struct confbridge_user *user);
39 
40 struct confbridge_state STATE_SINGLE = {
41  .name = "SINGLE",
42  .join_unmarked = join_unmarked,
43  .join_waitmarked = conf_default_join_waitmarked,
44  .join_marked = join_marked,
45  .leave_unmarked = leave_unmarked,
46  .leave_waitmarked = conf_default_leave_waitmarked,
47  .entry = transition_to_single,
48 };
49 struct confbridge_state *CONF_STATE_SINGLE = &STATE_SINGLE;
50 
51 static void join_unmarked(struct confbridge_user *user)
52 {
53  conf_add_user_active(user->conference, user);
56 
58 }
59 
60 static void join_marked(struct confbridge_user *user)
61 {
62  conf_add_user_marked(user->conference, user);
65 
67 }
68 
69 static void leave_unmarked(struct confbridge_user *user)
70 {
72  if (user->playing_moh) {
73  conf_moh_stop(user);
74  }
75 
76  if (user->conference->waitingusers) {
78  } else {
80  }
81 }
82 
83 static void transition_to_single(struct confbridge_user *user)
84 {
86 }
void conf_add_user_active(struct confbridge_conference *conference, struct confbridge_user *user)
Add a conference bridge user as an unmarked active user of the conference.
conference_event_fn join_unmarked
Definition: conf_state.h:47
struct confbridge_state * CONF_STATE_MULTI
Conference state with multiple active users, but no marked users.
void conf_remove_user_active(struct confbridge_conference *conference, struct confbridge_user *user)
Remove a conference bridge user from the unmarked active conference users in the conference.
unsigned int playing_moh
Definition: confbridge.h:285
void conf_default_leave_waitmarked(struct confbridge_user *user)
Logic to execute every time a waitmarked user leaves an unmarked conference.
Definition: conf_state.c:69
struct confbridge_conference * conference
Definition: confbridge.h:274
void conf_mute_only_active(struct confbridge_conference *conference)
Attempt to mute/play MOH to the only user in the conference if they require it.
void conf_update_user_mute(struct confbridge_user *user)
Update the actual mute status of the user and set it on the bridge.
struct confbridge_state * CONF_STATE_EMPTY
Conference state with no active or waiting users.
conference_event_fn leave_unmarked
Definition: conf_state.h:50
void conf_add_user_marked(struct confbridge_conference *conference, struct confbridge_user *user)
Add a conference bridge user as a marked active user of the conference.
conference_event_fn join_marked
Definition: conf_state.h:49
void conf_handle_second_active(struct confbridge_conference *conference)
Handle when a conference moves to having more than one active participant.
unsigned int waitingusers
Definition: confbridge.h:253
void conf_default_join_waitmarked(struct confbridge_user *user)
Logic to execute every time a waitmarked user joins an unmarked conference.
Definition: conf_state.c:62
struct confbridge_state * CONF_STATE_SINGLE
Conference state with only a single unmarked active user.
void conf_moh_stop(struct confbridge_user *user)
Stop MOH for the conference user.
structure to hold users read from users.conf
Confbridge state handling.
A conference state object to hold the various state callback functions.
Definition: conf_state.h:45
struct confbridge_state * CONF_STATE_INACTIVE
Conference state with only waiting users.
The structure that represents a conference bridge user.
Definition: confbridge.h:273
struct confbridge_state * CONF_STATE_MULTI_MARKED
Conference state with multiple active users and at least one marked user.
void conf_change_state(struct confbridge_user *user, struct confbridge_state *newstate)
Execute conference state transition because of a user action.
Definition: conf_state.c:77