Asterisk - The Open Source Telephony Project GIT-master-8f1982c
All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Macros Modules Pages
Functions | Variables
confbridge_manager.c File Reference

Confbridge manager events for stasis messages. More...

#include "asterisk.h"
#include "asterisk/channel.h"
#include "asterisk/bridge.h"
#include "asterisk/stasis.h"
#include "asterisk/stasis_channels.h"
#include "asterisk/stasis_bridges.h"
#include "asterisk/manager.h"
#include "asterisk/stasis_message_router.h"
#include "include/confbridge.h"
#include "asterisk/message.h"
#include "asterisk/stream.h"
Include dependency graph for confbridge_manager.c:

Go to the source code of this file.

Functions

static struct ast_jsonbridge_to_json (struct ast_bridge_snapshot *bridge_snapshot)
 
static struct ast_jsonchannel_to_json (struct ast_channel_snapshot *channel_snapshot, struct ast_json *conf_blob, struct ast_json *labels_blob)
 
void conf_send_event_to_participants (struct confbridge_conference *conference, struct ast_channel *chan, struct stasis_message *msg)
 Send events to bridge participants. More...
 
static void confbridge_atxfer_cb (void *data, struct stasis_subscription *sub, struct stasis_message *message)
 
static void confbridge_end_cb (void *data, struct stasis_subscription *sub, struct stasis_message *message)
 
const char * confbridge_event_type_to_string (struct stasis_message_type *event_type)
 Get the string representation of a confbridge stasis message type. More...
 
static void confbridge_join_cb (void *data, struct stasis_subscription *sub, struct stasis_message *message)
 
static void confbridge_leave_cb (void *data, struct stasis_subscription *sub, struct stasis_message *message)
 
static void confbridge_mute_cb (void *data, struct stasis_subscription *sub, struct stasis_message *message)
 
static void confbridge_publish_manager_event (struct stasis_message *message, struct ast_str *extra_text)
 
static void confbridge_start_cb (void *data, struct stasis_subscription *sub, struct stasis_message *message)
 
static void confbridge_start_record_cb (void *data, struct stasis_subscription *sub, struct stasis_message *message)
 
static void confbridge_stop_record_cb (void *data, struct stasis_subscription *sub, struct stasis_message *message)
 
static void confbridge_talking_cb (void *data, struct stasis_subscription *sub, struct stasis_message *message)
 
static void confbridge_unmute_cb (void *data, struct stasis_subscription *sub, struct stasis_message *message)
 
static int get_admin_header (struct ast_str **extra_text, struct stasis_message *message)
 
static int get_bool_header (struct ast_str **extra_text, struct stasis_message *message, const char *json_key, const char *ami_header)
 
static int get_muted_header (struct ast_str **extra_text, struct stasis_message *message)
 
int manager_confbridge_init (void)
 register stasis message routers to handle manager events for confbridge messages More...
 
void manager_confbridge_shutdown (void)
 unregister stasis message routers to handle manager events for confbridge messages More...
 
static struct ast_jsonpack_bridge_and_channel (struct ast_json *json_bridge, struct ast_json *json_channel, struct stasis_message *msg)
 
static struct ast_jsonpack_bridge_and_channels (struct ast_json *json_bridge, struct ast_json *json_channels, struct stasis_message *msg)
 
static struct ast_jsonpack_snapshots (struct ast_bridge_snapshot *bridge_snapshot, struct ast_channel_snapshot *channel_snapshot, struct ast_json *conf_blob, struct ast_json *labels_blob, struct stasis_message *msg)
 
static void send_message (const char *msg_name, char *conf_name, struct ast_json *json_object, struct ast_channel *chan)
 
 STASIS_MESSAGE_TYPE_DEFN (confbridge_end_type)
 
 STASIS_MESSAGE_TYPE_DEFN (confbridge_join_type)
 
 STASIS_MESSAGE_TYPE_DEFN (confbridge_leave_type)
 
 STASIS_MESSAGE_TYPE_DEFN (confbridge_mute_type)
 
 STASIS_MESSAGE_TYPE_DEFN (confbridge_start_record_type)
 
 STASIS_MESSAGE_TYPE_DEFN (confbridge_start_type)
 
 STASIS_MESSAGE_TYPE_DEFN (confbridge_stop_record_type)
 
 STASIS_MESSAGE_TYPE_DEFN (confbridge_talking_type)
 
 STASIS_MESSAGE_TYPE_DEFN (confbridge_unmute_type)
 
 STASIS_MESSAGE_TYPE_DEFN (confbridge_welcome_type)
 

Variables

static struct stasis_message_routerbridge_state_router
 
static struct stasis_message_routerchannel_state_router
 

Detailed Description

Confbridge manager events for stasis messages.

Author
Jonathan Rose jrose.nosp@m.@dig.nosp@m.ium.c.nosp@m.om

Definition in file confbridge_manager.c.

Function Documentation

◆ bridge_to_json()

static struct ast_json * bridge_to_json ( struct ast_bridge_snapshot bridge_snapshot)
static

Definition at line 338 of file confbridge_manager.c.

339{
340 struct ast_json *json_bridge = ast_bridge_snapshot_to_json(bridge_snapshot, NULL);
341
342 if (!json_bridge) {
343 return NULL;
344 }
345
346 /* These items have no use in the context of bridge participant info. */
347 ast_json_object_del(json_bridge, "technology");
348 ast_json_object_del(json_bridge, "bridge_type");
349 ast_json_object_del(json_bridge, "bridge_class");
350 ast_json_object_del(json_bridge, "creator");
351 ast_json_object_del(json_bridge, "channels");
352
353 return json_bridge;
354}
int ast_json_object_del(struct ast_json *object, const char *key)
Delete a field from a JSON object.
Definition: json.c:418
#define NULL
Definition: resample.c:96
struct ast_json * ast_bridge_snapshot_to_json(const struct ast_bridge_snapshot *snapshot, const struct stasis_message_sanitizer *sanitize)
Build a JSON object from a ast_bridge_snapshot.
Abstract JSON element (object, array, string, int, ...).

