CHANNEL()

CHANNEL(Feld)

(ab Asterisk 1.4 verfügbar)

Liest/setzt bestimmte Kanaldaten. Feld ist eines der folgenden (wenn nicht anders angegeben, ist nur Lesen möglich):

audioreadformat
Das Format eingehender Audiodaten auf dem Kanal
audionativeformat
Das native Audioformat des Kanals
audiowriteformat
Das Format ausgehender Audiodaten auf dem Kanal
callgroup
In Asterisk lassen sich Extensions in Call groups von 0 - 63 einordnen, z.B. als Kundennummer.[121]
channeltype
Die „Technologie“ dieses Kanals, also z.B: IAX oder SIP
language
Die Sprache für Voice-Prompts (auch Setzen möglich)
musicclass
Die Musik-Klasse für Wartemusik, wie in musiconhold.conf definiert (auch Setzen möglich)
state

Zustand des Kanals (Down, Rsrvd, OffHook, Dialing, Ring, Ringing, Up, Busy, Dialing Offhook, Pre-ring, Unknown)

tonezone
Die „Tone zone“ bestimmt die Ton-Signale (Wählen, Klingeln, Besetzt, ...) für bestimmte Länder. Sie wird in der Konfigurationsdatei des Kanals (z.B. zaptel.conf) durch loadzone und defaultzone festgelegt. Die möglichen Werte sind (wie in der indications.conf definiert): at, au, be, br, ch, cl, cn, cz, de, dk, ee, es, fi, fr, gr, hu, it, lt, mx, ml, no, nz, pl, pt, ru, se, sg, uk, us, us-old, tw, ve, za.
videonativeformat
Das native Videoformat dieses Kanals

Zusätzlich zu diesen Feldern kann der Treiber des Kanals noch weitere bereitstellen, die man in der entsprechenden Dokumentation nachschlagen kann. Felder, die auf dem aktuellen Kanal nicht zur Verfügung stehen, geben einen leeren String zurück.

; Typ des Kanals abfragen:
exten => 123,1,Set(foo=${CHANNEL(channeltype)})

; Sprache auf Englisch setzen:
exten => 123,1,Set(CHANNEL(language)=en)
[Anmerkung]

Interner Hilfetext zu dieser Applikation in Asterisk 1.4: 

  -= Info about function 'CHANNEL' =- 

[Syntax]
CHANNEL(item)

[Synopsis]
Gets/sets various pieces of information about the channel.

[Description]
Gets/set various pieces of information about the channel.
Standard items (provided by all channel technologies) are:
R/O  audioreadformat     format currently being read
R/O  audionativeformat   format used natively for audio
R/O  audiowriteformat    format currently being written
R/W  callgroup           call groups for call pickup
R/O  channeltype         technology used for channel
R/W  language            language for sounds played
R/W  musicclass          class (from musiconhold.conf) for hold music
R/W  rxgain              set rxgain level on channel drivers that suppor
t it
R/O  state               state for channel
R/W  tonezone            zone for indications played
R/W  txgain              set txgain level on channel drivers that suppor
t it
R/O  videonativeformat   format used natively for video

Additional items may be available from the channel driver providing
the channel; see its documentation for details.

Any item requested that is not available on the current channel will
return an empty string.

Differenz zum internen Hilfetext in Asterisk 1.2: 

-- in Version 1.2 nicht vorhanden --


[121] Diese Beschränkung auf 64 Gruppen scheint rein willkürlich zu sein, und dürfte für den ein oder anderen Anwender nicht ausreichen.