mirror of
https://github.com/asterisk/asterisk.git
synced 2025-09-05 20:20:07 +00:00
00baddb906
This essentially makes app_queue usable again. From reviewboard: * Reporting of transfers and call completion is done by creating stasis subscriptions and listening for specific events in order to determine when the call is finished (either via a transfer or hangup). * Dial end messages have been added where they were previously missing. * Queue stats are properly being updated again once calls have finished. * AgentComplete stasis messages and AMI events are now occurring again. * Mixmonitor starting has been factored into its own function and uses the Mixmonitor API now instead of using ast_pbx_run() In addition to the changes in app_queue, there are several supplementary changes as well: * Queue logging now differentiates between attended and blind transfers. A note about this is in the CHANGES file. * Local channel optimization events now report more information. This includes which of the two local channels involved is the destination of the optimization, the channel that is replacing the destination local channel, and an identifier so that begin and end events can be matched to each other. The end events are now sent whether the optimization was successful or not and includes an indicator of whether the optimization was successful. * Changes were made to features and bridging_basic so that additional flags may be set on a bridge. This is necessary because the queue requires that its bridge only allows move-swap local channel optimizations into the bridge. (closes issue ASTERISK-21517) Reported by Matt Jordan (closes issue ASTERISK-21943) Reported by Matt Jordan Review: https://reviewboard.asterisk.org/r/2694 git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@397451 65c4cc65-6c06-0410-ace0-fbb531ad65f3
151 lines
4.4 KiB
C
151 lines
4.4 KiB
C
/*
|
|
* Asterisk -- An open source telephony toolkit.
|
|
*
|
|
* Copyright (C) 2013 Digium, Inc.
|
|
*
|
|
* Richard Mudgett <rmudgett@digium.com>
|
|
*
|
|
* See http://www.asterisk.org for more information about
|
|
* the Asterisk project. Please do not directly contact
|
|
* any of the maintainers of this project for assistance;
|
|
* the project provides a web site, mailing lists and IRC
|
|
* channels for your use.
|
|
*
|
|
* This program is free software, distributed under the terms of
|
|
* the GNU General Public License Version 2. See the LICENSE file
|
|
* at the top of the source tree.
|
|
*/
|
|
|
|
/*!
|
|
* \file
|
|
* \brief Basic bridge subclass API.
|
|
*
|
|
* \author Richard Mudgett <rmudgett@digium.com>
|
|
*
|
|
* See Also:
|
|
* \arg \ref AstCREDITS
|
|
*/
|
|
|
|
#ifndef _ASTERISK_BRIDGING_BASIC_H
|
|
#define _ASTERISK_BRIDGING_BASIC_H
|
|
|
|
#if defined(__cplusplus) || defined(c_plusplus)
|
|
extern "C" {
|
|
#endif
|
|
|
|
#define AST_TRANSFERER_ROLE_NAME "transferer"
|
|
/* ------------------------------------------------------------------- */
|
|
|
|
/*!
|
|
* \brief Sets the features a channel will use upon being bridged.
|
|
* \since 12.0.0
|
|
*
|
|
* \param chan Which channel to set features for
|
|
* \param features Which feature codes to set for the channel
|
|
*
|
|
* \retval 0 on success
|
|
* \retval -1 on failure
|
|
*/
|
|
int ast_bridge_features_ds_set_string(struct ast_channel *chan, const char *features);
|
|
|
|
/*!
|
|
* \brief writes a channel's DTMF features to a buffer string
|
|
* \since 12.0.0
|
|
*
|
|
* \param chan channel whose feature flags should be checked
|
|
* \param buffer pointer string buffer where the output should be stored
|
|
* \param buf_size size of the provided buffer (ideally enough for all features, 6+)
|
|
*
|
|
* \retval 0 on successful write
|
|
* \retval -1 on failure
|
|
*/
|
|
int ast_bridge_features_ds_get_string(struct ast_channel *chan, char *buffer, size_t buf_size);
|
|
|
|
/*!
|
|
* \brief Get DTMF feature flags from the channel.
|
|
* \since 12.0.0
|
|
*
|
|
* \param chan Channel to get DTMF features datastore.
|
|
*
|
|
* \note The channel should be locked before calling this function.
|
|
* \note The channel must remain locked until the flags returned have been consumed.
|
|
*
|
|
* \retval flags on success.
|
|
* \retval NULL if the datastore does not exist.
|
|
*/
|
|
struct ast_flags *ast_bridge_features_ds_get(struct ast_channel *chan);
|
|
|
|
/*!
|
|
* \brief Set basic bridge DTMF feature flags datastore on the channel.
|
|
* \since 12.0.0
|
|
*
|
|
* \param chan Channel to set DTMF features datastore.
|
|
* \param flags Builtin DTMF feature flags. (ast_bridge_config flags)
|
|
*
|
|
* \note The channel must be locked before calling this function.
|
|
*
|
|
* \retval 0 on success.
|
|
* \retval -1 on error.
|
|
*/
|
|
int ast_bridge_features_ds_set(struct ast_channel *chan, struct ast_flags *flags);
|
|
|
|
/*!
|
|
* \brief Append basic bridge DTMF feature flags on the channel.
|
|
* \since 12.0.0
|
|
*
|
|
* \param chan Channel to append DTMF features datastore.
|
|
* \param flags Builtin DTMF feature flags. (ast_bridge_config flags)
|
|
*
|
|
* \note The channel must be locked before calling this function.
|
|
* \note This function differs from ast_bridge_features_ds_set only in that it won't
|
|
* remove features already set on the channel.
|
|
*
|
|
* \retval 0 on success.
|
|
* \retval -1 on error.
|
|
*/
|
|
int ast_bridge_features_ds_append(struct ast_channel *chan, struct ast_flags *flags);
|
|
|
|
/*! \brief Bridge basic class virtual method table. */
|
|
extern struct ast_bridge_methods ast_bridge_basic_v_table;
|
|
|
|
/*!
|
|
* \brief Create a new basic class bridge
|
|
*
|
|
* \retval a pointer to a new bridge on success
|
|
* \retval NULL on failure
|
|
*
|
|
* Example usage:
|
|
*
|
|
* \code
|
|
* struct ast_bridge *bridge;
|
|
* bridge = ast_bridge_basic_new();
|
|
* \endcode
|
|
*
|
|
* This creates a basic two party bridge with any configured
|
|
* DTMF features enabled that will be destroyed once one of the
|
|
* channels hangs up.
|
|
*/
|
|
struct ast_bridge *ast_bridge_basic_new(void);
|
|
|
|
/*!
|
|
* \brief Set feature flags on a basic bridge
|
|
*
|
|
* Using this function instead of setting flags directly will
|
|
* ensure that after operations such as an attended transfer,
|
|
* the bridge will maintain the flags that were set on it.
|
|
*
|
|
* \params Flags to set on the bridge. These are added to the flags already set.
|
|
*/
|
|
void ast_bridge_basic_set_flags(struct ast_bridge *bridge, unsigned int flags);
|
|
|
|
/*! Initialize the basic bridge class for use by the system. */
|
|
void ast_bridging_init_basic(void);
|
|
|
|
/* ------------------------------------------------------------------- */
|
|
|
|
#if defined(__cplusplus) || defined(c_plusplus)
|
|
}
|
|
#endif
|
|
|
|
#endif /* _ASTERISK_BRIDGING_BASIC_H */
|