References ast_bridge_snapshot_to_json(), ast_json_object_del(), and NULL.

Referenced by conf_send_event_to_participants(), and pack_snapshots().

◆ channel_to_json()

static struct ast_json * channel_to_json ( struct ast_channel_snapshot channel_snapshot,
struct ast_json conf_blob,
struct ast_json labels_blob 
)
static

Definition at line 303 of file confbridge_manager.c.

305{
306 struct ast_json *json_channel = ast_channel_snapshot_to_json(channel_snapshot, NULL);
307
308 if (!json_channel) {
309 return NULL;
310 }
311
312 /* These items are removed for privacy reasons. */
313 ast_json_object_del(json_channel, "dialplan");
314 ast_json_object_del(json_channel, "connected");
315 ast_json_object_del(json_channel, "accountcode");
316
317 /* conf_blob contains flags such as talking, admin, mute, etc. */
318 if (conf_blob) {
319 struct ast_json *conf_copy = ast_json_copy(conf_blob);
320
321 if (!conf_copy) {
322 ast_json_unref(json_channel);
323 return NULL;
324 }
325 ast_json_object_del(conf_copy, "conference");
326 ast_json_object_update(json_channel, conf_copy);
327 ast_json_unref(conf_copy);
328 }
329
330 /* labels_blob contains the msid labels to correlate to streams. */
331 if (labels_blob) {
332 ast_json_object_update(json_channel, labels_blob);
333 }
334
335 return json_channel;
336}
void ast_json_unref(struct ast_json *value)
Decrease refcount on value. If refcount reaches zero, value is freed.
Definition: json.c:73
struct ast_json * ast_json_copy(const struct ast_json *value)
Copy a JSON value, but not its children.
Definition: json.c:637
int ast_json_object_update(struct ast_json *object, struct ast_json *other)
Update object with all of the fields of other.
Definition: json.c:426
struct ast_json * ast_channel_snapshot_to_json(const struct ast_channel_snapshot *snapshot, const struct stasis_message_sanitizer *sanitize)
Build a JSON object from a ast_channel_snapshot.

References ast_channel_snapshot_to_json(), ast_json_copy(), ast_json_object_del(), ast_json_object_update(), ast_json_unref(), and NULL.

Referenced by conf_send_event_to_participants(), and pack_snapshots().

◆ conf_send_event_to_participants()

void conf_send_event_to_participants ( struct confbridge_conference conference,
struct ast_channel chan,
struct stasis_message msg 
)

Send events to bridge participants.

Since
15.7
16.1
Parameters
conferenceThe conference bridge
chanThe channel triggering the action
msgThe stasis message describing the event

Definition at line 453 of file confbridge_manager.c.

455{
456 struct ast_bridge_blob *obj = stasis_message_data(msg);
457 struct ast_json *extras = obj->blob;
458 struct user_profile u_profile = {{0}};
459 int source_send_events = 0;
460 int source_echo_events = 0;
461 struct ast_json* json_channels = NULL;
462 struct confbridge_user *user;
463 const char *msg_name = confbridge_event_type_to_string(stasis_message_type(msg));
464
465 ast_debug(3, "Distributing %s event to participants\n", msg_name);
466
467 /* This could be a channel level event or a bridge level event */
468 if (chan) {
470 ast_log(LOG_ERROR, "Unable to retrieve user profile for channel '%s'\n",
472 return;
473 }
474 source_send_events = ast_test_flag(&u_profile, USER_OPT_SEND_EVENTS);
475 source_echo_events = ast_test_flag(&u_profile, USER_OPT_ECHO_EVENTS);
476 ast_debug(3, "send_events: %d echo_events: %d for profile %s\n",
477 source_send_events, source_echo_events, u_profile.name);
478 }
479
480 /* Now send a message to the participants with the json string. */
483 struct ast_json *json_object;
484
485 /*
486 * If the msg type is join, we need to capture all targets channel info so we can
487 * send a welcome message to the source channel with all current participants.
488 */
489 if (source_send_events && stasis_message_type(msg) == confbridge_join_type()) {
490 struct ast_channel_snapshot *target_snapshot;
491 struct ast_json *target_json_channel;
492
494 if (!target_snapshot) {
495 ast_log(LOG_ERROR, "Unable to get a channel snapshot for '%s'\n",
496 ast_channel_name(user->chan));
497 continue;
498 }
499
500 target_json_channel = channel_to_json(target_snapshot, extras, NULL);
501 ao2_ref(target_snapshot, -1);
502
503 if (!json_channels) {
504 json_channels = ast_json_array_create();
505 if (!json_channels) {
506 ast_log(LOG_ERROR, "Unable to allocate json array\n");
507 ast_json_unref(target_json_channel);
508 return;
509 }
510 }
511
512 ast_json_array_append(json_channels, target_json_channel);
513 }
514
515 /* Don't send a message to the user that triggered the event. */
516 if (!source_echo_events && user->chan == chan) {
517 ast_debug(3, "Skipping queueing %s message to '%s'. Same channel.\n", msg_name,
518 ast_channel_name(user->chan));
519 continue;
520 }
521
522 /* Don't send a message to users in profiles not sending events. */
523 if (!ast_test_flag(&user->u_profile, USER_OPT_SEND_EVENTS)) {
524 ast_debug(3, "Skipping queueing %s message to '%s'. Not receiving events.\n", msg_name,
525 ast_channel_name(user->chan));
526 continue;
527 }
528
529 json_object = pack_snapshots(obj->bridge, obj->channel, extras, NULL, msg);
530
531 if (!json_object) {
532 ast_log(LOG_ERROR, "Unable to convert %s message to json\n", msg_name);
533 continue;
534 }
535
536 send_message(msg_name, conference->name, json_object, user->chan);
537 ast_json_unref(json_object);
538 }
539 ao2_unlock(conference);
540
541 /*
542 * If this is a join event, send the welcome message to just the joining user
543 * if it's not audio-only or otherwise restricted.
544 */
545 if (source_send_events && json_channels
547 struct ast_json *json_object;
548 struct ast_json *json_bridge;
549 const char *welcome_msg_name = confbridge_event_type_to_string(confbridge_welcome_type());
550
551 json_bridge = bridge_to_json(obj->bridge);
552 json_object = pack_bridge_and_channels(json_bridge, json_channels, msg);
553 if (!json_object) {
554 ast_log(LOG_ERROR, "Unable to convert ConfbridgeWelcome message to json\n");
555 return;
556 }
557 ast_json_string_set(ast_json_object_get(json_object, "type"), welcome_msg_name);
558
559 send_message(welcome_msg_name, conference->name, json_object, chan);
560 ast_json_unref(json_object);
561 }
562}
#define ast_log
Definition: astobj2.c:42
#define ao2_unlock(a)
Definition: astobj2.h:729
#define ao2_lock(a)
Definition: astobj2.h:717
#define ao2_ref(o, delta)
Reference/unreference an object and return the old refcount.
Definition: astobj2.h:459
const char * ast_channel_name(const struct ast_channel *chan)
const char * ast_channel_uniqueid(const struct ast_channel *chan)
const struct user_profile * conf_find_user_profile(struct ast_channel *chan, const char *user_profile_name, struct user_profile *result)
find a user profile given a user profile's name and store that profile in result structure.
@ USER_OPT_SEND_EVENTS
Definition: confbridge.h:69
@ USER_OPT_ECHO_EVENTS
Definition: confbridge.h:70
struct stasis_message_type * confbridge_welcome_type(void)
get the confbridge welcome stasis message type
struct stasis_message_type * confbridge_join_type(void)
get the confbridge join stasis message type
const char * confbridge_event_type_to_string(struct stasis_message_type *event_type)
Get the string representation of a confbridge stasis message type.
static struct ast_json * bridge_to_json(struct ast_bridge_snapshot *bridge_snapshot)
static struct ast_json * channel_to_json(struct ast_channel_snapshot *channel_snapshot, struct ast_json *conf_blob, struct ast_json *labels_blob)
static struct ast_json * pack_snapshots(struct ast_bridge_snapshot *bridge_snapshot, struct ast_channel_snapshot *channel_snapshot, struct ast_json *conf_blob, struct ast_json *labels_blob, struct stasis_message *msg)
static void send_message(const char *msg_name, char *conf_name, struct ast_json *json_object, struct ast_channel *chan)
static struct ast_json * pack_bridge_and_channels(struct ast_json *json_bridge, struct ast_json *json_channels, struct stasis_message *msg)
struct ast_channel_snapshot * ast_channel_snapshot_get_latest(const char *uniqueid)
Obtain the latest ast_channel_snapshot from the Stasis Message Bus API cache. This is an ao2 object,...
#define ast_debug(level,...)
Log a DEBUG message.
#define LOG_ERROR
int ast_json_array_append(struct ast_json *array, struct ast_json *value)
Append to an array.
Definition: json.c:378
struct ast_json * ast_json_array_create(void)
Create a empty JSON array.
Definition: json.c:362
struct ast_json * ast_json_object_get(struct ast_json *object, const char *key)
Get a field from a JSON object.
Definition: json.c:407
int ast_json_string_set(struct ast_json *string, const char *value)
Change the value of a JSON string.
Definition: json.c:288
#define AST_LIST_TRAVERSE(head, var, field)
Loops over (traverses) the entries in a list.
Definition: linkedlists.h:491
static char user[512]
struct stasis_message_type * stasis_message_type(const struct stasis_message *msg)
Get the message type for a stasis_message.
void * stasis_message_data(const struct stasis_message *msg)
Get the data contained in a message.
Blob of data associated with a bridge.
struct ast_bridge_snapshot * bridge
struct ast_channel_snapshot * channel
struct ast_json * blob
Structure representing a snapshot of channel state.
char name[MAX_CONF_NAME]
Definition: confbridge.h:247
struct confbridge_conference::@94 active_list
The structure that represents a conference bridge user.
Definition: confbridge.h:273
struct confbridge_conference * conference
Definition: confbridge.h:274
struct confbridge_user::@98 list
struct ast_channel * chan
Definition: confbridge.h:279
struct user_profile u_profile
Definition: confbridge.h:276
char name[MAX_PROFILE_NAME]
Definition: confbridge.h:155
structure to hold users read from users.conf
#define ast_test_flag(p, flag)
Definition: utils.h:63

References confbridge_conference::active_list, ao2_lock, ao2_ref, ao2_unlock, ast_channel_name(), ast_channel_snapshot_get_latest(), ast_channel_uniqueid(), ast_debug, ast_json_array_append(), ast_json_array_create(), ast_json_object_get(), ast_json_string_set(), ast_json_unref(), AST_LIST_TRAVERSE, ast_log, ast_test_flag, ast_bridge_blob::blob, ast_bridge_blob::bridge, bridge_to_json(), confbridge_user::chan, ast_bridge_blob::channel, channel_to_json(), conf_find_user_profile(), confbridge_event_type_to_string(), confbridge_join_type(), confbridge_welcome_type(), confbridge_user::conference, confbridge_user::list, LOG_ERROR, confbridge_conference::name, user_profile::name, NULL, pack_bridge_and_channels(), pack_snapshots(), send_message(), stasis_message_data(), stasis_message_type(), confbridge_user::u_profile, user, USER_OPT_ECHO_EVENTS, and USER_OPT_SEND_EVENTS.

