analyze_video_in_file

The function analyze_video_in_file performs video analysis on a file. If analysis is not successful, the function results in a Lua error.

Syntax

analyze_video_in_file(filename, params) 

Arguments

Argument Description
filename (string) The file to analyze.
params (table) A table of named parameters to configure video analysis. The table maps parameter names (String) to parameter values. For information about the parameters that you can set, see the following table. For information about how to use named parameters refer to the Connector Framework Server Administration Guide.

Named Parameters

Named Parameter Description Configuration Parameter
request_parameters (table) Additional parameters to pass to the Video Server process action.  
section (string) The name of a section in the CFS configuration file. If you set this then any parameters not set in the params table are read from this section of the configuration file.  
server (table) A table of additional named parameters that configure communication with Video Server. The table maps parameter names (String) to parameter values. For information about the parameters that you can set, see the following table.  
transform (string) The filename of an XSL transform. This is applied to the response from Video Server before the analysis results are returned. VideoAnalysisTransform

Video Server Settings

Named Parameter Description Configuration Parameter
section (string) The name of a section in the CFS configuration file. If you set this then any parameters not set in the server table are read from this section of the configuration file. If you do not set this parameter, the value of section from the params table is used.  
host (string) The host name of the machine running Video Server. VideoServerHost
port (Number) The Video Server ACI port. VideoServerHost
sslSection (string) The name of a section in the CFS configuration file that contains settings for communicating with Video Server over SSL. VideoServerSSLConfig
readFromOriginalLocation (Boolean) A Boolean that specifies whether Video Server can read the video file from its original location. If you set this parameter, sharedPath is ignored. ReadFromOriginalLocation
sharedPath (string) To transfer the video file to Video Server through a shared folder, set this parameter to the path of the folder. Both CFS and Video Server must have access to this folder. If you set readFromOriginalLocation, this parameter is ignored. VideoServerSharedPath

Examples

The following Lua script performs analysis on a file named video.mp4, using the settings in the [VideoServerSettings] section of the CFS configuration file.

   local result = analyze_video_in_file("video.mp4",
        { section="VideoServerSettings" });

The following example is similar, but overrides the XSL transform and Video Server host set in the CFS configuration file:

   local result = analyze_video_in_file("video.mp4",
        { section = "VideoServerSettings",
          transform = "transform.xsl",
          server = { host="localhost", port=14000 }
        });

_HP_HTML5_bannerTitle.htm