app-button

Opis

Bloczek app-button udostępnia w aplikacji mobilnej oraz w interfejsie WWW wirtualny przycisk powiązany z logiką projektu.

Kliknięcie tego przycisku przez użytkownika nie przełącza jego stanu na stałe, tylko generuje krótki impuls logiczny na wyjściu bloczka. Dzięki temu app-button może pełnić rolę przycisku wyzwalającego scenę, akcję jednorazową albo inne zdarzenie w logice.

Bloczek posiada jedno wejście i jedno wyjście. Wejście służy do ustawiania stanu prezentowanego użytkownikowi jako on albo off. Wyjście służy wyłącznie do zgłaszania kliknięć wykonanych w aplikacji mobilnej lub WWW.

Po dodaniu bloczka do projektu tworzona jest również powiązana reprezentacja urządzenia wirtualnego, dzięki której przycisk jest widoczny poza samym schematem logiki.

Parametry konfiguracyjne

Nazwa parametru	Wartość
name	Parametr opcjonalny. Określa nazwę widoczną dla użytkownika w aplikacji mobilnej i WWW. Brak tego parametru nie blokuje pracy bloczka.
default_on	Parametr obowiązkowy typu logicznego true albo false. Określa stan przycisku widoczny po uruchomieniu projektu, zanim na wejście bloczka dotrze pierwsza poprawna wartość logiczna.

Obsługa wejścia

Bloczek reaguje wyłącznie na wartości logiczne true i false podawane bezpośrednio na jego wejście. Nie korzysta z wejść oznaczanych za pomocą bloczka tag.

Szczegółowe zasady działania:

• wartość true ustawia stan przycisku widoczny w aplikacji mobilnej i WWW na on
• wartość false ustawia stan przycisku widoczny w aplikacji mobilnej i WWW na off
• zmiana stanu wejścia aktualizuje wyłącznie prezentowany stan przycisku i opis widoczny pod bloczkiem
• zmiana stanu wejścia nie powoduje wysłania żadnego zdarzenia na wyjście
• wartości inne niż logiczne, takie jak liczby, tekst, komendy z bloczka command albo null, są ignorowane
• po uruchomieniu projektu bloczek przyjmuje stan początkowy zgodny z parametrem default_on

Opis widoczny pod bloczkiem pokazuje bieżący stan oraz liczbę kliknięć wykonanych przez użytkownika, na przykład off, clicks: 0 albo on, clicks: 3.

Licznik kliknięć zwiększa się tylko po kliknięciu przycisku w aplikacji mobilnej albo WWW. Sama zmiana wartości na wejściu bloczka nie zwiększa tego licznika.

Wyjście bloczka

Bloczek posiada jedno wyjście.

Każde kliknięcie wykonane przez użytkownika w aplikacji mobilnej albo WWW powoduje wygenerowanie krótkiego impulsu logicznego:

• najpierw na wyjściu pojawia się wartość true
• zaraz potem bloczek wysyła wartość false

Oznacza to, że pojedyncze kliknięcie przycisku powoduje sekwencję false -> true -> false na wyjściu. Taki sygnał może zostać wykorzystany na przykład do wyzwalania dalszych akcji jednorazowych w logice.

Po uruchomieniu projektu bloczek ustawia wyjście w stanie false.

Błędy zwracane przez bloczek

Bloczek może zwracać następujące błędy:

Kod błędu	Opis błędu
Missing default_on configuration.	Parametr default_on nie został podany albo ma niepoprawną wartość. Bez tej konfiguracji bloczek nie wie, jaki stan początkowy ma prezentować użytkownikowi.

Przykłady działania

• Jeśli default_on = false, to po uruchomieniu projektu przycisk będzie widoczny jako off, a opis pod bloczkiem pokaże off, clicks: 0.
• Jeśli na wejście bloczka zostanie podana wartość true, to przycisk w aplikacji mobilnej i WWW zmieni stan na on, ale na wyjściu nie pojawi się żaden nowy sygnał.
• Jeśli użytkownik kliknie przycisk widoczny w aplikacji mobilnej albo WWW, bloczek wyśle na wyjście krótki impuls true, a następnie false.
• Jeśli po trzech kliknięciach przycisku wejście nadal ma wartość false, opis pod bloczkiem będzie miał postać off, clicks: 3.
• Jeśli na wejście bloczka dotrze liczba, tekst, komenda z bloczka command albo null, zdarzenie zostanie zignorowane.