Settings-Objekt

  • Artikel

[Das dieser Seite zugeordnete Feature Windows Medienwiedergabe SDK ist ein Legacyfeature. Es wurde von MediaPlayer ersetzt. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, nach Möglichkeit für neuen Code MediaPlayer anstelle von Windows Medienwiedergabe SDK zu verwenden. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Das Settings-Objekt bietet eine Möglichkeit, verschiedene Windows Medienwiedergabe Einstellungen mithilfe der folgenden Eigenschaften und Methoden zu ändern.

Das Settings-Objekt unterstützt die folgenden Eigenschaften.

Eigenschaft Beschreibung
AutoStart Gibt einen Wert an, der angibt, ob das aktuelle Medienelement automatisch abgespielt wird, oder ruft diesen ab.
Gleichgewicht Gibt die aktuelle Stereobilanz an oder ruft sie ab.
baseURL Gibt die Basis-URL an, die für die relative Pfadauflösung mit URL-Skriptbefehlen verwendet wird, die in Mediendateien eingebettet sind, oder ruft sie ab.
defaultAudioLanguage Ruft den Gebietsschemabezeichner (Locale Identifier, LCID) der in Windows Medienwiedergabe angegebenen Standardaudiosprache ab.
defaultFrame Gibt den Namen des Frames an, der zum Anzeigen einer URL verwendet wird, die in einem ScriptCommand-Ereignis empfangen wird, oder ruft diesen ab.
enableErrorDialogs Gibt einen Wert an oder ruft einen Wert ab, der angibt, ob Fehlerdialogfelder automatisch angezeigt werden.
invokeURLs Gibt einen Wert an, der angibt, ob URL-Ereignisse einen Webbrowser starten sollen, oder ruft sie ab.
Isavailable Ruft ab, ob ein angegebener Informationstyp verfügbar ist oder eine angegebene Aktion ausgeführt werden kann.
mediaAccessRights Ruft einen Wert ab, der die derzeit für den Bibliothekszugriff gewährten Rechte angibt.
Stumm Gibt einen Wert an, der angibt, ob Audio stummgeschaltet ist, oder ruft er ab.
playCount Gibt an oder ruft die Häufigkeit der Wiedergabe eines Medienelements ab.
Rate Gibt die aktuelle Wiedergaberate an oder ruft sie ab.
volume Gibt das aktuelle Volume an oder ruft es ab.

 

Das Settings-Objekt unterstützt die folgenden Methoden.

Methode Beschreibung
getMode Bestimmt, ob der Schleifenmodus oder shuffle-Modus aktiv ist.
requestMediaAccessRights Fordert eine angegebene Zugriffsebene auf die Bibliothek an.
setMode Legt den Schleifenmodus oder shuffle-Modus auf aktiv oder inaktiv fest.

 

Auf das Settings-Objekt wird über die folgende Eigenschaft zugegriffen.

Object Eigenschaft
Player settings

 

Siehe auch

Objektmodellreferenz für Skripterstellung