====== Jingle bots, offering Asterisk services to Psi+ ======



===== Einführung =====

Diese Seite enthält Anleitungen zum Verwenden von Asterisk mit Psi+.





===== Einzelheiten =====

Um Asterisk mit Psi+ verwenden zu können, müssen Sie den Jingle Zweig von Asterisk mit einigen Patches benutzen. (Patches auf der Psi Seite sind nicht mehr notwendig.)





===== Öffentliche Bots =====

Hier ist eine Liste der derzeit bekannten öffentlichen Jingle bots:

|| **JID** || **Bemerkungen** || **Läuft mit (getestet mit)** ||
|| echo@haar.student.utwente.nl || Einfacher Echotest || Psi, Psi+, Pidgin, Google Talk, QIP, Nokia N900, SIP ||
|| psi-dev@haar.student.utwente.nl || Konferenzraum über Psi+ (psi+ und psiplus@haar.student.utwente.nl geht auch) || Psi, Psi+, Pidgin, Google Talk, QIP, Nokia N900, SIP ||
|| tellme@haar.student.utwente.nl || SIP bridge zum Tell Me Service (Hinweis: Sagen Sie Black Jack im Hauptmenü) || Psi, Psi+, Pidgin, Google Talk, QIP, Nokia N900 ||
|| echo@test.collabora.co.uk || test-Bot von [[http://www.collabora.co.uk/|Collabora]] mit verschiedenen Tests, u.a. Echotest und Videotest || Psi, Psi+ ||





===== Benutzung =====

Um einen der oben gelisteten Bots zu benutzen:
  * Fügen sie die JID zu Ihrem Roster hinzu
  * Der Kontakt sollte Sie autorisieren und als online erscheinen
  * Rufen Sie den Kontakt an

Der Kontakt sollte das Gespräch annehmen und den genannten Dienst bieten.





===== Einrichten von Asterisk zur Benutzung mit Psi+ =====

  * Holen Sie sich den speziellen Jingle-Zweig von Asterisk (revision 281181 is the last revision that is still working):
<code>
svn -r 281181 co http://svn.digium.com/svn/asterisk/team/phsultan/jingle-support/
</code>
  * Besorgen Sie sich den Patch, der einige Programmfehler umgeht sowie denjenigen, der den Umgang mit wideband speex ermöglicht
<code>
wget http://haar.student.utwente.nl/~julius/patches/asterisk-jingle-hacks-20100430.patch.txt
wget "https://issues.asterisk.org/file_download.php?file_id=25936&type=bug" -O patch-jingle_speex-1.diff
</code>
  * Wechseln Sie in das Verzeichnis und bringen Sie die Patches an
<code>
cd jingle-support
patch -p1 < ../asterisk-jingle-hacks-20100430.patch.txt
patch -p0 < ../patch-jingle_speex-1.diff
</code>
  * Kompilieren Sie Asterisk wie üblich, stellen Sie dabei sicher, dass  res_jabber und chan_jingle eingeschaltet sind
<code>
./configure
make menuselect
make
make install
make samples
</code>
  * Legen Sie einen neues XMPP Konto an (z.B. in Psi, Sie können dieses später wieder entfernen)
  * Editieren Sie /etc/asterisk/jabber.conf und fügen Sie das neue Konto hinzu:
<code>
[echo]]
type=client
serverhost=localhost
username=echo@haar.student.utwente.nl/asterisk
secret=<password>
port=5222
usetls=no
usesasl=no
statusmessage=voice: echo test
</code>

    Beachten Sie bitte, dass im obigen Falle Asterisk auf dem selben Server läuft wie der XMPP Dämon.
  * Editieren Sie /etc/asterisk/jingle.conf:
    Stellen Sie sicher, dass speex erlaubt ist, diese beiden Zeilen sollten das erledigen
<code>
disallow=all
allow=speex
</code>

    Beachten Sie den Kontext oder setzen Sie ihn auf public oder ähnlich
<code>
context=public
</code>
  * Editieren Sie /etc/asterisk/extensions.conf:

    Editieren Sie den Kontext oder legen Sie einen neuen an und setzen Sie die Wahl-Regeln:

    Dies ist ein Beispiel für einen Echotest:
<code>
exten => echo@haar.student.utwente.nl,1,Playback(demo-echotest) ; Let them know what's going on
exten => echo@haar.student.utwente.nl,n,Echo                    ; Do the echo test
exten => echo@haar.student.utwente.nl,n,Playback(demo-echodone) ; Let them know it's over
exten => echo@haar.student.utwente.nl,n,Goto(s,6)               ; Start over
</code>

    Sie können auch eine SIP bridge einrichten:
<code>
exten => tellme@haar.student.utwente.nl,1,Dial(SIP/18005558355@proxy01.sipphone.com)
</code>





===== Bekannte Probleme =====

  * Asterisk wählt manchmal nicht die richtige IPv4-Adresse aus den Angeboten des aktuellen Datenstroms aus, so dass kein Audio empfangen wird.
  * Der Videotest mit dem Collabora Bot ist völlig ungetestet und funktioniert möglicherweise nicht.