mirror of
https://github.com/servalproject/serval-dna.git
synced 2024-12-23 23:12:31 +00:00
125 lines
4.6 KiB
C
125 lines
4.6 KiB
C
/*
|
|
* Asterisk -- An open source telephony toolkit.
|
|
*
|
|
* Copyright (C) 1999 - 2005, Digium, Inc.
|
|
*
|
|
* Mark Spencer <markster@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 Call Parking and Pickup API
|
|
* Includes code and algorithms from the Zapata library.
|
|
*/
|
|
|
|
#ifndef _AST_FEATURES_H
|
|
#define _AST_FEATURES_H
|
|
|
|
#include "asterisk/linkedlists.h"
|
|
|
|
#define FEATURE_MAX_LEN 11
|
|
#define FEATURE_APP_LEN 64
|
|
#define FEATURE_APP_ARGS_LEN 256
|
|
#define FEATURE_SNAME_LEN 32
|
|
#define FEATURE_EXTEN_LEN 32
|
|
#define FEATURE_MOH_LEN 80 /* same as MAX_MUSICCLASS from channel.h */
|
|
|
|
#define PARK_APP_NAME "Park"
|
|
|
|
#define FEATURE_RETURN_HANGUP -1
|
|
#define FEATURE_RETURN_SUCCESSBREAK 0
|
|
#define FEATURE_RETURN_PBX_KEEPALIVE AST_PBX_KEEPALIVE
|
|
#define FEATURE_RETURN_NO_HANGUP_PEER AST_PBX_NO_HANGUP_PEER
|
|
#define FEATURE_RETURN_PASSDIGITS 21
|
|
#define FEATURE_RETURN_STOREDIGITS 22
|
|
#define FEATURE_RETURN_SUCCESS 23
|
|
#define FEATURE_RETURN_KEEPTRYING 24
|
|
#define FEATURE_RETURN_PARKFAILED 25
|
|
|
|
#define FEATURE_SENSE_CHAN (1 << 0)
|
|
#define FEATURE_SENSE_PEER (1 << 1)
|
|
|
|
typedef int (*ast_feature_operation)(struct ast_channel *chan, struct ast_channel *peer, struct ast_bridge_config *config, char *code, int sense, void *data);
|
|
|
|
/*! \brief main call feature structure */
|
|
struct ast_call_feature {
|
|
int feature_mask;
|
|
char *fname;
|
|
char sname[FEATURE_SNAME_LEN];
|
|
char exten[FEATURE_MAX_LEN];
|
|
char default_exten[FEATURE_MAX_LEN];
|
|
int (*operation)(struct ast_channel *chan, struct ast_channel *peer, struct ast_bridge_config *config, char *code, int sense, void *data);
|
|
unsigned int flags;
|
|
char app[FEATURE_APP_LEN];
|
|
char app_args[FEATURE_APP_ARGS_LEN];
|
|
char moh_class[FEATURE_MOH_LEN];
|
|
AST_LIST_ENTRY(ast_call_feature) feature_entry;
|
|
};
|
|
|
|
|
|
|
|
/*! \brief Park a call and read back parked location
|
|
* \param chan the channel to actually be parked
|
|
\param host the channel which will have the parked location read to
|
|
Park the channel chan, and read back the parked location to the
|
|
host. If the call is not picked up within a specified period of
|
|
time, then the call will return to the last step that it was in
|
|
(in terms of exten, priority and context)
|
|
\param timeout is a timeout in milliseconds
|
|
\param extout is a parameter to an int that will hold the parked location, or NULL if you want
|
|
*/
|
|
int ast_park_call(struct ast_channel *chan, struct ast_channel *host, int timeout, int *extout);
|
|
|
|
/*! \brief Park a call via a masqueraded channel
|
|
* \param rchan the real channel to be parked
|
|
\param host the channel to have the parking read to
|
|
Masquerade the channel rchan into a new, empty channel which is then
|
|
parked with ast_park_call
|
|
\param timeout is a timeout in milliseconds
|
|
\param extout is a parameter to an int that will hold the parked location, or NULL if you want
|
|
*/
|
|
int ast_masq_park_call(struct ast_channel *rchan, struct ast_channel *host, int timeout, int *extout);
|
|
|
|
/*! \brief Determine system parking extension
|
|
* Returns the call parking extension for drivers that provide special
|
|
call parking help */
|
|
char *ast_parking_ext(void);
|
|
|
|
/*! \brief Determine system call pickup extension */
|
|
char *ast_pickup_ext(void);
|
|
|
|
/*! \brief Bridge a call, optionally allowing redirection */
|
|
int ast_bridge_call(struct ast_channel *chan, struct ast_channel *peer,struct ast_bridge_config *config);
|
|
|
|
/*! \brief detect a feature before bridging
|
|
\param chan
|
|
\param ast_flags ptr
|
|
\param char ptr of input code
|
|
\retval ast_call_feature ptr to be set if found
|
|
\return result, was feature found or not */
|
|
int ast_feature_detect(struct ast_channel *chan, struct ast_flags *features, char *code, struct ast_call_feature *feature);
|
|
|
|
/*! \brief Pickup a call */
|
|
int ast_pickup_call(struct ast_channel *chan);
|
|
|
|
/*! \brief register new feature into feature_set
|
|
\param feature an ast_call_feature object which contains a keysequence
|
|
and a callback function which is called when this keysequence is pressed
|
|
during a call. */
|
|
void ast_register_feature(struct ast_call_feature *feature);
|
|
|
|
/*! \brief unregister feature from feature_set
|
|
\param feature the ast_call_feature object which was registered before*/
|
|
void ast_unregister_feature(struct ast_call_feature *feature);
|
|
|
|
#endif /* _AST_FEATURES_H */
|