From 5a7a8666a120096bd6429dc5c123244ee095ac2b Mon Sep 17 00:00:00 2001
From: Mark Spencer <markster@digium.com>
Date: Sun, 31 Jul 2005 22:07:58 +0000
Subject: [PATCH] Add periodic announcement (bug #4677 with mods)

git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@6248 65c4cc65-6c06-0410-ace0-fbb531ad65f3
---
 apps/app_queue.c                   |  97 ++++++++++++++++++++++++++---
 configs/queues.conf.sample         |   6 ++
 sounds.txt                         |   2 +
 sounds/queue-periodic-announce.gsm | Bin 0 -> 12474 bytes
 4 files changed, 97 insertions(+), 8 deletions(-)
 create mode 100755 sounds/queue-periodic-announce.gsm

diff --git a/apps/app_queue.c b/apps/app_queue.c
index fa4b8ffae6..f8f7a7461f 100755
--- a/apps/app_queue.c
+++ b/apps/app_queue.c
@@ -238,6 +238,7 @@ struct queue_ent {
 	int pos;			/* Where we are in the queue */
 	int prio;			/* Our priority */
 	int last_pos_said;              /* Last position we told the user */
+	time_t last_periodic_announce_time;	/* The last time we played a periodic anouncement */
 	time_t last_pos;                /* Last time we told the user their position */
 	int opos;			/* Where we started in the queue */
 	int handled;			/* Whether our call was handled */
@@ -284,6 +285,7 @@ struct ast_call_queue {
 		unsigned int maskmemberstatus:1;
 		unsigned int realtime:1;
 	int announcefrequency;          /* How often to announce their position */
+	int periodicannouncefrequency;	/* How often to play periodic announcement */
 	int roundingseconds;            /* How many seconds do we round to? */
 	int holdtime;                   /* Current avg holdtime, based on recursive boxcar filter */
 	int callscompleted;             /* Number of queue calls completed */
@@ -300,6 +302,7 @@ struct ast_call_queue {
 	char sound_seconds[80];         /* Sound file: "seconds." (def. queue-seconds) */
 	char sound_thanks[80];          /* Sound file: "Thank you for your patience." (def. queue-thankyou) */
 	char sound_reporthold[80];	/* Sound file: "Hold time" (def. queue-reporthold) */
+	char sound_periodicannounce[80];/* Sound file: Custom announce, no default */
 
 	int count;			/* How many entries */
 	int maxlen;			/* Max number of entries */
@@ -526,6 +529,7 @@ static void init_queue(struct ast_call_queue *q)
 	q->announce[0] = '\0';
 	q->context[0] = '\0';
 	q->monfmt[0] = '\0';
+	q->periodicannouncefrequency = 0;
 	ast_copy_string(q->sound_next, "queue-youarenext", sizeof(q->sound_next));
 	ast_copy_string(q->sound_thereare, "queue-thereare", sizeof(q->sound_thereare));
 	ast_copy_string(q->sound_calls, "queue-callswaiting", sizeof(q->sound_calls));
@@ -535,6 +539,7 @@ static void init_queue(struct ast_call_queue *q)
 	ast_copy_string(q->sound_thanks, "queue-thankyou", sizeof(q->sound_thanks));
 	ast_copy_string(q->sound_lessthan, "queue-less-than", sizeof(q->sound_lessthan));
 	ast_copy_string(q->sound_reporthold, "queue-reporthold", sizeof(q->sound_reporthold));
+	ast_copy_string(q->sound_periodicannounce, "queue-periodic-announce", sizeof(q->sound_periodicannounce));
 }
 
 static void clear_queue(struct ast_call_queue *q)
@@ -608,6 +613,10 @@ static void queue_set_param(struct ast_call_queue *q, const char *param, const c
 			q->announceholdtime = ANNOUNCEHOLDTIME_ALWAYS;
 		else
 			q->announceholdtime = 0;
+	 } else if (!strcasecmp(param, "periodic-announce")) {
+		ast_copy_string(q->sound_periodicannounce, val, sizeof(q->sound_periodicannounce));
+	} else if (!strcasecmp(param, "periodic-announce-frequency")) {
+		q->periodicannouncefrequency = atoi(val);
 	} else if (!strcasecmp(param, "retry")) {
 		q->retry = atoi(val);
 		if (q->retry < 0)
@@ -1108,13 +1117,6 @@ static int say_position(struct queue_ent *qe)
 	return res;
 }
 
-static void record_abandoned(struct queue_ent *qe)
-{
-	ast_mutex_lock(&qe->parent->lock);
-	qe->parent->callsabandoned++;
-	ast_mutex_unlock(&qe->parent->lock);
-}
-
 static void recalc_holdtime(struct queue_ent *qe)
 {
 	int oldvalue, newvalue;
@@ -1467,6 +1469,71 @@ static int store_next(struct queue_ent *qe, struct localuser *outgoing)
 	return 0;
 }
 
+static int background_file(struct queue_ent *qe, struct ast_channel *chan, char *filename)
+{
+	int res;
+
+	ast_stopstream(chan);
+	res = ast_streamfile(chan, filename, chan->language);
+
+	if (!res) {
+		/* Wait for a keypress */
+		res = ast_waitstream(chan, AST_DIGIT_ANY);
+		if (res <= 0 || !valid_exit(qe, res))
+			res = 0;
+
+		/* Stop playback */
+		ast_stopstream(chan);
+	} else {
+		res = 0;
+	}
+	
+	/*if (res) {
+		ast_log(LOG_WARNING, "ast_streamfile failed on %s \n", chan->name);
+		res = 0;
+	}*/
+
+	return res;
+}
+
+static int say_periodic_announcement(struct queue_ent *qe)
+{
+	int res = 0;
+	time_t now;
+
+	/* Get the current time */
+	time(&now);
+
+	/* Check to see if it is time to announce */
+	if ( (now - qe->last_periodic_announce_time) < qe->parent->periodicannouncefrequency )
+		return -1;
+
+	/* Stop the music on hold so we can play our own file */
+	ast_moh_stop(qe->chan);
+
+	if (option_verbose > 2)
+		ast_verbose(VERBOSE_PREFIX_3 "Playing periodic announcement\n");
+
+	/* play the announcement */
+	res = background_file(qe, qe->chan, qe->parent->sound_periodicannounce);
+
+	/* Resume Music on Hold */
+	ast_moh_start(qe->chan, qe->moh);
+
+	/* update last_periodic_announce_time */
+	qe->last_periodic_announce_time = now;
+
+	return(res);
+}
+
+static void record_abandoned(struct queue_ent *qe)
+{
+	ast_mutex_lock(&qe->parent->lock);
+	qe->parent->callsabandoned++;
+	ast_mutex_unlock(&qe->parent->lock);
+}
+
+
 #define AST_MAX_WATCHERS 256
 
 #define BUILD_WATCHERS do { \
@@ -1780,8 +1847,12 @@ static int wait_our_turn(struct queue_ent *qe, int ringing, enum queue_result *r
 		if (res)
 			break;
 
+		/* Make a periodic announcement, if enabled */
+		if (qe->parent->periodicannouncefrequency && !ringing)
+			res = say_periodic_announcement(qe);
+
 		/* Wait a second before checking again */
-		res = ast_waitfordigit(qe->chan, RECHECK * 1000);
+		if (!res) res = ast_waitfordigit(qe->chan, RECHECK * 1000);
 		if (res)
 			break;
 	}
@@ -2744,6 +2815,7 @@ static int queue_exec(struct ast_channel *chan, void *data)
 	qe.prio = (int)prio;
 	qe.last_pos_said = 0;
 	qe.last_pos = 0;
+	qe.last_periodic_announce_time = time(NULL);
 	if (!join_queue(queuename, &qe, &reason)) {
 		ast_queue_log(queuename, chan->uniqueid, "NONE", "ENTERQUEUE", "%s|%s", url ? url : "",
 			      chan->cid.cid_num ? chan->cid.cid_num : "");
@@ -2805,6 +2877,15 @@ check_turns:
 				}
 				makeannouncement = 1;
 
+				/* Make a periodic announcement, if enabled */
+				if (qe.parent->periodicannouncefrequency && !ringing)
+					res = say_periodic_announcement(&qe);
+
+				if (res && valid_exit(&qe, res)) {
+					ast_queue_log(queuename, chan->uniqueid, "NONE", "EXITWITHKEY", "%c|%d", res, qe.pos);
+					break;
+				}
+
 				/* Try calling all queue members for 'timeout' seconds */
 				res = try_calling(&qe, options, announceoverride, url, &go_on);
 				if (res) {
diff --git a/configs/queues.conf.sample b/configs/queues.conf.sample
index 310d4cf750..68c980b6fc 100755
--- a/configs/queues.conf.sample
+++ b/configs/queues.conf.sample
@@ -80,6 +80,11 @@ persistentmembers = yes
 ;
 ;announce-frequency = 90 
 ;
+;
+; How often to make any periodic announcement (see periodic-announce)
+;
+;periodic-announce-frequency=60
+;
 ; Should we include estimated hold time in position announcements?
 ; Either yes, no, or only once.
 ; Hold time will be announced as the estimated time, 
@@ -105,6 +110,7 @@ persistentmembers = yes
 ;queue-thankyou = queue-thankyou		;	("Thank you for your patience.")
 ;queue-lessthan = queue-less-than		;       ("less than")
 ;queue-reporthold = queue-reporthold		;       ("Hold time")
+;periodic-announce = queue-periodic-announce    ;       ("All reps busy / wait for next")
 ;
 ; Calls may be recorded using Asterisk's monitor resource
 ; This can be enabled from within the Queue application, starting recording
diff --git a/sounds.txt b/sounds.txt
index a0ece6017f..426c63c633 100755
--- a/sounds.txt
+++ b/sounds.txt
@@ -84,6 +84,8 @@
 
 %pbx-transfer.gsm%Transfer.
 
+%queue-periodic-announce.gsm%All of our represenatives are currently busy. Please stay on the line and your call will be answered by the next available representative.
+
 %queue-callswaiting.gsm%Waiting to speak with a representative
 
 %queue-holdtime.gsm%The estimated hold time is currently
diff --git a/sounds/queue-periodic-announce.gsm b/sounds/queue-periodic-announce.gsm
new file mode 100755
index 0000000000000000000000000000000000000000..b06bedcb9d422a9bf80fda9bc5c749dfc0dfeecc
GIT binary patch
literal 12474
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

literal 0
HcmV?d00001