Process

Starts ingesting and processing the specified media.

Type: asynchronous

Parameter Description Required
AdditionalData Additional files to upload. If your session configuration requires a file, such as a Lua script or XSL transform, that is not available on the Media Server file system, you can upload it with the process action. Files must be uploaded as multipart/form-data. For more information about sending data to Media Server, refer to the Media Server Administration Guide. No
AdditionalDataLabels A comma-separated list of labels to identify the files uploaded using the AdditionalData parameter. Specify a label for each file that you upload. You can use these labels in your session configuration instead of file paths. No
Config A session configuration to use (base64 encoded, unless you upload it as multipart form data). Set Config, ConfigName, or ConfigPath
ConfigName The name of a session configuration file to use, when the file is stored in the ConfigDirectory.
ConfigPath The path of a session configuration file to use.
Persist Specifies whether the action restarts in the event that processing stops for any reason. No
Source The media source to process. Set either Source or SourceData
SourceData The media file to process. Set either Source or SourceData
Synchronous Specifies whether to run the action synchronously. No
Timeout The maximum amount of time to spend processing. No

Example

The following example starts processing a file using a configuration named myconfig that exists in the ConfigDirectory on the Media Server machine.

/action=Process
             &ConfigName=myconfig
             &Source=/videoarchive/broadcast.mpeg

The following example demonstrates how to upload a configuration, source file, and an additional XSL file using the command-line tool cURL.

curl http://localhost:14000/action=Process
                            -F Config=@ocr.cfg
                            -F SourceData=@document.pdf
                            -F AdditionalData=@transform.xsl
                            -F AdditionalDataLabels=file1

Response

This action is asynchronous, so Media Server always returns success accompanied by a token. You can use this token with the QueueInfo action to retrieve the status of your request.

The following is an example response from action=QueueInfo&QueueAction=GetStatus&QueueName=process:

<autnresponse>
  <action>QUEUEINFO</action>
  <response>SUCCESS</response>
  <responsedata>
    <actions>
      <action owner="...">
        <status>Queued</status>
        <queued_time>2021-May-24 13:53:25</queued_time>
        <time_in_queue>89</time_in_queue>
        <priority>0</priority>
        <token>...</token>
      </action>
      <action owner="...">
        <status>Processing</status>
        <queued_time>2021-May-24 13:53:24</queued_time>
        <time_in_queue>72</time_in_queue>
        <process_start_time>2021-May-24 13:54:36</process_start_time>
        <time_processing>18</time_processing>
        <configname>object_class_recognition.cfg</configname>
        <configuration>...</configuration>
        <source>video2.mp4</source>
        <token>...</token>
      </action>
      <action>
        <status>Finished</status>
        <queued_time>2021-May-24 13:53:09</queued_time>
        <time_in_queue>1</time_in_queue>
        <process_start_time>2021-May-24 13:53:10</process_start_time>
        <time_processing>86</time_processing>
        <process_end_time>2021-May-24 13:54:36</process_end_time>
        <configname>examples/Face/Face.cfg</configname>
        <configuration>...</configuration>
        <output>
          ...
        </output>
        <source>video1.mp4</source>
        <statistics>
          ...
        </statistics>
        <token>...</token>
      </action>
    </actions>
  </responsedata>
</autnresponse>

In addition to the standard fields that are returned from the QueueInfo action, the response can include:

  • configname - identifies the session configuration used to process the media. This element can contain a path, a file name, or the value "Base64 data".
  • configuration - the contents of the session configuration.
  • source - the media source.
  • output - contains any records that were sent to a response output engine.
  • statistics - statistics generated by the engines used in the processing session. For example, an engine might report the number of records that were processed and the average amount of time required to process each record.