Ehttp api doku

Aus TuxBoxWIKI
Wechseln zu: Navigation, Suche

Inhaltsverzeichnis


Allgemeines

Dies ist die Dokumentation der API des ehttp (Web-Server) von Enigma.


API-Dokumentation

Lautstärke setzen (Bereich 0...63)

Befehl: http://dbox/setVolume?volume=5

0 ist quasi mute, sprich Ton aus.

63 entspricht der vollen Lautstärke.

Diese Funktion liefert keine Rückgabewerte. (wird für das webif benötigt)


Lautstärke setzen (Bereich 63...0)

Befehl: http://dbox/cgi-bin/audio?volume=30

0 entspricht der vollen Lautstärke.

Rückgabe:

Volume set.
volume: 0
mute: 0

63 ist quasi mute, sprich Ton aus.

Rückgabe:

Volume set.
volume: 63
mute: 1


Ton Stumm schalten

Befehl: http://dbox/setVolume?mute=0

Diese Funktion liefert keine Rückgabewerte. (wird für das webif benötigt)


Ton Stumm schalten (2)

Befehl: http://dbox/cgi-bin/audio?mute=0

Rückgabe:

mute set
volume: 0
mute: 0


liefert die TV User-Bouquets inklusive Sender

Befehl: http://dbox/cgi-bin/getServices?ref=4097:7:0:6:0:0:0:0:0:0:&listContent=true

Beispiel Ausgabe:

4097:7:0:d2fca:0:0:0:0:0:0:/var/tuxbox/config/enigma/userbouquet.d2fca.tv;Basis
1:0:1:6dca:44d:1:c00000:0:0:0:;Das Erste;ARD;192
1:0:1:6d66:437:1:c00000:0:0:0:;ZDF;ZDFvision;192
1:0:1:2e:21:85:c00000:0:0:0:;SAT.1;ProSiebenSat.1;192
1:0:1:2ee3:441:1:c00000:0:0:0:;RTL Television;RTL World;192
1:0:1:382:21:85:c00000:0:0:0:;ProSieben;ProSiebenSat.1;192


liefert die Radio User-Bouquets inklusive Sender

Befehl: http://dbox/cgi-bin/getServices?ref=4097:7:0:4:0:0:0:0:0:0:&listContent=true

Beispiel Ausgabe:

4097:7:0:281ed:0:0:0:0:0:0:/etc/enigma/userbouquet.281ed.radio;Basis
1:0:2:aa:7:85:c00000:0:0:0:;ANTENNE BAYERN;BetaDigital;192
1:0:2:a9:7:85:c00000:0:0:0:;sunshine live;BetaDigital;192


liefert die Movies-Liste

Befehl: http://dbox/cgi-bin/getServices?ref=4097:7:0:1:0:0:0:0:0:0:&listContent=true

Beispiel Ausgabe:

1:0:1:382:21:85:c00000:0:0:0:/hdd/movie/ProSieben - Die Simpsons - 19_07_05.ts;Die Simpsons;192


zap zum angegebenen Service

Beispiel-Befehl: http://dbox/cgi-bin/zapTo?path=1:0:1:2ee3:441:1:c00000:0:0:0

Parameter 1: FavoritenTyp: 1=DBV-Service, 2=File

Parameter 2: Flags

Parameter 3: SType = Service Type; Dezimalwert: 1=TV, 2=Radio, 4=NVod, andere=Daten

Parameter 4: 2ee3 ist die SID, wird in hex angegeben

Parameter 5: 441 ist die TSID, wird in hex angegeben

Parameter 6: 1 ist die ONID, wird in hex angegeben

Parameter 7: Namespace in hex

Parameter 8: ?

Parameter 9: ?

Parameter10: ?


zum service zappen

Befehl: http://dbox/cgi-bin/switchService


dbox/dreambox shutdown

Befehl: http://dbox/cgi-bin/admin?command=shutdown


dbox/dreambox reboot

Befehl: http://dbox/cgi-bin/admin?command=reboot


Enigma Neustart

Befehl: http://dbox/cgi-bin/admin?command=restart


Enigma standby

Befehl: http://dbox/cgi-bin/admin?command=standby


