109. SendURL()
Zurück Anhang B. Applikationen im Dialplan Weiter

109. SendURL()

Sendet dem Channel eine URL.

SendURL(URL[,Option])

Sendet dem Channel eine URL, die das Gerät aufrufen soll (IAX2). Setzt die Ausführung beim nächsten Schritt fort.

Mit der Option j wird, wenn der Channel keine Übertragung von URLs unterstützt, zur Priorität n+101 gesprungen. Mit der Option wait wird vor dem Fortfahren auf eine Bestätigung gewartet, dass die URL geladen wurde.

Liefert 0 zurück, wenn die URL fehlerfrei übertragen wurde oder der Channel die Übertragung nicht unterstützt, sonst -1. Setzt die Channelvariable SENDURLSTATUS auf SUCCESS (Erfolg), FAILURE (Sendefehler), UNSUPPORTED (nicht unterstützt) oder NOLOAD (bei wait: Client konnte die URL nicht laden).

exten => 123,1,SendURL(http://www.asterisk.org/,wait)
[Anmerkung]Anmerkung

Interner Hilfetext zu dieser Applikation in Asterisk 1.4: 

  -= Info about application 'SendURL' =- 

[Synopsis]
Send a URL

[Description]
  SendURL(URL[|option]): Requests client go to URL (IAX2) or sends the 
URL to the client (other channels).
Result is returned in the SENDURLSTATUS channel variable:
    SUCCESS       URL successfully sent to client
    FAILURE       Failed to send URL
    NOLOAD        Client failed to load URL (wait enabled)
    UNSUPPORTED   Channel does not support URL transport

If the option 'wait' is specified, execution will wait for an
acknowledgement that the URL has been loaded before continuing

If jumping is specified as an option (the 'j' flag), the client does not
support Asterisk "html" transport, and there exists a step with priority
n + 101, then execution will continue at that step.

SendURL continues normally if the URL was sent correctly or if the channel
does not support HTML transport.  Otherwise, the channel is hung up.

Differenz zum internen Hilfetext in Asterisk 1.2: 

13c13
<     NOLOAD        Client failed to load URL (wait enabled)
---
>     NOLOAD        Clien failed to load URL (wait enabled)
17a18
> and will return -1 if the peer is unable to load the URL
19,24c20,26
< If jumping is specified as an option (the 'j' flag), the client does not
< support Asterisk "html" transport, and there exists a step with priority
< n + 101, then execution will continue at that step.
< 
< SendURL continues normally if the URL was sent correctly or if the channel
< does not support HTML transport.  Otherwise, the channel is hung up.
---
> Old behaviour (deprecated): 
>  If the client does not support Asterisk "html" transport, 
>  and there exists a step with priority n + 101, then execution will
>  continue at that step.
>  Otherwise, execution will continue at the next priority level.
>  SendURL only returns 0 if the URL was sent correctly  or if
>  the channel does not support HTML transport, and -1 otherwise.

Siehe auch. Abschnitt 107, „SendImage()“, Abschnitt 108, „SendText()“

Zurück Nach oben Weiter
108. SendText() Zum Anfang | InhV 110. Set()

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.