Create an MSS (Microsoft Smooth Streaming). From Microsoft, “If the Internet bandwidth and video rendering capability on your playback device are sufficiently high, you’ll experience high-definition video playback of the sample content. You will also be able to simulate end user experiences under varying conditions by simulating drops and recoveries in bandwidth.” See more.
How To
Single Stream
General Format:
createMSSStream localstreamnames=<localstreamname> bandwidths=<bandwidth> targetFolder=<target_folder_path> groupname=<groupname>
-
For Windows:
createMSSStream localstreamnames=myStream bandwidths=51265536 targetfolder=C:\EvoStream\evo-webroot groupname=myMSSGroup
-
For Linux Package:
createMSSStream localstreamnames=myStream bandwidths=51265536 targetfolder=/var/evo-webroot groupname=myMSSGroup
-
For Linux Archive:
createMSSStream localstreamnames=myStream bandwidths=51265536 targetfolder=/path_to_evo-webroot groupname=myMSSGroup
The created files will automatically save in the targetFolder
path.
evo-webroot: --> targetfolder
myMSSGroup --> groupname
- myStream --> localstreamname
-- audio --> audio_folder
--- 51265536 --> bitrate_folder
---- XXXXXXXXXX000.fmp4 --> audio_segment_file
---- XXXXXXXXXXXXX.fmp4 --> audio_segment_file
-- video --> video_folder
--- 51265536 --> bitrate_folder
---- XXXXXXXXXX000.fmp4 --> video_segment_file
---- XXXXXXXXXXXXX.fmp4 --> video_segment_file
- manifest.ismc --> manifest_file
Multiple Stream
To use multiple localStreamNames
using one createMSSStream command do the following:
General Format:
createMSSStream localstreamnames=<localstreamname1>,<localstreamname2>,<localstreamnameX> bandwidths=<bandwidth1,bandwidth2,bandwidthX> targetFolder=<target_folder_path> groupname=<groupname>
-
For Windows:
createMSSStream localstreamnames=myStream1,myStream2 bandwidths=10000000,20000000 targetfolder=C:\EvoStream\evo-webroot groupname=myMSSGroup
-
For Linux Package:
createMSSStream localstreamnames=myStream1,myStream2 bandwidths=10000000,20000000 targetfolder=/var/evo-webroot groupname=myMSSGroup
-
For Linux Archive:
createMSSStream localstreamnames=myStream1,myStream2 bandwidths=10000000,20000000 targetfolder=/path_to_evo-webroot groupname=myMSSGroup
The created files will automatically save in the targetFolder
path.
evo-webroot: --> targetfolder
myMSSGroup --> groupname
- 10000000 --> bitrate_folder_1
-- audio --> audio_folder
--- xxxxxxxxxx000.fmp4 --> fmp4_audio_file
--- xxxxxxxxxxxxx.fmp4 --> fmp4_audio_file
-- video --> video_folder
--- xxxxxxxxxx000.fmp4 --> fmp4_video_file
--- xxxxxxxxxxxxx.fmp4 --> fmp4_video_file
- 20000000 --> bitrate_folder_2
-- audio --> audio_folder
--- xxxxxxxxxx000.fmp4 --> fmp4_audio_file
--- xxxxxxxxxxxxx.fmp4 --> fmp4_audio_file
-- video --> video_folder
--- xxxxxxxxxx000.fmp4 --> fmp4_video_file
--- xxxxxxxxxxxxx.fmp4 --> fmp4_video_file
- manifest.ismc --> manifest_file
JSON CLI Response
Sample API Call:
createMSSStream localstreamnames=testpullstream,testpullstream bandwidths=10000000,20000000 targetfolder=../evo-webroot groupname=mss playlisttype=rolling
JSON CLI Response:
Command entered successfully!
MSS stream created
groupName: mss
localStreamNames:
-- testpullStream
manifestName: manifest.ismc
playlistType: rolling
targetFolder: /var/evo-webroot
Playing an MSS Manifest File
The corresponding link to play this stream would then be:
General Format:
http://<EMS_IP_Address:<Web_Server_Port>/<MSS_groupname>/<manifest_filename>
Sample URL:
-
Single Stream
http://192.168.2.34:8888/myMSSGroup/manifest.ismc
-
Multiple Stream
http://192.168.2.34:8888/myMSSGroup/myStream1/manifest.ismc
http://192.168.2.34:8888/myMSSGroup/myStream2/manifest.ismc
http://192.168.2.34:8888/myMSSGroup/myStream3/manifest.ismc
The player will now automatically play the stream once the MSS manifest is read.
Automatic MSS
The EMS can be configured to automatically create an MSS stream for every new inbound stream. The details for the MSS creation are placed in the config.lua file instead of as parameters to the createMSSStream
API call.
autoMSS=
{
targetFolder= "/var/evo-webroot",
},
To enable automatic MSS a section in the config.lua
file needs to be enabled and modified. See configuration here.