Gra w chmurze - Powiadomienia na Telegram o nowej turze

Pewną niedogodnością przy grze w chmurze jest konieczność uruchomienia aplikacji Steam, aby sprawdzić czy już jest twoja kolej. Zastanawiając się jak usprawnić komunikację pomiędzy graczami, znalazłem w sieci poniższy artykuł klik[blog.bjhomer.com] opisujący jak wykorzystać do tego celu aplikację IFTTT.

Inspirując się powyższym artykułem, utworzyłem działające powiadomienia o kolejnej turze, wysyłane do aplikacji Telegram. Aplikację Telegram natomiast można mieć zainstalowaną np. na telefonie, aby otrzymywać informacje z Civ w każdej sytuacji.

Przedstawiona w tym poradniku konfiguracja Cywilizacji tyczy się nowo złożonych gier!. Gry które są w trakcie, nie odczytują żadnych zmian w konfiguracji. Można podobno kombinować z zapisaniem gry i stworzeniu nowej gry na podstawie sejwa, ale nie testowałem tego rozwiązania.

• Aplikacja Telegram [telegram.org]
  
• Utworzony w aplikacji Telegram kanał, np CIV6NOTIFY. Może być prywatny. Do tego kanału zapraszamy znajomych z którymi gramy w CIVkę
  
• Konto na stronie IFTTT[ifttt.com]. Strona służy do łączenia różnych usług/aplikacji - akcja w jednej aplikacji powoduje reakcję w drugiej. Darmowe są trzy takie połączenia (applets)

Do swego Telegrama musisz zaprosić bota @IFTTT i dołączyć go do kanału, na którym będą wyświetlane notyfikacje.

Aby dodać bota musisz wejść w link https://ifttt.com/telegram i klinąć Connect.
(Bezpośredni link do bota, jeżeli nie działa powyższy: https://telegram.me/IFTTT)

Po kliknięciu któregokolwiek podanego wyżej linka, powinien otworzyć się twój Telegram z okienkiem czatu bota. Kliknij przycisk Rozpocznij na dole okna.

Następnie należy zautoryzować bota, poprzez kliknięcie przycisku Authorize IFTTT. Jeżeli brak tego przycisku, wydaj botowi jakąkolwiek komendę. (To wszystko w okienku czatu @IFTTT)

Podczas autoryzacji zostaniesz znowu przekierowany na stronę IFTTT.com, na którą musisz ponownie się zalogować (jeśli przeglądarka nie zalogowała cię automatycznie).

Jeżeli poszło wszystko dobrze, powinieneś w Telegramie zobaczyć:

Do utworzonego wcześniej przez ciebie kanału w programie Telegram, zaproś bota @IFTTT jako administrator kanału: Zarządzaj kanałem --> Administratorzy --> Dodaj administratora. Bot nie jest wyświetlany na liście członków, więc musisz wpisać jego nazwę (@IFTTT) w polu szukaj.

Wróć do okienka z czatem @IFTTT i wydaj komendę /connect_channel

Wróć do swego kanału, wpisz jakąkolwiek informację w okienku kanału, następnie ja przekaż do @IFTTT, klikając na wiadomości prawym przyciskiem:
W odpowiedzi, na czacie @IFTTT powinieneś zobaczyć komunikat:

To tyle jeśli chodzi o konfigurację Telegrama. Teraz pora na ustawienie powiadomień na stronie IFTTT.com

Zaloguj się na stronie https://iftt.com i kliknij Create, lub wejdź w poniższy link IFTTT[ifttt.com].
Powinieneś zobaczyć ekran podobny do tego co umieściłem poniżej:
Kliknij IF THIS, Znajdź i kliknij kafelek Webhooks.
Tutaj powinieneś widzieć co najmniej dwie opcje. Ciebie interesuje Recive a web request którą wybierasz. W polu Event Name wpisujesz dowolną nazwę zdarzenia, bez spacji, i ją zapamiętujesz (np: civ6_turn_notification - ta nazwa będzie potrzebna na kolejnych etapach tego poradnika).
Kliknij Update trigger aby zatwierdzić zmiany. Powinieneś być z powrotem na ekranie startowym tworzenia nowego apletu. Kliknij teraz Then That aby przejść do kolejnej podstrony. Znajdź kafelek Telegram (najlepiej skorzystać z wyszukiwarki) i go kliknij (na tym etapie można wybrać inną usługę niż Telegram). Wybierz akcję Send message

• Target chat: powinien być do wyboru twój kanał Telegram, skonfigurowany wcześniej. Jeżeli go nie widzisz, cofnij się do rozdziału Konfiguracja bota IFTTT w Telegramie
  
• Message text: tutaj należy umieścić treść powiadomienia które będzie wyświetlane w Telegramie. Można wykorzystać zmienne które będą wysyłane przez CIVkę (w podwójnych wąsach {{Value}}):
  
  • Value1 - nazwa gry
    
  • Value2 - nazwa gracza
    
  • Value3 - numer tury
  Ja użyję kominkatu: Tura {{Value3}} gracza <b>{{Value2}}</b>

Kliknij Update action a następnie Update, aby zakończyć tworzenie apletu IFTTT.

Jeżeli jest wszystko skonfigurowane poprawnie, powinieneś widzieć mniej więcej podobny ekran:

Oczywiście możesz kliknąć Edit title aby zmienić nazwę apletu.

Wejdź na stronę Webhooks Settings[ifttt.com] i skopiuj URL , który jest w postaci https://maker.ifttt.com/use/_key_ gdzie _key_ to twój klucz.
Teraz musisz zbudować URLa na który będą słane powiadomienia z civki. Url wygląda tak: https://maker.ifttt.com/trigger/_webhookname_/with/key/_key_ gdzie:

• _webhookname_ to Event name użyty w w poprzednim rozdziale w punkcie 1.b. W tym poradniku użyłem nazwy civ6_turn_notification
  
• _key_ to klucz z akapitu wyżej

Ostatecznie url powinien wyglądać mniej więcej tak: https://maker.ifttt.com/trigger/civ6_turn_notification/with/key/xxxxyyyyzzzz Należy wiedzieć że zmiana konfiguracji poniższych ustawień działa tylko na nowe gry.
W Cywilizacji przechodzimy do Ustawień gry --> Gra:

• Adres URL elementu webhook gry w chmurze: wstawiamy powyższy adres
  
• Częstotliwość elementu webhook gry w chmurze: dowolnie

Potwierdzamy i zakładamy nową grę.

• Przedstawiona w tym poradniku konfiguracja Cywilizacji tyczy się nowych gier!. Gry które są w trakcie nie stosują żadnych zmian w konfiguracji. Można podobno kombinować z zapisaniem gry i stworzeniu nowej gry na podstawie sejwa, ale nie testowałem tego rozwiązania.
  
• Czasem słane są podwójne powiadomienia na telegram, i ma to chyba związek z opcją Częstotliwość elementu webhook gry w chmurze: w każdej turze - ale tego nie sprawdziłem.
  
• Czasem nie są słane w ogóle powiadomienia na telegram. Mi na 100 tur (200 powiadomień przy dwóch osobach) zdarzyło się to z 2 razy. Wówczas ręcznie wpisywałem na kanał informację że skończyłem turę