Compartilhar via


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

Object Model Reference for Scripting