Settings.rate
[The feature associated with this page, Windows Media Player SDK, is a legacy feature. It has been superseded by MediaPlayer. MediaPlayer has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer instead of Windows Media Player SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The rate property specifies or retrieves the current playback rate of video media.
Syntax
player.settings.rate
Possible Values
This property is a read/write Number (double) with a default value of 1.0.
Remarks
This property acts as a multiplier value that allows you to play a clip at a faster or slower rate. The default value of 1.0 indicates the authored speed. Note that an audio track becomes difficult to understand at rates lower than 0.5 or higher than 1.5. A playback rate of 2 equates to twice the normal playback speed.
Windows Media Player will attempt to use the most effective of four different playback modes. These modes are smooth video playback with audio pitch maintained, smooth video playback with audio pitch not maintained, smooth video playback with no audio, and keyframe video playback with no audio. The mode chosen by the Player depends on numerous factors including file type and location, operating system, network, and server.
Other considerations apply as well, depending on media type:
- Windows Media Format (WMV) and ASF files: Optimal values for this property are from 1 to 10, or from 1 to 10 for reverse play. Values from 0.5 to 1.0 or from -0.5 to -1.0 may also work well in cases where audio pitch can be maintained, for example, when playing files located on the local computer. Values with an absolute magnitude greater than 10 are allowed, but are not very meaningful.
- Other Video Media Types: This property can range from 0 to 9. Negative values are not allowed. Values less than 1 represent slow motion. Values above 9 are allowed, but are not very meaningful.
The Controls.fastForward method changes the value of rate to 5.0, while the Controls.fastReverse method changes rate to 5.0.
The playback rate of some media types cannot be altered. Use the Settings.isAvailable method to determine whether this property can be specified for a particular media item.
Windows Media Player 10 Mobile: This property only accepts or returns values of -5.0, 1.0, or 5.0.
Examples
The following example creates an HTML SELECT element that allows the user to change the playback speed of the current media. The SELECT options offer normal speed, half -speed and double-speed playback rates. The Player object was created with ID = "Player".
<!-- Create the HTML SELECT element. -->
<SELECT ID = pbRATE NAME = "pbRATE" LANGUAGE="JScript"
onChange="
/* Test whether playback rate can be set. */
if(Player.settings.IsAvailable('Rate'))
/* Set the playback rate based on the current
value of the SELECT element. */
Player.settings.rate = this.value
">
/* Create the OPTION list. */
<OPTION VALUE = 1>NORMAL</OPTION>
<OPTION VALUE = .5>half speed</OPTION>
<OPTION VALUE = 2>2 speed</OPTION>
</SELECT>
Requirements
| Requirement | Value |
|---|---|
| Version |
Windows Media Player version 7.0 or later. |
| DLL |
|