2001-08-05 21:46:13 +00:00
|
|
|
/*
|
|
|
|
* Asterisk -- A telephony toolkit for Linux.
|
|
|
|
*
|
|
|
|
* Application convenience functions, designed to give consistent
|
|
|
|
* look and feel to asterisk apps.
|
|
|
|
*
|
|
|
|
* Copyright (C) 1999, Mark Spencer
|
|
|
|
*
|
|
|
|
* Mark Spencer <markster@linux-support.net>
|
|
|
|
*
|
|
|
|
* This program is free software, distributed under the terms of
|
|
|
|
* the GNU General Public License
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef _ASTERISK_APP_H
|
|
|
|
#define _ASTERISK_APP_H
|
|
|
|
|
|
|
|
#if defined(__cplusplus) || defined(c_plusplus)
|
|
|
|
extern "C" {
|
|
|
|
#endif
|
2001-10-31 15:28:08 +00:00
|
|
|
//! Plays a stream and gets DTMF data from a channel
|
|
|
|
/*!
|
|
|
|
* \param c Which channel one is interacting with
|
|
|
|
* \param prompt File to pass to ast_streamfile (the one that you wish to play)
|
|
|
|
* \param s The location where the DTMF data will be stored
|
|
|
|
* \param maxlen Max Length of the data
|
|
|
|
* \param timeout Timeout length waiting for data(in milliseconds). Set to 0 for standard timeout(six seconds), or -1 for no time out.
|
|
|
|
*
|
|
|
|
* This function was designed for application programmers for situations where they need
|
|
|
|
* to play a message and then get some DTMF data in response to the message. If a digit
|
|
|
|
* is pressed during playback, it will immediately break out of the message and continue
|
|
|
|
* execution of your code.
|
|
|
|
*/
|
2001-08-05 21:46:13 +00:00
|
|
|
extern int ast_app_getdata(struct ast_channel *c, char *prompt, char *s, int maxlen, int timeout);
|
|
|
|
|
2003-02-23 06:00:11 +00:00
|
|
|
/* Full version with audiofd and controlfd. NOTE: returns '2' on ctrlfd available, not '1' like other full functions */
|
|
|
|
extern int ast_app_getdata_full(struct ast_channel *c, char *prompt, char *s, int maxlen, int timeout, int audiofd, int ctrlfd);
|
|
|
|
|
2002-12-26 19:38:27 +00:00
|
|
|
//! Record voice (after playing prompt if specified), waiting for silence (in ms) up to a given timeout (in s) or '#'
|
|
|
|
int ast_app_getvoice(struct ast_channel *c, char *dest, char *dstfmt, char *prompt, int silence, int maxsec);
|
|
|
|
|
|
|
|
//! Determine if a given mailbox has any voicemail
|
2003-03-26 00:15:11 +00:00
|
|
|
extern int ast_app_has_voicemail(const char *mailbox);
|
|
|
|
|
|
|
|
//! Determine number of new/old messages in a mailbox
|
|
|
|
extern int ast_app_messagecount(const char *mailbox, int *newmsgs, int *oldmsgs);
|
2002-12-26 19:38:27 +00:00
|
|
|
|
2004-03-21 18:15:37 +00:00
|
|
|
//! Safely spawn an external program while closingn file descriptors
|
|
|
|
extern int ast_safe_system(const char *s);
|
|
|
|
|
2004-05-07 21:14:55 +00:00
|
|
|
//! Send DTMF to chan (optionally entertain peer)
|
|
|
|
int ast_dtmf_stream(struct ast_channel *chan, struct ast_channel *peer, char *digits, int between);
|
2004-05-07 20:39:14 +00:00
|
|
|
|
2004-05-13 19:01:10 +00:00
|
|
|
//! Stream a filename (or file descriptor) as a generator.
|
|
|
|
int ast_linear_stream(struct ast_channel *chan, const char *filename, int fd, int allowoverride);
|
|
|
|
|
2001-08-05 21:46:13 +00:00
|
|
|
#if defined(__cplusplus) || defined(c_plusplus)
|
|
|
|
}
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#endif
|