Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin

...

Code Block
borderColorgrey
bgColor#eeeeee
borderStylesolid
langjavascript
borderStylesolid
// 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);

...

  • (warning) Der korrekte Angebotsname muß angegeben werden. Dieser Angebotsname wird vom Betreiber der Streaming-Lösung vergeben.
    Code Block
    borderColorgrey
    bgColor#eeeeee
    borderStylesolid
    langjavascriptborderStylesolid
    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
    borderColorgrey
    bgColor#eeeeee
    borderStylesolid
    langjavascriptborderStylesolid
    	
    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.

    desc

    Ja

    Hier kann eine Beschreibung des Streams hinterlegt werden.

...

  • 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
    borderColorgrey
    bgColor#eeeeee
    borderStylesolid
    langjavascript
    borderStylesolid
    var content:Object = ...; 
    

...

  • 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
    borderStyle
    borderColorgrey
    bgColor#eeeeee
    borderStylesolid
    langjavascriptsolid
    var stream:Stream = sensors.track(content, desc);
    
  • Die Messung einzelner Streams kann jederzeit durch den Aufruf der Methode Stream.stop() abgebrochen werden.

...

Info

Ein Intervall ist definiert als:

Code Block
borderColorgrey
bgColor#eeeeee
borderStylesolid
langjavascriptborderStylesolid
[start, end, timestamp]

start

Die Startsekunde auf dem Stream

end

Die Endsekunde auf dem Stream

timestamp

Der clientseitige Zeitpunkt beim Erstellen des Intervalls

...

Code Block
borderColorgrey
bgColor#eeeeee
borderStylesolid
langjavascriptborderStylesolid
// System-Objekt
[{"sx":1280,
"sy":1024,
"pl":"FlashPlugin",
"plv":"WIN 10,0,45,2"
},
// Nutzungsinformationen
{"stream":"spring/teststream", 
     "dur":"600", 
     "sx":"400",
     "sy":"300",
     "uid":"267fgut",
      "vt":356, 
     "pst":[[0,0,"kzog7e"],[22,378,"kzog7e"]]
}]

...

Code Block
borderColorgrey
bgColor#eeeeee
borderStylesolid
langhtml
borderStylesolid
<script src=".../springstreams.js"></script>

...

Code Block
borderStyle
borderColorgrey
bgColor#eeeeee
borderStylesolid
langjavascriptsolid
	
var sensors = new SpringStreams("test"); 

...

Code Block
borderColorgrey
bgColor#eeeeee
borderStylesolid
langjavascriptborderStylesolid
var myAdapter = {

	"getMeta" : function(id) {
		return {
			"pl" :"own player",
			"plv" :"version1",
			"sx" : screen.width,
			"sy" : screen.height
		}
	},
	"getDuration" : function(id) {
		return 0;
	},
	"getPosition" : function(id) {
		return new Date().getTime() / 1000;
	}
};

...

Code Block
borderColorgrey
bgColor#eeeeee
borderStylesolid
langjavascript
borderStylesolid
sensors.track(someObject, desc, myAdapter);

...

Code Block
borderColorgrey
bgColor#eeeeee
borderStylesolid
langjavascriptborderStylesolid
sensors.debug = function(v) {
        window.status = " " + v;
}

...

Code Block
borderColorgrey
bgColor#eeeeee
borderStylesolid
langjavascriptborderStylesolid
function unload() {
        sensors.unload();
}

...

Code Block
borderColorgrey
bgColor#eeeeee
borderStylesolid
langjavascriptborderStylesolid
function unload() {
	sensors.unload();
        // give time for submission
	var start= new Date(); var now = null; do now = new Date();  
        while(now-start < 100);
}

...

Code Block
borderColorgrey
bgColor#eeeeee
borderStylesolid
langhtmlborderStylesolid
<body onunload="unload();">

...

Code Block
borderColorgrey
bgColor#eeeeee
borderStylesolid
langjavascriptborderStylesolid
var stream = sensors.track(someObject, desc, myAdapter);
...
stream.stop();

...

Code Block
borderColorgrey
bgColor#eeeeee
borderStylesolid
langjavascriptborderStylesolid
sensors.track(rvplayer, description, sensors.RVStreamAdapter);

...

Code Block
borderColorgrey
bgColor#eeeeee
borderStylesolid
langhtmlborderStylesolid
<html>
<head>
<title>spring sensors</title>
<script src="springstreams.js"></script>
</head>
<body onunload="unload();">
<script type="text/javascript">

var sensors = new SpringStreams("test"); 
var adapter = {
	"getMeta" : function() {
		return {
			"pl" :"own player",
			"plv" :"version1",
			"sx" : screen.width,
			"sy" : screen.height
		}
	},
	"getDuration" : function() {
		return 1000;
	},
	"getPosition" : function() {
		return new Date().getTime() / 1000;
	}
};

