Version 0.1.9 from FTP
[asterisk/asterisk.git] / apps / app_playback.c
1 /*
2  * Asterisk -- A telephony toolkit for Linux.
3  *
4  * Trivial application to playback a sound file
5  * 
6  * Copyright (C) 1999, Mark Spencer
7  *
8  * Mark Spencer <markster@linux-support.net>
9  *
10  * This program is free software, distributed under the terms of
11  * the GNU General Public License
12  */
13  
14 #include <asterisk/file.h>
15 #include <asterisk/logger.h>
16 #include <asterisk/channel.h>
17 #include <asterisk/pbx.h>
18 #include <asterisk/module.h>
19 #include <asterisk/translate.h>
20 #include <string.h>
21 #include <stdlib.h>
22 #include <pthread.h>
23
24 static char *tdesc = "Trivial Playback Application";
25
26 static char *app = "Playback";
27
28 static char *synopsis = "Play a file";
29
30 static char *descrip = 
31 "  Playback(filename[|option]):  Plays  back  a  given  filename (do not put\n"
32 "extension). Options may also be  included following a pipe symbol. The only\n"
33 "defined option at this time is 'skip',  which  causes  the  playback of the\n"
34 "message to  be  skipped  if  the  channel is not in the 'up' state (i.e. it\n"
35 "hasn't been  answered  yet. If 'skip' is not specified, the channel will be\n"
36 "answered before the sound is played. Returns -1 if the channel was hung up,\n"
37 "or if the file does not exist. Returns 0 otherwise.\n";
38
39 STANDARD_LOCAL_USER;
40
41 LOCAL_USER_DECL;
42
43 static int playback_exec(struct ast_channel *chan, void *data)
44 {
45         int res = 0;
46         struct localuser *u;
47         char tmp[256];
48         char *options;
49         int option_skip=0;
50         if (!data || !strlen((char *)data)) {
51                 ast_log(LOG_WARNING, "Playback requires an argument (filename)\n");
52                 return -1;
53         }
54         strncpy(tmp, (char *)data, sizeof(tmp));
55         strtok(tmp, "|");
56         options = strtok(NULL, "|");
57         if (options && !strcasecmp(options, "skip"))
58                 option_skip = 1;
59         LOCAL_USER_ADD(u);
60         if (chan->state != AST_STATE_UP) {
61                 if (option_skip) {
62                         /* At the user's option, skip if the line is not up */
63                         LOCAL_USER_REMOVE(u);
64                         return 0;
65                 } else
66                         /* Otherwise answer */
67                         res = ast_answer(chan);
68         }
69         if (!res) {
70                 ast_stopstream(chan);
71                 res = ast_streamfile(chan, tmp, chan->language);
72                 if (!res) 
73                         res = ast_waitstream(chan, "");
74                 else
75                         ast_log(LOG_WARNING, "ast_streamfile failed on %s for %s\n", chan->name, (char *)data);
76                 ast_stopstream(chan);
77         }
78         LOCAL_USER_REMOVE(u);
79         return res;
80 }
81
82 int unload_module(void)
83 {
84         STANDARD_HANGUP_LOCALUSERS;
85         return ast_unregister_application(app);
86 }
87
88 int load_module(void)
89 {
90         return ast_register_application(app, playback_exec, synopsis, descrip);
91 }
92
93 char *description(void)
94 {
95         return tdesc;
96 }
97
98 int usecount(void)
99 {
100         int res;
101         STANDARD_USECOUNT(res);
102         return res;
103 }
104
105 char *key()
106 {
107         return ASTERISK_GPL_KEY;
108 }