Referenced by send_conf_stasis().

◆ confbridge_atxfer_cb()

static void confbridge_atxfer_cb ( void *  data,
struct stasis_subscription sub,
struct stasis_message message 
)
static

Definition at line 663 of file confbridge_manager.c.

665{
667
669 return;
670 }
671
672 /*
673 * This callback will get called for ALL attended transfers
674 * so we need to make sure this transfer belongs to
675 * a conference bridge before trying to handle it.
676 */
678 && strcmp(msg->dest.app, "ConfBridge") == 0) {
680 }
681}
void confbridge_handle_atxfer(struct ast_attended_transfer_message *msg)
Create join/leave events for attended transfers.
@ AST_BRIDGE_TRANSFER_SUCCESS
Definition: bridge.h:1104
@ AST_ATTENDED_TRANSFER_DEST_APP
Message representing attended transfer.
enum ast_attended_transfer_dest_type dest_type
union ast_attended_transfer_message::@286 dest
enum ast_transfer_result result

References ast_attended_transfer_message::app, AST_ATTENDED_TRANSFER_DEST_APP, AST_BRIDGE_TRANSFER_SUCCESS, confbridge_handle_atxfer(), ast_attended_transfer_message::dest, ast_attended_transfer_message::dest_type, ast_attended_transfer_message::result, and stasis_message_data().

Referenced by manager_confbridge_init().

◆ confbridge_end_cb()

static void confbridge_end_cb ( void *  data,
struct stasis_subscription sub,
struct stasis_message message 
)
static

Definition at line 634 of file confbridge_manager.c.

636{
638}
static void confbridge_publish_manager_event(struct stasis_message *message, struct ast_str *extra_text)

References confbridge_publish_manager_event(), and NULL.

Referenced by manager_confbridge_init().

◆ confbridge_event_type_to_string()

const char * confbridge_event_type_to_string ( struct stasis_message_type event_type)

Get the string representation of a confbridge stasis message type.

Since
15.5
Parameters
event_typeThe confbridge event type such as 'confbridge_welcome_type()'
Return values
Thestring representation of the message type
unknownif not found

Definition at line 276 of file confbridge_manager.c.

277{
278 if (event_type == confbridge_start_type()) {
279 return "ConfbridgeStart";
280 } else if (event_type == confbridge_end_type()) {
281 return "ConfbridgeEnd";
282 } else if (event_type == confbridge_join_type()) {
283 return "ConfbridgeJoin";
284 } else if (event_type == confbridge_leave_type()) {
285 return "ConfbridgeLeave";
286 } else if (event_type == confbridge_start_record_type()) {
287 return "ConfbridgeRecord";
288 } else if (event_type == confbridge_stop_record_type()) {
289 return "ConfbridgeStopRecord";
290 } else if (event_type == confbridge_mute_type()) {
291 return "ConfbridgeMute";
292 } else if (event_type == confbridge_unmute_type()) {
293 return "ConfbridgeUnmute";
294 } else if (event_type == confbridge_talking_type()) {
295 return "ConfbridgeTalking";
296 } else if (event_type == confbridge_welcome_type()) {
297 return "ConfbridgeWelcome";
298 } else {
299 return "unknown";
300 }
301}
struct stasis_message_type * confbridge_mute_type(void)
get the confbridge mute stasis message type
struct stasis_message_type * confbridge_talking_type(void)
get the confbridge talking stasis message type
struct stasis_message_type * confbridge_stop_record_type(void)
get the confbridge stop_record stasis message type
struct stasis_message_type * confbridge_end_type(void)
get the confbridge end stasis message type
struct stasis_message_type * confbridge_start_type(void)
get the confbridge start stasis message type
struct stasis_message_type * confbridge_start_record_type(void)
get the confbridge start_record stasis message type
struct stasis_message_type * confbridge_unmute_type(void)
get the confbridge unmute stasis message type
struct stasis_message_type * confbridge_leave_type(void)
get the confbridge leave stasis message type

References confbridge_end_type(), confbridge_join_type(), confbridge_leave_type(), confbridge_mute_type(), confbridge_start_record_type(), confbridge_start_type(), confbridge_stop_record_type(), confbridge_talking_type(), confbridge_unmute_type(), and confbridge_welcome_type().

Referenced by conf_send_event_to_participants(), confbridge_publish_manager_event(), pack_bridge_and_channel(), pack_bridge_and_channels(), and send_message().

◆ confbridge_join_cb()

static void confbridge_join_cb ( void *  data,
struct stasis_subscription sub,
struct stasis_message message 
)
static

Definition at line 651 of file confbridge_manager.c.

653{
654 struct ast_str *extra_text = NULL;
655
656 if (!get_admin_header(&extra_text, message)
657 && !get_muted_header(&extra_text, message)) {
659 }
660 ast_free(extra_text);
661}
#define ast_free(a)
Definition: astmm.h:180
static int get_admin_header(struct ast_str **extra_text, struct stasis_message *message)
static int get_muted_header(struct ast_str **extra_text, struct stasis_message *message)
Support for dynamic strings.
Definition: strings.h:623

References ast_free, confbridge_publish_manager_event(), get_admin_header(), get_muted_header(), and NULL.

Referenced by manager_confbridge_init().

◆ confbridge_leave_cb()

static void confbridge_leave_cb ( void *  data,
struct stasis_subscription sub,
struct stasis_message message 
)
static

Definition at line 640 of file confbridge_manager.c.

642{
643 struct ast_str *extra_text = NULL;
644
645 if (!get_admin_header(&extra_text, message)) {
647 }
648 ast_free(extra_text);
649}