var desc = {
	"stream": "videos/teststream"
}

sensors.track("someid", desc, adapter);

// uncomment for debugging
//	sensors.debug = function(v) {
//		window.status = v;
//	}

function unload() {
	sensors.unload();
        // give time for submission
	var start= new Date(); var now = null; do now = new Date();  
        while(now-start < 100);
}
</script>	
</body>

...

Code Block
borderColorgrey
bgColor#eeeeee
borderStylesolid
langhtmlborderStylesolid
<script src=".../springstreams.js"></script>

...

Code Block
borderColorgrey
bgColor#eeeeee
borderStylesolid
langjavascriptborderStylesolid
var sensors = new SpringStreams("test"); 

...

Code Block
borderColorgrey
bgColor#eeeeee
borderStylesolid
langjavascriptborderStylesolid
sensors.track(wmplayer, {});

...

Code Block
borderColorgrey
bgColor#eeeeee
borderStylesolid
langjavascriptborderStylesolid
var description = {
	"stream": "videos/teststream"
	"desc": "some additional description" 
};
sensors.track(wmplayer, description);

...

Code Block
borderColorgrey
bgColor#eeeeee
borderStylesolid
langhtmlborderStylesolid
<html>
<head>
<title>spring sensors</title>
<script src="springstreams.js"></script>
</head>
<body onunload="unload();">

<SCRIPT type="text/javascript">
      if(-1 != navigator.userAgent.indexOf("MSIE"))
      {
        document.write('<OBJECT id="wmplayer" width="435" height="326" CLASSID="CLSID:6BF52A52-394A-11d3-B153-00C04F79FAA6" type="application/x-ms-wmp">');
        document.write('                <param name="URL" value="http://wstreaming.zdf.de/zdf/veryhigh/070912_iaa_mim.asx">');
        document.write('                <param name="AutoStart" VALUE="1">');
        document.write('                <param name="ShowStatusBar" VALUE="1">');
        document.write('</object>');
     }
      else  {
       document.write('<OBJECT id="wmplayer" width="435" height="326" type="application/x-ms-wmp">');
       document.write('                 <param name="URL" value="http://wstreaming.zdf.de/zdf/veryhigh/070912_iaa_mim.asx">');
       document.write('                 <param name="AutoStart" VALUE="1">');
       document.write('                 <param name="ShowStatusBar" VALUE="1">');
       document.write(' </object>');
      }         
    </SCRIPT>
		
<script type="text/javascript">

// "test" is the name of the tracked website
var sensors = new SpringStreams("test");

// wmplayer is the id of the stream above
sensors.track(wmplayer, {"stream":"videos/teststream"});

// uncomment for debugging
//sensors.debug = function(v) {
//	window.status = v;
//}

function unload() {
	sensors.unload();
        // give time for submission
	var start= new Date(); var now = null; do now = new Date();  
        while(now-start < 100);
}
</script>	
</body>

...

Code Block
borderColorgrey
bgColor#eeeeee
borderStylesolid
langjavascriptborderStylesolid
var sensors:SpringStreams = new SpringStreams("test"); 

...

Code Block
borderColorgrey
bgColor#eeeeee
borderStylesolid
langjavascriptborderStylesolid
var sensors:SpringStreams = new SpringStreams("test", true); 

...

Code Block
borderColorgrey
bgColor#eeeeee
borderStylesolid
langjavascriptborderStylesolid
sensors.track(ns,{});

Dem gemessenen Objekt können weitere, beschreibende Informationen mitgegeben werden:

Code Block
borderColorgrey
bgColor#eeeeee
borderStylesolid
langjavascriptborderStylesolid
var description:Object = {
	"stream": "videos/teststream",
	"desc": "some additional infos",
	"sx": video.width,
	"sy": video.heigth,
};
sensors.track(ns, description);

...

Code Block
borderColorgrey
bgColor#eeeeee
borderStylesolid
langhtml
borderStylesolid
<body onunload="unload()">
...
function unload() {
   FlexProject.SPRING_UNLOAD();
}

...

Code Block
borderColorgrey
bgColor#eeeeee
borderStylesolid
langjavascriptborderStylesolid
function unload() {
	FlexProject.SPRING_UNLOAD();
        // give time for submission
	var start= new Date(); var now = null; do now = new Date();  
        while(now-start < 100);
}

