Eigene Zifferblätter - Referenzdokument

Diese Seite ist für Designer neuer Zifferblättern gedacht. Es listet alle verfügbaren Schlüsselbegriffe und Funktionen auf, die für das Erstellen oder Animieren von neuen Zifferblättern genutzt werden können.

• Die neuen Funktionalitäten und Keys des Custom Watchface V2 (Wear apk 3.3.0 oder neuer) sind hier zu finden

„Custom Watchface“-Format

„Custom Watchface“ ist ein offenes Format, das für AAPS entwickelt wurde und mit dem neuen „AAPS (Custom)“-Zifferblatt verknüpft ist.

Die Zifferblatt-Datei ist eine einfache Zip-Datei. Damit sie auch als Zifferblatt erkannt werden kann, muss sie die folgenden Dateien enthalten:

• Eine Bilddatei mit dem Namen „CustomWatchface“ (zulässige Bitmap-formate sind CustomWatchface.jpg, CustomWatchface.png oder ein Vektor CustomWatchface.svg). Diese Datei wird als Icon in der Zifferblatt-Auswahl angezeigt, wenn Du auf „Watchface laden“ klickst. Das Bild wird auch auf den Buttons im WEAR-Tab angezeigt.

• Eine Datei mit dem Namen CustomWatchface.json (siehe JSON-Struktur unten). Diese zweite Datei ist die Schlüsseldatei, die alle Informationen enthält, die für das Design des Zifferblattes bestimmt. Diese json-Datei muss gültig sein (das ist wahrscheinlich der schwierigste Punkt, wenn Du diese Datei von Hand in einem Texteditor bearbeitest, weil bereits ein fehlendes oder zusätzliches Komma ausreicht, um das json-Format zu zerstören). This JSON file must also include a "metadata" block with a "name" key with not empty value. Dies wird später der Zifferblatt-Name sein (siehe Metadaten Einstellungen unten)

• Die ZIP-Datei sollte so klein wie möglich (kleiner als 500 KB) sein. Eine zu große Datei wird geblockt und nicht an die Smartwatch übertragen.

Die ZIP-Datei kann auch einige zusätzliche Ressourcen-Dateien enthalten:

• Hardcodierte Dateinamen für Bilder, die in Standardansichten der Smartwatch verwendet werden (wie Background, CoverChart …) findest Du in der Liste der hartkodierten Ressourcen-Dateien unten. Gültige Dateiformate sind: jpg, png oder svg. Für die meisten wirst Du png oder svg, die mit Transparenz umgehen können, nutzen müssen. (jpg sind kleiner als png, können aber keine Transparenz darstellen). Hinweis: Das beste Verhältnis zwischen Qualität und Dateigröße bietet das Vektorformat (svg-Dateien).

• Additional resource files with free names. Diese zusätzlichen Dateien können entweder Bilddateien oder Schriftarten sein (ttf und otf Formate werden für Schriftarten akzeptiert). Beachte bitte, dass für diese zusätzlichen Dateien Dateiname (ohne die Erweiterung) als Schlüsselwert innerhalb der JSON-Datei verwendet wird, um festzulegen, wo oder wann diese Dateien verwendet werden sollen.

  • Bilddateien werden häufig als Hintergrund für Textansichten oder für dynamische Animationen (wie zum Beispiel den Akkustand zwischen 0% und 100%) eingesetzt

  • Schriftarten-Dateien ermöglichen Dir eigene Schriftarten innerhalb Deines Zifferblattes zu nutzen

JSON-Struktur

JSON files can be edited in Notepad (or notepad++) text editor (prefer notepad++ that recognize JSON and use color formatting)

• Es enthält String Keys "string_key": und Schlüsselwerte, die Strings wie "key value", integer, boolean wie trueoder false oder Datenblöcke sein können.

• each value is separated by a comma ,

• Ein Datenblock beginnt mit { und endet mit }

• the json file is a whole block so it starts by { and ends by }, and inside this file all embedded blocks are associated to a "key" that should be unique within the block

• To improve readability of json file, it’s generally indented (each new key is on a new line, each new block is shifted on the right by 4 spaces characters)

Metadaten-Einstellungen

Dieser Block ist der erste und verpflichtende Block, der in der JSON-Datei enthalten ist. It contains all the information associated to this watchface, like the name, the author, the date of creation or update, the author version or the plugin version.

Ein Beispiel des Metadatenblocks:

"metadata": {
    "name": "Default Watchface",
    "author": "myName",
    "created_at": "07\/10\/2023",
    "author_version": "1.0",
    "cwf_version": "1.0",
    "comment": "Default watchface, you can click on EXPORT WATCHFACE button to generate a template"
},

Beachte, dass / für das Datum ein Sonderzeichen ist. Damit es in der JSON Datei richtig erkannt wird, muss davor ein „escape“-Zeichen \ gesetzt werden.

Einige JSON-Dateien enthälten den zusätzlichen Schlüssel "filename". Dieser Schlüssel wird automatisch erzeugt und aktualisiert, wenn das Zifferblatt in AAPS geladen wird. Er wird für den Dateinamen der ZIP-Datei im „Exports“-Orndner benötigt. Du kannst diesen Schlüsselö also aus dem Metadatenblock löschen.

Allgemeine Parameter-Einstellungen

Nach dem ersten Block mit Metadaten, werden einige allgemeine Parameter gesetzt (siehe ListederallgemeinenParameter unten). Damit kannst Du die Farben der Graphen (Kohlenhydrate, Bolus, Glukosewerte …), und auch die Standardfarben für Werte im Zielbereich, Hyper oder Hypo (Standardfarben für den Glukosewert und die Trendpfeile) setzen.

Ein Beispiel für allgemeine Parameter:

"highColor": "#FFFF00",
"midColor": "#00FF00",
"lowColor": "#FF0000",
"lowBatColor": "#E53935",
"carbColor": "#FB8C00",
"basalBackgroundColor": "#0000FF",
"basalCenterColor": "#64B5F6",
"gridColor": "#FFFFFF",
"pointSize": 2,
"enableSecond": true,

ImageView-Einstellungen

Ein benutzerdefiniertes Bild kannmit dem richtigen Dateinamen, der jedem ImageView zugeordnet ist, und in das benutzerdefinierte Zifferblatt-Layout aufgenommen wurde, angepasst werden. Dann dient der JSON-Block nur dazu, die Position, die Größe, und die sichtbarkeit zu definieren und optional die Farbe anzupassen:

Hier ist ein Beispiel eines Image-Blocks für second_hand, (in diesem Fall ist keine Bilddatei in der ZIP-Datei enthalten, sodass das Default second hand Bild genutzt (jedoch farblich angepasst) wird.

"second_hand": {
    "width": 400,
    "height": 400,
    "topmargin": 0,
    "leftmargin": 0,
    "visibility": "visible",
    "color": "#BC906A"
}

Um das „second_hand“ Bild mit einer Standardfarbe einzufärben (lowRange, midRange oder highRange), muss die unterste Zeile mit dem Schlüsselwert bgColor geändert werden.

    "color": "bgColor"

TextView-Einstellungen

TexView hat mehr Parameter ImageView: Du kannst die Rotation (ganze Zahl in Grad) verändern, Textgröße (textsize: ganze Zahl in Pixel), Gravity (um festzulegen, ob der Textwert zentriert wird (Standardwert) oder links oder rechts ausgerichtet ist), die Schriftart, FontStyle und FontColor, sowie die Hintergrundfarbe der Textansicht festlegen

"basalRate": {
    "width": 91,
    "height": 32,
    "topmargin": 133,
    "leftmargin": 249,
    "rotation": 0,
    "visibility": "visible",
    "textsize": 23,
    "gravity": "center",
    "font": "default",
    "fontStyle": "bold",
    "fontColor": "#BDBDBD"
},

Beachte bitte, dass wenn Du nicht möchtest, dass eine Ansicht innerhalb Deines Zifferblatts verwaltet wird, Du den Key "visibility" auf "gone" und auch die Größe und Position außerhalb des sichtbaren Bereichs setzt, so wie es hier gezeigt wird:

"second": {
    "width": 0,
    "height": 0,
    "topmargin": 0,
    "leftmargin": 0,
    "rotation": 0,
    "visibility": "gone",
    "textsize": 46,
    "gravity": "center",
    "font": "default",
    "fontStyle": "bold",
    "fontColor": "#BDBDBD"
},

Wenn Größe und Position innerhalb des sichtbaren Bereichs liegen, kannst Du beim Aktualisieren des Zifferblatts einen kurzes „Blitzlicht“ des versteckten Werts erhalten.

Wenn Du das Hintergrundbild eines Textfelds anpassen möchtest, kannst Du dazu den Key "background": verwenden und den Dateinamen des Bildes, das in der Zip-Datei enthalten ist, als Schlüsselwert angeben. Alternativ kannst Du auch einfach die Hintergrundfarbe mit dem Key "color:" ändern.

"background": "fileName"

Du hast auch 4 spezifische textViews (freetext1 bis freetext4) zur Verfügung, die einen besonderen Parameter "textvalue": haben, der z.B. auch für ein Label verwendet werden kann.

ChartView-Einstellungen

ChartView ist eine sehr spezifische Ansicht, die sich einige Parameter mit ImageView oder mit TextView teilen kann…

Die Standardeinstellungen für diese Ansicht sind sehr einfach:

"chart": {
    "width": 400,
    "height": 170,
    "topmargin": 230,
    "leftmargin": 0,
    "visibility": "visible"
},

Zwei zusätzliche Parameter, die Du für die Diagrammansicht (ChartView) hinzufügen kannst, sind die Hintergrundfarbe (Key "color") und das Hintergrundbild (Key "background"). Die Standardhintergrundfarbe ist ‚transparent‘.

Wie Du Dein erstes Zifferblatt entwirfst/erstellst

Benötigte Werkzeuge

• Text editor: My advice is to use NotePad++ (or equivalent) that is a simple text editor, but added value is you can see formatted text with color code, so it’s easier to detect errors. any simple text editor will do the job. Since the purpose is to tune json information.

• Bildeditor (Bitmap und/oder Vektor)

  • Wenn Du Bitmaps verwendest

    • Der Bildeditor sollte in der Lage sein, mit Transparenz (erforderlich für alle Bilder über dem Hintergrund) und dem png-Format (wenn Du ein Bitmap-Bild verwendet hast) umzugehen

    • Das Hintergrundbild kann im jpg-Format sein (kleiner als png)

    • Image editor should allow you to measure in pixel graphical objects (can be a simple square) (top, left, width, height)

    • Der Bildeditor sollte Farben mit dem RRVVBB-Code in Hexadezimal anzeigen können

    • Der Bildeditor sollte Bilder auf 400px x 400px (eine der wichtigsten Auflösungen) verkleinern können

  • Wenn Du Vektoren verwendest

    • Die Vektorgrafik sollte im svg-Format exportiert werden

Vorlagen nutzen, um nicht bei Null starten zu müssen

Wenn Du Dein erstes Zifferblatt entwerfen möchtest, startest Du am besten mit dem Standard-Zifferblatt, da Du damit automatisch die neueste Version mit allen verfügbaren und korrekt sortierten Ansichten zur Verfügung hast

• Du bekommst die Zip-Datei, indem Du im Wear-Plugin auf „Export Template“ tippst. Die Zip-Datei wird damit erstellt und ist dann im AAPS/exports-Ordner verfügbar

• Die Schaltflächen für benutzerdefinierte Zifferblätter (custom watchfaces) sind nur dann verfügbar, wenn AAPS mit einer Smartwatch verbunden ist. Eine verbundene Smartwatch ist allerdings auch notwendig, um Deine selbst erstellten Zifferblätter zu prüfen, zu testen und zu verbessern

Das Standard-Zifferblatt ist sehr einfach gehalten und die Zip-Datei enthält nur die 2 Dateien:

• CustomWatchface.png (Das Bild des Standard-Zifferblatts, das in der Zifferblatt-Auswahl angezeigt wird)

• CustomWatchface.json

Organisiere Deine Dateien auf Deinem Computer

Am einfachsten ist es das Smartphone mit dem Computer zu verbinden und mit bestimmten Ordnern zu arbeiten:

• In einem Datei-Explorer-Fenster, wird der Ordner angezeigt, der alle Dateien (JSON, Bitmap-Bilder, Vektorgrafiken, Schriftarten) und die Datei „CustomWatchface.zip“ enthält

• In einem weiteren Datei-Explorer-Fenster wird der Ordner /AAPS/exports Deines verbundenen Smartphones angezeigt

Das vereinfacht das Arbeiten erheblich: Bei jeder Änderung mit dem Texteditor an der JSON-Datei und/oder der Änderung des Bildes mit einem Bildeditor (Bitmap oder Vektor) musst Du lediglich:

1. die Änderung in der jeweiligen App speichern

2. alle Dateien innerhalb der CustomWatchface.zip Datei herüberziehen (Drag & Drop)

3. die Datei CustomWatchface.zip in den Ordner AAPS/exports des Smartphones herüberziehen (Drag & Drop)

4. CustomWatchface an die Smartwatch übertragen, um das Ergebnis zu prüfen

Die Zifferblatt-Anpassung beginnen

First step you will have to define a watchface Name (necessary to select it easily for testing), and start to tune metadata keys at the beginning of json file

Dann musst Du festlegen, welche Informationen angezeigt werden sollen, d. h. Du definierst welche Ansicht sichtbar sein soll und welche ausgeblendet werden soll.

• Soll ein Sekundenzeiger genutzt werden?

• Möchtest Du eine Digital-Uhr oder eine analoge Uhr (oder beides) entwerfen?

Nun kannst Du damit beginnen den "visibility": Key der einzelnen Ansichten festzulegen, indem Du ihnen entweder den Wert "visible" oder "gone" (je nachdem, ob Du die Ansicht behalten möchtest oder nicht) zuweist

You can also start to tune approximativaly top, left margin and width height values to start organizing the watchface (these values will be tuned later using image editor)

Hinweis: Alles innerhalb eines 400px x 400px Rechtecks kann gestaltet werden. Alle Angaben sind absolute Koordinaten innerhalb dieses Bereichs.

Wenn Du Dein erstes Zifferblatt entwirfst ist es wichtig zu wissen, dass alles in Schichten (layer) beginnend von hinten nach vorne aufgebaut ist. Jede Ansicht (ImageView oder TextView) kann etwas Dahinterliegendes verdecken…

Innerhalb der JSON-Datei werden dann alle Ansichten von hinten nach vorne sortiert (das hilft Dir zu erkennen, was hinter wem verborgen ist)

Wenn Du Dein erstes benutzerdefiniertes Zifferblatt entwirfst oder anpasst, beginne mit einfachen Dingen: ändere die Sichtbarkeit einiger Ansichten, füge ein dediziertes Hintergrundbild, ohne die JSON-Datei zu ändern, hinzu…

Farben verwalten

Innerhalb der JSON-Datei hast Du mehrere Schlüssel (Keys), um die Farben festzulegen: "color", "fontColor" für Ansichten, aber auch "highColor", "midColor", "lowColor", … (vgl. Liste allgemeiner Parameter)

Farben werden mit einem Textfeld angegeben, das mit # beginnt, gefolgt von RRGGBB (Rot, Grün, Blau) Werten im hexadezimalen Format:

• "#FFFFFF" ist weiß, und "#000000" ist schwarz, "#FF0000" ist rot…

Du kannst auch 2 zusätzliche Werte für den Alphakanal und eine Transparenzstufe angeben (AARRGGBB):

• "#00000000"is completely transparent, and "#FF000000" is completely opaque ( so "#FF000000" is equivalent to "#000000")

Du kannst auch den spezifischen Schlüsselwert (keyvalue) "bgColor" verwenden, um damit automatisch die dem jeweiligen Glukosewert zugeordneten Farben für "highColor", "midColor", "lowColor", die in in den allgemeinen Parametern festgelegt sind, zu nutzen:

• "fontColor": "bgColor", wird automatisch die Schriftfarbe der Ansicht (fontColor) auf die des zugeordneten Glukosewertes (bgColor) anpassen

• Beachte, dass sgv (für die Glukosewert-Ansicht) und direction (für die Trendpfei-Ansicht automatisch die Glukosewert-Farben verwenden, die in den allgemeinen Parametern festgelegt sind (für diese beiden Ansichten). Wenn Du unterschiedliche Farben haben möchtest, musst Du die erweiterte dynData-Funktion mit einer One-Step-Farbe verwenden…)

Um mehr über ImageViews und die "color":-Schlüssel zu erfahren, kannst Du unten das eigene Kapitel Farbe des Bildes anpassen lesen.

Hardcodierte Bilder einbinden

Der einfachste Weg Dein Zifferblatt anzupassen ist, einige Bilder mit spezifischen Namen in die Zip-Datei aufzunehmen (siehe Liste der fest codierten Ressourcendateien)

• Das Bild sollte das .jpg, .png oder .svg-Format haben. but be careful, jpg doesn’t manage transparency, so should be only used for background layer. For all intermediate layers (cover_chart, cover_plate, hands) use either .pngor .svg image

• Wenn einen Vektorbildeditor hast (wie zum Beispiel „Illustrator“), bevorzuge ein Format, das kleine Textdateien mit der .svg-Erweiterung und bester Qualität erzeugt.

• Du solltest darauf achten, den genauen Dateinamen zu verwenden (einschließlich Groß-/Kleinschreibung)

Wenn Du jetzt ein spezielles Hintergrundbild haben möchtest, musst Du nur eine Datei mit dem Namen Background.jpg in die Zip-Datei aufnehmen (ohne sonst etwas zu ändern). Sende die Zip-Datei an die Smartwatch und überprüfe das Ergebnis!.

Wenn Du den Stundenzeiger (hour_hand), Minutenzeiger (minute_hand) oder den Sekundenzeiger (second_hand) einer analogen Uhr anpassen möchtest, füge einfach HourHand.png (oder HourHand.svg), MinuteHand.png und SecondHand.png hinzu.

• Diese Bilder werden automatisch um das Zentrum des Bildes rotieren, daher sollten die Bilder auf 00:00:00 eingestellt werden (und für eine „Vollbild“-Analoguhr verwende eine Größe von 400 x 400 px, positioniert oben 0 links 0)

Innerhalb der Liste der fest codierten Ressourcendateien gibt es für jede Bildansicht zwei zusätzliche fest codierte Dateinamen High und Low (zum Beispiel kannst Du andere Bilder mit den Dateinamen BackgroundHigh.jpg und BackgroundLow.jpg zum Zip-Ordner hinzufügen). Das Bild wird dann automatisch passend zu Deinem Glukosewert geändert (im Zielbereich, Hyper oder Hypo). Schau Dir das AIMICO-Zifferblatt als Beispiel an.

Bildfarbe anpassen

Der "color"-Schlüssel kann verwendet werden, um die Standardbildfarbe anzupassen:

• Angewendet auf die Hintergrundansicht wird damit die Hintergrundfarbe eingestellt (Standardmäßig schwarz)

• Angewendet auf die cover_plate (einfaches Zifferblatt) oder die Zeiger ändert es das Standardbild (weiß) durch die angegebene Farbe (einschließlich "bgColor")

When you apply "color" key on a bitmap image (.jpg or .png), color will apply an interesting effect on color saturation. Du wirst Dein Bitmap immer noch erkennen.

Der color-Schlüssel wird auf Bilddateien im .svg-Format keine Wirkung haben, nimm an die Farbe der Vektor-Dateien sei fest codiert. Wenn Du die Farben ändern möchtest, musst Du mehrere svg-Dateien einbinden und die dynData-Funktion verwenden, um sie zu ändern

Zusätzliche Schriftarten für TextViews verwenden

Mehrere Standardschriftarten sind bereits in der Wear-App verfügbar (siehe font-Keys im Kapitel Schlüsselwerte). But if you want to use additional fonts not available as default, you can include additional fonts within zip file:

• Die beiden zulässigen Font-Formate sind .ttf und .otf

• Wenn Du eine eigene Schriftart in der Zip-Datei aufnimmst, zum Beispiel eine Datei mit dem Namen myCustomFont.ttf, dann muß genau dieser Dateinamen genutzt werden, um sie in der JSON-Datei für einen TextView zu verwenden:

"font": "myCustomFont",

Habe im Hinterkopf, dass einige Schriftarten in große Dateien eingebunden sein können (und es eine Größenbeschränkung für die Zip-Datei gibt). Wenn Du also nur wenige Buchstaben nutzt (Zahlen, ., ,), kannst Du auch frei verfügbare Tools (z. B. hier) nutzen, um die überflüssigen Buchstaben zu löschen und so die Größe der Fonts zu reduzieren.

Erweiterte Funktionen

Voreinstellungen

CustomWatchface kann einige Voreinstellungen der Uhren automatisch anpassen, um die korrekte Darstellung des Zifferblatts zu ermöglichen (sofern vom Benutzer innerhalb der Wear-Einstellungen autorisiert).

Diese Funktion sollte aber mit Vorsicht verwendet werden. Voreinstellungen werden mit allen anderen Zifferblättern geteilt. Es gibt also einige Regeln bei dieser Funktion zu beachten:

• Lege niemals Einstellungen, die sich auf versteckte Ansichten (hidden views) beziehen, fest

• Versuche die sichtbaren Ansichten zu maximieren

• Stelle die Breite bestimmter Ansichten übergroß dar (oversize):

  • TBR can be shown as percentage (small width, but also as absolute values much wider)

  • delta oder avg delta mit detaillierten Informationen können sehr breit sein

  • Das Gleiche gilt für iob2: Diese Ansicht kann einen Gesamt-IOB haben, aber wenn ein detailliertes IOB ausgewählt ist, kann die Textgröße sehr lang sein

Wenn Du immer noch einige sehr spezifische Einstellungen für eine korrekte Anzeige zu erreichen benötigen solltest (im Beispiel unten, wenn nicht genügend Platz für detaillierte IOB vorhanden ist), kannst Du diesen Parameter auf Deiner Uhr auf false „zwingen“. Einige Einstellungen kannst Du als Beschränkung in den Metadaten-Block wie folgt aufnehmen

Wenn der Nutzer es zulässt, das das benutzerdefinierte Zifferblatt die Parameter der Smartwatch ändern darf (eine Einstellung im Wear-Plugin), dann wird „Show detailed iob“ auf „disable“ gesetzt, und für eine Deaktivierung gesperrt (keine Änderung des Paramters möglich, bis dass die Autorisierung im Wear-Plugin-Parameter deaktiviert wird oder ein anderes Zifferblatt ausgewäht wird)

• Beachte, dass wenn ein Benutzer ein Zifferblatt auswählt, er die Anzahl der „benötigten Parameter“ während der Zifferblattauswahl sehen kann

Im untenstehenden Beispiel hat das Gota-Zifferblatt einen erforderlichen Parameter. Wenn keine Autorisierung vorliegt, wird es in weißer Farbe angezeigt. Wenn aber eine Autorisierung vorliegen sollte, wird dieser Parameter fest gesetzt und auf der Uhr gesperrt (in diesem Fall ist die Zahl in orangener Farbe)

TwinView-Funktion

Zwillingsansichten (Twin Views) bieten eine einfache Möglichkeit, die Ansichtsposition basierend auf den sichtbaren Ansichten anzupassen. Dies hat nicht die Kraft eines vollständig aus LinearLayout bestehenden Layouts, kann jedoch viele gängige Fälle verarbeiten.

Im Beispiel unten siehst Du das AAPS (Cockpit)-Zifferblatt mit allen Ansichten in den Einstellungen, und das gleiche Zifferblatt mit deaktiviertem „Show rig battery“ und deaktiviertem „Show avg delta“

Du erkennst, dass wenn eine der beiden Ansichten versteckt ist, die andere Ansicht in die Mitte verschoben wird

Im Beispiel siehst Du innerhalb des "uploader_battery"-Blocks der "twinView":-Schlüssel hinzugefügt ist, um die "rig_battery"-Ansicht zu definieren. Im "rig_battery"-Block definiert der "twinView":-Schlüssel die Ansicht "uploader_battery" als Zwilling. Der zusätzliche Schlüssel "leftOffsetTwinHidden": definiert dann die Anzahl der Pixel, um die die Ansicht verschiebt, wenn der Zwilling verborgen wird.

Um diese Zahl zu ermitteln: Die Differenz zwischen der leftMargin jeder der beiden Ansichten beträgt 50 Pixel. Daher beträgt der Versatz, um zentriert zu bleiben, die Hälfte in die eine oder andere Richtung.

Wenn die Zwillings-Ansichten vertikal positioniert sind, musst Du den Schlüssel "topOffsetTwinHidden": verwenden.

"uploader_battery": {
    "width": 49,
    "height": 30,
    "topmargin": 354,
    "leftmargin": 150,
    "rotation": 0,
    "visibility": "visible",
    "textsize": 23,
    "gravity": "center",
    "font": "roboto_condensed_bold",
    "fontStyle": "bold",
    "fontColor": "#FFFFFF",
    "twinView": "rig_battery",
    "leftOffsetTwinHidden": 25
},
"rig_battery": {
    "width": 49,
    "height": 30,
    "topmargin": 354,
    "leftmargin": 200,
    "rotation": 0,
    "visibility": "visible",
    "textsize": 23,
    "gravity": "center",
    "font": "roboto_condensed_bold",
    "fontStyle": "bold",
    "fontColor": "#FFFFFF",
    "twinView": "uploader_battery",
    "leftOffsetTwinHidden": -25
},

DynDaten-Funktion

DynData is the most powerful feature if you want to include some animation within you watchface, according to some internal values (like BG value, BG level, delta, % of battery… see list of available data here)

Um diese Funktion zu veranschaulichen, nehme ich das Beispiel des AAPS (SteamPunk) Zifferblatts:

In diesem Zifferblatt müssen wir die Rotation des Glukosewerts (von 30 Grad bis 330 Grad) auf der rechten Seite managen, den Dynamikbereich von avg_delta (Skala bis zu 5 mgdl, 10 mgdl oder 20 mgdl je nach Wert), die Rotation des Zeigers, die mit der Skala synchronisiert werden sollte, sowie die verschiedenen Ebenen der Ansichten…

Um dieses Zifferblatt managen zu können, schau Dir die Bilder unten, die in der ZIP-Datei enthalten sind, an:

Hinweis: Um Transparenz sehen zu können, sind alle diese Bilder auf einem gelben Hintergrund und von einem roten Quadrat umgeben

• In der ersten Zeile werden Background.jpg und CoverPlate.png automatisch mit der zugeordneten Ansicht (Dateiname der Standardansicht) verknüpft, und steampunk_pointer.png wird von dynData gesteuert

• In der zweiten Zeile siehst Du die drei Skalen des Dynamikbereichs für avg_delta, die ebenfalls von dynData gesteuert werden

• In der dritten Reihe wird chartBackground.jpg manuell mit der Diagrammansicht verknüpft, während die Dateien HourHand.png und MinuteHand.png automatisch mit den zugehörigen Ansichten verbunden werden

Hintergrund-Management

First, concerning BG value image, no choice here, it can only be in the background layer (otherwise it will be in front of the chart view and chart will not be visible!). Also müssen wir den Glukosewert auf den Hintergrund abbilden und dann das Hintergrundbild entsprechend dem Glukosewert drehen.

Innerhalb des "background"-Blocks werden wir 2 dedizierte Schlüssel einfügen, um diese Rotation durchzuführen:

"background": {
    "width": 400,
    "height": 400,
    "topmargin": 0,
    "leftmargin": 0,
    "dynData": "rotateSgv",
    "rotationOffset": true,
    "visibility": "visible"
},

"dynData": key will define which block should be used to define the animation (value, range, conversion…) here this block was named „rotateSgv“ (choose an explicit name when you use this feature),

"rotationOffset": true, wird festlegen, dass die Animation entsprechend dem Wert rotieren sollte. (andere verfügbare Schlüssel sind "leftOffset" und "topOffset", wenn Du einen Schieberegler (Slider) erstellen möchtest)

Jetzt gehen wir ans Ende der Datei, unter die letzte Ansicht:

"second_hand": {
    "width": 120,
    "height": 120,
    "topmargin": 140,
    "leftmargin": 140,
    "visibility": "gone"
},
"dynData": {
    "rotateSgv": {
        "valueKey": "sgv",
        "minData": 30,
        "maxData": 330
    },

Du siehst unter der letzten Ansicht ("second_hand"), einen neu hinzugefügten "dynData" { ... }-Block, der alle Animationen enthält:

Der Block, der innerhalb der Ansicht "background" definiert wurde, heißt "rotateSgv" und ist der erste Block, den Du in "dynData" findest!

Dieser Block ist einfach: Du hast einen ersten Schlüssel mit dem Namen "valueKey":, der festlegt, welcher Wert verwendet werden soll. In diesem Fall ist "sgv" ein „keyValue“, der den Glukosewert definiert (beachte, dass der Schlüsselwert in den meisten Fällen den gleichen Namen hat wie die Ansicht, die diese Information anzeigt).

In Bezug auf den Glukosewert wird 39 mg/dl als Minimalwert (min data) und 400 mg/dl Maximalwert (max data) vorbelegt (siehe DynData-Referenzschlüsselwerte unten allen verfügbaren Schlüsselwerten und den zugehörigen Min/Max-Datenwerten).

Innerhalb des "rotateSgv"-Blocks werden die beiden zusätzlichen Schlüssel ("minData": und "maxData":) verwendet, um die Mindest- und Höchstwerte auf 30 und 330 zu justieren. With these min and max values, we will be able to directly use data value (without any conversion) to rotate background in degrees. In dieser Situation werden alle Glukosewerte über 330 mg/dl auf 330 begrenzt, die obere Begrenzung des Bildes.

Chart-Management

Der Standardhintergrund des Diagramms ist transparent. Um die Glukosewert-Skala, die Teil des Hintergrundbildes ist, auszublenden, müssen wir ein dediziertes Hintergrundbild aufnehmen (dieses Bild wird die gesamten Schatten des Steampunk-Zifferblatts enthalten). Der Link zur Datei charBackground.jpg erfolgt mit dem Schlüssel "background":

Natürlich muss die Größenanpassung und Positionierung der Ansicht pixelgenau erfolgen!

"chart": {
    "width": 216,
    "height": 107,
    "topmargin": 280,
    "leftmargin": 80,
    "visibility": "visible",
    "background": "chartBackground"
},

Avg delta-Management

Um mit den dynamischen Bereichen von avg delta umgehen zu können, werden wir die vier Freetext-Ansichten verwenden. freetext1 wird verwendet, um den Bildmaßstab zu verwalten, und freetext2 bis freetext4 werden verwendet, um die Zeigerrotation entsprechend dem Maßstab zu verwalten.

freetext1

Wie bereits erklärt, sind Freitextansichten vor dem Diagramm und vor dem Hintergrund platziert, deshalb haben wir einen transparenten Bereich hinzugefügt, um diese Bilder zu sehen (rechte Seite und untere Seite des Bildes)

Beachte, dass der entfernte untere Teil dieser Bilder als Hintergrunddiagramm verwendet wurde, um eine perfekte Integration zu erreichen.

"freetext1": {
    "width": 400,
    "height": 400,
    "topmargin": 0,
    "leftmargin": 0,
    "rotation": 0,
    "visibility": "visible",
    "dynData": "avgDeltaBackground"
},

Für diese Ansicht fügen wir den Link zu einem anderen "dynData"-Block mit dem Namen avgDeltaBackground hinzu. Dieser Block wird die avgDelta-Skala entsprechend dem Durchschnitts-Delta-Wert (avgDelta) anpassen.

"avgDeltaBackground": {
    "valueKey": "avg_delta",
    "minData": -20,
    "maxData": 20,
    "invalidImage": "steampunk_gauge_mgdl_5",
    "image1": "steampunk_gauge_mgdl_20",
    "image2": "steampunk_gauge_mgdl_20",
    "image3": "steampunk_gauge_mgdl_10",
    "image4": "steampunk_gauge_mgdl_5",
    "image5": "steampunk_gauge_mgdl_5",
    "image6": "steampunk_gauge_mgdl_10",
    "image7": "steampunk_gauge_mgdl_20",
    "image8": "steampunk_gauge_mgdl_20"
},

• "valueKey": wird den Link zum Wert "avg_delta" herstellen

• min und maxData begrenzen auch den Bereich auf den maximal verfügbaren Wert innerhalb dieses Zifferblatts (von -20 mg/dl bis 20 mg/dl). Für mmol-Benutzer gilt es zu beachten, dass alle internen Werte innerhalb von AAPS immer in mg/dl sind.

Jetzt schauen wir uns an, wie man mit Hintergrundbildern auf Basis eines Wertes dynamisch umgehen kann.

"invalidImage": ist der Schlüssel der das Bild referenziert, das angezeigt werden wird, wenn wir ungültige (oder fehlende Daten) haben. Hier erstellen wir den Link zu einem zusätzlichen Ressourcenbild mit einer Skala von 5 mg/dl, das zur Zip-Datei hinzugefügt ist

Then we will use a series of images, starting from "image1": to "image8":. Die Anzahl der bereitgestellten Bilder wird die Anzahl der Schritte zwischen minData und maxData definieren.

• image1 definiert das Bild, das angezeigt wird, wenn avg_delta gleich oder nahe bei minData ist, und das Bild mit der höchsten Nummer (hier image8) wird verwendet, um das Bild zu definieren, das angezeigt werden soll, wenn avg_delta gleich oder nahe bei maxData ist

• between -20mgdl and 20mgdl, the overall range is 40mgdl, divided by 8 (number of images provided), we will have 8 steps of 5mgdl

• Jetzt können wir Hintergrundbilder dem jeweiligen avg_delta Wert zuordnen, beginnend mit den niedrigsten Werten: zwischen -20 und -15, und auch zwischen -15 und -10 werden wir steampunk_gauge_mgdl_20 für die Skala verwenden, dann zwischen -10 und -5 steampunk_gauge_mgdl_10, und so weiter bis +15 und +20, wo wir wieder steampunk_gauge_mgdl_20 als Hintergrundbild verwenden

freetext2 bis freetext4

Für diese Ansichten werden wir dynamische Bilder und die zuvor erklärte Rotationsfunktion kombinieren:

"freetext2": {
    "width": 276,
    "height": 276,
    "topmargin": 64,
    "leftmargin": 64,
    "rotation": 0,
    "visibility": "visible",
    "dynData": "avgDelta5",
    "rotationOffset": true
},
"freetext3": {
    "width": 276,
    "height": 276,
    "topmargin": 64,
    "leftmargin": 64,
    "rotation": 0,
    "visibility": "visible",
    "dynData": "avgDelta10",
    "rotationOffset": true
},
"freetext4": {
    "width": 276,
    "height": 276,
    "topmargin": 64,
    "leftmargin": 64,
    "rotation": 0,
    "visibility": "visible",
    "dynData": "avgDelta20",
    "rotationOffset": true
},

Here each view is dedicated to a specific scale (so is linked to a dedicated dynData block), you can also notice that "rotationOffset": key is enabled for these 3 views.Now take a look on the first dynData block:

Here, even if dynamic range will be used only between -5 and +5 avg_delta data, it’s important to keep the overall range of -20, +20mgdl to ensure that the pointer will be synchronize with the background during scale switches. That’s why we keep the same overall range than for avgDeltaBackground and the same number of steps (8 images).

Du kannst erkennen, dass "invalidImage" oder mehrere "imagexx" den Schlüsselwert "null" haben (es könnte eine beliebige Zeichenkette sein, die nicht als Dateiname in der Zip-Datei existiert). Wenn ein Dateiname nicht gefunden wird, wird das Hintergrundbild transparent angezeigt. Daher wird sichergestellt, dass der Zeiger nur für Schritt 4 und Schritt 5 sichtbar ist (avg_delta zwischen -5 mg/dl und +5 mg/dl) und außerhalb dieses Bereichs nicht sichtbar ist.

Jetzt sehen wir einen neuen Block "rotationOffset":, der zwei Schlüssel "minValue": und "maxValue": hat. These values are used to make the conversion between internal data (in mgdl), and the angle rotation we want to have.

• Das Steampunk-Zifferblatt ist so konzipiert, dass der Zeiger um maximal -30 Grad bis 30 Grad gedreht werden kann. Also gemäß der Skala (hier von -5 mg/dl bis 5 mg/dl) möchten wir für diese Werte 30 Grad haben. Weil minData und maxData4-mal größer sind, sind die entsprechenden minValues und maxValues 4 * 30 Grad, also -120 und +120 Grad. Aber für alle Rotationen über oder unter +-30 Grad wird der Zeiger ausgeblendet (kein Bild sichtbar). Der Zeiger wird nur für Werte zwischen -5 und +5 mg/dl sichtbar sein… Also genau das, was hier erwartet wird.

Die anderen dynData-Blöcke werden auf die gleiche Weise definiert, um "avgDelt10" und "avgDelta20" anzupassen

Loop-Ansicht (Loop-View)

Im Steampunk-Ziffernblatt sind grüne und rote Pfeile (für den Status) des Loops deaktiviert. Das wird auch mit einem dedizierten dynData-Block gesteuert, der mit der Loop-Ansicht verknüpft ist.

    "loopArrows": {
        "invalidImage": "greyArrows",
        "image1": "greenArrows",
        "image2": "redArrows"
    }

Weil dieser Block nur durch die Loop-View aufgerufen wird und die Standarddaten, die von dieser Ansicht verwaltet werden, Loop-Informationen sind, ist der Schlüssel "valueKey": optional.

Die Standardwerte minData und maxData für den Loop werden auf 0min und 28min festgelegt, sodass bei zwei Bildern alle Datenwerte unter 14 Minuten mit dem Hintergrund image1 angezeigt werden und alle Datenwerte über 14 Minuten mit image2 angezeigt werden. 14 Minuten ist genau die Schwelle, um vom grünen Pfeil auf den roten Pfeil umzuschalten.

In diesem Beispiel greyArrows, greenArrows und redArrows sind nicht in der Zip-Datei enthalten. Damit Du diesen Block „wie er ist“ verwenden kannst, wenn Du Status-Pfeile mit benutzerdefinierten Hintergrundbildern einstellen möchtest, werden nur diese Pfeile entfernt (unsichtbar).

rig_battery und uploader_battery-Ansichten

Um den Überblick über das dynData-Feature abzuschließen, werfen wir einen Blick auf das Batteriemanagement. Die Idee hier ist, die Textfarbe entsprechend dem Batteriestand anzupassen (von 0 bis 100%)

Beide Ansichten teilen sich den gleichen Dyndaten-Block mit dem Namen batteryIcons. Das ist möglich, da standardmäßig zugeordneten Daten die eine der Ansicht sind (ohne die Angabe eines "valueKey":-Schlüssels innerhalb des batteryIcons-Blocks wird sie mit den Daten von uploader_battery oder rig_battery gemäß der Ansicht befüllt).

Auch diese beiden Ansichten nutzen die TwinView-Funktion, die hier erklärt wird.

Jetzt werfen wir einen Blick auf den dynData-Block:

"batteryIcons": {
    "invalidFontColor": "#00000000",
    "fontColor1": "#A00000",
    "fontColor2": "#000000",
    "fontColor3": "#000000",
    "fontColor4": "#000000",
    "fontColor5": "#000000"        
},

Hier verwenden wir genau die gleiche Logik wie für das dynamische Hintergrundbild, jedoch mit den dedizierten Schlüsseln ("invalidFontColor" und "fontColor1" bis "fontColor5", um 5 Schritte von jeweils 20 % zu spezifizieren).

• "fontColor1" (dunkelrot) wird für alle Werte unter 20% verwendet, und weiß wird für alle Werte über diesem Schwellenwert verwendet.

• Wenn Du die Schwelle auf „unter 10%“ senken möchtest, musst Du lediglich 5 zusätzliche Schlüssel von "fontColor6" bis "fontColor10" hinzufügen, aber Du kannst auch jede Farbe anpassen, wenn Du eine zusätzliche Variation von Grün über Gelb, Orange und Rot wünschst…

DynPref-Funktion

Bevor Du dieses Kapitel liest, musst Du verstehen, wie dynData funktioniert, weil DynPref eine erweiterte Nutzung von DynData ist: Du kannst DynData-Block den benutzerspezifischen Wünschen entsprechend anpassen:

Um die DynPref-Funktion zu veranschaulichen, werden wir zwei Beispiele verwenden:

• Steampunk-Zifferblatt (einfache Nutzung, um es ins gleiche mgdl-Zifferblatt und mmol-Zifferblatt zu integrieren; das Zifferblatt wechselt automatisch je nach der in AAPS ausgewählten Einheit).

• Das AAPS V2-Ziffernblatt wird verschiedene Einstellungen kombinieren, um Textfarbe und Hintergrund entsprechend den Einstellungen der dunklen Trennlinie zu steuern.

Einfache Anwendung der dynPref innerhalb des Steampunk-Zifferblatts

Innerhalb von Steampunk müssen wir das passende Bild für die jeweiligen Einheiten setzen: Ein background-Bild, das eine Glukosewert-Skala hat uns sich entsprechend dem Glukosewert drehen wird. Und freeText1, das den dynamischen Maßstab passend zum avgDelta-Wert enthält. Um ein Zifferblatt zu haben, das automatisch die richtigen Einheiten anzeigt, sollten wir das Bild entsprechend der ausgewählten Einheit auswählen.

Um dies zu tun, ersetzen wir im View-Block den dynData-Schlüssel durch einen DynPref-Schlüssel:

 "background": {
    "width": 400,
    "height": 400,
    "topmargin": 0,
    "leftmargin": 0,
    "dynPref": "rotateSgv",
    "rotationOffset": true,
    "visibility": "visible"
},

Die Verwendung des dynPref-Schlüssels wird sehr ähnlich dem des dynData-Schlüssels sein, die im vorherigen Kapitel erklärt wurden

Nun werden wir uns das Ende der JSON-Datei ansehen, nach dem dynData-Block:

"dynData": {
    ...
},
"dynPref": {
    "rotateSgv": {
        "prefKey": "key_units",
        "true": {
            "valueKey": "sgv",
            "minData": 30,
            "maxData": 330,
            "invalidImage": "Background_mgdl",
            "image1": "Background_mgdl"
        },
        "false": {
            "valueKey": "sgv",
            "minData": 30,
            "maxData": 330,
            "invalidImage": "Background_mmol",
            "image1": "Background_mmol"
        }
    },
    ...
}

Du siehst, dass der dynpref-Schlüssel, der innerhalb des Blocks, der die background-Ansicht beschreibt, definiert ist ("dynPref": "rotateSgv") und im dynPref JSON-Block am Ende der JSON-Datei enthalten ist:

Dieser Block sollte einen "prefKey"-Schlüssel enthalten, der definiert, welche Einstellung verwendet werden soll. In diesem Beispiel ist der Schlüssel "key_units" mit der auf dem Smartphone in AAPS ausgewählten Einheit verknüpft, und der Wert ist "true", wenn die ausgewählte Einheit mg/dl ist, "false", wenn die ausgewählte Einheit mmol ist.

Dann kommen zwei JSON-Blöcke, die das Format „dynData“ verwenden und entsprechend der ausgewählten Einstellung verwendet werden.

Note that the „HardCoded“ file name for Background image is now replaced by a dynamic image that will be the same whatever the BG value (Background_mgdl.pngfile if key_units is „true“, Background_mmol.png if key_units is false), and we also include an `“invalidImage“ key to always have a background image even if no data has been received from the phone.

Kombiniere verschiedene Einstellungen innerhalb von dynPref mit AAPS V2

In den meisten Fällen, in denen Du Einstellungen definierst, geht es nicht darum, „dynamisches Verhalten“ zu erzeugen, sondern nur um die Ergebnisse basierend auf einer bestimmten Auswahl anzuzeigen. Innerhalb von dynPref wird das allerdings als dynamisches Merkmal behandelt …

• Wenn ein dynData-Block mit allen Parametern gefüllt ist (mit Bildern, Schriftfarbe, Farbe, …), wirst Du mit dynPref jeden Parameter mit einer spezifischen Einstellung kombinieren können.

• Here we will see how match divider preference will be associated to dark preference to show when it’s enabled (true) white text on black background on dark watchface (dark parameter true) or black text on white background on light watchface (dark false)…

Lass und zuerst auf den Anfang der JSON-Datei schauen:

"dynPrefColor": "prefColorDark",
"pointSize": 2,
"enableSecond": false,
"background": {
    "width": 400,
    "height": 400,
    "topmargin": 0,
    "leftmargin": 0,
    "visibility": "visible",
    "dynPref": "dark"
},

"dynPrefColor": "prefColorDark" wird den dynPref-Block für alle Standardfarben außerhalb der Ansichten (views) bestimmen. Diese Farben werden entsprechend dem dunklen Parameter innerhalb von "prefColorDark" angepasst:

Und am Ende, innerhalb des dynPref-Blocks, hast Du einen spezifischen dynPref-Block für Standardfarben:

"prefColorDark": {
    "prefKey": "key_dark",
    "true": {
        "highColor": "#FFFF00",
        "midColor": "#00FF00",
        "lowColor": "#FF0000",
        "lowBatColor": "#E53935",
        "carbColor": "#FB8C00",
        "basalBackgroundColor": "#0000FF",
        "basalCenterColor": "#64B5F6",
        "gridColor": "#FFFFFF"
    },
    "false": {
        "highColor": "#A0A000",
        "midColor": "#00A000",
        "lowColor": "#A00000",
        "lowBatColor": "#E53935",
        "carbColor": "#D07C00",
        "basalBackgroundColor": "#0000A0",
        "basalCenterColor": "#64B5F6",
        "gridColor": "#303030"
    }
}

Der Unterschied zwischen diesem dynPref-Block und den anderen Standard-dynPref-Blöcken, die für Ansichten verwendet werden, besteht darin, dass es hier keinen dynData-Block für jeden Wert des "key_dark"-Parameters gibt, sondern nur die Liste der Hauptfarben (highColor, midColor, …)

Lass uns nun einen Blick auf die in den „Trennstreifen“ aufgenommenen Elemente werfen (im folgenden Beispiel ist die Ansicht "basalRate" mit der Ansicht "matchDivider" dynPref verknüpft:

"basalRate": {
    "width": 90,
    "height": 32,
    "topmargin": 127,
    "leftmargin": 242,
    "rotation": 0,
    ...
    "leftOffsetTwinHidden": 33,
    "dynPref": "matchDivider"
},

Then within dynPref block, you can see that Match divider parameter (key_match_divider key), include the 2 blocks „true“ and „false“, but these two blocks are only used to define that view will use either „dark“ dynBlock (so exactly the same background and text color than the otherviews outside the banner), or „white“ dynBLock that will set opposite colors for background and text…

"matchDivider": {
    "prefKey": "key_match_divider",
    "true": {
        "dynPref": "dark"
    },
    "false": {
        "dynPref": "white"
    }
},
"dark": {
    "prefKey": "key_dark",
    "true": {
        "color1": "#000000",
        "fontColor1": "#FFFFFF"
    },
    "false": {
        "color1": "#FFFFFF",
        "fontColor1": "#000000"
    }
},

Beachte, dass Du Dich hier innerhalb eines „dynData“-Blocks befindest. Um eine Farbe oder eine Schriftfarbe zu definieren, verwende ein dynData (hier nicht beschrieben) und einen einzigen Schritt ("color1" und 'fontColor1' werden genutzt)

• Für alle Parameter mit Ausnahme von image wird standardmäßig für „ungültiger Wert“ (wenn nicht speziell durch den "invalidColor"- oder den "invalidFontColor"-Schlüssel anders definiert) "color1" und "fontColor1" berücksichtigt.

Then we will see a third example with iob views (iob1 and iob2), where we will use smaller text for detailed iob and bigger text for total iob:

"iob1": {
    "width": 125,
    "height": 33,
    "topmargin": 168,
    "leftmargin": 275,
    "rotation": 0,
    "visibility": "visible",
    "textsize": 19,
    ...
    "dynPref": "prefIob1"
},
"iob2": {
    "width": 125,
    "height": 33,
    "topmargin": 196,
    "leftmargin": 275,
    "rotation": 0,
    "visibility": "visible",
    "textsize": 24,
    ...
    "leftOffsetTwinHidden": -10,
    "dynPref": "prefIob2"
},

Innerhalb der Standardansichtseinstellungen und den zwei verschiedenen dynPref-Blöcken, die die Textgröße (gemäß des detaillierten iob-Parameters) und die Farben (gemäß des dunklen Parameters) anpassen sollen, ist die Textgröße (19 für iob1 und 24 für iob2)

"prefIob1": {
    "prefKey": "key_show_detailed_iob",
    "true": {
        "dynPref": "dark",
        "textsize1": 24
    },
    "false": {
        "dynPref": "dark"
    }
},
"prefIob2": {
    "prefKey": "key_show_detailed_iob",
    "true": {
        "dynPref": "dark",
        "textsize1": 19
    },
    "false": {
        "dynPref": "dark"
    }
},

Du erkennst, dass wenn der iob-Parameter ("key_show_detailed_iob" Schlüssel) „true“ ist, die Textgröße auf einen festgelegten Wert größer als der Standard festgelegt wird (24 anstatt 19): Dies wird mit der textsize „step“-Funktion erreicht, innerhalb, der nur um eine Stufe (step) erhöht… (Anmerkung: für alle Parameter wird textsize1 für ungültige Daten verwendet (ausgenommen sind Bilder), sofern invalidTextSize nicht festgelegt ist)

Dann wird der „dark“ dynPref-Block verwendet, um Farbe und Schriftfarbe festzulegen

In diesem Beispiel wird der dynData-Block dann für die Ansicht iob1 verwendet, wenn detailliertes IOB aktiviert ist und „dark“ aktiviert ist:

{
    "color1": "#000000",
    "fontColor1": "#FFFFFF",
    "textsize1": 24
},

Damit wird der Text weiß auf schwarzem Hintergrund sein und die 24er-Größe die Standardgröße (19), die in der Ansicht festgelegt wurde, ersetzen

Der dynData-Block, der für die gleiche iob1-Ansicht verwendet wird, wenn das detaillierte IOB deaktiviert ist und „dark“ deaktiviert ist, sieht wird folgt aus:

{
    "color1": "#FFFFFF",
    "fontColor1": "#000000"
},

Der Text ist nun schwarz auf weißem Hintergrund mit einer Größe von 19

Tipps und Tricks für dynPref

• You can combine as many pref than you want, but be careful, the number of blocks to describe can increase very fast (it’s exponential): if you chain 3 parameters and you want to define all situations, you will have 8 blocks to describe, if each parameter has only 2 values…

• Be careful to not build „infinite loop“ (for example if dynpref1 block should be completed by dynpref2 block that should be completed by dynpref1 block…). In diesem Fall werden die dynpref-Blöcke als ungültig betrachtet…

• Vergiss nicht, den numerischen Index nach dem Schlüssel aufzunehmen (wenn Du zum Beispiel "textsize" innerhalb einer Ansicht verwendest muss "textsize1" innerhalb des Werteblocks des dynPref verwendet werden, da es sich um ein „dynData“-Format handelt, das in diesem Fall mit einem Einzelschritt verknüpft ist)

• Es sollte nur ein Schlüssel "valueKey" pro Ansicht festgelegt werden, daher sollten bei Zusammenstellung eines endgültigen dynData-Blocks aus mehreren dynPref-Blöcken nicht mehrere "valueKey" (und zugehörige "minData", "maxData", …) enthalten sein

Neue Funktionen in CustomWatchface V2 (AAPS V3.3.0 oder höher)

Bitte berücksichtige, dass Zifferblätter, die diese neuen Funktionen oder Ansichten (engl. views) nutzen, zwingend eine aus der AAPS Version 3.3.0 erstellte Wear-APK benötigen.

Wenn Du ein Zip-Datei „v2“ mit einer Smartwatch nutzt, die CustomWachface V1 hat, werden entweder falsche Inhalte auf der Smartwatch angezeigt oder es fehlen möglicherweise Informationen in der Anzeige.

Das CustomWatchface V2 enthält folgende Funktionen:

• Neue Status-View

• Neue View für temporäre Ziele

• Neue Reservoir-Stand-View

• New Formatting Feature

• Show External data for Follower (up to 3 set of data within one single Watchface, for AAPS, AAPSCLIENT and AAPSCLIENT2)

Neue Status-View

Der Key dieser Ansicht ist „status“ und der zugeordnete Block wird automatisch in die Vorlage exportiert, die von Wear-APK „Custom Watchface V2“ (erstellt aus der AAPS-Version 3.3.0 oder neuer)

Diese Ansicht (view) war Bestandteil der bestehenden Zifferblätter AAPS (NoChart), AAPS (BigChart) und AAPS (Large) und enthalten einen in der Wear-APK erzeugten „string value“.

Diese bisherigen Watchfaces wurden mittlerweile entfernt und durch drei neue benutzerdefinierte Watchfaces in AAPS 3.3.0 ersetzt.

• die Minimal-Information ist der IOB-Wert (immer sichtbar, wie auch immer der IOB-Parameter ist)

• zusätzlich gibt es, wenn es in den Einstellungen aktiviert ist, detaillierte IOB-Werte (BolusIOB|BasalIOB)

• und den BGI-Wert (auch hier: wenn er in den Einstellungen aktiviert ist)

Diese "status"-Ansicht ist (innerhalb von dynPref) mit dem "key_show_loop_status"-Schlüssel verknüpft, um die Sichtbarkeit zu steuern.

Diese Ansicht konnte in V1 mit den bestehenden "iob1", "iob2" und "bgi" Ansichten gesteuert werden. Dazu waren allerdings komplexe dynPref-Einstellungen notwendig, um den Abstand innerhalb jeder Information entsprechend den verschiedenen Einstellungen innerhalb der Smartwatchv zu steuern.

Neue View für temporäre Ziele

Der Key dieser Ansicht ist „tempTarget“ und der zugeordnete Block wird automatisch in die Vorlage aus der Wear-APK „Custom Watchface V2“ (erstellt aus der AAPS-Version 3.3.0 oder neuer) exportiert.

Im Zifferblatt wird angezeigt:

• Profil-Ziel (Einzelwert oder min-max Zielwerte) (Standardfarbe in Weiß)

• Das durch den Loop angepasste Ziel (Standardfarbe in Grün)

• Das durch Dich definierte temporäre Ziel (Standardfarbe in Gelb)

Diese "tempTarget"-Ansicht ist (innerhalb von dynPref) mit dem "key_show_temp_target"-Schlüssel verknüpft, um die Sichtbarkeit zu steuern.

Der DynData-Schlüssel (verknüpft mit Farbinformation) ist in "tempTarget" (dem Standard DynData-Schlüssel in der TempTarget Ansicht)

Der DynData-Wert ist gleich:

• 0 (Profil-Ziel),

• 1 (Loop-Ziel) oder

• 2 (Benutzerdefiniertes temporäres Ziel)

Beachte, dass diese Ansicht auch für externe Daten verfügbar ist (siehe unten) mit "tempTarget_Ext1" und "tempTarget_Ext2"-Schlüsseln (Ansicht und DynData)

Neue Reservoir-Stand-View

Der Key dieser Ansicht ist „reservoir“ und der zugeordnete Block wird automatisch in die Vorlage aus der Wear-APK „Custom Watchface V2“ (erstellt aus der AAPS-Version 3.3.0 oder neuer) exportiert.

Diese Ansicht zeigt den Reservoir-Stand (in IE) mit einer weißen Standardfarbe, Gelb bei Warnung, Rot, wenn dringender Stand

Diese „Reservoir“-Ansicht ist mit dem „key_show_reservoir_level“-Schlüssel (innerhalb von dynPref) verknüpft, um die Sichtbarkeit zu steuern.

Die DynData-Schlüssel, die mit dem Reservoir-Stand verknüpft sind:

• „reservoir“ (Standard-DynData-Schlüssel, der mit der Reservoir-Stand-Ansicht verknüpft ist) verknüpft mit dem Insulin-Stand in IE

• Min. Wert ist 0,0 IE

• Max. Wert ist 500,0 IE

• „reservoirLevel“

• 0 (Standard, weiße Farbe voreingestellt)

• 1 (Warnstufe, gelbe Farbe voreingestellt)

• 2 (Dringend, rote Farbe voreingestellt)

Beachte, dass diese Ansicht auch für externe Daten verfügbar ist (siehe unten) mit "reservoir_Ext1", "reservoir_Ext2", "reservoirLevel_Ext1" und "reservoirLevel_Ext2"-Schlüsseln (Ansicht und DynData).

New Formatting feature for DynData or DynPref

You can now manage a custom formatting of raw values received by the watch and included in dyndata key value table below.

Um zu zeigen, wie diese Funktion funktioniert, nehmen wir das AAPS (Large) Zifferblatt und schauen uns die Ergebnisse „time ago value“ und den neuen„Status“Zeit-Vor-Wert“ und der neuen „Status“: Ansicht ist „visible“ oder nicht:

• Im ersten Screenshot auf der linken Seite ist die Statusansicht sichtbar (mit IOB, detailliertem IOB und BGI) also steht nur 1/3 der Zeile zur Anzeige des Zeitstempels zur Verfügung (sehr kompakte Informationen mit 1', und für die Uploader Akku-Informationen U: 55%)

• Im zweiten Screenshot wurde jetzt die Status-Ansicht im Smartwatch-Parameter versteckt, um mehr Platz für das das volle Label mit Zeitstempel-Informationen und Uploader-Batterie zu haben(1 minute ago und Uploader: 55 %)

• Im dritten Screenshot auf der rechten Seite hast Du die gleichen Smartwatch-Einstellungen, jetzt aber hat sich der Zeitstempel geändert und liegt über „1“. now the custom watchface is able to show the label updated with plural management (2 minutes ago)

I will not explain below how the whole views are managed within zip file (positioning of each view according to different settings), but I will only focus on the way we manage formatting feature and associated dynamic value within AAPS (Large) watchface.

Diese Funktion bracuht ienen „dynamischen Block“ (das kann entweder ein dynData-Block oder ein dynPref-Block sein)

• Für das AAPS (Large) Zifferblatt wollten wir das Format parametrisiert steuern (kurzes oder langes Format in Abhängigkeit von der Sichtbarkeit der Status-Ansicht). Dafür haben wir einen dynPref-Block genutzt.

Lass uns mit den Ansichten beginnen:

"uploader_battery": {
    "width": 200,
    "height": 50,
    "topmargin": 175,
    "leftmargin": 0,
    "rotation": 0,
    "visibility": "visible",
    "textsize": 25,
    "gravity": "center",
    "font": "roboto_condensed_light",
    "fontStyle": "normal",
    "dynPref": "uploader",
    "dynValue": false,
    "fontColor": "#BDBDBD"
},

"timestamp": {
    "width": 200,
    "height": 50,
    "topmargin": 175,
    "leftmargin": 0,
    "rotation": 0,
    "visibility": "visible",
    "textsize": 25,
    "gravity": "center",
    "font": "roboto_condensed_light",
    "fontStyle": "normal",
    "dynPref": "timestamp",
    "dynValue": false,
    "fontColor": "#FFFFFF"
},

Der wichtigste Schlüssel ist hier "dynValue": Wenn diese Schlüsselinformation vorliegt, kann damit der Rohwert dynamisch gesteuert werden. Der boolesche Wert dahinter (true oder false) legt fest, ob der Wert „konvertiert“ werden soll oder nicht

• false: raw value will be use as it is without any limitation or conversion

• true: Der Rohwert wird konvertiert (mit den minData und maxData-Schlüsseln des dynData-Blocks und mit den in dynData definierten minValue und maxValue-Werten

For this watchface, raw values are used without any conversion, so for both views, "dynValue" key as been set to false.

Jetzt schauen wir uns den "uploader"-Block an, der in „dynPref“ definiert ist:

"uploader": {
    "prefKey": "key_show_loop_status",
    "true": {
        "dynPref": "uploader_true_ago",
        "invalidTextvalue": "U: --",
        "textvalue1": "U: %.0f%%"
    },
    "false": {
        "dynPref": "uploader_false_ago",
        "invalidTextvalue": "Uploader: --",
        "textvalue1": "Uploader: %.0f%%"
    }
},

Standardmäßig ist die „uploader_battery“-Ansicht mit „uploader_battery“ verknüpft, so dass keiner separaten Zeile Bedarf

"valueKey": "uploader_battery" (min Wert 0, max Wert 100, und Rohwert ist Prozentwert des Smartphone-Akkus)

The formatting string is included into "textvalue1" key ("textvalue1", "textvalue2", etc keys are linked to "textvalue" key that could be included into view block)

• "textvalue" key can be used with formatting information within the view block (in this situation format will be static, whatever the value or the settings)

• If you want to modify formatting information according to settings or values, thenall dynData feature can be applied, and the dedicated keys are "invalidTextValue" key (without „formatting information“ because value is not valid) and "textvalue1", "textvalue2"… (and as many values that you want to manage steps between minData and maxData)

• Die zusätzlichen „dynPref“-Schlüssel werden dazu genutzt andere Blöcke für die Positionierung, und Farbvarianten in Abhängigkeit von den sichtbaren Ansichten, Dunkelheits- und matchDivider-Einstellungen zu definieren

Concerning now the formatting string, syntax is the following: %[flags][width][.precision]f

• % is the beginning of a formatting, f is the end and should be used for Double value conversion.

  • Note that if you want to use % character within your string, you will have to use %% to specify that it’s not a formatting string but percentage character.

• [flag] ist optional, es kann häufig ein + sein, wenn Du vor den Zahlen ein Zeichen haben möchtest oder ( wenn Du negative Werte in Klammern haben willst

• [width] ist optional, definiere die minimale Zeichenanzahl, die in die Ausgabe geschrieben werden soll

• [.precision] wird verwendet, um die Ziffernanzahl nach dem Radix-Punkt zu definieren.

  • Beachte, dass die Werte „Double“ sind, daher ist es ratsam, immer eine Genauigkeit zu setzen (um zu viele Zeichen nach dem Radix-Punkt aufgrund der Kotlin-Genauigkeit zu vermeiden)

Im obigen Beispiel wird %.0f den „Double“ Wert als Ganzzahl anzeigen

Lass uns jetzt einen Blick auf den Timestamp dynPref-Block werfen, um mehrere zu verwalten:

"timestamp": {
    "prefKey": "key_show_loop_status",
    "true": {
        "dynPref": "timestamp_true_uploader",
        "invalidTextvalue": "U: --",
        "textvalue1": "%.0f'"
    },
    "false": {
        "dynPref": "timestamp_false_uploader",
        "minData": 0,
        "maxData": 3,
        "invalidTextvalue": "-- minute ago",
        "textvalue1": "%.0f minute ago",
        "textvalue2": "%.0f minutes ago"
    }
},

• wenn die status-Ansicht sichtbar ist (also der "key_show_loop_satus"-Schlüssel „true“ ist), wird ein einziges Format („textvalue1“), mit ' als „Einheit“ verwendet

• wenn die status-Ansicht versteckt ist, hast Du 2 verschiedene Formate für 0 oder 1 mit Singular, und ein anderes Format für Werte über 2 mit Plural

  • „minData“ und „maxData“ werden verwendet, um den Bereich zu definieren und stellen sicher, dass der Wechsel von Singular zu Plural zwischen 1 und 2 Werten erfolgt

  • Beachte, dass „maxData“ (Integer) auf 3 und nicht auf 2 gesetzt wurde nur weil „Double“-Daten, die im System verwaltet werden, keine ganze Zahl sind, so dass ein Wert etwas oberhalb oder etwas unterhalb 1 ein einzelnes oder plurales Format haben kann, auch wenn es nach dem Runden auf ganze Zahlen der Wert ist 1.

• For timestamp view, it’s important to set "dynValue" key to false, otherwise because of formatting (singular/plural), all values above 3 will be limited to 3 minutes ago with conversion using maxData…

Additional comment concerning formatting feature

• Beachte, dass die einzigen verfügbaren dynamischen Werte die sind, die hier aufgelistete sind:

• All BG values are in mgdl unit, if you want to use formatting feature to show values in mmol units, you will have to manage mgdl to mmol conversion. Within a dynData or dynPref block, the key that should be used to name the block that will include "minValue"and "maxValue" for value conversion should be named "dynValue": { ...  }. (siehe Dyn Data Schlüssel)

• If within a view you want to use a static formatting string, with "textvalue" key to define format, and "dynValue" key to define usage of dynamic value, then you will have to also use a "dynData" or a "dynPref"block (even if empty), to be able to use formatting feature.

• "textvalue1", "textvalue2" to textvaluen can be used without formatting feature to replace double value step by a dedicated text label (for example with "day_name" key value and seven steps to define custom name of the dayx of the week, … )

• Für die vollständige Dokumentation siehe Class Formatter

Show External data for Follower

Das benutzerdefinierte Zifferblatt kann nun auf dem gleichen Zifferblatt bis zu 3 Datensätze anzeigen: AAPS, AAPSCLIENT und AAPSCLIENT2

Um dieses Feature nutzen zu können, muss Folgendes erfüllt sein:

• have at least 2 of the 3 following apps installed in phone (AAPS, AAPSCLIENT, AAPSCLIENT2)

• Aktiviere Broadcast-Daten in AAPSCLIENT und/oder AAPSCLIENT2, um Daten an die Hauptanwendung zu übermitteln, die zur Synchronisierung mit CustomWatchface verwendet wird (AAPS oder AAPSCLIENT)

• Benutze ein CustomWatchface, das Ansichten mit einem Schlüssel implementiert, einschließlich _Ext1 oder _Ext2 (siehe Schlüssel und KeyValue Referenz unten)

Note that if main app in phone is AAPSCLIENT and secondary app which broadcast data is AAPSCLIENT2, you will have to enable Switch external data in watchface parameter within Custom Watchface dedicated parameter if you use a watchface which use standard views and Ext1 additional views (Ext1 is linked to AAPSCLIENT and Ext2 is linked to AAPSCLIENT2)

Zusätzlich wurden drei neue Ansichten ("patient_name" , "patient_name_Ext1" und "patient_name_Ext2" *) hinzugefügt, um den Patientennamen automatisch in das Ziffeerblatt einbinden zu können (siehe Beispiel unten)

Key und KeyValue Referenz

Liste der Metadaten-Schlüssel

Liste der Standard Metadaten-Schlüssel

Key	Kommentar
"name"	Name des eigenen Zifferblattes
"author"	Name oder Pseudo des Autor(en)
"created_at"	Creation (or update) date, be careful / is a special character, so if you use it for the date put \before
"cwf_version"	Das Watchface-Plugin, das mit dem Deinem Zifferblatt kompatibel ist [cwf - custom watchface]
"author_version"	Hier kann der Autor die Zifferblatt-Version hinterlegen
"comment"	Freitext, der dazu genutzt werden kann, Zusatzinformationen oder Beschränkungen des aktuellen Zifferblatts zu beschreiben

Einstellungen-Schlüssel

Key	Standardwert und Kommentar
"key_show_detailed_iob"	true sperrt detaillierte IOB-Daten auf der Ansicht iob2, dann wird iob1 (falls sichtbar und nicht durch ein Symbol ersetzt) den gesamten IOB anzeigen. false sperrt den Gesamt-IOB auf der Ansicht iob2. Kann verwendet werden, wenn die Breite von iob2 zu klein ist, um iob detailliert richtig anzuzeigen
"key_show_detailed_delta"	false (nur wenn das Design nicht mit der Breite des detaillierten Delta für die Ansichten delta und avg_delta kompatibel ist)
"key_show_bgi"	true, wenn Dein Design bgi-Informationen benötigt
"key_show_iob"	true, wenn Dein Design iob1 oder iob2-Ansichten benötigt
"key_show_cob"	true, wenn Dein Design cob1 oder cob2-Ansichten (views) benötigen
"key_show_delta"	true, wenn Dein Design delta-Informationen benötigt
"key_show_avg_delta"	true, wenn Dein Design avg_delta-Informationen benötigt
"key_show_temp_target"	true, wenn Dein Design tempTarget-Informationen benötigt
"key_show_reservoir_level"	true, wenn Dein Design Reservoir-Informationen benötigt
"key_show_uploader_battery"	true, wenn Dein Design uploader_battery (Smartphone-Akku)-Informationen benötigt
"key_show_rig_battery"	true, wenn Dein Design rig_battery-Informationen benötigt
"key_show_temp_basal"	true, wenn Dein Design basalRate-Informationen benötigt
"key_show_direction"	true, wenn Dein Design direction-Informationen benötigt (Glukosewert-Trendpfeile)
"key_show_ago"	true, wenn Dein Design timestamp Informationen (Minuten seit dem letzten empfangenen Glukosewert) benötigt
"key_show_bg"	true, wenn Dein Design sgv-Informationen benötigt (Glukosewert)
"key_show_loop_status"	true, wenn Dein Design loop-Informationen benötigt (Loop-Status und vergangene Zeit)
"key_show_week_number"	true, wenn Dein Design week_number-Informationen benötigt (Loop-Status und vergangenen Zeit)
"key_show_date"	true, wenn Dein Design Date, Month oder Day of the week-Information benötigt

Interne Schlüssel (internal keys)

Key	Kommentar und
"filename"	Dieser Schlüssel wird automatisch erstellt (bzw. aktualisiert), wenn das Zifferblatt geladen wird und enthält den lokalen ZIP-Dateinamen im Export-Verzeichnis
"cwf_authorization"	Dieser Schlüssel wird erstellt (wenn das Zifferblatt geladen wird) und jedes Mal aktualisiert, wenn die Autorisierungseinstellung in den Wear-Einstellungen geändert wird, und er wird verwendet, um die Autorisierung mit der Smartwatch zu synchronisieren

Liste der allgemeinen Parameter

Key	Kommentar
"highColor"	"#FFFF00"(Standard-Gelb): Farbe des Glukosewertes, der Trendpfeile und des Glukosewertes im Diagramm, wenn der Glukosewert über dem oberen Grenzwert liegt (Hyper)
"midColor"	"#00FF00"(Standard-Grün): Farbe des Glukosewertes, der Trendpfeile und des Glukosewertes im Diagramm, wenn der Glukosewert im Zielbereich liegt
"lowColor"	"#FFFF00"(Standard-Rot): Farbe des Glukosewertes, der Trendpfeile und des Glukosewertes im Diagramm, wenn der Glukosewert unter dem oberen Grenzwert liegt (Hypo)
"lowBatColor"	"#E53935"(Standard-Dunkelrot): Farbe der uploader_battery, wenn der Akkustand niedrig ist (unter 20% tbc)
"carbColor"	"#FB8C00"(Standard-Orange): Farbe der Kohlenhydrate-Punkte im Diagramm
"basalBackgroundColor"	"#0000FF"(Standard-Dunkelblau): Farbe der TBR-Kurven im Diagramm
"basalCenterColor"	"#64B5F6"(Standard-Hellblau): Farbe der Bolus- oder SMB-Punkte im Diagramm
"gridColor"	"#FFFFFF"(Standard-Weiß): Farbe der Linien und Textskala im Diagramm
"pointSize"	2 (Standard): Größe der Punkte im Diagramm (1 für kleinen Punkt, 2 für große Punkte)
"enableSecond"	false (Standard): Angeben, ob das Zifferblatt Sekunden innerhalb der Ansichten time, second oder second_hand verwaltet wird oder nicht. Es ist wichtig, konsistent zwischen der Sichtbarkeit der Ansichten und der übergreifenden Einstellung, die eine sekündliche Aktualisierung der Zeitinformationen zulässt, zu sein
"dayNameFormat"	„E“ (Standard): von „E“ bis „EEEE“ legt das Format des Tagesnamens fest (Nummer, Kurzname, vollständiger Name) tbc
"monthFormat"	„MMM“ (Standard): von „M“ bis „MMMM“ legt das Monatsformat (Nummer, Kurzname, vollständiger Name) fest

Liste der fest codierten Ressourcendateien

Für die meisten Bilder ist es möglich sie mit High- und Low-Suffixen an den Glukosespiegel anzupassen (im Zielbereich, Hyper oder Hypo)

Dateinamen	Kommentar
CustomWatchface	Bild, das für die Zifferblatt-Auswahl und innerhalb des Wear-Plugins angezeigt wird
Background, BackgroundHigh, BackgroundLow	none (standardmäßig schwarz): Hintergrundbild. background is always visible and default color is black if no image provided. Die Farbe kann dem Zifferblatt-Design angepasst werden
CoverChart, CoverChartHigh, CoverChartLow	none (Standard): Bild vor dem Diagramm (Transparenz sollte angegeben sein, um das dahinter liegende Diagramm sehen zu können. Kann zur Begrenzung des Diagramm-Bereichs verwendet werden
CoverPlate, CoverPlateHigh, CoverPlateLow	Einfach Zifferblatt-Beschriftung (standardmäßig): Bild, das vor allen Textwerten angezeigt wird. Transparenz ist erforderlich, um alle dahinter liegenden Werte sehen zu können
HourHand, HourHandHigh, HourHandLow	hour_hand (default): Bild eines Stundenzeigers. Ein Standardbild wird „mitgeliefert“ und kann, um es dem zum Analogdesign anzupassen, eingefärbt werden. Beachte, dass um den Mittelpunkt des Bildes rotiert werden wird (Rotationsachse)
MinuteHand, MinuteHandHigh, MinuteHandLow	minute_hand (default): Bild eines Minutenzeigers. Ein Standardbild wird „mitgeliefert“ und kann, um es dem zum Analogdesign anzupassen, eingefärbt werden. Beachte, dass um den Mittelpunkt des Bildes rotiert werden wird (Rotationsachse)
SecondHand, SecondHandHigh, SecondHandLow	second_hand (default): Bild eines Sekundenzeigers. Ein Standardbild wird „mitgeliefert“ und kann, um es dem zum Analogdesign anzupassen, eingefärbt werden. Beachte, dass um den Mittelpunkt des Bildes rotiert werden wird (Rotationsachse)
ArrowNone	?? (default): Bild, das gezeigt wird, wenn es keinen gültigen Pfeil gibt.
ArrowDoubleUp	↑↑ (default): Bild eines doppelten Pfeils nach oben
ArrowSingleUp	↑ (default): Bild eines einfachen Pfeils nach oben
Arrow45Up	↗ (default): Bild eines Pfeils nach schräg oben
ArrowFlat	→ (default): Bild eines gleichbleibenden Pfeils
Arrow45Down	↘ (default): Bild eines Pfeils nach schräg unten
ArrowSingleDown	↓ (default): Bild eines einfachen Pfeils nach unten
ArrowDoubleDown	↓↓ (default): Bild eines doppelten Pfeils nach unten

Als Dateitypen sind .jpg, .png und .svg möglich. But be careful, .jpgdoesn’t manage transparency (so most of the files should be with .png or .svg to not hide view that are behind…)

Liste der Ansichtsschlüssel (View-Keys)

Diese Liste ist von hinten nach vorne (Hintergrund zum Vordergrund), da dies beim Umgang mit dem Zifferblatt sehr wichtig ist. Es ist wichtig, die Anordnung zu kennen, da Bilder oder Texte sich sonst gegenseitig verdecken können.

Hinweis: Alle Schlüssel, die _Ext1 oder _Ext2 am Ende enthalten sind neu und für Multi-User-Watchfaces gedacht.

Key	Type of view	Data attached	DynData Schlüssel
"background"	Image View
"chart"	Specific Chart View	Graphical curves
"cover_chart"	Image View
"freetext1"	Text View
"freetext2"	Text View
"freetext3"	Text View
"freetext4"	Text View
"patient_name" * "patient_name_Ext1" * "patient_name_Ext2" *	Text View	Patientenname
"iob1" "iob1_Ext1" * "iob1_Ext2" *	Text View	IOB-Label oder IOB Total
"iob2" "iob2_Ext1" * "iob2_Ext2" *	Text View	IOB Total or IOB Detailed
"cob1" "cob1_Ext1" * "cob1_Ext2" *	Text View	Kohlenhydrate-Bezeichnung
"cob2" "cob2_Ext1" * "cob2_Ext2" *	Text View	COB-Wert
"delta" "delta_Ext1" * "delta_Ext2" *	Text View	Short delta (5 min)	delta
delta_Ext1 delta_Ext2
"avg_delta" "avg_delta_Ext1" * "avg_delta_Ext2" *	Text View	Avg delta (15 min)	avg_delta avg_delta_Ext1 avg_delta_Ext2
"tempTarget"* "tempTarget_Ext1" * "tempTarget_Ext2" *	Text View	BG Target (single value or min - max targets values)	tempTarget tempTarget_Ext1 tempTarget_Ext2
"reservoir"* "reservoir_Ext1" * "reservoir_Ext2" *	Text View	Reservoirstand	reservoir reservoirLevel reservoir_Ext1 reservoirLevel_Ext1 reservoir_Ext2 reservoirLevel_Ext2
"uploader_battery"	Text View	Smartphone Akkustand (%)	uploader_battery
"rig_battery" "rig_battery_Ext1" * "rig_battery_Ext2" *	Text View	Akkustand des Rigs (%)	rig_battery rig_battery_Ext1 rig_battery_Ext2
"basalRate" "basalRate_Ext1" * "basalRate_Ext2" *	Text View	% oder absoluter Wert
"bgi" "bgi_Ext1" * "bgi2_Ext2" *	Text View	mgdl/(5 min) oder mmol/(5 min)
"status" * "status_Ext1" * "status_Ext2" *	Text View	Zusammenstellung des IOB (unabhängig von der IOB-Einstellung in der Smartwatch), detailliertes IOB (je nach Smartwatch-Einstellung) und BGI (je nach Smartwatch-Einstellung)
"zeit"	Text View	HH:MM oder HH:MM:SS
"Stunde"	Text View	HH
"Minute"	Text View	MM
"second"	Text View	SS
"timePeriod"	Text View	AM oder PM
"day_name"	Text View	Name des Tages (vgl. dayName-Format)	day_name
"Tag"	Text View	DD Datum	day
"week_number"	Text View	(WW) Kalenderwoche	week_number
"month"	Text View	Monatsname (siehe monthFormat)
"loop" "loop_Ext1" * "loop_Ext2" *	Text View	Zeit (in Minuten) seit der letzten Aktualisierung und Status (Farbpfeile im Hintergrund), Farbpfeile können mit DynData angepasst werden	loop
"direction" "direction_Ext1" * "direction_Ext2" *	Image View	Trendpfeile	direction
"timestamp" "timestamp_Ext1" * "timestamp_Ext2" *	Text View	integer (min ago)	timestamp
"sgv" "sgv_Ext1" * "sgv_Ext2" *	Text View	sgv-Wert (mgdl oder mmol)	sgv sgvLevel sgv_Ext1 sgvLevel_Ext1 sgv_Ext2 sgvLevel_Ext2
"cover_plate"	Image View
"hour_hand"	Image View
"minute_hand"	Image View
"second_hand"	Image View

*Ansicht seit Custom Watchface V2.0 hinzugefügt (verfügbar in AAPS 3.3.0 Wear-Apk oder höher)

Liste der JSON-Schlüssel

Gemeinsame Schlüssel

die für alle Ansichtsarten verwendet werden kann (TextView, ImageView, GraphView)

Key	Typ	Kommentar / Wert
"width"		Breite in Pixeln
"height"		height of view in pixel
"topmargin"		Oberer Rand in Pixeln
"leftmargin"		Linker Rand in Pixeln
"rotation"		Drehwinkel in Grad
"visibility"	string	siehe Tabelle mit Schlüsselwerten
"dynData"	string	Schlüsselblockname, der die dynamische Daten zur Verknüpfung mit der zugehörigen Animation (Farben, Bild, Verschiebung, Rotation) spezifiziert "dynData": "customName", (siehe unten)
"leftOffset"	boolean	Nimm diesen Schlüssel mit dem Schlüsselwert true auf, um eine horizontale Verschiebung (positiver oder negativer Wert) aufgrund des dynData-Werts zu verwenden
"topOffset"	boolean	Nimm diesen Schlüssel mit dem Schlüsselwert true auf, um eine vertikale Verschiebung (positiver oder negativer Wert) aufgrund eines dynData-Werts zu verwenden
"rotationOffset"	boolean	Nimm diesen Schlüssel mit dem Schlüsselwert true auf, um eine Drehung (positiver oder negativer Wert) aufgrund eines dynData-Werts zu verwenden
"twinView"	string	Schlüssel der anderen Ansicht (in der Regel enthält die andere Ansicht auch den twinView-Parameter mit dem Schlüssel dieser Ansicht darin)
"topOffsetTwinHidden"		Anzahl der Pixel, um die die Ansicht vertikal verschoben werden soll, wenn die Zwillingsansicht (twinView) ausgeblendet ist (positiver oder negativer Wert) topOffsetTwinHidden = (topOffset TwinView - topOffset thisView)/2
"leftOffsetTwinHidden"		Anzahl der Pixel, um die die Ansicht horizontal verschoben werden soll, wenn die Zwillingsansicht (twinView) ausgeblendet ist (positiver oder negativer Wert) topOffsetTwinHidden = (topOffset twinView - topOffset thisView)/2
"dynPref"	string	Schlüsselblockname, der die dynamischen Einstellungen zur Verknüpfung mit der zugehörigen Animation (Farben, Bild, Verschiebung, Drehung) spezifiziert "dynPref": "customName", (siehe unten)

TextView-Schlüssel

Key	Typ	comment
"textsize"		Schriftgröße in Pixel (beachte, dass die Schriftart auch obere und untere Ränder enthalten kann, sodass die tatsächliche Textgröße im Allgemeinen kleiner ist als die festgelegte Anzahl von Pixeln). Note that size should be smaller than view height to not be truncated
"gravity"	string	siehe Tabelle mit Schlüsselwerten
"font"	string	siehe Schlüsselwert-Tabelle für verfügbare Schriftarten. Kann auch der Schriftdateiname (ohne Erweiterung) für in die Zip-Datei aufgenommene Schriftarten sein
"fontStyle"	string	siehe Tabelle mit Schlüsselwerten
"fontColor"	string	Manage color of the font "#RRVVBB": color code in RVB format, hexadecimal values #FF0000 is red "#AARRVVBB": AA include Alpha information (transparency), 00 is transparent, FF is opaque "bgColor": keyValue bgColor is an easy way to use highColor, midColor or lowColor according to BG value
"allCaps"	boolean	true, wenn der Text in Großbuchstaben dargestellt werden soll (hauptsächlich für Tages- oder Monatsnamen)
"background"	string	resource_filename you can include a resource image as background of the text view (resource file will be resized to fit height and width of text view, but keeping image ratio). text value will be in front of background image. - Note that this key can also be used for chart view to set a custom background to the chart, in front of background image
"color"	string	Manage the color of view Background or tune color of image (if bitmap only) "#RRVVBB": color code in RVB format, hexadecimal values #FF0000 is red "#AARRVVBB": AA include Alpha information (transparency), 00 is transparent, FF is opaque "bgColor": keyValue bgColor is an easy way to use highColor, midColor or lowColor according to BG value - For default embedded image (hand, dial) color will be applied directly, for bitmap image (jpg or png) this will apply a saturation gradient filter on imagae - For svg this parameter will have no effect (color of svg files cannot be modified) - Note that this key can also be used for chart view to set a custom background to the chart, in front of background image
"textvalue"	string	Schlüssel speziell für die 4 freien Textansichten, die im Layout enthalten sind (von freetext1 bis freetext4), damit kann der einzufügende Text festgelegt werden(kann ein Label sein, oder einfach nur :, wenn Du nur Trennzeichen zwischen Stunden- und Minutenansicht hinzufügen möchtest)
Aus dem Custom Watchface plugin v2 (AAPS 3.3), kann der Textwert verwendet werden, um einen Format-String für die anderen TextViews einzufügen (Verwendung mit dynValue-Schlüssel und dynData oder dynPref). zum Beispiel
"dynValue"*	boolean	„true“, wenn Du den Rohwert als „double“ einfügen möchtest. Useful with texvalue key if you want a dedicated format to show value

*Schlüssel seit Custom Watchface V2.0 hinzugefügt (verfügbar in AAPS 3.3.0 Wear-Apk oder höher)

ImageView-Schlüssel

Key	Typ	comment
"color"	string	Manage the color of view Background or tune color of image (if bitmap only) "#RRVVBB": color code in RVB format, hexadecimal values #FF0000 is red "#AARRVVBB": AA include Alpha information (transparency), 00 is transparent, FF is opaque "bgColor": keyValue bgColor is an easy way to use highColor, midColor or lowColor according to BG value - For default embedded image (hand, dial) color will be applied directly, for bitmap image (jpg or png) this will apply a saturation gradient filter on imagae - For svg this parameter will have no effect (color of svg files cannot be modified) - Note that this key can also be used for chart view to set a custom background to the chart, in front of background image

ChartView-Schlüssel

Key	Typ	comment
"color"	string	Manage the color of view Background or tune color of image (if bitmap only) "#RRVVBB": color code in RVB format, hexadecimal values #FF0000 is red "#AARRVVBB": AA include Alpha information (transparency), 00 is transparent, FF is opaque "bgColor": keyValue bgColor is an easy way to use highColor, midColor or lowColor according to BG value - For default embedded image (hand, dial) color will be applied directly, for bitmap image (jpg or png) this will apply a saturation gradient filter on imagae - For svg this parameter will have no effect (color of svg files cannot be modified) - Note that this key can also be used for chart view to set a custom background to the chart, in front of background image
"background"	string	resource_filename you can include a resource image as background of the text view (resource file will be resized to fit height and width of text view, but keeping image ratio). text value will be in front of background image. - Note that this key can also be used for chart view to set a custom background to the chart, in front of background image

Key Werte

Schlüsselwert	Schlüssel [key]	comment
"gone"	visibility	Ansicht verborgen
"visible"	visibility	Ansicht im Zifferblatt sichtbar (Sichtbarkeit kann aber in den Parametern aktiviert oder deaktiviert werden)
"center"	gravity	Text ist vertikal und horizontal in der Ansicht zentriert
"left"	gravity	Text ist in der Ansicht vertikal zentriert und linksbündig ausgerichtet
"right"	gravity	Text ist in der Ansicht vertikal zentriert und rechtsbündig ausgerichtet
"sans_serif"	font
"standard"	font
"default_bold"	font
"monospace"	font
"serif"	font
"roboto_condensed_bold"	font
"roboto_condensed_light"	font
"roboto_condensed_regular"	font
"roboto_slab_light"	font
"normal"	fontStyle
"bold"	fontStyle
"bold_italic"	fontStyle
"italic"	fontStyle

DynData-Schlüssel

Key	Typ	comment
"dynData"	block	Definiere den Block aller dynamischen Datenblöcke, die für die Ansichten verwendet werden. In der Regel nach der letzten Ansicht. Alle in diesem Block definierten Schlüssel werden als Schlüsselwert innerhalb des View Blocks verwendet: "dynData": { dynData blocks } und jeder Block ist durch einen benutzerdefinierten Namen und mehrere Schlüssel definiert: "customName": { one dynData block }
"valueKey"	string	Name der dynamischen Daten, die verwendet werden sollen (in der Regel gleichbedeutend mit dem zugehörigen Ansichtenschlüssel). Falls nicht vorhanden, werden standardmäßig die Werte verwendet, die für die Ansicht verwendet werden, die diesen Block nutzt. Du kannst beispielsweise einen Block definieren, um den Akkustand ohne Angabe von valueKey anzupassen, und dann denselben Block verwenden, um uploader_battery und rig_battery anzupassen
"minData"		specify the minimum value to take into account for AAPS data : for example if value is sgv (unit mgdl internally), if minData is set to 50, all bg values below 50mgdl will be set to 50. - Note that minData and maxData will be used to calculate dynamic values (in pixel or in degrees).
"maxData"		specify the maximum value to take into account for AAPS data : for example if value is sgv (unit mgdl internally), if maxData is set to 330, all bg values above 330mgdl will be set to 330.
"leftOffset"	block	Gibt die horizontale Verschiebung der Ansicht gemäß den Minimal- und Maximalwerten in Pixel an. - Es beinhaltet den Schlüssel für den minimalen Wert, den Schlüssel für den maximalen Wert und den Schlüssel für ungültige Werte (optional) - Wenn die Daten unterhalb oder gleich dem minData sind, wird die Ansicht um minValue Pixel verschoben, und wenn die Daten oberhalb oder gleich dem maxData sind, wird die Ansicht um maxValue Pixel verschoben Beachte, dass für die Anwendung dieser Verschiebung leftOffset innerhalb der Ansicht auf true gesetzt werden sollte
"topOffset"	block	Gibt die vertikale Verschiebung der Ansicht gemäß den Minimal- und Maximalwerten in Pixel an. - Es beinhaltet den Schlüssel für den minimalen Wert, den Schlüssel für den maximalen Wert und den Schlüssel für ungültige Werte (optional) - Wenn die Daten unterhalb oder gleich dem minData sind, wird die Ansicht um minValue Pixel verschoben, und wenn die Daten oberhalb oder gleich dem maxData sind, wird die Ansicht um maxValue Pixel verschoben Beachte, dass für die Anwendung dieser Verschiebung topOffset innerhalb der Ansicht auf true gesetzt werden sollte
"rotationOffset"	block	Gibt den Drehwinkel in Grad der Ansicht gemäß den Minimal- und Maximalwerten in Pixel an. - Er beinhaltet den Schlüssel für den minimalen Wert (minValue), den Schlüssel für den maximalen Wert (maxValue) und den optionalen Schlüssel für ungültige Werte (invalidValue) - Wenn die Daten unterhalb oder gleich dem minData sind, wird die Ansicht um minValue-Grad gedreht, und wenn die Daten oberhalb oder gleich dem maxData sind, wird die Ansicht um maxValue-Grad gedreht Beachte, dass für die Anwendung dieser Drehung rotationOffset innerhalb der Ansicht auf „true“ gesetzt werden sollte
"dynValue"*	block	Specify the dynValue conversion from min and max range to min and max values in pixels. - It includes minValue key, maxValue Key and invalidValue key (optional) - If data is below or equal minData, then the dynValue sent will be minValue (converted to double) , and if data is above or equal to maxData, then the dynValue calculated will be maxValue (converted to double) Note that to apply this conversion, dynValue key should be set to true within the view
"minValue"		Ergebniswert, der auf die Ansicht angewendet werden soll (Schlüssel nur innerhalb eines leftOffset-, topOffset- oder rotationOffset-Blocks anwendbar)
"maxValue"		Ergebniswert, der auf die Ansicht angewendet werden soll (Schlüssel nur innerhalb eines leftOffset-, topOffset- oder rotationOffset-Blocks anwendbar)
"invalidValue"		Ergebniswert, der auf die Ansicht angewendet werden soll, wenn Daten ungültig sind (Schlüssel nur innerhalb eines leftOffset-, topOffset- oder rotationOffset-Blocks anwendbar)
"invalidImage"	string	resource_filename wird für die ImageView oder die Hintergrund TextView genutzt, wenn Daten ungültig sind
image1_to_n	string	resource_filename image to use for each step between minData (or close to minData) with "image1" and maxData (or close to maxData) with imagen If for example your put 5 images (from image1 to image5), the range between minData and maxData will be divided in 5 steps and according to data value, the corresponding image will be shown
"invalidFontColor"	string	Manage die Schriftfarbschritte, wenn die Daten ungültig sind "#RRVVBB" oder "#AARRVVBB": Farbe, die verwendet werden soll, wenn ungültige Daten empfangen werden (kann transparent sein, wenn AA=00)
fontColor1_to_n	string	Manage fontColor steps "#RRVVBB" or "#AARRVVBB": color to use for each step between minData (or close to minData) with "fontColor1" and maxData (or close to maxData) with fontColorn
"invalidColor"	string	Manage die Hintergrund- oder Bildfarbe, wenn die Daten ungültig sind "#RRVVBB" oder "#AARRVVBB": Farbe, die verwendet werden soll, wenn ungültige Daten empfangen werden (kann transparent sein, wenn AA=00)
color1_to_n	string	Manage background color or image Color steps "#RRVVBB" or "#AARRVVBB": color to use for each step between minData (or close to minData) with "color1" and maxData (or close to maxData) with colorn
"invalidTextSize"		Manage die Textgröße, wenn die Daten ungültig sind
textsize1_to_n		Manage text size to use for each step between minData (or close to minData) with "textsize1" and maxData (or close to maxData) with textsizen
"invalidLeftOffset"		Manage leftOffset-Schritte, wenn die Daten ungültig sind
leftOffset1_to_n		Manage leftOffset, der für jeden Schritt zwischen minData (oder nahe bei minData) mit leftOffset1 und maxData (oder nahe bei maxData) mit leftOffsetn Hinweis: Kann mit dynPref verwendet werden, um eine Ansicht zu verschieben, wenn eine andere Ansicht verborgen ist…
"invalidTopOffset"		Manage topOffset-Schritte, wenn die Daten ungültig sind
topOffset1_to_n		Manage topOffset, der für jeden Schritt zwischen minData (oder nahe bei minData) mit topOffset1 und maxData (oder nahe bei maxData) mit leftOffsetn Hinweis: Kann mit dynPref verwendet werden, um eine Ansicht zu verschieben, wenn eine andere Ansicht verborgen ist…
"invalidRotationOffset"		Manage rotationOffset-Schritte, wenn die Daten ungültig sind
rotationOffset1_to_n		Manage rotationOffset für jeden Schritt zwischen minData (oder nahe an minData) mit rotationOffset1 und maxData (oder nahe an maxData) mit rotationOffsetn
"invalidTextvalue"*	string	Manage textvalue if the data in invalid
textvalue1_to_n *	string	Manage texvalue to use for each step between minData (or close to minData) with textvalue1 and maxData (or close to maxData) with textvaluen Note, can include formatting string if "dynValue" is set to true within view

*Schlüssel seit Custom Watchface V2.0 hinzugefügt (verfügbar in AAPS 3.3.0 Wear-Apk oder höher)

DynDaten-Schlüsselwerte

Schlüsselwert	Schlüssel [key]	comment
"sgv" "sgv_Ext1" * "sgv_Ext2" *	valueKey	default minData = 39 mg/dl default maxData = 400 mg/dl - Beachte, dass der tatsächliche MaxData mit Deinem Sensor verknüpft ist und die Einheiten für interne Werte immer mg/dl sind
"sgvLevel" "sgvLevel_Ext1" * "sgvLevel_Ext2" *	valueKey	default minData = -1 (Hypo) default maxData = 1 (Hyper) if BG is within Range = 0
"direction" "direction_Ext1" * "direction_Ext2" *	valueKey	default minData = 1 (double Down) default maxValue = 7 (double Up) flat arrow data = 4 Error or missing data = 0 (??)
"delta" "delta_Ext1" * "delta_Ext2" *	valueKey	default minData = -25 mgdl default maxData = 25 mgdl - Berücksichtige, dass die wahren min und maxData darüber liegen können und dass intern immer mgdl als Einheit verwendet wird
"avg_delta" "avg_delta_Ext1" * "avg_delta_Ext2" *	valueKey	default minData = -25 mgdl default maxData = 25 mgdl - Berücksichtige, dass die wahren min und maxData darüber liegen können und dass intern immer mgdl als Einheit verwendet wird
"tempTarget"* "tempTarget_Ext1" * "tempTarget_Ext2" *	valueKey	Default minData = 0 (Profil-Ziel) Default maxData = 2 (temporäres Ziel) Ziel wurde durch Loop angepasst = 1 Default oder fehlende Informationen = 0
"reservoir"* "reservoir_Ext1" * "reservoir_Ext2" *	valueKey	default minData = 0 U default maxData = 500 U
"reservoirLevel"* "reservoirLevel_Ext1" * "reservoirLevel_Ext2" *	valueKey	default minData = 0 (Standardfarbe) default maxData = 2 (Farbe für „Dringend“) Warnfarbe = 1
"uploader_battery"	valueKey	default minData = 0 % default maxData = 100%
"rig_battery" "rig_battery_Ext1" * "rig_battery_Ext2" *	valueKey	default minData = 0 % default maxData = 100%
"timestamp" "timestamp_Ext1" * "timestamp_Ext2" *	valueKey	default minData = 0 min default maxData = 60 min
"loop" "loop_Ext1" * "loop_Ext2" *	valueKey	default minData = 0 min default maxData = 28 min - Beachte, dass Statuspfeile für Werte unter 14 min grün sind, und rot für Werte über 14 min sind. Wenn Du hier 2 Bilder hinterlegst, kannst Du den Status-Hintergrund mit Deinem eigenen Bild und mit default min and maxData ersetzen
"Tag"	valueKey	default minData = 1 default maxData = 31
"day_name"	valueKey	default minData = 1 default maxData = 7
"month"	valueKey
"week_number"	valueKey	default minData = 1 default maxData = 53

*Schlüssel seit Custom Watchface V2.0 hinzugefügt (verfügbar in AAPS 3.3.0 Wear-Apk oder höher)

DynPref-Schlüssel

Key	Typ	comment
"dynPref"	block	Definiere den Block aller dynamischen Einstellungs-Blöcke, die für die Ansichten verwendet werden. In der Regel nach der letzten Ansicht oder dem letzten dynData-Block. Alle in diesem Block definierten Schlüssel werden als Schlüsselwert innerhalb des View Blocks verwendet: "dynPref": { dynPref blocks } und jeder Block ist durch einen benutzerdefinierten Namen und mehrere Schlüssel definiert: "customName": { one dynPref block }
"dynPref"	string	Name des dynamischen dynPref-Blocks, der innerhalb eines View-Blocks genutzt wird (generell identisch mit dem, der für den View-Schlüssel oder der entsprechenden Eigenschaft (Preference) verwendet wird).
"dynPref"	string	In einem partiellen dynData-Block in einem DynPref-Block : Name des dynamischen DynPref-Blocks, um den dynData Block zu abzuschließen. Das ermöglicht Dir, einen dynData-Block auf Basis mehrerer Einstellungen (Preferences) einzustellen
"dynPrefColor"	string	Dieser Schlüssel gilt ausdrücklich für den Main-Block und dessen wesentlichen Farben (highColor, midColor, lowColor, graph colors…). Du kannst dies nutzen, um die Standardfarben auf Basis der Einstellungen (Preferences) zu verändern
"prefKey"	string	Gib hier den Schlüsselwert der Einstellung an, der genutzt werden soll, um die benutzerdefinierten Einstellungen zu erhalten (siehe PrefKey-Werte unten). Dieser Schlüssel sollte innerhalb eines dynPref Blocks verwendet werden. Dann sollte der dynPref-Block genau so viele Schlüssel wie prefKey Werte enthalten. Beachte, dass die meisten Zeiteinstellungen „Boolean“ sind, also solltest Du innerhalb des dynPref-Blocks diese beiden dynData-Blöcke finden: "true": { dynData Block }, "false": { dynData Block }
"true"	block	Die meisten Einstellungen werden als boolean "true" oder "false" gesetzt. You will specify the dynData block to use if preference selected by user is true. Note that if the block also contains a "dynPref":key, the dynData block will be merged with other block. Das ermöglicht Dir beispielsweise Farben mit einer Einstellung und die Textgröße auf Basis einer anderen Einstellung zu setzen
"false"	block	Die meisten Einstellungen werden als boolean "true" oder "false" gesetzt. You will specify the dynData block to use if preference selected by user is false. Note that if the block also contains a "dynPref":key, the dynData block will be merged with other block. Das ermöglicht Dir beispielsweise Farben mit einer Einstellung und die Textgröße auf Basis einer anderen Einstellung zu setzen

PrefKey-Werte

Alle Schlüssel, die im obigen Kapitel Einstellungen-Schlüssel enthalten sind, können verwendet werden, um Ansichtsparameter anzupassen

Du kannst auch die zusätzlichen Schlüssel unten verwenden, die in die AAPS (benutzerdefiniert)-spezifischen-Parameter aufgenommen sind:

Key	Typ	comment
"key_units"	boolean	true: wenn in AAPS mg/dl als Einheiten ausgewählt ist false: wenn die auf AAPS gewählten Einheiten mmol/dl sind
"key_dark"	boolean	true: Um einen dunklen Hintergrund zu setzen false: Um einen hellen Hintergrund zu verwenden: Dieser Parameter wird oft in älteren AAPS-Zifferblättern verwendet (AAPS, AAPS V2…)
"key_match_divider"	boolean	true: Trennstrich in AAPS, AAPS v2 Watchfaces werden nicht sichtbar sein false: Trennstrich in AAPS, AAPS v2 Watchfaces werden sichtbar sein Hinweis: Diese Einstellung wird oft mit dunklen Voreinstellungen kombiniert (Verwendung des dynPref-Schlüssels im dynData-Block), um Textfarbe (und Hintergrund) auf die gleiche oder die entgegengesetzte Farbe zu setzen als die des dunklen Parameters…