References ast_free, confbridge_publish_manager_event(), get_admin_header(), and NULL.

Referenced by manager_confbridge_init().

◆ confbridge_mute_cb()

static void confbridge_mute_cb ( void *  data,
struct stasis_subscription sub,
struct stasis_message message 
)
static

Definition at line 695 of file confbridge_manager.c.

697{
698 struct ast_str *extra_text = NULL;
699
700 if (!get_admin_header(&extra_text, message)) {
702 }
703 ast_free(extra_text);
704}

References ast_free, confbridge_publish_manager_event(), get_admin_header(), and NULL.

Referenced by manager_confbridge_init().

◆ confbridge_publish_manager_event()

static void confbridge_publish_manager_event ( struct stasis_message message,
struct ast_str extra_text 
)
static

Definition at line 564 of file confbridge_manager.c.

567{
570 const char *conference_name;
571 RAII_VAR(struct ast_str *, bridge_text, NULL, ast_free);
572 RAII_VAR(struct ast_str *, channel_text, NULL, ast_free);
573
574 ast_assert(blob != NULL);
576
577 bridge_text = ast_manager_build_bridge_state_string(blob->bridge);
578 if (!bridge_text) {
579 return;
580 }
581
582 conference_name = ast_json_string_get(ast_json_object_get(blob->blob, "conference"));
583 ast_assert(conference_name != NULL);
584
585 if (blob->channel) {
586 struct confbridge_conference *conference = conf_find_bridge(conference_name);
587
589 ao2_cleanup(conference);
590 }
591
593 "Conference: %s\r\n"
594 "%s"
595 "%s"
596 "%s",
597 conference_name,
598 ast_str_buffer(bridge_text),
599 channel_text ? ast_str_buffer(channel_text) : "",
600 extra_text ? ast_str_buffer(extra_text) : "");
601}
struct confbridge_conference * conf_find_bridge(const char *conference_name)
Find a confbridge by name.
#define ao2_cleanup(obj)
Definition: astobj2.h:1934
const char * ast_json_string_get(const struct ast_json *string)
Get the value of a JSON string.
Definition: json.c:283
#define manager_event(category, event, contents,...)
External routines may send asterisk manager events this way.
Definition: manager.h:254
struct ast_str * ast_manager_build_channel_state_string(const struct ast_channel_snapshot *snapshot)
Generate the AMI message body from a channel snapshot.
#define EVENT_FLAG_CALL
Definition: manager.h:76
struct ast_str * ast_manager_build_bridge_state_string(const struct ast_bridge_snapshot *snapshot)
Generate the AMI message body from a bridge snapshot.
char * ast_str_buffer(const struct ast_str *buf)
Returns the string buffer within the ast_str buf.
Definition: strings.h:761
The structure that represents a conference bridge.
Definition: confbridge.h:246
Definition: astman.c:222
#define RAII_VAR(vartype, varname, initval, dtor)
Declare a variable that will call a destructor function when it goes out of scope.
Definition: utils.h:941
#define ast_assert(a)
Definition: utils.h:739

References ao2_cleanup, ast_assert, ast_free, ast_json_object_get(), ast_json_string_get(), ast_manager_build_bridge_state_string(), ast_manager_build_channel_state_string(), ast_str_buffer(), ast_bridge_blob::blob, ast_bridge_blob::channel, conf_find_bridge(), confbridge_event_type_to_string(), EVENT_FLAG_CALL, manager_event, NULL, RAII_VAR, stasis_message_data(), and stasis_message_type().

Referenced by confbridge_end_cb(), confbridge_join_cb(), confbridge_leave_cb(), confbridge_mute_cb(), confbridge_start_cb(), confbridge_start_record_cb(), confbridge_stop_record_cb(), confbridge_talking_cb(), and confbridge_unmute_cb().

◆ confbridge_start_cb()

static void confbridge_start_cb ( void *  data,
struct stasis_subscription sub,
struct stasis_message message 
)
static

Definition at line 628 of file confbridge_manager.c.

References confbridge_publish_manager_event(), and NULL.

Referenced by manager_confbridge_init().

◆ confbridge_start_record_cb()

static void confbridge_start_record_cb ( void *  data,
struct stasis_subscription sub,
struct stasis_message message 
)
static

Definition at line 683 of file confbridge_manager.c.

References confbridge_publish_manager_event(), and NULL.

Referenced by manager_confbridge_init().

◆ confbridge_stop_record_cb()

static void confbridge_stop_record_cb ( void *  data,
struct stasis_subscription sub,
struct stasis_message message 
)
static

Definition at line 689 of file confbridge_manager.c.

References confbridge_publish_manager_event(), and NULL.

Referenced by manager_confbridge_init().

◆ confbridge_talking_cb()

static void confbridge_talking_cb ( void *  data,
struct stasis_subscription sub,
struct stasis_message message 
)
static

Definition at line 717 of file confbridge_manager.c.

719{
720 RAII_VAR(struct ast_str *, extra_text, NULL, ast_free);
722 const char *talking_status = ast_json_string_get(ast_json_object_get(blob->blob, "talking_status"));
723 if (!talking_status) {
724 return;
725 }
726
727 ast_str_append_event_header(&extra_text, "TalkingStatus", talking_status);
728 if (!extra_text) {
729 return;
730 }
731
732 if (!get_admin_header(&extra_text, message)) {
734 }
735}
int ast_str_append_event_header(struct ast_str **fields_string, const char *header, const char *value)
append an event header to an ast string
Definition: manager.c:10215

References ast_free, ast_json_object_get(), ast_json_string_get(), ast_str_append_event_header(), ast_bridge_blob::blob, confbridge_publish_manager_event(), get_admin_header(), NULL, RAII_VAR, and stasis_message_data().

Referenced by manager_confbridge_init().

◆ confbridge_unmute_cb()

static void confbridge_unmute_cb ( void *  data,
struct stasis_subscription sub,
struct stasis_message message 
)
static

Definition at line 706 of file confbridge_manager.c.

708{
709 struct ast_str *extra_text = NULL;
710
711 if (!get_admin_header(&extra_text, message)) {
713 }
714 ast_free(extra_text);
715}

References ast_free, confbridge_publish_manager_event(), get_admin_header(), and NULL.

Referenced by manager_confbridge_init().

◆ get_admin_header()

static int get_admin_header ( struct ast_str **  extra_text,
struct stasis_message message 
)
static

Definition at line 618 of file confbridge_manager.c.

619{
620 return get_bool_header(extra_text, message, "admin", "Admin");
621}
static int get_bool_header(struct ast_str **extra_text, struct stasis_message *message, const char *json_key, const char *ami_header)

References get_bool_header().

Referenced by confbridge_join_cb(), confbridge_leave_cb(), confbridge_mute_cb(), confbridge_talking_cb(), and confbridge_unmute_cb().

◆ get_bool_header()

static int get_bool_header ( struct ast_str **  extra_text,
struct stasis_message message,
const char *  json_key,
const char *  ami_header 
)
static

Definition at line 603 of file confbridge_manager.c.

605{
607 const struct ast_json *obj;
608
609 obj = ast_json_object_get(blob->blob, json_key);
610 if (!obj) {
611 return -1;
612 }
613
614 return ast_str_append_event_header(extra_text, ami_header,
616}
int ast_json_is_true(const struct ast_json *value)
Check if value is JSON true.
Definition: json.c:263
#define AST_YESNO(x)
return Yes or No depending on the argument.
Definition: strings.h:143

References ast_json_is_true(), ast_json_object_get(), ast_str_append_event_header(), AST_YESNO, ast_bridge_blob::blob, and stasis_message_data().

Referenced by get_admin_header(), and get_muted_header().

◆ get_muted_header()

static int get_muted_header ( struct ast_str **  extra_text,
struct stasis_message message 
)
static

Definition at line 623 of file confbridge_manager.c.

624{
625 return get_bool_header(extra_text, message, "muted", "Muted");
626}

References get_bool_header().

Referenced by confbridge_join_cb().

◆ manager_confbridge_init()

int manager_confbridge_init ( void  )

register stasis message routers to handle manager events for confbridge messages

Since
12.0
Return values
0success
non-zerofailure

Definition at line 760 of file confbridge_manager.c.

761{
772
775
776 if (!bridge_state_router) {
777 return -1;
778 }
779
783 NULL)) {
785 return -1;
786 }
790 NULL)) {
792 return -1;
793 }
797 NULL)) {
799 return -1;
800 }
804 NULL)) {
806 return -1;
807 }
811 NULL)) {
813 return -1;
814 }
818 NULL)) {
820 return -1;
821 }
825 NULL)) {
827 return -1;
828 }
832 NULL)) {
834 return -1;
835 }
839 NULL)) {
841 return -1;
842 }
846 NULL)) {
848 return -1;
849 }
850
853
856 return -1;
857 }
858
862 NULL)) {
864 return -1;
865 }
869 NULL)) {
871 return -1;
872 }
876 NULL)) {
878 return -1;
879 }
883 NULL)) {
885 return -1;
886 }
890 NULL)) {
892 return -1;
893 }
897 NULL)) {
899 return -1;
900 }
904 NULL)) {
906 return -1;
907 }
911 NULL)) {
913 return -1;
914 }
918 NULL)) {
920 return -1;
921 }
922
923 /* FYI: confbridge_welcome_type is never routed */
924
925 return 0;
926}
static void confbridge_unmute_cb(void *data, struct stasis_subscription *sub, struct stasis_message *message)
static void confbridge_start_cb(void *data, struct stasis_subscription *sub, struct stasis_message *message)
static void confbridge_atxfer_cb(void *data, struct stasis_subscription *sub, struct stasis_message *message)
static struct stasis_message_router * bridge_state_router
void manager_confbridge_shutdown(void)
unregister stasis message routers to handle manager events for confbridge messages
static void confbridge_stop_record_cb(void *data, struct stasis_subscription *sub, struct stasis_message *message)
static void confbridge_end_cb(void *data, struct stasis_subscription *sub, struct stasis_message *message)
static void confbridge_leave_cb(void *data, struct stasis_subscription *sub, struct stasis_message *message)
static void confbridge_start_record_cb(void *data, struct stasis_subscription *sub, struct stasis_message *message)
static void confbridge_talking_cb(void *data, struct stasis_subscription *sub, struct stasis_message *message)
static void confbridge_join_cb(void *data, struct stasis_subscription *sub, struct stasis_message *message)
static struct stasis_message_router * channel_state_router
static void confbridge_mute_cb(void *data, struct stasis_subscription *sub, struct stasis_message *message)
struct stasis_topic * ast_channel_topic_all(void)
A topic which publishes the events for all channels.
#define STASIS_MESSAGE_TYPE_INIT(name)
Boiler-plate messaging macro for initializing message types.
Definition: stasis.h:1493
struct stasis_message_type * ast_attended_transfer_type(void)
Message type for ast_attended_transfer_message.
struct stasis_topic * ast_bridge_topic_all(void)
A topic which publishes the events for all bridges.
#define stasis_message_router_create(topic)
Create a new message router object.
int stasis_message_router_add(struct stasis_message_router *router, struct stasis_message_type *message_type, stasis_subscription_cb callback, void *data)
Add a route to a message router.

