Changes between Version 5 and Version 6 of de/External-Software-E2WebIfAPI


Ignore:
Timestamp:
Jan 20, 2019 6:08:12 AM (2 months ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • de/External-Software-E2WebIfAPI

    v5 v6  
    1 [[TranslatedPages]] 
    2 ---- 
    3 '''9.4 E2WebIfAPI''' [=#point9.4] ([wiki:Wiki#point0 Inhaltsverzeichnis]) ([WikiStart#point0 Sprachauswahl]) 
    4 ---- 
    5  
    6 == Einführung == 
    7 Enigma2 Webinterface (WebIf) API wurde für Dreambox definiert. 
    8 Es ist ein Protokoll, welches die Steuerung von Dreambox mittels HTTP-Anfragen erlaubt. 
    9  
    10 Typische Steuerungsaufgaben sind: 
    11  
    12 * Programmierung (Timer) und Wiedergabe von Aufnahmen 
    13 * Live-Streaming (TV und Radio) 
    14 * EPG-Funktionen (Anzeige, Suche) 
    15 * Fernbedienung (Remote Control) 
    16  
    17 Einen guten Überblick zum Protokoll findet Ihr im [http://dream.reichholf.net/wiki/Enigma2:WebInterface DreamboxWIKI]. 
    18  
    19 == Motivation == 
    20  
    21 Für TitanNit wurde die Android-App [TiMote#point9.1 tiMote] entwickelt. Mit dieser App steht die oben beschriebene Funktionalität zur Verfügung. D.h. jeder der ein Android-Handy bzw. -Tablett besitzt, kann den TitanNit-Receiver steuern und sogar auf dem Handy fernsehen. Das ist eine coole Sache, oder? 
    22  
    23 Dieses Glück hat jedoch der Besitzer eines iOS-Geräts (iPhone, iPad) nicht mehr. 
    24 Man kann zwar auch mit einem Web-Browser plattformunabhängig (Windows, Linux, Android, iOS) den Receiver steuern, dies ist aber nicht so komfortabel wie mit tiMote. 
    25  
    26 Anderseits gibt es sowohl für iOS als auch Android schon fertige Apps für Dreambox-Receiver. Diese Apps basieren auf dem E2-WebIf-Protokoll. Könnte man nicht diese Apps ebenfalls für TitanNit-Receiver verwenden statt eine neue App für iOS zu entwickeln? 
    27  
    28 == Die Lösung == 
    29 TitanNit besitzt schon ein eigenes Protokoll, welches jedoch mit Enigma2 WebIf nicht kompatibel ist. 
    30 Nach kurzer Analyse wurde festgestellt, dass eine Konvertierung der E2-Anfragen auf TitanNit-Anfragen nicht so schwer ist. 
    31 Deswegen wurde ein E2-Web-Server (e2webserv) entwickelt, welches das Enigma2 WebIf implementiert. Dieser Server empfängt die E2-Anfragen, delegiert die Aufrufe zum lokalen TitanNit Web-Server und die TiatnNit-Antworten wandelt zurück ins XML-Format, welches vom E2-Client erwartet wird. 
    32  
    33 Auf diese Weise wird die TitanNit-Box jetzt offen für die vorhandene E2-Clientsoftware. 
    34  
    35  
    36 == Voraussetzungen == 
    37  
    38 * Web-Server muss auf dem Receiver aktiviert werden 
    39 * e2webserv muss auf dem Receiver installiert werden 
    40  
    41 == iOS-Apps == 
    42  
    43 Folgende Apps habe ich auf meinem iPad2: 
    44 * dreaMote 
    45 * dreaMote Lite 
    46 * e2RemoteHD 
    47 * Dreambox Live 
    48  
    49 Falls Ihr im App-Store nichts kaufen wollt, dann kann ich dreaMote Lite empfehlen. 
    50  
    51 Zusätzlich zu der App benötigt Ihr einen Player. 
    52  
    53 Ich habe folgende Player ausprobiert, welche bei mir gut funktionieren: 
    54 * GoodPlayer 
    55 * BUZZ Player 
    56 * OPlayerHD Lite 
    57 * VLC Player 
    58  
    59 VLC und OPlayerHD Lite sind frei. 
    60  
    61 == XBMC == 
    62  
    63 Falls Ihr die Media-Center-Software [http://xbmc.org/ XBMC] im Einsatz habt, so könnt Ihr mittels Live-TV-Plugin VU+ Euren TitanNit-Receiver direkt einbinden. 
    64 XBMC läuft auf einem PC sowohl unter Windows als auch Linux, ist aber auch für Raspberry Pi verfügbar. 
    65  
    66 == VLC == 
    67 Mit dem installierten e2webserv könnt Ihr Live-Streaming nur mittels [http://www.videolan.org/vlc/ VLC] (ohne extra Software) auf einem PC (Windows oder Linux) genießen. 
    68  
    69 Ihr braucht dafür nicht die Kanäle manuell umschalten, es passiert alles automatisch. Damit dies möglich wird, braucht Ihr eine M3U-Playliste. Solche Playliste könnt Ihr pro Favorit generieren lassen und auf dem PC speichern. Danach einfach M3U-Datei mit VLC öffnen und das gewünschte Programm anklicken. 
    70  
    71 Wie exportiert man die M3U-Datei für eine bestimmte Favoritenliste? 
    72  
    73 In einem Web-Browser einfach die gewünschte Adresse angeben. 
    74  
    75 Beispiel (Favorit heißt "Polish"): 
    76  
    77 [http://192.168.1.1:8080/web/services.m3u?bRef=Polish] 
    78  
    79 Bei dem Link muss nur die eigene IP-Adresse angegeben werden und bei Namen mit Leerzeichen sollte man "%20" statt des Leerzeichen nehmen. 
    80  
    81 Beispiel (Favorit heißt "Mein TV", Receiver-IP: 192.168.0.10): 
    82  
    83 [http://192.168.0.10:8080/web/services.m3u?bRef=Mein%20TV] 
    84  
    85 == Client-Konfiguration == 
    86 Bitte bei dem E2-Client folgendes konfigurieren: 
    87 * IP-Adresse des Receivers 
    88 * Port: 8080 
    89 * Streaming Port: 8001 
    90  
    91 Zu beachten ist, dass SSL nicht unterstützt wird. 
    92  
    93 Unten sieht man eine Beispielkonfiguration für dreaMote. 
    94  
    95 [[Image(DreaMote.png, 384px)]] 
    96  
    97 == e2webserv.conf == 
    98  
    99 Die Konfiguration für den Server muss man bei Bedarf manuell anpassen. 
    100 Bei Standard-TitanNit-Konfiguration sollten keine Änderungen in e2webserv.conf notwendig sein. 
    101  
    102 Bei einer Flash-Installation liegt die Konfigurationsdatei '''e2webserv.conf''' in dem Verzeichnis '''/mnt/swapextensions/etc''' 
    103  
    104 Hier ist der Inhalt: 
    105 {{{ 
    106 # e2 web port 
    107 port=8080 
    108 # e2 data port 
    109 dataPort=8001 
    110 # titan web port 
    111 titanPort=80 
    112 # titan data port 
    113 titanDataPort=22222 
    114 # titan host (change it if e2webserv is not running locally on the receiver) 
    115 titanHost=127.0.0.1 
    116 # automatic switching of channels 
    117 # It is useful if you don't want manually switch a channel on receiver with a single tuner. 
    118 # If it is set to false and you have a single tuner the you can stream only channels located  
    119 # on the same transponder as the current channel active on the receiver. 
    120 autoZap=true 
    121 # log output file 
    122 logFile=/tmp/e2webserv.log 
    123 # maximal log file size in KB. Set it to 0 (default 10KB) to disable logging (maximal allowed value is 1024). 
    124 # When the file limit is reached a backup of the current file is created.  
    125 # It means maximally 2 x maxLogSize KB will be used. 
    126 maxLogSize=10 
    127 # thread pool size (1..8) 
    128 threadPool=2 
    129 # Directory where the transponder and bouquet files are located. 
    130 # You don't need to specify it, it will be automatically discovered. 
    131 # But if you you start e2webserv not on the receiver (but e.g. on your Linux server or Windows computer) then you 
    132 # should copy the settings (channel, transponder, provider and all bouquets file) and specify here the location on the local computer. 
    133 titanDir=/mnt/settings 
    134 }}} 
    135 == Links == 
    136  
    137 * Enigma2 Web-API im [http://www.aaf-digital.info/forum/showthread.php?90948-Enigma2-Web-API-f%FCr-Titan AAF-Forum] 
    138 * Sources auf [https://github.com/gswiatek/e2api4titan GitHub] 
    139   
    140 [[br]] 
    141 [[br]]