'''[wiki:WiMAX/WiMAX-Tutorial/Dash/02 Previous]'''

== Writing an OMF Application Wrapper ==


When an OML-enabled application is run using OMF, the application itself is installed on the resource and a simple [https://mytestbed.net/projects/omf/wiki/BasicTutorialStage3-5-2 OMF application wrapper] is installed on the console where the OMF Experiment Controller runs. This wrapper just gives some basic information about the application, the parameters that can be passed at the command line, and the OML measurement points that have been defined in the application:


{{{ 
#!ruby
defApplication('vlc-dash') do |app|
 
   app.path = "/usr/local/bin/vlc" 
   app.version(2, 1, 0)
   app.shortDescription = "VLC" 
   app.description = "VLC multimedia player and streamer" 
 

   app.defProperty("input", "Stream input (e.g. file or network address)", nil, 
                   {:type => :string, :dynamic => false, :use_name => false})
   app.defProperty("sout", "Stream output", "--sout", 
                   {:type => :string, :dynamic => false,}) 
   app.defProperty("intf", "Main interface module", "--intf",
                   {:type => :string, :dynamic => false})
   app.defProperty("extraintf", "Extra interface module(s). Use --extraintf omlstats to enable OML", "--extraintf",
                   {:type => :string, :dynamic => false})
   app.defProperty("mtu", "Specifies the MTU of the network interface", "--mtu",
                   {:type => :string, :dynamic => false})
   app.defProperty("quiet", " Deactivates all console messages", "--quiet",
                   {:type => :boolean, :dynamic => false})
   app.defProperty("play-and-exit", "Exit VLC after playing all the items in the input stream list", "--play-and-exit",
                   {:type => :boolean, :dynamic => false})
   app.defProperty("redirect", "Redirect stdout and stderr to /dev/null", " > /dev/null 2>&1", 
                   {:type => :boolean, :dynamic => false, :order => 100})

   app.defMeasurement('dashRateAdaptation') do |mp|
     mp.defMetric('chosenRate_bps',:int)
     mp.defMetric('empiricalRate_bps',:int)
     mp.defMetric('decisionRate_bps',:int)
     mp.defMetric('buffer_percent',:int)
   end

   app.defMeasurement('dashDlSession') do |mp|
     mp.defMetric('chunkCount',:int)
     mp.defMetric('readSession_B',:int)
     mp.defMetric('readChunk_B',:int)
     mp.defMetric('timeSession_s',:float)
     mp.defMetric('timeChunk_s',:float)
   end

end
}}}















'''[wiki:WiMAX/WiMAX-Tutorial/Dash/04 Next]'''