63. MeetMe()

Nimmt den Anrufer in eine MeetMe-Konferenz auf.

MeetMe([KonferenzNr][,Optionen[,PIN]])

Verbindet den Anrufer auf dem aktuellen Channel zu einer MeetMe-Konferenz, angegeben durch den Parameter KonferenzNr. Ohne Angabe der Konferenznummer wird der Teilnehmer zur Eingabe derselben aufgefordert.

Wird als PIN-Parameter die PIN-Nummer der Konferenz (statisch in meetme.conf oder dynamisch vom Ersteller festgelegt) übergeben, so wird der Anrufer direkt in die Konferenz geleitet. Ansonsten muss der Anrufer die PIN eingeben, um beitreten zu können.

[Wichtig]Wichtig

Damit MeetMe-Konferenzen funktionieren, muss ein passendes Zaptel-Interface installiert sein. Alternativ kann auch der ztdummy-Treiber für Timing-Zwecke verwendet werden.

MeetMe-Konferenzen benutzen offenbar intern immer den uLaw-Codec, je mehr Teilnehmer in einer Konferenz andere Codecs wie GSM verwenden, desto mehr Rechenleistung wird für die Umkodierung benötigt.

Die Optionen können sich aus folgenden Zeichen zusammensetzen:

a
Aktiviert den Administrator-Modus.
A
Markiert den eintretenden User als besonderen Teilnehmer (siehe w und x).
b
Startet das in ${MEETME_AGI_BACKGROUND} spezifizierte AGI-Skript, standardmäßig conf-background.agi. (Funktioniert nur dann korrekt, wenn alle Kanäle in einer Konferenz Zap-Kanäle sind.) Das Skript erhält alle DTMF-Tanstendrücke, wodurch die Kombination mit Optionen, die auch das Abfangen von Tasten zur Folge haben (p), nicht möglich ist.
c
Kündigt beim Betreten die Zahl der Teilnehmer an.
d
Legt dynamisch einen neuen Konferenzraum an.
D
Legt dynamisch einen neuen Konferenzraum an, wobei die Festlegung der PIN verlangt wird. (Wenn der User keine PIN will, muss er # drücken.)
e
Wählt eine leere Konferenz aus.
E
Wählt eine leere Konferenz aus, die keine PIN verlangt.
i
Kündigt Betreten oder Verlassen eines Teilnehmers an (nur mit Zap-Kanälen).
m
Aktiviert den Monitor-Modus (nur hören, nicht sprechen).
M
Aktiviert Wartemusik (Music on Hold), wenn nur ein Teilnehmer in der Konferenz ist.
p
Ermöglicht es dem Teilnehmer, die Konferenz durch Drücken von # zu verlassen.
P
Fragt immer nach der PIN, auch wenn sie hier im Befehl angegeben ist.
q
Aktiviert den ruhigen Modus (spielt keine Eintritts-/Austrittsklänge ab).
r
Zeichnet eine Konferenz auf. Datei: ${MEETME_RECORDINGFILE}, Format: ${MEETME_RECORDINGFORMAT}. Der Standard-Dateiname lautet meetme-conf-rec-${KonferenzNr}-${UniqueID}, wobei UniqueID eine einmalige ID ist. Das Standardformat ist wav. (Funktioniert nur mit Zap-Kanälen)
s
Wechselt beim Drücken von * ins (Teilnehmer- oder Administrator-)Menü.
t
Aktiviert den Nur-Sprechen-Modus (nur reden, nicht hören).
T
Aktiviert die Sprecher-Erkennung (wird zum Manager-Inferface gesendet und in der MeetMe-Liste im CLI angezeigt).
v
Aktiviert den Video-Modus (bisher ohne Funktion).
w
Wartet, bis ein gekennzeichneter Teilnehmer (siehe A) die Konferenz betritt. Bis dahin hören alle Teilnehmer Wartemusik.
x
Schließt die Konferenz, wenn sie vom letzten gekennzeichneten Teilnehmer (siehe A) verlassen wird.
X
Ermöglicht es dem Teilnehmer, die Konferenz durch Eingabe einer einziffrigen Extension im Context ${MEETME_EXIT_CONTEXT} zu verlassen, oder durch Eingabe der Nummer einer Extension des aktuellen Contexts, falls diese Variable nicht definiert ist.

Die Option X funktioniert nicht zusammen mit p oder s.

Verwenden Sie e (oder E) zusammen mit d (oder D), um dynamisch einen neuen Konferenzraum zu eröffnen, wobei Asterisk automatisch die KonferenzNr festlegt. Sie müssen dann natürlich den anderen Teilnehmern die Nummer mitteilen oder entsprechende Dialplan-Logik einsetzen.

[Anmerkung]Anmerkung

Mit d oder D werden dynamisch Konferenzräume angelegt, in der meetme.conf können sie statisch definiert werden.

exten => 123,1,Answer()
; den Anrufer in Konferenzraum 333 schicken (mit der PIN 1234):
exten => 123,n,MeetMe(333,DpM,1234)

Siehe auch. Abschnitt 64, „MeetMeAdmin(), Abschnitt 65, „MeetMeCount()

Befehle im CLI. Diese Befehle stehen im CLI zur Verfügung, um MeetMe-Konferenzen zu verwalten (dabei ist die TeilnehmerNr die in der Liste angezeigte Nummer des Teilnehmers):

MeetMe
Listet alle Konferenzen auf.
MeetMe list KonferenzNr
Listet die Teilnehmer einer Konferenz auf.
MeetMe kick KonferenzNr TeilnehmerNr
Wirft einen Teilnehmer aus der Konferenz.
MeetMe kick KonferenzNr
Wirft alle Teilnehmer aus der Konferenz.
MeetMe lock KonferenzNr
Sperrt eine Konferenz, so dass keine Teilnehmer mehr aufgenommen werden.
MeetMe unlock KonferenzNr
Hebt eine Konferenz-Sperre (s.o.) wieder auf.
MeetMe mute KonferenzNr TeilnehmerNr
Schaltet einen Teilnehmer stumm.
MeetMe unmute KonferenzNr TeilnehmerNr
Hebt die Stummschaltung eines Teilnehmers (s.o.) wieder auf.
[Anmerkung]Anmerkung

Interner Hilfetext zu dieser Applikation in Asterisk 1.4: 

  -= Info about application 'MeetMe' =- 

[Synopsis]
MeetMe conference bridge

[Description]
  MeetMe([confno][,[options][,pin]]): Enters the user into a specified MeetMe
conference.  If the conference number is omitted, the user will be prompted
to enter one.  User can exit the conference by hangup, or if the 'p' option
is specified, by pressing '#'.
Please note: The Zaptel kernel modules and at least one hardware driver (or ztdummy)
             must be present for conferencing to operate properly. In addition, the chan_zap
             channel driver must be loaded for the 'i' and 'r' options to operate at all.

The option string may contain zero or more of the following characters:
      'a' -- set admin mode
      'A' -- set marked mode
      'b' -- run AGI script specified in ${MEETME_AGI_BACKGROUND}
             Default: conf-background.agi  (Note: This does not work with
             non-Zap channels in the same conference)
      'c' -- announce user(s) count on joining a conference
      'd' -- dynamically add conference
      'D' -- dynamically add conference, prompting for a PIN
      'e' -- select an empty conference
      'E' -- select an empty pinless conference
      'i' -- announce user join/leave with review
      'I' -- announce user join/leave without review
      'l' -- set listen only mode (Listen only, no talking)
      'm' -- set initially muted
      'M' -- enable music on hold when the conference has a single caller
      'o' -- set talker optimization - treats talkers who aren't speaking as
             being muted, meaning (a) No encode is done on transmission and
             (b) Received audio that is not registered as talking is omitted
             causing no buildup in background noise
      'p' -- allow user to exit the conference by pressing '#'
      'P' -- always prompt for the pin even if it is specified
      'q' -- quiet mode (don't play enter/leave sounds)
      'r' -- Record conference (records as ${MEETME_RECORDINGFILE}
             using format ${MEETME_RECORDINGFORMAT}). Default filename is
             meetme-conf-rec-${CONFNO}-${UNIQUEID} and the default format is
             wav.
      's' -- Present menu (user or admin) when '*' is received ('send' to menu)
      't' -- set talk only mode. (Talk only, no listening)
      'T' -- set talker detection (sent to manager interface and meetme list)
      'w[(<secs>)]'
          -- wait until the marked user enters the conference
      'x' -- close the conference when last marked user exits
      'X' -- allow user to exit the conference by entering a valid single
             digit extension ${MEETME_EXIT_CONTEXT} or the current context
             if that variable is not defined.
      '1' -- do not play message when first person enters

Differenz zum internen Hilfetext in Asterisk 1.2: 

8,11c8,11
<   MeetMe([confno][,[options][,pin]]): Enters the user into a specified MeetMe
< conference.  If the conference number is omitted, the user will be prompted
< to enter one.  User can exit the conference by hangup, or if the 'p' option
< is specified, by pressing '#'.
---
>   MeetMe([confno][,[options][,pin]]): Enters the user into a specified MeetMe conference.
> If the conference number is omitted, the user will be prompted to enter
> one. 
> User can exit the conference by hangup, or if the 'p' option is specified, by pressing '#'.
20,21c20,21
<              Default: conf-background.agi  (Note: This does not work with
<              non-Zap channels in the same conference)
---
>              Default: conf-background.agi
>              (Note: This does not work with non-Zap channels in the same conference)
27,30c27,28
<       'i' -- announce user join/leave with review
<       'I' -- announce user join/leave without review
<       'l' -- set listen only mode (Listen only, no talking)
<       'm' -- set initially muted
---
>       'i' -- announce user join/leave
>       'm' -- set monitor only mode (Listen only, no talking)
32,35d29
<       'o' -- set talker optimization - treats talkers who aren't speaking as
<              being muted, meaning (a) No encode is done on transmission and
<              (b) Received audio that is not registered as talking is omitted
<              causing no buildup in background noise
41,42c35
<              meetme-conf-rec-${CONFNO}-${UNIQUEID} and the default format is
<              wav.
---
>              meetme-conf-rec-${CONFNO}-${UNIQUEID} and the default format is wav.
52d44
<       '1' -- do not play message when first person enters

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.