95. Record()

95. `Record()`
Zurück	Anhang B. Applikationen im Dialplan	Weiter

95. `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
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 '#'

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. Abschnitt 28, „Dictate()“, Abschnitt 68, „Monitor()“, Abschnitt 67, „MixMonitor()“

Zurück	Nach oben	Weiter
94. `RealTimeUpdate()`	Zum Anfang \| InhV	96. `RemoveQueueMember()`

Asterisk Schulung

27.10. - 28.10.2008 in Koblenz

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

Asterisk-Tag.org 2008

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

Das Asterisk Buch von Stefan Wintermeyer