#################################################################################################### ---------------------------------------------------------------------------------------------------- ZANMANTOU WebAVPlayer Version 1.5 Copyright (c) 2006-2007, Mathias Karstädt, Andi Dittrich All rights reserved. ---------------------------------------------------------------------------------------------------- #################################################################################################### EINLEITUNG ---------------------------------------------------------------------------------------------------- Es freut uns, dass du dir den neuen ZANMANTOU WebAV(AudioVideo)Player heruntergeladen hast. Dabei handelt es sich um einen MP3 Player, welcher sich sehr einfach in beliebige HTML Seiten integrieren läßt. Er basiert auf der Adobe Flash Technologie und wird von den meisten modernen Browsern welche das Flash Plugin installiert haben unterstützt. Der MP3/Video Player läßt sich sehr einfach den eigenen Wünschen entsprechend anpassen. Durch ein flexibles Skin System, welches über eine XML Datei konfiguriert werden kann, läßt sich sein Aussehen und die Anordnung der einzelnen Bedienungselemente beliebig ändern. Ebenfalls können über diese XML Konfigurationsdatei auch die gewünschten MP3 Songs als Playliste definieren, welche dann vom Player abgespielt werden können. Hier läßt sich auch ein Name für jeden Song zuordnen. Der Player besitzt außerdem die Möglichkeit, Titelnamen der Songs aus den MP3 Dateien zu extrahieren und kann diese stattdessen anzeigen. Ein weiteres Feature ist die integrierte JavaScript Steuerung des Players. Diese ermöglicht es, den Player über mehrere unterschiedliche JavaScript Funktionen zu steuern. So kann man den Player starten, stoppen, den nächsten Song starten und auch neue Songs hinzufügen. Dies ist auch von Vorteil, wenn man den Player in der Webseite versteckt einbauen möchte, aber trotzdem in der Lage sein möchte diesen steuern zu können. INSTALLATION ---------------------------------------------------------------------------------------------------- Die Installation läßt sich in wenigen Schritten durchführen. SCHRITT 1 - DEN PLAYER HERUNTERLADEN UND ENTPACKEN Ihr könnt euch den Player als ZIP Datei unter der folgenden URL herunterladen: http://zanmantou.voodoon.com Kopiert diese Datei in das gewünschte Verzeichnis auf eurer Festplatte und entpackt diese mit einem dafür geeigneten Programm, wie z.B. WinZIP. Die Dateien werden automatisch in ein neues Verzeichnis entpackt. Ihr könnt dieses Verzeichnis euren Wünschen entsprechend umbenennen. SCHRITT 2 - EINE PLAYLISTE ERSTELLEN Um den Player jetzt testen zu können, müssen zuerst ein oder mehrere MP3 Dateien in das dafür vorgesehene Verzeichnis kopiert werden. Ist dies geschehen, muss als nächstes die Playliste in der XML Konfigurationsdatei angepasst werden. Die Konfigurationsdatei heißt config.xml und be- findet sich im obersten Verzeichnis. Öffnet die Datei mit einem Texteditor und passt die Einträge im Bereich an. Jeder Song Eintrag hat zwei Attribute. Das Attribut name gibt den Namen des Songs an, so wie er später im Player angezeigt werden soll. Das Attribut filename enthält den Namen der MP3 Datei mit der Endung .mp3! SCHRITT 3 - DEN PLAYER TESTEN Wenn ihr alle eure MP3 Dateien in die Playliste aufgenommen habt, könnt ihr den MP3 Player gleich ausprobieren, indem ihr die HTML Datei zanmantou.html in eurem Browser öffnet. Wenn alles gut gegangen ist, solltet ihr nun in der Lage sein, eure Songs abzuspielen. Herzlichen Glückwunsch! DEN PLAYER IN DIE EIGENE HTML SEITE INTEGRIEREN ---------------------------------------------------------------------------------------------------- Bei den folgenden Beschreibungen gehe ich davon aus, dass ihr den Zanmantou Player in folgender Weise auf euren Server kopiert habt: Pfad_zum_Player/ media/ hier eure MP3 Dateien einfügen images/ hier befinden sich die vom Player verwendeten Grafiken zanmantou.html zanmantou.swf config.xml Um den Player in die eigene Seite integrieren zu können, muss dort nur ein object Tag eingebunden werden. Wie dies aussehen muss könnt ihr der zanmantou.html Datei entnehmen oder ihr nehmt einfach den folgenden HTML Code: Wichtig ist, das ihr im Tag das data Attribut richtig setzt. Dort solltet ihr den passenden Pfad zur zanmantou.swf Datei definieren. Befindet sich diese im gleichen Verzeichnis wie die XML Datei, braucht ihr dort nur den Namen der SWF Datei angeben. Über die width und height Attribute könnt ihr außerdem festlegen, wie groß der Player dargestellt werden soll. Die im Tag enthaltenen 's müssen vorerst nicht weiter angepasst werden. Außer der movie Parameter, welcher den gleichen Inhalt haben sollte, wie das data Attribute des Tags. Eine genaue Beschreibung entnehmen Sie bitte der Online-Dokumentation ---------------------------------------------------------------------------------------------------- Siehe Online-Dokumentation : http://zanmantou.voodoon.com