mirror of
				https://github.com/asterisk/asterisk.git
				synced 2025-10-31 18:55:19 +00:00 
			
		
		
		
	Introduce a ChannelTransfer event and the ability to notify progress to ARI. Implement emitting this event from the PJSIP channel instead of handling the transfer in Asterisk when configured. Introduce a dialplan function to the PJSIP channel to switch between the "core" and "ari-only" behavior. UserNote: Call transfers on the PJSIP channel can now be controlled by ARI. This can be enabled by using the PJSIP_TRANSFER_HANDLING(ari-only) dialplan function.
		
			
				
	
	
		
			184 lines
		
	
	
		
			5.9 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			184 lines
		
	
	
		
			5.9 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
| /*
 | |
|  * Asterisk -- An open source telephony toolkit.
 | |
|  *
 | |
|  * Copyright (C) 2013, Digium, Inc.
 | |
|  *
 | |
|  * 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 PJSIP dialplan functions header file
 | |
|  */
 | |
| 
 | |
| #ifndef _PJSIP_DIALPLAN_FUNCTIONS
 | |
| #define _PJSIP_DIALPLAN_FUNCTIONS
 | |
| 
 | |
| /*!
 | |
|  * \brief CHANNEL function read callback
 | |
|  * \param chan The channel the function is called on
 | |
|  * \param cmd The name of the function
 | |
|  * \param data Arguments passed to the function
 | |
|  * \param buf Out buffer that should be populated with the data
 | |
|  * \param len Size of the buffer
 | |
|  *
 | |
|  * \retval 0 on success
 | |
|  * \retval -1 on failure
 | |
|  */
 | |
| int pjsip_acf_channel_read(struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t len);
 | |
| 
 | |
| /*!
 | |
|  * \brief PJSIP_MEDIA_OFFER function write callback
 | |
|  * \param chan The channel the function is called on
 | |
|  * \param cmd The name of the function
 | |
|  * \param data Arguments passed to the function
 | |
|  * \param value Value to be set by the function
 | |
|  *
 | |
|  * \retval 0 on success
 | |
|  * \retval -1 on failure
 | |
|  */
 | |
| int pjsip_acf_media_offer_write(struct ast_channel *chan, const char *cmd, char *data, const char *value);
 | |
| 
 | |
| /*!
 | |
|  * \brief PJSIP_DTMF_MODE function read callback
 | |
|  * \param chan The channel the function is called on
 | |
|  * \param cmd The name of the function
 | |
|  * \param data Arguments passed to the function
 | |
|  * \param buf Out buffer that should be populated with the data
 | |
|  * \param len Size of the buffer
 | |
|  *
 | |
|  * \retval 0 on success
 | |
|  * \retval -1 on failure
 | |
|  */
 | |
| int pjsip_acf_dtmf_mode_read(struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t len);
 | |
| 
 | |
| /*!
 | |
|  * \brief PJSIP_DTMF_MODE function write callback
 | |
|  * \param chan The channel the function is called on
 | |
|  * \param cmd The name of the function
 | |
|  * \param data Arguments passed to the function
 | |
|  * \param value Value to be set by the function
 | |
|  *
 | |
|  * \retval 0 on success
 | |
|  * \retval -1 on failure
 | |
|  */
 | |
| int pjsip_acf_dtmf_mode_write(struct ast_channel *chan, const char *cmd, char *data, const char *value);
 | |
| 
 | |
| /*!
 | |
|  * \brief PJSIP_MOH_PASSTHROUGH function read callback
 | |
|  * \param chan The channel the function is called on
 | |
|  * \param cmd The name of the function
 | |
|  * \param data Arguments passed to the function
 | |
|  * \param buf Out buffer that should be populated with the data
 | |
|  * \param len Size of the buffer
 | |
|  *
 | |
|  * \retval 0 on success
 | |
|  * \retval -1 on failure
 | |
|  */
 | |
| int pjsip_acf_moh_passthrough_read(struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t len);
 | |
| 
 | |
