Einstellungen
Füge typisierte Presence-Einstellungen mit Boolean-, Eingabe-, Auswahl- und Slider-Steuerelementen hinzu.
Was Einstellungen Sind
Mit Einstellungen können Nutzer das Verhalten einer Presence anpassen, ohne Code zu bearbeiten.
Unterstützte Einstellungstypen
Nowly unterstützt Boolean-, Eingabe-, Auswahl- und Slider-Einstellungen.
| Feld | Typ | Beschreibung | Standard |
|---|---|---|---|
boolean | boolean | Umschalter für aktivierte/deaktivierte Optionen. | - |
input | string | Freier Textwert. | - |
select | string | Ein Wert, ausgewählt aus vordefinierten Optionen. | - |
slider | number | Numerischer Wert mit optionalem Min, Max und Schrittweite. | - |
Einstellungen Definieren
Verwende Presence.Settings, um typisierte Einstellungen zu definieren:
const settings = Presence.Settings({
showButtons: {
type: "boolean",
default: true,
label: {
"en-US": "Show buttons"
}
}
})Einstellungen Lesen
Verwende getSetting zur Laufzeit. Die Werte stammen aus den gespeicherten Einstellungen des Nutzers und fallen auf die Standardwerte aus Presence.Settings zurück. Live-Änderungen aus dem Seitenpanel kommen als SETTINGS_UPDATED an und aktualisieren dieselbe Map.
Du kannst die aktuelle Map auch aus ctx.settings in UpdateData lesen:
presence.on("UpdateData", async (ctx) => {
const showButtons = await presence.getSetting<boolean>("showButtons")
// gleicher Wert: ctx.settings.showButtons
})Lokalisierte Bezeichnungen
Einstellungsbezeichnungen und -beschreibungen verwenden dieselben Locale-Schlüssel wie die Metadaten.
Standardwerte
Wähle sichere Standardwerte. Eine Presence sollte direkt nach der Installation funktionieren, ohne dass eine Konfiguration erforderlich ist.