References ast_attended_transfer_type(), ast_bridge_topic_all(), ast_channel_topic_all(), bridge_state_router, channel_state_router, confbridge_atxfer_cb(), confbridge_end_cb(), confbridge_end_type(), confbridge_join_cb(), confbridge_join_type(), confbridge_leave_cb(), confbridge_leave_type(), confbridge_mute_cb(), confbridge_mute_type(), confbridge_start_cb(), confbridge_start_record_cb(), confbridge_start_record_type(), confbridge_start_type(), confbridge_stop_record_cb(), confbridge_stop_record_type(), confbridge_talking_cb(), confbridge_talking_type(), confbridge_unmute_cb(), confbridge_unmute_type(), confbridge_welcome_type(), manager_confbridge_shutdown(), NULL, stasis_message_router_add(), stasis_message_router_create, and STASIS_MESSAGE_TYPE_INIT.

Referenced by load_module().

◆ manager_confbridge_shutdown()

void manager_confbridge_shutdown ( void  )

unregister stasis message routers to handle manager events for confbridge messages

Since
12.0

Definition at line 737 of file confbridge_manager.c.

References bridge_state_router, channel_state_router, confbridge_end_type(), confbridge_join_type(), confbridge_leave_type(), confbridge_mute_type(), confbridge_start_record_type(), confbridge_start_type(), confbridge_stop_record_type(), confbridge_talking_type(), confbridge_unmute_type(), confbridge_welcome_type(), NULL, stasis_message_router_unsubscribe(), and STASIS_MESSAGE_TYPE_CLEANUP.

Referenced by manager_confbridge_init(), and unload_module().

◆ pack_bridge_and_channel()

static struct ast_json * pack_bridge_and_channel ( struct ast_json json_bridge,
struct ast_json json_channel,
struct stasis_message msg 
)
static

Definition at line 356 of file confbridge_manager.c.

359{
360 const struct timeval *tv = stasis_message_timestamp(msg);
361 const char *msg_name = confbridge_event_type_to_string(stasis_message_type(msg));
362
363 return ast_json_pack("{s: s, s: o, s: o, s: [o*]}",
364 "type", msg_name,
365 "timestamp", ast_json_timeval(*tv, NULL),
366 "bridge", json_bridge,
367 "channels", json_channel);
368}
struct ast_json * ast_json_pack(char const *format,...)
Helper for creating complex JSON values.
Definition: json.c:612
struct ast_json * ast_json_timeval(const struct timeval tv, const char *zone)
Construct a timeval as JSON.
Definition: json.c:670
const struct timeval * stasis_message_timestamp(const struct stasis_message *msg)
Get the time when a message was created.

References ast_json_pack(), ast_json_timeval(), confbridge_event_type_to_string(), NULL, stasis_message_timestamp(), and stasis_message_type().

Referenced by pack_snapshots().

◆ pack_bridge_and_channels()

static struct ast_json * pack_bridge_and_channels ( struct ast_json json_bridge,
struct ast_json json_channels,
struct stasis_message msg 
)
static

Definition at line 370 of file confbridge_manager.c.

373{
374 const struct timeval *tv = stasis_message_timestamp(msg);
375 const char *msg_name = confbridge_event_type_to_string(stasis_message_type(msg));
376
377 return ast_json_pack("{s: s, s: o, s: o, s: o}",
378 "type", msg_name,
379 "timestamp", ast_json_timeval(*tv, NULL),
380 "bridge", json_bridge,
381 "channels", json_channels);
382}

References ast_json_pack(), ast_json_timeval(), confbridge_event_type_to_string(), NULL, stasis_message_timestamp(), and stasis_message_type().

Referenced by conf_send_event_to_participants().

◆ pack_snapshots()

static struct ast_json * pack_snapshots ( struct ast_bridge_snapshot bridge_snapshot,
struct ast_channel_snapshot channel_snapshot,
struct ast_json conf_blob,
struct ast_json labels_blob,
struct stasis_message msg 
)
static

Definition at line 384 of file confbridge_manager.c.

387{
388 struct ast_json *json_bridge;
389 struct ast_json *json_channel;
390
391 json_bridge = bridge_to_json(bridge_snapshot);
392 json_channel = channel_to_json(channel_snapshot, conf_blob, labels_blob);
393
394 return pack_bridge_and_channel(json_bridge, json_channel, msg);
395}
static struct ast_json * pack_bridge_and_channel(struct ast_json *json_bridge, struct ast_json *json_channel, struct stasis_message *msg)

References bridge_to_json(), channel_to_json(), and pack_bridge_and_channel().

Referenced by conf_send_event_to_participants().

◆ send_message()

static void send_message ( const char *  msg_name,
char *  conf_name,
struct ast_json json_object,
struct ast_channel chan 
)
static

Definition at line 397 of file confbridge_manager.c.

