setRepeat Method

Sets a new repeating specification for this item.

The “timingType” parameter indicates which type of repeat timing is to be used. It must be one of the following values:

  • REPEAT_TIMING_PARALLEL
  • REPEAT_TIMING_SERIAL

The “repeatType” parameter indicates what sort of value is contained in the “control” parameter. Currently the “repeatType” parameter must always be set to “REPEAT_TYPE_COUNT_CONSTANT”.

The “control” parameter is the count of the number of repeats to be performed. If the value is less than or equal to zero, the item will not be played at all.

The “distributionType” parameter indicates what sort of value is contained in the “distribution” parameter. Currently the “distributionType” parameter must always be set to “REPEAT_DISTRIBUTION_CONSTANT”.

The “distribution” parameter is a time length, in milliseconds, by which the start of each repeat is to be offset from the start of the prior repeat. This value only applies to parallel repeats, and must be set to zero for serial repeats.