Widgets
Ein Widget ist ein kompletter, vorgefertigter Block mit Timer-Inhalten: der Countdown mit Blinds und Spieleranzahl, eine Auszahlungsliste, eine Knockout-Rangliste. Statt Zelle für Zelle zu bauen, setzt du ein Widget ein, und es kommt fertig gestaltet und bereits mit den laufenden Turnierdaten verdrahtet an.
Die Galerie öffnest du aus dem Bearbeitungsmodus: Tippe auf eine Schaltfläche + dort, wo der Block landen soll, und wähl dann Widget.
Eingebaute Widgets
Abschnitt betitelt „Eingebaute Widgets“Dreizehn Widgets werden mitgeliefert. Die meisten blenden sich aus, bis das Turnier tatsächlich etwas zu zeigen hat, du kannst sie also jederzeit gefahrlos hinzufügen: Ein Auszahlungs-Widget, das eingesetzt wird, bevor jemand eingekauft hat, bleibt einfach unsichtbar, bis Geld hereinkommt.
| Widget | Zeigt | Erscheint, wenn |
|---|---|---|
| Eliminierungen | Die fünf Spieler mit den meisten Knockouts, mit ihren Summen | Jemand ausgeschieden ist |
| Kopfgelder | Die zehn besten Kopfgeld-Gewinner und ihre Gewinne | Das Turnier Kopfgeld-Chips nutzt und jemand einen gewonnen hat |
| Punkte | Die Endplatzierung — die zehn besten Platzierungen und die Punkte, die jeder erzielt hat | Das Turnier beendet ist |
| Auszahlungen | Die Preisliste — Platz, Spieler und Betrag in drei ausgerichteten Spalten | Geld eingesammelt wurde |
| Beste Hand | Wer die aktuelle beste Hand hält, ihr Name und ihre Karten | Eine beste Hand erfasst wurde |
| Chip Leader | Die drei aktiven Spieler mit den größten Stapeln, mit ihren Summen | Ein Spieler einen Chipstand gemeldet hat und das Turnier noch läuft |
| Chips tauschen! | Welche Chipwerte vom Tisch genommen werden sollen, gezeichnet als die Chips selbst | Pause ist und die Blinds seit der letzten Pause über einen Chip hinausgewachsen sind |
| Rebuy-Countdown | Wie viel von der Rebuy-Phase noch übrig ist | Rebuys an sind, eine Rebuy-Phase gesetzt ist und das Turnier läuft |
| Timer | Der komplette Standardblock — Turniertitel, Level-Titel und -Untertitel, die Countdown-Uhr, ein Banner Chips tauschen! und die nächsten drei Widgets darin verschachtelt | Bis das Turnier beendet ist |
| Blinds und Antes | Small und Big Blind des aktuellen Levels, dazu ein etwaiges Ante | Das Level einen Blind oder ein Ante hat |
| Nächstes Level und Pause | Was als Nächstes kommt — die nächsten Blinds oder die Länge der nächsten Pause, und wie lange es bis zur übernächsten dauert | Nach dem aktuellen Level noch eines kommt |
| Spieleranzahl usw. | Verbleibende Spieler von der Gesamtzahl, durchschnittlicher Stapel und Big Blinds im Spiel | Chips im Spiel sind |
| Aktuelle Uhrzeit | Die Tageszeit | Immer |
Auszahlungen, Kopfgelder und Eliminierungen folgen denselben Daten wie die Bildschirme Auszahlungen, Kopfgelder und Spieler verwalten, sie aktualisieren sich also, während du das Turnier leitest.
Das Standard-Timer-Layout ist aus genau diesen gebaut: ein Rebuy-Countdown, ein Timer, ein Punkte und eine Beste Hand in einer Spalte, dazu Auszahlungen, Eliminierungen und Chip Leader in einer anderen. Das Layout des Auszahlungs-Bildschirms ist ein Punkte, ein Auszahlungen und ein Kopfgelder nebeneinander.
Weil diese Bedingungen einander ausschließen, ändert der Bildschirm seinen Charakter, sobald der letzte Spieler ausscheidet — siehe Wenn das Turnier endet.
Das Widget Punkte ist die Endplatzierung: alle, die das Turnier beendet haben, der Sieger zuerst, mit den erzielten Punkten in zwei ausgerichteten Spalten. Es listet die besten zehn und markiert ein größeres Feld mit einem angehängten „…“.
Die Punkte stammen aus der Punkteformel für Spieler im Statistik-Bildschirm — derselben Formel, die auch die Rangliste der Club-Statistik speist. Welche Wertung deine Liga auch nutzt, das Widget zeigt sie. Es gibt nichts einzurichten und nichts abzugleichen: Änderst du die Formel, folgt das Widget.
Es wartet, bis das Turnier vorbei ist, denn vorher würden sich die Zahlen ständig ändern. Ein Spieler erzielt erst Punkte, wenn er einen Platz hat, mitten im Turnier würde die Liste also mitwachsen. Schlimmer noch: Ein Rebuy löscht diesen Platz und schiebt alle anderen nach oben, was bereits angezeigte Punkte wieder zurücknehmen würde. Ist der letzte Spieler ausgeschieden, stehen alle Plätze fest und der Sieger kommt hinzu.
Willst du der Platzierung stattdessen beim Wachsen zusehen, ist es sicherer, das Ende der Rebuy-Phase abzuwarten, als die Bedingung ganz zu streichen:
!rebuysOpen && playersEliminated.count > 0Sind die Rebuys geschlossen, kann kein Platz mehr zurückgenommen werden, die Punkte wachsen also nur noch. Trag diese Bedingung an allen vier Stellen ein: am Block und an jedem der drei Inhalte darin (siehe Ein Widget kann zwei Bedingungen haben). Hat das Turnier kein Rebuy-Endlevel, wird rebuysOpen nie falsch, nimm dann nur playersEliminated.count > 0.
Punkte ist Teil des Standardlayouts und des Auszahlungs-Bildschirms — ein Turnier, das du nicht angepasst hast, zeigt die Platzierung am Ende also von selbst. Hast du dein Layout angepasst, bleibt es so, wie du es gebaut hast: Füge Punkte aus der Galerie dort ein, wo du es haben willst.
Jeder Text, den du schreibst, kann dieselben Werte lesen: p.points liefert die Punkte eines Spielers nach deiner Formel. Siehe Turnierdaten.
Chip Leader
Abschnitt betitelt „Chip Leader“Das Widget Chip Leader wird von den Chipständen gespeist, die die Spieler selbst melden. Wenn Spieler sich mit einem geteilten Turnier verbinden und ihre aktuellen Chips melden (siehe Spielerprofil-Updates), verfolgt die App den jeweils letzten Stand jedes aktiven Spielers und listet die drei größten Stapel auf: Namen und Summen in zwei ausgerichteten Spalten, meiste Chips zuerst, wie beim Widget Eliminierungen. Ist ein vierter Spieler mit dem dritten angezeigten gleichauf, markiert ein angehängtes „…“, dass die Rangliste dort nicht endet.
Chips tauschen!
Abschnitt betitelt „Chips tauschen!“Wenn die Blinds steigen, werden die kleinsten Chips überflüssig: Niemand wechselt eine 25, wenn der Small Blind bei 500 liegt. Das Widget Chips tauschen! achtet darauf und nennt bei jeder Pause die Werte, die seit der vorherigen Pause entbehrlich geworden sind: ein kompaktes oranges Banner mit Chips tauschen!, gefolgt von den Chips selbst, gezeichnet als deine echten Chipbilder.
Es zeigt nur die Chips, die vom Tisch gehen. Welcher Chip daraus wird, bleibt bewusst weg, denn diesen zweiten Chip lesen die Leute so, als würde auch er entfernt.
Ein Chip wird nur einmal vorgeschlagen. Sind die 25er bei der ersten Pause unnötig geworden, erwähnt die zweite Pause sie nicht noch einmal, sondern nennt, was seither entbehrlich geworden ist. Und ein Chip wird nie vorgeschlagen, solange ihn ab dem aktuellen Level noch irgendein Blind, Ante oder Bring-in braucht.
Das Banner gehört zum Standardblock Timer, ein neues Turnier bekommt es in den Pausen also ohne dein Zutun. Es liegt außerdem einzeln in der Galerie, für selbst gebaute Layouts.
Angetrieben wird es vom Wert colorUpChips, siehe Turnierdaten. Jeder Text, den du schreibst, kann ebenfalls Chips zeigen: Tipp den Wert eines Chips gefolgt von einem s (25s, 1,000s) in einen Inhalt, und der Timer zeichnet an dieser Stelle den Chip statt des Texts.
Rebuy-Countdown
Abschnitt betitelt „Rebuy-Countdown“Setz in den Einstellungen Rebuys enden nach, und dieses Widget erscheint für den Rest der Rebuy-Phase auf dem Timer und verschwindet von selbst, wenn die Phase schließt. Es zählt die Pause nach dem letzten Rebuy-Level zur Phase dazu, läuft also durch die Pause weiter, in der Rebuys und Addons üblicherweise genommen werden.
Was es sagt, hängt von der Uhr ab. Bei laufendem Timer zählt es herunter: „Rebuys enden in 32:00!“ Eine Restzeit sagt bei stehender Uhr nichts aus, beim Pausieren wechselt es deshalb dazu, die Frist zu benennen: „Rebuys enden nach Level 3!“
Das sind zwei Inhalte, rebuy countdown und rebuy countdown paused, mit entgegengesetzten Bedingungen in einer Zelle gestapelt, sodass immer nur einer zu sehen ist. Bearbeite einen davon, um ihn umzuformulieren, siehe Inhalt.
Die Bedingungen hinter „Erscheint, wenn“
Abschnitt betitelt „Die Bedingungen hinter „Erscheint, wenn““An der Spalte „Erscheint, wenn“ ist nichts fest verdrahtet. Jedes eingebaute Widget trägt eine ganz normale Bedingung, die du nach dem Einsetzen lesen, ändern oder entfernen kannst. Wähl im Bearbeitungsmodus die äußerste Zelle des Widgets aus und öffne Bedingung:
| Widget | Bedingung |
|---|---|
| Eliminierungen | playersEliminated.count > 0 |
| Kopfgelder | useBountyChips && players.where(func(p) { p.bountyChipWinnings > 0 }).count > 0 |
| Punkte | isPostgame |
| Auszahlungen | totalCollected > 0 |
| Beste Hand | hasHighHand |
| Chip Leader | chipLeaders.isNotEmpty && !isPostgame |
| Timer | !isPostgame |
| Chips tauschen! | isBreakLevel && colorUpChips.isNotEmpty |
| Rebuy-Countdown | rebuysAllowed && secondsUntilRebuysEnd > 0 && isInGame && !isPregameLevel |
| Blinds und Antes | currentLevel.bigBlind > 0 || currentLevel.ante > 0 |
| Nächstes Level und Pause | levelIndex + 1 < levels.length |
| Spieleranzahl usw. | totalChipsInPlay > 0 |
Aktuelle Uhrzeit hat keine Bedingung, deshalb ist sie immer zu sehen.
Ein Widget kann zwei Bedingungen haben
Abschnitt betitelt „Ein Widget kann zwei Bedingungen haben“Die Bedingung des Blocks ist nicht immer die einzige. Mehrere Widgets tragen zusätzlich eine Bedingung an den Inhalten darin, und ein Block, dessen Inhalte alle verborgen sind, zeigt gar nichts. Änderst du bei diesen die äußere Bedingung, kann das Widget also unsichtbar bleiben, weil der Inhalt es weiter zurückhält:
| Widget | Inhalte | Ihre Bedingung |
|---|---|---|
| Punkte | points title, points names, points totals | isPostgame |
| Beste Hand | high hand title, high hand | hasHighHand |
| Chip Leader | chip leader title, chip leader names, chip leader totals | chipLeaders.isNotEmpty |
| Chips tauschen! | color up title, color ups | isBreakLevel && colorUpChips.isNotEmpty |
| Rebuy-Countdown | rebuy countdown, rebuy countdown paused | die Bedingung des Widgets, dazu isTimerRunning beim ersten und !isTimerRunning beim zweiten |
Um sie zu erreichen, wähl eine Textzelle im Block und öffne Inhalt: Der markierte Eintrag hat einen Knopf Bearbeiten, und Inhalt verwalten oben rechts listet alle auf. Alle übrigen eingebauten Widgets lassen ihre Inhalte ohne Bedingung, dort ist die äußere Bedingung die einzige Sperre.
Das ⓘ auf einer verborgenen Karte in der Galerie nennt genau die Bedingung, die gerade blockiert. Das ist der schnellste Weg, die beiden auseinanderzuhalten. Siehe Warum ein Widget leer aussieht.
Wenn das Turnier endet
Abschnitt betitelt „Wenn das Turnier endet“Scheidet der letzte Spieler aus, wird der Timer-Bildschirm zur Ergebnistafel. Nichts wird von Hand abgeschaltet: Die Widgets haben schlicht einander ausschließende Bedingungen, und isPostgame kippt in dem Moment, in dem das Turnier einen Sieger hat.
Weg ist alles, was ein laufendes Spiel beschreibt:
- der Timer-Block und mit ihm Turniertitel, Uhr, Blinds, nächstes Level und Spieleranzahl
- Chip Leader, denn es gibt keine Stapel mehr, die führen könnten
- die Chip-Bilder und die Tischdiagramme am Rand des Bildschirms
An ihrer Stelle erscheint Punkte neben dem, was ohnehin schon da war: Auszahlungen, Eliminierungen und die Beste Hand.
Chips und Tische sind der eine Teil, der keine Widget-Bedingung ist, und funktionieren deshalb etwas anders: Sie auszublenden ist nur die Voreinstellung. Eine Ansicht, die sie ausdrücklich anfordert, bekommt sie weiterhin — darum zeigt die Ansicht Sitzplan weiter den Tisch des Siegers, statt leer zu bleiben. Siehe Wenn das Turnier vorbei ist.
Alles daran kannst du ändern. Lösch !isPostgame aus der Bedingung des Timer-Blocks, und die Uhr bleibt nach dem Spiel stehen. Punkte braucht einen Schritt mehr, denn seine drei Inhalte tragen isPostgame ebenfalls: Lösch es auch dort, und es zeigt die Platzierung schon im Aufbau, mitsamt wandernder Zahlen. Siehe Ein Widget kann zwei Bedingungen haben.
Warum ein Widget leer aussieht
Abschnitt betitelt „Warum ein Widget leer aussieht“Jede Karte in der Galerie ist eine Live-Vorschau, gezeichnet mit deinem Turnier im aktuellen Zustand, kein Musterbild. Das ist nützlich, bedeutet aber, dass ein Widget ohne etwas zu sagen leer aussieht.
Passiert das, zeigt die Karte ein durchgestrichenes Auge und eine Schaltfläche ⓘ (deren Tooltip Derzeit ausgeblendet lautet). Tippst du darauf, erklärt die App den Grund im Klartext:
- Die Bedingung „…“ ist derzeit falsch. — die Bedingung des Widgets selbst oder die des Inhalts darin ist noch nicht erfüllt
- „…“ hat derzeit keinen Wert. — der Inhalt löst sich auf, liefert aber keinen Text
- Fehlende Variable „…“. — eine Textzelle zeigt auf einen Inhalt, den es nicht mehr gibt
- Das Widget hat keinen Inhalt. — eine leere Zeile oder Spalte
Eine leere Karte ist fast nie ein Problem. Füg das Widget trotzdem ein; es füllt sich, sobald das Turnier so weit ist.
Eigene Widgets speichern
Abschnitt betitelt „Eigene Widgets speichern“Hast du einen Block gebaut, der dir gefällt, wähl seine äußerste Zelle aus und tippe auf Als Widget speichern. Gib ihm einen Namen, und er reiht sich neben den eingebauten in die Galerie ein, bereit für jedes Turnier.
Gespeicherte Widgets liegen bei deinem Konto, sie folgen dir also auf alle deine Geräte, solange du angemeldet bist.
Jeder eigene Inhalt, den das Widget nutzt, reist mit. Setzt du das Widget in ein anderes Turnier ein, kommen diese Inhalte mit, wobei jeder Name übersprungen wird, den dieses Turnier schon hat. Dein vorhandener Inhalt wird also nie überschrieben.
Die Galerie verwalten
Abschnitt betitelt „Die Galerie verwalten“Sortieren und Bearbeiten erscheinen in der Symbolleiste der Galerie, sobald du mindestens ein Widget gespeichert hast.
- Sortieren ordnet die ganze Galerie nach Geändert oder Name, und die Wahl bleibt zwischen den Sitzungen erhalten. Eingebaute Widgets teilen sich ein einziges festes Änderungsdatum, das Sortieren nach Geändert hält sie also zusammen und schwemmt deine eigene Arbeit nach oben.
- Bearbeiten setzt auf jedes deiner gespeicherten Widgets eine Schaltfläche Umbenennen und Löschen. Löschen fragt nach einer Bestätigung. Eingebaute Widgets lassen sich weder umbenennen noch löschen. Willst du eine eigene Fassung von einem, setz es ein, pass es an und speicher das Ergebnis unter einem neuen Namen.
Solange Bearbeiten an ist, setzt ein Tipp auf eine Karte sie nicht mehr ein. Tippe auf Fertig, um zum Einsetzen zurückzukehren.