WARNUNG: Sie haben die Ausführung von Javascript in ihrem Browser deaktiviert. A3non.org benötigt zur korrekten Funktion jedoch Javascript - Bitte aktivieren Sie es um den vollen Funktionsumfang der Website nutzen zu können. Was ist Javascript.

Die Konfiguration von Zanmantou ist mit den vielen neuen Möglichkeiten in Bezug auf die vorherige Version um einiges umfangreicher geworden. Aus diesem Grund teilt sich Dokumentation in zwei unterschiedliche Bereiche: zum einen werden in diesem Artikel ausschließlich die Struktur sowie die Einstellungen für den Player beschrieben, in einem anderen Artikel geht es um die UserInterface (UI) Konfiguration des Players.

Struktur:

Grundsätzlich gibt es in Zanmantou3 zwei verschiedene Konfigurationsdateien:

1. config.xml: Einstellungen sowie UI Setup
2. medialist.xml: Playlist

Items für die Playlist können in der aktuellen Zanmantou Version ausschließlich in der Medialist definiert oder dynmaisch per Javascript hinzugefügt werden. Die Übergabe von Items in der URL zum Player sowie die Playlist in der Konfigurationsdatei (in Zanmantou 1.6) werden nicht mehr unterstützt. Der Grund hierfür liegt vor allem in der neuen Struktur und der Tatsache, dass die beiden Möglichkeiten im Grunde genommen überflüssig waren. Zur Info: Eine Playlist lässt sich mit z.B. PHP und SimpleXML sehr einfach automatisch generieren.

Aufbau der Playlist:

Die eigentliche Playlist ist sehr simpel aufgebaut: jeder Song/Video wird als Item-Tag abgebildet und kann mit beliebigen Eigenschaften versehen werden.

XML-Playlist Beispiel

<?xml version="1.0" encoding="UTF-8"?>
<zanmantou>
	<item source="zanmantou3.f4v">
		<param name="title">Zanmantou3 Demo Video</param>
		<param name="releasedate">03.03.2013</param> 
	</item>
	<item source="demo2.php?content=myfile" type="video">
		<param name="title">Zanmantou3 Streaming test</param>
	</item>
	<item source="songs/Jamtoo-Sunshine.mp3">
		<param name="title">Jamtoo Sunshine</param>
		<param name="author"><![CDATA[Janosch Meyer<-->Torben Osmer]]></param>
	</item>
</zanmantou>

Ein Item muss immer über das Attribut source verfügen. Hierbei handelt es sich um den Dateinamen der abzuspielenden Datei. Der Dateipfad wird dabei aus dem mediapath (config.xml) und dem source Attribut gebildet (mediapath+source). Sollten absolute Dateinamen verwendet werden so muss der mediapath leer gelassen werden!
Optional kann einem Item das Attribut type hinzugefügt werden: generell entscheidet Zanmantou automatisch anhand der Dateiendung ob es sich um ein Video oder einen Audio-Track handelt, jedoch kann es vorkommen, dass Dateien zum Beispiel über ein Sript ausgeliefert werden und der Player somit nicht weiss um was für ein Medium es sich handelt. In diesem Fall ist der Medientyp manuell anzugeben. Zulässige Werte sind "audio" und "video".

Auffällig in Bezug auf Zanamntou1 oder andere Player ist, dass es kein Attribut für den Titel eines Items mehr gibt. Um eine maximale Skalierbarkeit zu erzielen wurde das ganze Playlist-Handling weitesgehend abstrahiert: es ist nun möglich über den param Tag innerhalb eines Items beliebige Parameter zu definieren auf welche in den Infoarea zugegriffen werden kann. Zu beachten ist hierbei, dass das Attribut name im Parameter Tag ausschließlich aus Buchstaben und Zahlen bestehen darf. Sollten im Inhalt des Parameter Tag die Zeichen "<" ">" benutzt werden ist der Inhalt als CDATA zu deklarieren. Ansonsten ist das XML Markup invalid und Zanmantou kann die Playlist nicht lesen.

Aufbau der Konfiguration

Die Konfiguration gliedert sich in die drei Hauptabschnitte "normal", "fullscreen" und "settings". Je nachdem ob der Player in Normalen-Modus oder im Fullscreen-Modus ausgeführt wird, kann in den jeweiligen Abschnitten ein Eigenständiges Layout definiert werden. D.h. im Fullscreen-Modus kann das Design des Players ein vollstöndig anderes sein als im Normalen-Modus. Ist dies nicht gewünscht so kann in den Abschnitten "normal" und "fullscreen" jeweils die identische Konfiguration verwenden.

XML-Übersicht über die Struktur der config.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- Zanmantou 3 Config !-->
<zanmantou version="3.0">
	<!-- normal UI config !-->
	<normal>
	</normal>
	<!-- // normal UI config !-->

	<!-- fullscreen UI config !-->
	<fullscreen>
	</fullscreen>
	<!-- // fullscreen UI config !-->

	<!-- Zanmantou Settings !-->
	<settings>
	</settings>
	<!-- // Zanmantou Settings !-->
</zanmantou>

Die vielfältigen UI Konfigurationsmöglichkeiten finden Sie im Artikel "Zanmantou UI Konfiguration".

In den Settings werden unter anderem die Pfade für den Skin sowie die Playlistitems als auch das Startverhalten des Players festgelegt. Dabei ist es wichtig, dass alle hier aufgelisteten Optionen konfiguriert werden. Sollten einige Tags fehlen so kann das zu einem unvorhersehbaren Verhalten des Players führen.

XML-Settings Beispiel

<!-- Zanmantou Settings !-->
<settings>
	<!-- path to player images. NOTE: the image is loaded from the location "imgpath+source" !-->
	<imgpath>/zanmantou3/puregrey/</imgpath>

	<!-- path to media files. NOTE: the file is loaded from the location "mediapath+source" !-->
	<mediapath>/zanmantou3/</mediapath>

	<!-- initial volume [0 ... 1.0] !-->
	<volume>1</volume>

	<!-- initial pan [-1.0 ... 0 ... 1.0] !-->
	<pan>0</pan>

	<!-- initial repeatall status [true, false]!-->
	<repeatall>true</repeatall>

	<!-- initial repeat status [true, false] !-->
	<repeat>false</repeat>

	<!-- initial shuffle status [true, false] !-->
	<shuffle>false</shuffle>
</settings>
<!-- // Zanmantou Settings !-->

Verfügbare Optionen

imgpath: STRING

medipath: STRING

volume: DOUBLE[0.0 ... 1.0]

pan: DOUBLE[-1.0 ... 0.0 ... 1.0]

repeatall:  BOOLEAN[true, false]

repeat: BOOLEAN[true, false]

shuffle: BOOLEAN[true, false]