19. ChanSpy()

Einen Channel belauschen

ChanSpy([Channelpräfix[,Optionen]])

Erlaubt es, das Gespräch auf beliebigen Kanälen mitzuhören. (Ist also nicht wie ZapBarge()/ZapScan() an Zap-Kanäle gebunden.) Für das Verständnis einiger Optionen ist zu beachten, dass diese Applikation einzelne Kanäle abhört, aber nicht Gespräche im eigentlichen Sinn (min. 2 Teilnehmer), obwohl Sie natürlich das ein- und ausgehende Audio auf dem abgehörten Channel hören können. Bitte achten sie die Persönlichkeitsrechte anderer! Falls sie Gespräche unaufgefordert und ohne Wissen der Teilnehmer mithören machen sie sich strafbar.

Wenn Channelpräfix angegeben ist, stehen nur Kanäle, die mit diesem String beginnen, zur Auswahl.

Optionen (auch in Kombination):

b
(bridged) Auswahl nur auf verbundene Kanäle beschränken.
g(grp)
(group) Auswahl auf Kanäle beschränken, auf denen grp in der durch Doppelpunkt (:) getrennten Liste ${SPYGROUP} (Channelvariable) enthalten ist.
q
(quiet) Keine Piep-Töne beim Umschalten von Kanälen spielen und Channelname nicht ankündigen.
r([Name])

(record) Die Sitzung in einer Datei im Verzeichnis /var/spool/asterisk/monitor/ aufzeichnen. Default-Basis-Dateiname (also ohne Endung) ist chanspy.

v[(Wert)]

(volume) Die anfängliche Lautstärkeeinstellung von -4 (leise) bis 4 (laut) verändern.

w
(whisper) Flüster-Modus aktivieren. Damit kann der lauschende Channel mit dem belauschten sprechen, wobei dies nur der belauschte Channel hört, nicht dessen Gesprächspartner. (Diese Option ist seit Asterisk 1.4 verfügbar.)
W
(private whisper) Privater Flüster-Modus. Wie w, aber der lauschende Channel kann den belauschten nicht hören. (sinnvoll?)

Während des Abhörens können folgende Tastenbefehle gegeben werden:

#
Schaltet durch die Lautstärkeeinstellung (-4 bis 4)
*
Schaltet zu einem anderen Channel
...#
Eine Reihe von Ziffern, abgeschlossen durch #, wird an Channelpräfix angehängt. Wenn Sie z.B. ChanSpy(Agent) ausführen und 1234# eingeben, werden Sie auf dem Channel Agent/1234 lauschen.
; Agenten belauschen:
exten => 123,1,ChanSpy(Agent)
exten => 123,n,Hangup()

; Beispiel für die Option g:
; auf Anrufen auf 0... SPYGROUP 10005 setzen:
exten => _0.,1,Set(SPYGROUP=10005)
;...
; Kanäle der SPYGROUP 10005 belauschen:
exten => 123,1,ChanSpy(,g(10005))
exten => 123,n,Hangup()
[Anmerkung]Anmerkung

Interner Hilfetext zu dieser Applikation in Asterisk 1.4: 

  -= Info about application 'ChanSpy' =- 

[Synopsis]
Listen to a channel, and optionally whisper into it

[Description]
  ChanSpy([chanprefix][|options]): This application is used to listen to the
audio from an Asterisk channel. This includes the audio coming in and
out of the channel being spied on. If the 'chanprefix' parameter is specified,
only channels beginning with this string will be spied upon.
  While spying, the following actions may be performed:
    - Dialing # cycles the volume level.
    - Dialing * will stop spying and look for another channel to spy on.
    - Dialing a series of digits followed by # builds a channel name to append
      to 'chanprefix'. For example, executing ChanSpy(Agent) and then dialing
      the digits '1234#' while spying will begin spying on the channel
      'Agent/1234'.
  Options:
    b             - Only spy on channels involved in a bridged call.
    g(grp)        - Match only channels where their ${SPYGROUP} variable is set to
                    contain 'grp' in an optional : delimited list.
    q             - Don't play a beep when beginning to spy on a channel, or speak the
                    selected channel name.
    r[(basename)] - Record the session to the monitor spool directory. An
                    optional base for the filename may be specified. The
                    default is 'chanspy'.
    v([value])    - Adjust the initial volume in the range from -4 to 4. A
                    negative value refers to a quieter setting.
    w             - Enable 'whisper' mode, so the spying channel can talk to
                    the spied-on channel.
    W             - Enable 'private whisper' mode, so the spying channel can
                    talk to the spied-on channel but cannot listen to that
                    channel.

Differenz zum internen Hilfetext in Asterisk 1.2: 

5c5,6
< Listen to a channel, and optionally whisper into it
---
> Listen to the audio of an active channel
> 
9c10
< audio from an Asterisk channel. This includes the audio coming in and
---
> audio from an active Asterisk channel. This includes the audio coming in and
12c13
<   While spying, the following actions may be performed:
---
>   While Spying, the following actions may be performed:
17c18
<       the digits '1234#' while spying will begin spying on the channel
---
>       the digits '1234#' while spying will begin spying on the channel,
20,24c21,24
<     b             - Only spy on channels involved in a bridged call.
<     g(grp)        - Match only channels where their ${SPYGROUP} variable is set to
<                     contain 'grp' in an optional : delimited list.
<     q             - Don't play a beep when beginning to spy on a channel, or speak the
<                     selected channel name.
---
>     b - Only spy on channels involved in a bridged call.
>     g(grp) - Match only channels where their ${SPYGROUP} variable is set to
>              'grp'.
>     q - Don't play a beep when beginning to spy on a channel.
28,34c28,29
<     v([value])    - Adjust the initial volume in the range from -4 to 4. A
<                     negative value refers to a quieter setting.
<     w             - Enable 'whisper' mode, so the spying channel can talk to
<                     the spied-on channel.
<     W             - Enable 'private whisper' mode, so the spying channel can
<                     talk to the spied-on channel but cannot listen to that
<                     channel.
---
>     v([value]) - Adjust the initial volume in the range from -4 to 4. A
>                  negative value refers to a quieter setting.

Siehe auch. Abschnitt 39, „ExtenSpy(), Abschnitt 141, „ZapBarge(), Abschnitt 143, „ZapScan(), Abschnitt 68, „Monitor()


Asterisk Schulung

2.1 Beta-Version!

2.1 Beta-Version des Asterisk Buches. Die 1.0 stabile Version ist ebenfalls online. Bitte melden Sie Fehler und Feedback per E-Mail an den Autor.

YouTube Screencasts

Kostenlose Asterisk Screencasts mit jeweils 10 minütigen Erklärungen zu Spezial-Themen.

Shameless Plug

noch-ne-auto-seite.de

Das gedruckte Buch

Werbung

Asterisk-Tag.org 2008

Auf der Asterisk-Tag.org Webseite finden Sie die Folien und Videos der Vorträge.