TV-Daten Tutorial
Inhaltsverzeichnis
Voraussetzungen
Bevor man mit diesem Tutorial anfangen kann, sollte man zuerst noch sicherstellen, das man folgende Tools installiert hat:
- Apache Ant
- JDK 5 oder höher (also die Entwickler-Version von Java), zu finden unter http://java.sun.com
- Das TV-Daten Starterkit muss runtergeladen und entpackt werden.
Einleitung
Achtung: Bevor man TV-Daten anbietet, müssen die Rechteinhaber der Daten vorher natürlich die Veröffentlichung in dieser Form genehmigt haben!
Danke, das du dir dieses Tutorial durchliest. Das zeigt, das du Interesse hast am Anbieten von TV-Daten. Das ganze ist auch nicht wirklich schwer. Man muss nur die Daten in XML wandeln können (oder ein kleines Java-Programm schreiben) und drei Tools laufen lassen.
Diese drei Tools sind:
- PDSRunner, ein Tool zum konvertieren der Daten in das TVBrowser-Format und legt diese in dem "raw"-Verzeichnis ab.
- PrimaryDataManager, dieses Tool erzeugt Diff-Dateien und legt diese im "prepared"-Verzeichnis ab. Die TV-Browser wissen, welche Version einer Datei lokal vorliegt und laden dann die Diff-Dateien mit den Unterschieden zur aktuellen Version. Dies verhindert, das komplette Tagesprogramme mehrfach runtergeladen werden müssen und sparen so eine große Zahl an zu übertragenen MBs.
- MirrorUpdater, ein Tool das die Dateien auf die eigentlichen Server hochlädt
In diesem Beispiel werden wir eine XML-Datei konvertieren die in dem Verzeichnis input liegt. In dieser Datei sind einige Beispiel-Einträge vorhanden, die aufzeigen sollen, wie die Datei auszusehen hat.
PDSRunner
Um die XML-Datei in das TV-Browser-Format zu konvertieren, muss folgendes in der Kommadozeile eingegeben werden:
ant pdsrunner -Dpdsclasses=XmlTvPDS
Jetzt wird die Klasse XmlTvPDS kompiliert und danach die Xml-Datei konvertiert. Nach diesem Schritt sollte im Verzeichnis raw eine neue Datei 2008-09-10_de_test24_raw_full.prog.gz vorhanden sein.
Sollten widererwarten Fehler auftretten, befindet sich nach Ende des Programmes in dem Verzeichnis pdslog eine Datei mit einer Fehlermeldung.
Um zu überprüfen, ob der Inhalt der Datei korrekt ist, gibt es ein Tool namens "DayProgramFileTranslator". Um es zu starten, einfach
ant dayprogramfiletranslator
ausführen. Jetzt ist ein neues Verzeichnis vorhanden namens raw/txt. Dort sind Text-Dateien mit dem Inhalt der .prog.gz-Dateien und .bin-Dateien mit Jpegs der Bilder, sollten Bilder vorhanden sein.
PrimaryDataManager
Gruppen
Damit der TV-Browser die vielen Sender von unterschiedlichen Anbietern unterscheiden kann, gibt es ein Gruppen-System. Jeder Anbieter kann mehrere Gruppen mit Sendern anbieten. Dabei ist der Name der Gruppe eindeutig. Der Name der Gruppe kann Buchstaben von A-Z und a-z und Zahlen enthalten.
Folgende Gruppen-Namen sind also gültig:
- BodosLokaleSender3
- SenderDesOstens
Folgende Gruppen-Namen sind ungültig:
- Bodo's Lokale Sender 3 (Keine Leerzeichen und ' erlaubt)
- AusländischeSender (Keine Umlaute)
In jeder Gruppe können beliebig viele Sender vorhanden sein. Jeder Sender hat dabei ebenfalls eine ID, die den selben Regeln folgt. Diese ID wird auch in der XML-Datei benutzt als Attribut "channel". Channel darf also keine Leerzeichen oder Umlaute enthalten. Aber keine Angst, die Umlaute und Leerzeichen werden auf andere Wege angegeben.
<programme channel="test24" [...]
Ein Sender ist immer eindeutig durch die Kombination von Gruppe+Sender-ID, das bedeutet es kann mehrere Sender mit der ID fox geben in unterschiedlichen Gruppen. Den Gruppen-Namen und die Sender-ID sollte man allerdings sehr sorgfältig wählen, diese können nicht mehr geändert werden, sobald Nutzer diese Sender abonniert haben. Sollte der Sender seinen Namen ändern, sollte die Sender-ID bestehen bleiben, damit die Nutzer den Sender nicht neu einstellen müssen.
Konfiguration
Damit eine Gruppe funktioniert, gibt es drei Dateien, die gefüllt werden müssen. Das TV-Daten Starterkit liefert eine Test-Gruppe namens myfirstgroup mit. Für diese gibt es im config-Verzeichnis schon Beispiel-Dateien.
Diese Dateien haben alle das Windows-Encoding ISO-8859-15, wenn du nicht unter Windows arbeitest, berücksichtige dies bitte in deinem Text-Editor.
Der Name der Dateien beginnt immer mit dem Gruppen-Namen, in unserem Fall beginnen also alle Dateien mit myfirstgroup.
myfirstgroup.txt
In dieser Datei wird der Name und die Beschreibung der Gruppe angegeben. Da der TV-Browser in Zukunft auch International an Bedeutung gewinnt, muss dies in Deutsch und in Englisch geschehen. Damit die Gruppe einer Person zugewiesen werden kann, und nicht "anonym" ist, kann der eigene Name in der Provider-Zeile angegeben werden.
myfirstgroup_mirrorlist.txt
In dieser Datei muss angegeben werden, auf welchen Servern diese Sendergruppe zu finden ist, damit der TV-Browser diese auch laden kann. Hierbei kann man pro Zeile einen Server angeben. Neben der URL des Verzeichnisses, in dem die Dateien liegen, muss noch mit einem ";" getrennt die Priorität des Servers eingestellt werden. Sollten alle Server gleich stark genutzt werden, sollte man hier "50" angeben.
Der TV-Browser addiert alle Zahlen einer Sendergruppe zusammen und errechnet daraus eine Wahrscheinlichkeit und nutzt diese bei dem "Auswürfeln" des zu nehmenden Servers. Sollte ein Server nicht erreichbar sein, wird ein weiterer aus der Liste genommen. Findet der TV-Browser keinen Server aus dieser Liste, bekommt der Nutzer eine Fehlermeldung, das für diese Sendergruppe kein Server bereit steht.
myfirstgroup_channellist.txt
Diese Datei ist die wichtigste Datei im Config-Verzeichnis. Hier wird eingestellt, welche Sender in dieser Gruppe vorhanden sein sollen