399{
400 struct ast_msg_data *data_msg;
401 struct ast_msg_data_attribute attrs[] = {
402 { .type = AST_MSG_DATA_ATTR_FROM, conf_name },
403 { .type = AST_MSG_DATA_ATTR_CONTENT_TYPE, .value = "application/x-asterisk-confbridge-event+json"},
404 { .type = AST_MSG_DATA_ATTR_BODY, },
405 };
406 char *json;
407 int rc = 0;
408 struct ast_frame f;
409 RAII_VAR(struct ast_bridge_channel *, bridge_chan, NULL, ao2_cleanup);
410
411 bridge_chan = ast_channel_get_bridge_channel(chan);
412 if (!bridge_chan) {
413 /* Don't complain if we can't get the bridge_chan. The channel is probably gone. */
414 return;
415 }
416
417 json = ast_json_dump_string_format(json_object, AST_JSON_PRETTY);
418 if (!json) {
419 ast_log(LOG_ERROR, "Unable to convert json_object for %s message to string\n", msg_name);
420 return;
421 }
422 attrs[2].value = json;
423
425 if (!data_msg) {
426 ast_log(LOG_ERROR, "Unable to create %s message for channel '%s'\n", msg_name,
427 ast_channel_name(chan));
428 ast_json_free(json);
429 return;
430 }
431
432 memset(&f, 0, sizeof(f));
433 f.frametype = AST_FRAME_TEXT_DATA;
434 f.data.ptr = data_msg;
435 f.datalen = ast_msg_data_get_length(data_msg);
436
437 rc = ast_bridge_channel_queue_frame(bridge_chan, &f);
438 ast_free(data_msg);
439 if (rc != 0) {
440 /* Don't complain if we can't send a leave message. The channel is probably gone. */
441 if (strcmp(confbridge_event_type_to_string(confbridge_leave_type()), msg_name) != 0) {
442 ast_log(LOG_ERROR, "Failed to queue %s message to '%s'\n%s\n", msg_name,
443 ast_channel_name(chan), json);
444 }
445 ast_json_free(json);
446 return;
447 }
448
449 ast_debug(3, "Queued %s message to '%s'\n%s\n", msg_name, ast_channel_name(chan), json);
450 ast_json_free(json);
451}
int ast_bridge_channel_queue_frame(struct ast_bridge_channel *bridge_channel, struct ast_frame *fr)
Write a frame to the specified bridge_channel.
struct ast_bridge_channel * ast_channel_get_bridge_channel(struct ast_channel *chan)
Get a reference to the channel's bridge pointer.
Definition: channel.c:10587
struct ast_msg_data * ast_msg_data_alloc(enum ast_msg_data_source_type source, struct ast_msg_data_attribute attributes[], size_t count)
Allocates an ast_msg_data structure.
size_t ast_msg_data_get_length(struct ast_msg_data *msg)
Get length of the structure.
@ AST_MSG_DATA_ATTR_BODY
Definition: message.h:458
@ AST_MSG_DATA_ATTR_FROM
Definition: message.h:456
@ AST_MSG_DATA_ATTR_CONTENT_TYPE
Definition: message.h:457
@ AST_MSG_DATA_SOURCE_TYPE_IN_DIALOG
Definition: message.h:449
@ AST_FRAME_TEXT_DATA
void ast_json_free(void *p)
Asterisk's custom JSON allocator. Exposed for use by unit tests.
Definition: json.c:52
@ AST_JSON_PRETTY
Definition: json.h:795
char * ast_json_dump_string_format(struct ast_json *root, enum ast_json_encoding_format format)
Encode a JSON value to a string.
Definition: json.c:484
Structure that contains information regarding a channel in a bridge.
Data structure associated with a single frame of data.
enum ast_msg_data_attribute_type type
Definition: message.h:463
Structure used to transport a message through the frame core.
#define ARRAY_LEN(a)
Definition: utils.h:666

References ao2_cleanup, ARRAY_LEN, ast_bridge_channel_queue_frame(), ast_channel_get_bridge_channel(), ast_channel_name(), ast_debug, AST_FRAME_TEXT_DATA, ast_free, ast_json_dump_string_format(), ast_json_free(), AST_JSON_PRETTY, ast_log, ast_msg_data_alloc(), AST_MSG_DATA_ATTR_BODY, AST_MSG_DATA_ATTR_CONTENT_TYPE, AST_MSG_DATA_ATTR_FROM, ast_msg_data_get_length(), AST_MSG_DATA_SOURCE_TYPE_IN_DIALOG, confbridge_event_type_to_string(), confbridge_leave_type(), ast_frame::data, ast_frame::datalen, ast_frame::frametype, LOG_ERROR, NULL, ast_frame::ptr, RAII_VAR, ast_msg_data_attribute::type, and ast_msg_data_attribute::value.

Referenced by conf_send_event_to_participants().

◆ STASIS_MESSAGE_TYPE_DEFN() [1/10]

STASIS_MESSAGE_TYPE_DEFN ( confbridge_end_type  )

◆ STASIS_MESSAGE_TYPE_DEFN() [2/10]

STASIS_MESSAGE_TYPE_DEFN ( confbridge_join_type  )

◆ STASIS_MESSAGE_TYPE_DEFN() [3/10]

STASIS_MESSAGE_TYPE_DEFN ( confbridge_leave_type  )

◆ STASIS_MESSAGE_TYPE_DEFN() [4/10]

STASIS_MESSAGE_TYPE_DEFN ( confbridge_mute_type  )

◆ STASIS_MESSAGE_TYPE_DEFN() [5/10]

STASIS_MESSAGE_TYPE_DEFN ( confbridge_start_record_type  )

◆ STASIS_MESSAGE_TYPE_DEFN() [6/10]

STASIS_MESSAGE_TYPE_DEFN ( confbridge_start_type  )

◆ STASIS_MESSAGE_TYPE_DEFN() [7/10]

STASIS_MESSAGE_TYPE_DEFN ( confbridge_stop_record_type  )

◆ STASIS_MESSAGE_TYPE_DEFN() [8/10]

STASIS_MESSAGE_TYPE_DEFN ( confbridge_talking_type  )

◆ STASIS_MESSAGE_TYPE_DEFN() [9/10]

STASIS_MESSAGE_TYPE_DEFN ( confbridge_unmute_type  )

◆ STASIS_MESSAGE_TYPE_DEFN() [10/10]

STASIS_MESSAGE_TYPE_DEFN ( confbridge_welcome_type  )

Variable Documentation

◆ bridge_state_router

struct stasis_message_router* bridge_state_router
static

Definition at line 256 of file confbridge_manager.c.

Referenced by manager_confbridge_init(), and manager_confbridge_shutdown().

◆ channel_state_router

struct stasis_message_router* channel_state_router
static

Definition at line 257 of file confbridge_manager.c.

Referenced by manager_confbridge_init(), and manager_confbridge_shutdown().