Add / Edit a Streaming Media Task

Device Type: ServerView Platform

Glossary: Streaming Media Task

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.

 

How to Edit a Streaming Media Task

Once you have created a device and are adding or editing a Streaming Media task, you will be prompted to adjust the following settings:

(This image is from the Legacy Editor)

video_streaming

Task name

Defines the task name and is shown within the task’s Device.

Maximum Connection Timeout (in seconds)

Defines the timeout value (in milliseconds) for task execution.

URL

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”: https://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. https://demo.tegrity.com/Class/_Resources/StreamingTest.asf?DotcomReportFormat=2
c. https://demo.tegrity.com/Class/_Resources/StreamingTest.asf?chto-to=tam&gdeto=chto&DotcomReportFormat=3

Prepare 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";