DEVICE_STATE(geraet
)
Gibt den Status eines „Geräts“ zurück. Ein Gerät kann
z. B. ein SIP-Peer/User
(
SIP/peername
), eine
MeetMe-Konferenz
(MeetMe:konferenzraum
) oder
ein eigenes Custom-Gerät
(Custom:name
) sein. Der Status
von Custom
-Geräten lässt sich mit dieser Funktion auch
setzen.exten => 123,hint,SIP/lisa exten => 123,1,Dial(SIP/lisa) exten => 456,1,Verbose(1,Status von lisa: ${DEVICE_STATE(SIP/lisa)})
Die Funktion gibt einen der folgenden Werte zurück:
UNKNOWN
(unbekannt bzw. nicht angemeldet),
NOT_INUSE
(frei), INUSE
(im Gespräch),
BUSY
(im Gespräch bzw. besetzt),
INVALID
(ungültig), UNAVAILABLE
(nicht
erreichbar), RINGING
(klingelt),
RINGINUSE
(im Gespräch und klingelt bzw. Anklopfen),
ONHOLD
(auf Halten).Für eine ausführliche Beschreibung siehe auch Abschnitt 23.6, „Gezielte Ansteuerung der LEDs“.
Asterisk-Versionen:
| | | | | 1.6 |————————
Interner Hilfetext zu dieser Funktion in Asterisk 1.6:
-= Info about function 'DEVICE_STATE' =-
[Syntax]
DEVICE_STATE(device)
[Synopsis]
Get or Set a device state
[Description]
The DEVICE_STATE function can be used to retrieve the device state from any
device state provider. For example:
NoOp(SIP/mypeer has state ${DEVICE_STATE(SIP/mypeer)})
NoOp(Conference number 1234 has state ${DEVICE_STATE(MeetMe:1234)})
The DEVICE_STATE function can also be used to set custom device state from
the dialplan. The "Custom:" prefix must be used. For example:
Set(DEVICE_STATE(Custom:lamp1)=BUSY)
Set(DEVICE_STATE(Custom:lamp2)=NOT_INUSE)
You can subscribe to the status of a custom device state using a hint in
the dialplan:
exten => 1234,hint,Custom:lamp1
The possible values for both uses of this function are:
UNKNOWN | NOT_INUSE | INUSE | BUSY | INVALID | UNAVAILABLE | RINGING
RINGINUSE | ONHOLD