Media Server 25.1
Media Server Help

# IngestRate

The rate at which Media Server ingests video.

You must use `IngestRate=1` for streams and in most cases OpenText 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, OpenText 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 | OpenText 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. OpenText 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 | OpenText 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. OpenText 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: |

Copyright 2024 Open Text
Version 25.1 | Last updated January 2025

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: Knowledge Discovery Media Server 25.1

Topic Title: IngestRate