Enigma aufwachen aus standby

Befehl: http://dbox/cgi-bin/admin?command=wakeup


Nachricht auf den Fernsehbildschirm

Befehl: http://dbox/cgi-bin/message?Hallo


erweiterte Nachricht auf den Fernsehbildschirm

Befehl: http://dbox/cgi-bin/xmessage?timeout=3&caption=Nachricht&body=Hallo


startet einen Audio-HTTP-Stream des aktuell laufenden Services

Befehl: http://dbox/audio.m3u


startet einen Video-HTTP-Stream (VLC kompatibel) des aktuell laufenden Services

Befehl: http://dbox/video.pls


startet einen Video-HTTP-Stream (MPlayer kompatibel) des aktuell laufenden Services

Befehl: http://dbox/mplayer.mply


aktuelles Enigma-Datum und -Uhrzeit

Befehl: http://dbox/cgi-bin/status

Beschreibung: gibt das aktuelle Enigma-Datum und -Uhrzeit zurück


zeigt aktuelle Version von Enigma an

Befehl: http://dbox/version

(die Rückgabewerte sollten mal aktualisiert werden)


liefert den EPG des aktuellen Service

Befehl: http://dbox/cgi-bin/getcurrentepg


liefert die Stream-Daten des aktuellen Service

Befehl: http://dbox/cgi-bin/streaminfo


liefert den Namen des aktuellen Service

Befehl: http://dbox/channels/getcurrent


gibt die PMT als XML-File zurück

Befehl: http://dbox/cgi-bin/getPMT


Enigma Einstellungen neu laden

Befehl: http://dbox/cgi-bin/reloadSettings


Liste der Recordings neu laden

Befehl: http://dbox/cgi-bin/reloadRecordings


Liste der Recordings im Flash speichern

Befehl: http://dbox/cgi-bin/saveRecordings


Playlist neu laden

Befehl: http://dbox/cgi-bin/reloadPlaylist


Playlist speichern

Befehl: http://dbox/cgi-bin/savePlaylist


User-Bouquets neu einlesen

Befehl: http://dbox/cgi-bin/reloadUserBouquets


User-Bouquets speichern

Befehl: http://dbox/cgi-bin/saveUserBouquets


Timer-Liste neu einlesen

Befehl: http://dbox/cgi-bin/reloadTimerList


Timer-Liste speichern

Befehl: http://dbox/cgi-bin/saveTimerList


Plugin starten

Befehl: http://dbox/cgi-bin/startPlugin?name=pluginname


screenshot nach /tmp/screenshot.bmp

Befehl: http://dbox/cgi-bin/screenshot


screenshot des OSD nach /tmp/osdshot.png

Befehl: http://dbox/cgi-bin/osdshot


einige Kompatibilitäts-Funktionen zu Neutrino

Nachricht auf den Fernsehbildschirm

Befehl: http://dbox/control/message?Hallo


liefert die VPid und APid des aktuellen Service (dezimal)

Befehl: http://dbox/control/zapto?getpids

Beispiel-Ausgabe:

255
256

255 ist die Video Pid

256 ist die Audio Pid


liefert VPid, APid's, vtxt Pid und PMT Pid des aktuellen Service (dezimal)

Befehl: http://dbox/control/zapto?getallpids

Beispiel-Ausgabe:

00255
00256 deutsch
00257 dolby digital (AC3)
00032 vtxt
00100 pmt

00255 ist die Video Pid

00256 ist die Audio Pid

00257 ist die 2te Audio Pid

00032 ist die vtxt (Teletext) Pid

00100 ist die PMT Pid


sollte zum angegebenen Channel zappen -> tut es aber nicht

Befehl: http://dbox/control/zapto?69531


liefert onid+sid

Befehl: http://dbox/control/getonidsid


liefert die komplette Kanalliste (unsortiert)

Befehl: http://dbox/control/channellist


XML-Funktionen

liefert Statusinformationen der Box wie z.B. Standby, Recording, etc.

Befehl: http://dbox/xml/boxstatus

Beispiel-Ausgabe:

<status>
 <current_time>Sat Jul 23 23:03:17 2005
 </current_time>
 <standby>OFF</standby>
 <recording>OFF</recording>
 <mode>0</mode>
 <ip>192.168.0.10</ip>
</status>


Erläuterungen:

<current_time>Sat Jul 23 23:03:17 2005</current_time> liefert das Datum und die aktuelle Uhrzeit

<standby>OFF</standby> die Box ist nicht im standby, ON bedeutet sie befindet sich im Standby

<recording>OFF</recording> Enigma nimmt gerade nicht auf, ON bedeutet Enigma nimmt gerade auf

<mode>0</mode> Enigma befindet sich im TV-Modus

<mode>1</mode> Enigma befindet sich im Radio-Modus

<mode>2</mode> Enigma befindet sich im Datei-Modus

<ip>192.168.0.10</ip> gibt die aktuelle IP-Adresse der Box zurück, in diesem Fall wäre das die 192.168.0.10


liefert die Timerliste

Befehl: http://dbox/xml/timers

Timer.jpg


Befehl: http://dbox/xml/serviceepg?ref={service reference}

(ref ist optional, falls nicht angegeben wird der eingestellte Service genommen)

Gibt den EPG eines Services mit der Servicereferenz 'ref' zurueck:

600px


liefert Daten des momentanen Services wie EPG, Audio- und Video-Channels, etc.

Befehl: http://dbox/xml/currentservicedata

600px


Box-Info

Befehl: http://dbox/xml/boxinfo


liefert die Stream-Daten des aktuellen Service

Befehl: http://dbox/xml/streaminfo


Alle Services

Befehl: http://dbox/xml/services


Timer

einmal-Timer hinzufügen

http://dbox/addTimerEvent?type=regular&ref=' + channel + '&sday=' + sday + '&smonth=' + smonth + '&syear=' +

 syear + '&shour=' + shour + '&smin=' + smin + '&eday=' + eday + '&emonth=' + emonth + '&eyear=' + eyear + '&ehour=' +

 ehour + '&emin=' + emin + '&descr=' + descr + '&after_event=' + after_event + '&action=' + action;

Bei action gibt man dvr, ngrab oder zap an.


wiederholender-Timer hinzufügen

http://dbox/addTimerEvent?timer=repeating&ref=' + channel + '&shour=' + shour + '&smin=' + smin + '&ehour=' + 

ehour + '&emin=' + emin + '&mo=' + mo + '&tu=' + tu + '&we=' + we + '&th=' + th + '&fr=' + fr + '&sa=' + sa + '&su=' + 

su + '&descr=' + descr + '&after_event=' + after_event + '&action=' + action;

Bei action gibt man dvr, ngrab oder zap an.

Achtung:

Gegenüber dem Hinzfügen eines einmal-Timers muss hier nach addTimerEvent? timer=repeating kommen.


einmal-Timer ändern

http://dbox/changeTimerEvent?type=regular<dieselben parameter wie addtimerevent> plus old_type=...&old_stime=... 

zur Identifikation des Timers. Bei old_data muss der Parameter <typedata> aus der Timerliste übernommen werden und old_stime ist die alte Startzeit <start>


wiederholender-Timer ändern

http://dbox/changeTimerEvent?type=repeating<dieselben parameter wie addtimerevent> plus old_type=...&old_stime=... 

zur Identifikation des Timers. Bei old_data muss der Parameter <typedata> aus der Timerliste übernommen werden und old_stime ist die alte Startzeit <start>


einmal-Timer löschen

http://dbox/deleteTimerEvent?ref=#REFERENCE#&start=#START#&type=#TIMERTYPE#&force=no/yes

Hier ist type=dvr oder type=ngrab.


wiederholender-Timer löschen

http://dbox/deleteTimerEvent?ref=#REFERENCE#&start=#START#&type=#TIMERID#&force=no/yes

Achtung:

Hier muss bei type die timer-id angegeben werden, dies ist nur für wiederholende-Timer notwendig.




Review-KandidatDieser Artikel befindet sich derzeit im Reviewprozess. Hilf mit, ihn zu verbessern! Falls du bei weiteren Artikeln helfen willst, findest du hier eine Auswahl offener Artikel.