Page Comparison

...

// 1. Instantiiere das API-Objekt
var sensors:SpringStreams = new SpringStreams("angebotsname");

// 2. Ein Description-Objekt für den Streaming-Content anlegen.
var desc:Object = {
   "stream":"videos/mystream",
   "duration":600, // in Sekunden
   "sx":video.width,
   "sy":video.height
};

// 3. Das Content-Objekt zur Verfügung stellen
var content:Object = ...; // Irgendein Objekt, dass in der Lage ist die aktuelle Position in Sekunden zu liefern

// 4. Den Content mit dem Description-Objekt auf dem Sensor registieren.
var stream:Stream = sensors.track(content, desc);

...

• Der korrekte Angebotsname muß angegeben werden. Dieser Angebotsname wird vom Betreiber der Streaming-Lösung vergeben.

  Code Block
  borderColor grey bgColor #eeeeee borderStyle solid lang javascript
  var sensors:SpringStreams = new SpringStreams("angebotsname");

• Eine Instanz des Objektes SpringStreams ist im Framework nur einmalig anzulegen. Ab da können ein oder mehrere Streams der track-Methode zur Messung übergeben werden.

...

• Im Description-Objekt muss mindestens der Name des Streams angegeben werden.

  Code Block
  borderColor grey bgColor #eeeeee borderStyle solid lang javascript
  var desc:Object = { "stream":"videos/mystream", "duration":600 // in Sekunden };

• Mit dem Description-Objekt übergibt man der API nähere Informationen zum Streaming-Content. Hierbei sind folgende Variablen erlaubt bzw. werden vom Messsystem verstanden.

  Variable	Optional	Beschreibung
  stream	Nein	Der Names des Streams, der optimalerweise als Hierarchie übergeben wird. z.B. path/to/stream/name
  duration	Nein	Die Duration muss angegeben werden. Im Falle von Livestreams kann sie weggelassen werden oder wird mit dem Wert 0 geliefert
  ct	Ja	Hier kann ein beliebiger Wert verwendet werden, der ein Aussage über den ContentType macht. Beispielweise könnte der Wert ad angegeben werden, um den Stream als Werbung zu markieren.
  sx	Ja	Die Breite (width) des Streamfensters - sofern es sich um einen Film handelt. Im Falle eines Radiostreams, können die Variablen weggelassen werden oder werden mit dem Wert 0 geliefert.
  sy	Ja	Die Höhe (height) des Streamfensters - sofern es sich um einen Film handelt. Im Falle eines Radiostreams, können die Variablen weggelassen werden oder werden mit dem Wert 0 geliefert.

...

• Die einzige Anforderung an dieses Objekt seitens der Streaming-API ist, dass es die Möglichkeit bietet die aktuelle Position auf einem Stream in Sekunden auslesen zu können. Je nach Programmiersprache sind hier ebenfalls softwaretechnische Lösungen denkbar, wie die Implementierung von Interfaces oder die Implementierung von Adapterklassen.

  Code Block
  borderColor grey bgColor #eeeeee borderStyle solid lang javascript
  var content:Object = ...;

zu 4: Den Content mit dem Description-Objekt auf dem Sensor registieren.

• Im nächsten Schritt der Streaming-Content und das Description-Objekt der API-Methode track übergeben werden. Ab diesem Zeitpunkt wird die aktuelle Position auf dem Stream getracked. An dieser Stelle ist es möglich mehrere Streams parallel zu messen, in dem jeder zusätzlich Streaming-Content mit dem zugehörigen Description-Objekt ebenfalls der track-Methode übergeben wird.

  Code Block
  borderColor grey bgColor #eeeeee borderStyle solid lang javascript
  var stream:Stream = sensors.track(content, desc);

• Die Messung einzelner Streams kann jederzeit durch den Aufruf der Methode Stream.stop() abgebrochen werden.

...