| /*!
 | |
|  * \brief PJSIP_MOH_PASSTHROUGH function write callback
 | |
|  * \param chan The channel the function is called on
 | |
|  * \param cmd The name of the function
 | |
|  * \param data Arguments passed to the function
 | |
|  * \param value Value to be set by the function
 | |
|  *
 | |
|  * \retval 0 on success
 | |
|  * \retval -1 on failure
 | |
|  */
 | |
| int pjsip_acf_moh_passthrough_write(struct ast_channel *chan, const char *cmd, char *data, const char *value);
 | |
| 
 | |
| /*!
 | |
|  * \brief PJSIP_MEDIA_OFFER function read callback
 | |
|  * \param chan The channel the function is called on
 | |
|  * \param cmd The name of the function
 | |
|  * \param data Arguments passed to the function
 | |
|  * \param buf Out buffer that should be populated with the data
 | |
|  * \param len Size of the buffer
 | |
|  *
 | |
|  * \retval 0 on success
 | |
|  * \retval -1 on failure
 | |
|  */
 | |
| int pjsip_acf_media_offer_read(struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t len);
 | |
| 
 | |
| /*!
 | |
|  * \brief PJSIP_SEND_SESSION_REFRESH function write callback
 | |
|  * \param chan The channel the function is called on
 | |
|  * \param cmd the Name of the function
 | |
|  * \param data Arguments passed to the function
 | |
|  * \param value Value to be set by the function
 | |
|  *
 | |
|  * \retval 0 on success
 | |
|  * \retval -1 on failure
 | |
|  */
 | |
| int pjsip_acf_session_refresh_write(struct ast_channel *chan, const char *cmd, char *data, const char *value);
 | |
| 
 | |
| /*!
 | |
|  * \brief PJSIP_DIAL_CONTACTS function read callback
 | |
|  * \param chan The channel the function is called on
 | |
|  * \param cmd The name of the function
 | |
|  * \param data Arguments passed to the function
 | |
|  * \param buf Out buffer that should be populated with the data
 | |
|  * \param len Size of the buffer
 | |
|  *
 | |
|  * \retval 0 on success
 | |
|  * \retval -1 on failure
 | |
|  */
 | |
| int pjsip_acf_dial_contacts_read(struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t len);
 | |
| 
 | |
| /*!
 | |
|  * \brief PJSIP_PARSE_URI function read callback
 | |
|  * \param chan The channel the function is called on
 | |
|  * \param cmd The name of the function
 | |
|  * \param data Arguments passed to the function
 | |
|  * \param buf Out buffer that should be populated with the data
 | |
|  * \param len Size of the buffer
 | |
|  *
 | |
|  * \retval 0 on success
 | |
|  * \retval -1 on failure
 | |
|  */
 | |
| int pjsip_acf_parse_uri_read(struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t len);
 | |
| 
 | |
| /*!
 | |
|  * \brief Hang up an incoming PJSIP channel with a SIP response code
 | |
|  * \param chan The channel the function is called on
 | |
|  * \param data SIP response code or name
 | |
|  *
 | |
|  * \retval 0 on success
 | |
|  * \retval -1 on failure
 | |
|  */
 | |
| int pjsip_app_hangup(struct ast_channel *chan, const char *data);
 | |
| 
 | |
| /*!
 | |
|  * \brief Manager action to hang up an incoming PJSIP channel with a SIP response code
 | |
|  * \param s session
 | |
|  * \param m message
 | |
|  *
 | |
|  * \retval 0 on success
 | |
|  * \retval -1 on failure
 | |
|  */
 | |
| int pjsip_action_hangup(struct mansession *s, const struct message *m);
 | |
| 
 | |
| /*!
 | |
|  * \brief PJSIP_TRANSFER_HANDLING function write callback
 | |
|  * \param chan The channel the function is called on
 | |
|  * \param cmd the Name of the function
 | |
|  * \param data Arguments passed to the function
 | |
|  * \param value Value to be set by the function
 | |
|  *
 | |
|  * \retval 0 on success
 | |
|  * \retval -1 on failure
 | |
|  */
 | |
| int pjsip_transfer_handling_write(struct ast_channel *chan, const char *cmd, char *data, const char *value);
 | |
| 
 | |
| #endif /* _PJSIP_DIALPLAN_FUNCTIONS */
 |