Settings Object
[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 Settings object provides a way to modify various Windows Media Player settings by using the following properties and methods.
The Settings object supports the following properties.
| Property | Description |
|---|---|
| autoStart | Specifies or retrieves a value indicating whether the current media item begins playing automatically. |
| balance | Specifies or retrieves the current stereo balance. |
| baseURL | Specifies or retrieves the base URL used for relative path resolution with URL script commands that are embedded in media files. |
| defaultAudioLanguage | Retrieves the locale identifier (LCID) of the default audio language specified in Windows Media Player. |
| defaultFrame | Specifies or retrieves the name of the frame used to display a URL that is received in a ScriptCommand event. |
| enableErrorDialogs | Specifies or retrieves a value indicating whether error dialog boxes are shown automatically. |
| invokeURLs | Specifies or retrieves a value indicating whether URL events should launch a Web browser. |
| isAvailable | Retrieves whether a specified type of information is available or a specified action can be performed. |
| mediaAccessRights | Retrieves a value indicating the rights currently granted for library access. |
| mute | Specifies or retrieves a value indicating whether audio is muted. |
| playCount | Specifies or retrieves the number of times a media item will play. |
| rate | Specifies or retrieves the current playback rate. |
| volume | Specifies or retrieves the current volume. |
The Settings object supports the following methods.
| Method | Description |
|---|---|
| getMode | Determines whether the loop mode or shuffle mode is active. |
| requestMediaAccessRights | Requests a specified level of access to the library. |
| setMode | Sets the loop mode or shuffle mode to active or inactive. |
The Settings object is accessed through the following property.
| Object | Property |
|---|---|
| Player | settings |
See also