asterisk/contrib
Joshua Colp aed6c219a3 pjsip: Fix a few media bugs with reinvites and asymmetric payloads.
When channel format changes occurred as a result of an RTP
re-negotiation the bridge was not informed this had happened.
As a result the bridge technology was not re-evaluated and the
channel may have been in a bridge technology that was incompatible
with its formats. The bridge is now unbridged and the technology
re-evaluated when this occurs.

The chan_pjsip module also allowed asymmetric codecs for sending
and receiving. This did not work with all devices and caused one
way audio problems. The default has been changed to NOT do this
but to match the sending codec to the receiving codec. For users
who want asymmetric codecs an option has been added, asymmetric_rtp_codec,
which will return chan_pjsip to the previous behavior.

The codecs returned by the chan_pjsip module when queried by
the bridge_native_rtp module were also not reflective of the
actual negotiated codecs. The nativeformats are now returned as
they reflect the actual negotiated codecs.

ASTERISK-26423 #close

Change-Id: I6ec88c6e3912f52c334f1a26983ccb8f267020dc
2016-10-26 12:48:57 +00:00
..
ast-db-manage pjsip: Fix a few media bugs with reinvites and asymmetric payloads. 2016-10-26 12:48:57 +00:00
docker Add initial support to build Docker images 2016-03-17 09:53:57 -05:00
editors contrib/editors: Fix vim syntax highlighting of comments in config files 2015-05-07 19:37:42 +00:00
init.d Update init.d scripts to handle stderr; readd splash screen for remote consoles 2013-01-21 20:41:12 +00:00
scripts pjsip: Support dual stack automatically. 2016-10-23 13:53:55 +00:00
thirdparty remove extraneous svn:executable properties 2005-11-29 18:24:39 +00:00
unistimLang Add French translation for chan_unistim phones on-screen menus. 2012-07-16 07:34:12 +00:00
upstart Change all refererences to 1.6.3 to be 1.8, since that will be the next feature release 2009-12-21 18:51:17 +00:00
utils Fix typo's (retrieve, specified, address). 2015-01-23 15:13:08 +00:00
Makefile Astobj2: Allow reference debugging to be enabled/disabled by config. 2015-04-27 18:37:26 -04:00
README.festival remove extraneous svn:executable properties 2005-11-29 18:24:39 +00:00
asterisk-doxygen-header remove extraneous svn:executable properties 2005-11-29 18:24:39 +00:00
asterisk-ices.xml remove extraneous svn:executable properties 2005-11-29 18:24:39 +00:00
dictionary.digium Add support for logging CDR recrods to a radius server (issue #6639, phsultan) 2006-05-20 22:30:05 +00:00
festival-1.4.1-diff remove extraneous svn:executable properties 2005-11-29 18:24:39 +00:00
festival-1.4.2.diff remove extraneous svn:executable properties 2005-11-29 18:24:39 +00:00
festival-1.4.3.diff remove extraneous svn:executable properties 2005-11-29 18:24:39 +00:00
festival-1.95.diff remove extraneous svn:executable properties 2005-11-29 18:24:39 +00:00
i18n.testsuite.conf Merged revisions 170671 via svnmerge from 2009-01-23 20:23:00 +00:00
valgrind-RedHat-8.0.supp remove extraneous svn:executable properties 2005-11-29 18:24:39 +00:00
valgrind.supp Line 24 missed in compatibility fix in revision 233577 2010-04-26 19:05:47 +00:00

README.festival

app_festival is an application that allows one to send text-to-speech commands
to a background festival server, and to obtain the resulting waveform which
gets sent down to the respective channel. app_festival also employs a waveform 
cache, so invariant text-to-speech strings ("Please press 1 for instructions") 
do not need to be dynamically generated all the time. 

You need : 

1) festival, patched to produce 8khz waveforms on output. Patch for Festival
1.4.2 RELEASE are included. The patch adds a new command to festival 
(asterisk_tts). 

It is possible to run Festival without patches in the source-code. Just
add this to your /etc/festival.scm or /usr/share/festival/festival/scm:

    (define (tts_textasterisk string mode)
    "(tts_textasterisk STRING MODE)
    Apply tts to STRING. This function is specifically designed for
    use in server mode so a single function call may synthesize the string.
    This function name may be added to the server safe functions."
    (let ((wholeutt (utt.synth (eval (list 'Utterance 'Text string)))))
    (utt.wave.resample wholeutt 8000)
    (utt.wave.rescale wholeutt 5)
    (utt.send.wave.client wholeutt)))

[See the comment with subject "Using Debian
 festival >= 1.4.3-15 (no recompiling needed!)" on
 http://www.voip-info.org/wiki-Asterisk+festival+installation for the
 original mentioning of it]

2) You may wish to obtain and install the asterisk-perl
module by James Golovich <james@gnuinter.net>, from 
either CPAN, or his site: http://asterisk.gnuinter.net,
as this contains a good example of how variable text
can be tts'd via asterisk, namely the examples/tts-*.agi
files there. It has been noted that the current expression
evaluation capabilities of asterisk are not best suited
for the generation and manipulation of text. AGI scripting
can be ideal for these sorts of needs. For simpler usage,
fixed, pre-recorded messages may be more amenable for your
purposes.

3) Before running asterisk, you have to run festival-server with a command 
like : 

/usr/local/festival/bin/festival --server > /dev/null 2>&1 &