Ustawienia
Dodaj typowane ustawienia dla poszczególnych obecności z kontrolkami boolean, input, select i slider.
Czym są ustawienia
Ustawienia pozwalają użytkownikom dostosować działanie obecności bez edytowania kodu.
Obsługiwane typy ustawień
Nowly obsługuje ustawienia typu boolean, input, select i slider.
| Pole | Typ | Opis | Domyślny |
|---|---|---|---|
boolean | boolean | Przełącznik dla opcji włączonych/wyłączonych. | - |
input | string | Dowolna wartość tekstowa. | - |
select | string | Jedna wartość wybrana spośród predefiniowanych opcji. | - |
slider | number | Wartość liczbowa z opcjonalnym min, max i krokiem. | - |
Definiowanie ustawień
Użyj Presence.Settings, aby zdefiniować typowane ustawienia:
const settings = Presence.Settings({
showButtons: {
type: "boolean",
default: true,
label: {
"en-US": "Show buttons"
}
}
})Odczytywanie ustawień
Użyj getSetting w czasie wykonywania. Wartości pochodzą z zapisanych ustawień użytkownika, z powrotem do wartości domyślnych z Presence.Settings. Zmiany na żywo z panelu bocznego docierają jako SETTINGS_UPDATED i aktualizują tę samą mapę.
Możesz też odczytać bieżącą mapę z ctx.settings w UpdateData:
presence.on("UpdateData", async (ctx) => {
const showButtons = await presence.getSetting<boolean>("showButtons")
// ta sama wartość: ctx.settings.showButtons
})Zlokalizowane etykiety
Etykiety i opisy ustawień używają tych samych kluczy locale, co metadane.
Wartości domyślne
Wybieraj bezpieczne wartości domyślne. Obecność powinna działać od razu po instalacji, bez konieczności konfiguracji.