Settings 对象

[与此页面关联的功能（Windows 媒体播放器 SDK）是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 如果可能，Microsoft 强烈建议新代码使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

Settings 对象提供了一种使用以下属性和方法修改各种Windows 媒体播放器设置的方法。

Settings 对象支持以下属性。

属性	说明
autoStart	指定或检索一个值，该值指示当前媒体项是否自动开始播放。
平衡	指定或检索当前立体声平衡。
baseURL	使用嵌入在媒体文件中的 URL 脚本命令指定或检索用于相对路径解析的基 URL。
defaultAudioLanguage	检索Windows 媒体播放器中指定的默认音频语言的区域设置标识符 (LCID) 。
defaultFrame	指定或检索用于显示 ScriptCommand 事件中收到的 URL 的帧的名称。
enableErrorDialogs	指定或检索一个值，该值指示是否自动显示错误对话框。
invokeURLs	指定或检索一个值，该值指示 URL 事件是否应启动 Web 浏览器。
isAvailable	检索指定类型的信息是否可用或可以执行指定的操作。
mediaAccessRights	检索一个值，该值指示当前授予库访问权限的权限。
静音	指定或检索一个值，该值指示音频是否静音。
playCount	指定或检索媒体项将播放的次数。
率	指定或检索当前播放速率。
volume	指定或检索当前卷。

 

Settings 对象支持以下方法。

方法	说明
getMode	确定循环模式还是随机模式处于活动状态。
requestMediaAccessRights	请求对库的指定访问级别。
setMode	将循环模式或随机模式设置为活动模式或非活动模式。

 

通过以下属性访问 Settings 对象。

Object	属性
播放器	设置

 

另请参阅

脚本的对象模型参考