IngestRate

The rate at which Media Server ingests video.

You must use IngestRate=1 for streams and in most cases Micro Focus recommends IngestRate=0 for video files.

The parameter accepts the following values:

  • 1 - Media Server ingests video at normal (playback) speed. Assuming there are no external limitations such as network bandwidth, Media Server ingests one minute of video every minute. If an analysis task cannot process frames at this rate, it will analyze fewer frames.

  • 0 - The rate at which video is ingested is determined by the slowest analysis task that you have configured. Some analysis tasks are very fast, but some are slower and can analyze only one or two frames per second per thread. With IngestRate=0, the amount of time required to ingest a video file depends on the analysis tasks that you have configured and the resources available to Media Server.

    NOTE: Even with IngestRate=0, Media Server does not analyze every frame. The number of frames that are analyzed depends on the value of the configuration parameter SampleInterval, which you can configure for most analysis tasks. If you want to analyze every frame of a video file, you must set IngestRate=0 and then set SampleInterval=0 for all relevant analysis tasks. However, Micro Focus does not recommend processing every frame because in most cases this will take far longer and may not increase accuracy.

Options Default SampleInterval SampleInterval = 0
IngestRate=1

Micro Focus recommends using IngestRate=1 and the default sample intervals for processing live streams.

Media Server does not attempt to process every frame, but selects frames for analysis based on the specified sample interval. The default sample intervals should provide good accuracy in most cases. If necessary, Media Server will increase the sample interval to ensure that analysis occurs at normal (playback) speed.

If Media Server does not have sufficient resources, it will increase the sample interval, which might cause a reduction in accuracy.

Media Server attempts to analyze every frame, but frames are skipped if the analysis tasks you have configured cannot process the frames at normal (playback) speed.

Micro Focus does not recommend these settings because processing every frame is usually not necessary and Media Server is likely to skip large numbers of frames.

IngestRate=0

Micro Focus recommends IngestRate=0 and the default sample intervals for processing video from files.

Media Server does not attempt to process every frame, but selects frames for analysis based on the specified sample interval. The default sample intervals should provide good accuracy in most cases. If analysis is slow, Media Server ingests the file at a slower rate so that frames can be analyzed at the requested sample interval.

If Media Server does not have sufficient resources, it will take longer to process the file, but accuracy is maintained.

Ensures that all frames are analyzed.

Micro Focus does not recommend these settings because in most cases this will take much longer and might not increase accuracy.

Use this mode only if it is critical that every frame is analyzed.

Type: Number
Default: 1
Required: No
Configuration Section: Session
Example: IngestRate=0
See Also: