Die virtPresenter-Software wird von uns nicht mehr aktiv weiterentwickelt! Statt dessen nutzen wir unsere Entwicklungs-Ressourcen für das Opencast Matterhorn Projekt in dem viele Erfahrungen von virtPresenter eingebracht werden.


 

Protokoll Videokonvertierungs-Dienst

Das Konzept des Protokolls entspricht dem des Videorekorder Services. Nähere Informationen können also dort nachgelesen werden.

Direkt nach dem Aufbau der Verbindung schickt der Server eine Statusmeldung der Form: 

  220 <protokollversion> <infotext>

Anschließend können die folgenden Befehle an den Server gegeben werden: 

 auth <passwort>

Meldet den Benutzer mit dem angegebenen Paßwort am Server an. Das Paßwort darf keine Leerzeichen oder sonstigen Zwischenraum enthalten. Erst nach diesem Anmeldevorgang können die anderen Befehle (mit Ausnahme von quit) gegeben werden.

Zulässige Antworten des Servers: 

  200 ok
  500 syntax error
  501 password incorrect


  add <URL zur Job-XML-Datei>

Fügt einen neuen Auftrag hinzu. Die Beschreibung des XML-Formates erfolgt weiter unten.

Zulässige Antworten des Servers: 

  201 <Position in Queue> 
  401 <Fehlertext>
  500 syntax error
  501 not logged in


  remove <id des Convert-Vorganges>

Löscht einen einen Konvertierungs Job aus der Liste.

Zulässige Antworten des Servers: 

  200 ok
  401 <Fehlertext>
  402 not found
  500 syntax error
  501 not logged in


  status

Gibt den aktuellen Atstus des Konvertierungsdienstes aus

Zulässige Antworten des Servers: 

  202 idle
  203 converting <id>, <Startzeit im Standard Linux Datumsformat>
  501 not logged in


  queuelength

Gibt die Anzahl der Aufträge in der Queue an.

Zulässige Antworten des Servers: 

  201 <anzahl> jobs
  501 not logged in 

  listqueue

Gibt die Liste der anstehenden Aufträge aus, in der Reihenfolge wie diese abgearbeitet würden.

Zulässige Antworten des Servers: 

  201 <id> <id>  ... <id> 
  202 empty queue 
  501 not logged in

XML-Format für Konvertierung:

<?xml version="1.0" encoding="UTF-8"?>
<root>
	<id>algo200610301524</id>
	<file>video.mpg</file>
	<source> 
		<server>192.168.0.1</server>
		<path>/home/video/bin</path>
		<username>video</username>
		<password>video1</password>
	</source>

Wenn kein convert-Objekt angegeben wird, wird auch keine Konvertierung vorgenommen

	<convert format="MP4"> ACHTUNG Format immer in Großbuchstaben
		<bandwidth>384</bandwidth> optional
		<resolution>360x240</resolution> optional
 		<framerate>15</framerate> optional
		<deinterlace/> 
		<audiobandwidth>64</audiobandwidth> optional
		<audiorate>22500</audiorate> optional
		<start>0:10:00.0</start> optional
		<duration>0:60:00.0</duration> optional

		<upload> 			<url>http://192.168.0.6/public/video.mp4</url>
			<server>vs1.rz.uos.de</server>
			<path>public/vorlesungen/demo/mp4</path>
			<username>video</username>
			<password>passwort</password>
			<file>video.mp4</file>
		</upload>
		<notify>http://www.virtuos.uos.de/notify.php?id=algo200610301524.mp4</notify> optional
	</convert>

	<convert format="FLV">
		<bandwidth>384</bandwidth>
		<resolution>360x240</resolution>
		<deinterlace/>
		<framerate>25</framerate>
		<audiobandwidth>64</audiobandwidth>
		<audiorate>22500</audiorate>
		<start>0:10:00.0</start>
		<duration>0:60:00.0</duration>
		<upload>
			<url>http://vs1.rz.uos.de/public/video.flv</url>
			<server>vs1.rz.uos.de</server>
			<path>public/vorlesungen/demo/flv</path>
			<username>video</username>
			<password>passwort</password>
			<file>video.flv</file>
		</upload>
		<notify>http://www.virtuos.uos.de/notify.php?id=algo200610301524.flv</notify>
	</convert>	

	<convert format="MP3">
		<audiobandwidth>128 </audiobandwidth>
		<audiorate>22500</audiorate>
		<start>0:10:00.0</start>
		<duration>0:60:00.0</duration>

		<upload>
			<url>http://192.168.0.6/public/video.mp3</url>
			<server>vs1.rz.uos.de</server>
			<path>public/vorlesungen/demo/mp3</path>
			<username>video</username>
			<password>passwort</password>
			<file>video.mp3</file>
		</upload>
		<notify>http://www.virtuos.uos.de/notify.php?id=algo200610301524.mp3</notify>
	</convert>

	<convert format="OGG">
		<audiobandwidth>128 </audiobandwidth>
		<audiorate>22500</audiorate>
		<start>0:10:00.0</start>
		<duration>0:60:00.0</duration>

		<upload>
			<url>http://192.168.0.6/public/video.ogg</url>
			<server>vs1.rz.uos.de</server>
			<path>public/vorlesungen/demo/ogg</path>
			<username>video</username>
			<password>passwort</password>
			<file>video.mp3</file>
		</upload>
		<notify>http://www.virtuos.uos.de/notify.php?id=algo200610301524.ogg</notify>
	</convert>	

</root>