Record()
Zurück 11. Applikationen im Dialplan Weiter

Record()

Aufnahme von Audio auf einem Channel in eine Datei

ab Asterisk 1.2: 

Record(Basisname[.Format[,Stille[,maxDauer[,Optionen]]]])

Nimmt Audio auf dem Channel auf und speichert es in der Datei Basisname.Format. Existiert diese Datei bereits, wird sie überschrieben.

Optionale Parameter sind:

format
Spezifiziert das Dateiformat der Aufnahmedatei (g723, g729, gsm, h263, ulaw, alaw, wav, ...)
Stille
Gibt die Dauer in Sekunden an, die geräuschlos verstreichen darf, bevor die Aufnahme beendet wird.
maxDauer
Gibt die maximale Aufnahmedauer in Sekunden an. Falls nicht angegeben oder 0, gibt es keine Obergrenze.
Optionen

Kann beliebige der aufgeführten Flags enthalten:

s
Nimmt nicht auf, wenn die Leitung bisher nicht beantwortet wurde.
n
Antwortet nicht, aber nimmt trotzdem auf, auch wenn die Leitung bisher nicht beantwortet wurde.
a
Hängt die Aufnahme an die bereits bestehende Aufnahme an, statt sie zu überschreiben.
t
Benutzt die alternative Abschlusstaste * an Stelle der standardmäßig eingestellten #-Taste.
q
Keinen Piep-Ton vor der Aufnahme spielen.
x
Auch die Abbruchtasten # oder * als DTMF-Töne aufzeichnen. Die Aufnahme kann dann nur durch Timeout von maxDauer oder Auflegen beendet werden.

Enthält der Basisname die Zeichenkette %d, wird diese durch eine Nummerierung ersetzt, die bei jedem erneuten Aufnehmen der Datei um 1 erhöht wird.

Der Teilnehmer kann die Taste # benutzen, um die Aufnahme abzubrechen und zur nächsten Priorität überzugehen. Beim Auflegen wird die Aufnahme verworfen.

Liefert -1 zurück, wenn der Benutzer auflegt, sonst 0.

; den Namen des Anrufers aufzeichnen:
exten => 123,1,Playback(bitte-sprechen-sie-ihren-namen-nach-dem-ton)
exten => 123,n,Record(/tmp/name.gsm,3,10)
exten => 123,n,Playback(/tmp/name)

Beachten Sie auch die Hinweise bei Monitor().

[Anmerkung]Anmerkung

Interner Hilfetext zu dieser Applikation in Asterisk 1.4: 

  -= Info about application 'Record' =- 

[Synopsis]
Record to a file

[Description]
  Record(filename.format|silence[|maxduration][|options])

Records from the channel into a given filename. If the file exists it will
be overwritten.
- 'format' is the format of the file type to be recorded (wav, gsm, etc).
- 'silence' is the number of seconds of silence to allow before returning.
- 'maxduration' is the maximum recording duration in seconds. If missing
or 0 there is no maximum.
- 'options' may contain any of the following letters:
     'a' : append to existing recording rather than replacing
     'n' : do not answer, but record anyway if line not yet answered
     'q' : quiet (do not play a beep tone)
     's' : skip recording if the line is not yet answered
     't' : use alternate '*' terminator key (DTMF) instead of default '#'
     'x' : ignore all terminator keys (DTMF) and keep recording until hangup

If filename contains '%d', these characters will be replaced with a number
incremented by one each time the file is recorded. 

Use 'show file formats' to see the available formats on your system

User can press '#' to terminate the recording and continue to the next priority.

If the user should hangup during a recording, all data will be lost and the
application will teminate.

Differenz zum internen Hilfetext in Asterisk 1.2: 

21,22c21
<      't' : use alternate '*' terminator key (DTMF) instead of default '#'
<      'x' : ignore all terminator keys (DTMF) and keep recording until hangup
---
>      't' : use alternate '*' terminator key instead of default '#'

Siehe auch. „Dictate()“, „Monitor()“, „MixMonitor()“

Zurück Nach oben Weiter
RealTimeUpdate() Zum Anfang | InhV RemoveQueueMember()

Version 1.2, November 2002

Neue Version verfügbar

Sie betrachten gerade die alte Version des Buches (Version 1.0). Wir empfehlen Ihnen für Asterisk 1.4 und 1.6 die neue Version des Buches.

Asterisk-Tag 2008

Lernen Sie Mark Spencer (den Erfinder von Asterisk) kennen! Viele Vorträge, Case-Studies und Workshops rund um das Thema VoIP. Asterisk-Tag.org

Das gedruckte Buch