...

  1. Legen Sie in der HTML-Seite im object-Tag der SWF-Datei den folgenden Parameter fest:
    Code Block
    borderColorgrey
    bgColor#eeeeee
    borderStylesolid
    langhtmlborderStylesolid
    <param name="allowScriptAccess" value="always" />
    
  2. Fügen Sie in der SWF-Datei den folgenden ActionScript-Code ein:
    Code Block
    borderColorgrey
    bgColor#eeeeee
    borderStylesolid
    langjavascript
    borderStylesolid
    flash.system.Security.allowDomain( sourceDomain )
    

...

Code Block
borderStyle
borderColorgrey
bgColor#eeeeee
borderStylesolid
langjavascriptsolid
 var nsClient:Object = {};
 nsClient.onMetaData = ...
 nsClient.onCuePoint = ...  

 nc = new NetConnection();
 nc.connect(null);

 ns = new NetStream(nc);
 ns.play(streamlocation);
 ns.client = nsClient;

 video = new Video();
 video.attachNetStream(ns);
 
 addChild(video);
                
 var tracker:SpringStreams = new SpringStreams("test");
 tracker.track(ns,{"stream":"videos/teststream","sx":video.width,"sy":video.height});

...

Code Block
borderColorgrey
bgColor#eeeeee
borderStylesolid
langjavascriptborderStylesolid
var nsClient:Object = {};
 nsClient.onMetaData = ...
 nsClient.onCuePoint = ...  

 nc = new NetConnection();
 nc.connect(null);

 ns = new NetStream(nc);
 ns.play(streamlocation);
 ns.client = nsClient;

 video = new Video();
 video.attachNetStream(ns);
 
 addChild(video);
                
 var tracker:SpringStreams = new SpringStreams("test");
 var stream:Stream = tracker.track(ns,{"stream":"videos/teststream","sx":video.width,"sy":video.height});

 stream.setDuration(600/*10 minutes*/);

...

Code Block
borderColorgrey
bgColor#eeeeee
borderStylesolid
langjavascriptborderStylesolid
var net:NetConnection = new NetConnection();
net.connect(null);
var ns:NetStream = new NetStream(net);
var currentPosition:Number = ns.time;

...

Code Block
borderColorgrey
bgColor#eeeeee
borderStylesolid
langjavascript
borderStylesolid
package 
{
import flash.media.SoundChannel;
import flash.net.NetConnection;
import flash.net.NetStream;
	
public class SoundNetStreamAdapter extends NetStream
{
	private var channel:SoundChannel;
	
	public function SoundNetStreamAdapter(net:NetConnection, c:SoundChannel)
	{
		super(net);
		channel = c;
	}
		
	override public function get time():Number { 
            // return the position in seconds
		return channel.position/1000;
	}

}
}

...

Code Block
borderStyle
borderColorgrey
bgColor#eeeeee
borderStylesolid
langjavascriptsolid
var tracker:SpringStreams = new SpringStreams("test");
			
var s:Sound = new Sound();
s.load(new URLRequest("file:///pathto/sound.mp3"));

var desc:Object = {
	"stream":"sounds/sound.mp3",
	"sx":0,"sy":0,
};
			
var nc:NetConnection = new NetConnection();
nc.connect(null);

var ns:NetStream = new SoundNetStreamAdapter(nc, s.play());
var stream:Stream = tracker.track(ns, desc);
stream.setDuration(s.length/1000); // duration in seconds

...

Code Block
borderColorgrey
bgColor#eeeeee
borderStylesolid
langjavascriptborderStylesolid
 var nsClient:Object = {};
 nsClient.onMetaData = ...
 nsClient.onCuePoint = ...  

 nc = new NetConnection();
 nc.connect(null);

 ns = new NetStream(nc);
 ns.play(streamlocation);
 ns.client = nsClient;

 video = new Video();
 video.attachNetStream(ns);
 
 addChild(video);
                
// 20:00 - 20:15 Tagesschau
// 20:15 - 21:00 PlusMinus
var tracker:SpringStreams = new SpringStreams("test");
// 20:00
var stream:Stream = tracker.track(ns,{"stream":"livestreams/ard/Tagesschau","sx":video.width,"sy":video.height});

// 20:15
stream.stop();
stream = tracker.track(ns,{"stream":"livestreams/ard/PlusMinus","sx":video.width,"sy":video.height});

...

Code Block
borderColorgrey
bgColor#eeeeee
borderStylesolid
langjavascriptborderStylesolid
...
ns1 = new NetStream(...);
...
ns2 = new NetStream(...);
...
var tracker:SpringStreams = new SpringStreams("test");
var stream1:Stream = tracker.track(ns1,{"stream":"streams/stream1","sx":video.width,"sy":video.height});
var stream2:Stream = tracker.track(ns2,{"stream":"streams/stream2","sx":video.width,"sy":video.height});