How to create devices and tasks

Identify the Media You Are Trying to Monitor

This is frequently confused with the web page or media player location on your website.  The target of a streaming media task will not be the URL of a player or webpage that contains the player, but the actual media file path that is used by a player to play the file.

Once you have identified the location, check the media file type. What protocol does it use? (make sure to specify the protocol in the file path (such as rtmp:// or https://, for example).

Supported protocols include: applehttp, concat, crypto, file, gopher, hls, http, httpproxy, mms, pipe, rtmp, rtp, tcp, udp, rtsp, https.

Depending on the file type and codec, the task will play back the media file in one of several engines which generate slightly different monitoring values: a general player, Windows flash player or Silverlight.

Creating a task

Once you have created a device and are adding or editing a Telnet Port Availability task, you will be prompted to adjust the following settings.

Stream URI

Enter the address of the actual media file you wish to monitor. Note that the url must link directly to the media file and not a web page that contains a media player. For example, the url should contain a  “filename.filetype”: http://streammedia.com/stream.asf

You can control the level of detail of the report by adding a key to the GET parameter of the URL. Add “DotcomReportFormat=” plus one of the following values to the end of the GET string.

0 – Simple
1 – Detailed
2 – Full, including XML returned after processing

Here are several examples:

a. rtsp://38.93.175.176:1935/live/Clifford?DotcomReportFormat=1
b. http://demo.tegrity.com/Class/_Resources/StreamingTest.asf?DotcomReportFormat=2
c. http://demo.tegrity.com/Class/_Resources/StreamingTest.asf?chto-to=tam&gdeto=chto&DotcomReportFormat=3

Completion Timeout (in seconds)

Enter the number of seconds the task should wait for a response from the web page before ending the task and returning an error. If this is left blank the default timeout for a task is 120 seconds.

Custom Script

Apart from media URL you can choose  MediaEngine and ReportDetails by adding into “Prepare Script” field:

(Tasks[0] as Media).MediaEngine= "SMOOTH";
(Tasks[0] as Media).ReportDetails = "Full";

Where  MediaEngine  = ( “FLASH”, “GENERAL”, “SMOOTH”, “WMP”, “FLASH_FC”)

and

ReportDetails = (“STANDART”, “FULL”, “SHORT”)

In case of “FLASH_FC” engine should contain required MediaHost & MediaStream.

Example:

Url = Media
Prepare Script:

(Tasks[0] as Media).MediaHost = "rtmp://fml.125F2.alphacdn.net/20125F2/MediaPlayer/";    
(Tasks[0] as Media).MediaStream = "simulcast-flash-128k";
(Tasks[0] as Media).MediaEngine= " FLASH_FC";
(Tasks[0] as Media).ReportDetails = "Full";