Tabele wyników

Tabele wyników mogą być ciekawym sposobem na zachęcenie graczy do rywalizacji. Dotyczy to zarówno najbardziej zagorzałych fanów (którzy będą walczyć o pierwsze miejsce na publicznej tabeli wyników), jak i mniej zaangażowanych graczy (którzy będą chcieli porównać swoje postępy z tymi swoich znajomych).

Aby dowiedzieć się, jak wdrożyć tablice liderów na swojej platformie, zapoznaj się z artykułem Wdrażanie klienta.

Tabele wyników

Gdy utworzysz tablicę wyników, Usługi Google Play zajmą się zarządzaniem większością jej aspektów. Typowy proces wygląda tak:

1. Pod koniec gry (lub w odpowiednim momencie określonym przez Ciebie) gra przesyła wynik gracza na co najmniej jedną z tablic wyników utworzonych dla tej gry.
2. Usługi gier Play sprawdzają, czy wynik jest lepszy niż aktualny wynik gracza na tablicy wyników w przypadku wyniku dziennego, tygodniowego lub łącznego. Jeśli tak, Usługi gier Play zaktualizują odpowiednie tabele wyników, uwzględniając nowy wynik.
3. Usługi gier Play wysyłają raport o wyniku z powrotem do klienta gry. Ten raport informuje klienta, czy jest to nowy wynik dzienny, tygodniowy czy wszechczasów. Jeśli tak nie jest, usługi Play Games przekazują klientowi aktualny wynik dzienny, tygodniowy lub wszechczasów danego gracza.
4. Aby pobrać wyniki gracza w tabeli wyników, możesz poprosić o określony przedział czasowy (codziennie, co tydzień lub od początku) i określić, czy użytkownik chce zobaczyć tabelę wyników społecznościowych czy publiczną. Usługi Play Games wykonują wszystkie niezbędne filtrowanie, a potem wysyłają wyniki z powrotem do klienta.
5. Jeśli do raportu ma zostać dodane dużo wyników, Usługi Google Play dotyczące Gier zwracają tylko dane o najlepszych wynikach w tabeli wyników. Możesz też pobrać dane dotyczące surowych wyników dla najlepszych wyników lub wyników sąsiadujących z graczem.

Wiele tabel wyników

Gry mogą mieć wiele tabel wyników (maksymalnie 70). Na przykład gra wielopoziomowa może mieć oddzielną tablicę liderów dla każdego poziomu, a gra wyścigowa może mieć oddzielną tablicę liderów dla każdej trasy.

Przedziały czasowe w tabeli wyników

Pakiet SDK Play Games automatycznie tworzy dzienne, tygodniowe i ogólne wersje każdej tworzonej przez Ciebie tablicy liderów. Nie musisz tworzyć osobnych tabel wyników dla poszczególnych okresów.

Codziennie tablice liderów są resetowane o godzinie UTC-7 (czyli o „północy czasu pacyficznego letniego”) przez cały rok.

Wyniki tygodniowe są resetowane o północy z soboty na niedzielę w tym samym strefie czasowej co wyniki dzienne (UTC-7).

Tabele wyników publiczne i społeczne

Pakiet SDK Play Games może wyświetlać graczom 2 różne wersje każdej tablicy liderów:

Tablica wyników społeczna to tablica wyników, na której znajdują się użytkownicy z kręgów użytkownika (a ściślej mówiąc, członkowie kręgów, które użytkownik zdecydował się udostępnić Twojej aplikacji), którzy zdecydowali się udostępnić użytkownikowi swoją aktywność w grze.

Tabela wyników publiczna to tabela wyników, która składa się z graczy, którzy zdecydowali się publicznie udostępniać swoją aktywność w grze. Jeśli gracz nie zdecydował się na publiczne udostępnianie swojej aktywności w grze, nie będzie widoczny na tej tablicy.

Wyświetlanie tabel wyników

W bibliotekach klienta na urządzenia mobilne biblioteki zajmują się formatowaniem i wyświetlaniem tabel liderów. Możesz określić, czy gracz może wyświetlać określoną tabelę wyników, czy też może wyświetlić listę wszystkich tabel wyników, spośród których może wybrać.

Możesz też wdrażać własne wersje tabel wyników, uzyskując dostęp do danych bezpośrednio z bibliotek klienta.

Atrybuty

Aby tworzyć tabele wyników i nimi zarządzać, musisz znać te atrybuty tabeli wyników:

Podstawy

Te podstawowe elementy są powiązane z każdą tablicą liderów:

• Identyfikator to unikalny ciąg znaków wygenerowany przez Konsolę Google Play. Użyjesz tego unikalnego identyfikatora, aby odwoływać się do tabeli wyników w klientach gry.
• Nazwa to krótka nazwa listy liderów (np. „Wysokie wyniki” lub „Poziom 3”). Może ona zawierać maksymalnie 100 znaków.
• Ikona to kwadratowa ikona, która będzie powiązana z Twoją tabelą wyników. Aby poznać najlepsze praktyki tworzenia ikonek na tablicy liderów, zapoznaj się ze wskazówkami dotyczącymi ikon.
• Kolejność na liście to kolejność, w jakiej tabela wyników będzie wyświetlana, gdy gracz będzie przeglądać tabele wyników powiązane z Twoją grą.
• Limity to opcjonalne wartości, które określają dolną i górną granicę wyników dozwolonych w tabeli. Pomoże Ci to odrzucić zgłoszenia wyników, które są wyraźnie nieuczciwe. Możesz też użyć Players.hide, aby ukryć graczy, którzy Twoim zdaniem przesłali wyniki uzyskane w nieuczciwy sposób, ze wszystkich tabel wyników w aplikacji.

Tabele wyników w kolejności

Tabele liderów mogą mieć jeden z 2 typów sortowania:

• Domyślnie wyświetlane są większe tablice liderów. W większości gier, w których gracze zdobywają punkty, jest to standardowa sytuacja.
• Mniej znaczy więcej – tablice wyników są czasami używane w przypadkach, gdy niższy wynik jest lepszy. Najczęstszym przykładem tego typu rankingu są gry wyścigowe, w których wynik reprezentuje czas potrzebny graczowi na ukończenie wyścigu.

Format wyniku

Wszystkie wyniki są przesyłane do tabel wyników i przechowywane wewnętrznie jako liczby całkowite długie, ale usługi gier Play mogą prezentować je użytkownikowi w kilku różnych formatach:

• Liczbowe tabele wyników zawierają wyniki w postaci liczb. Mogą być wyświetlane jako liczby całkowite lub liczby rzeczywiste z określoną liczbą miejsc po przecinku. Wynik jest przesyłany jako liczba całkowita, a separator dziesiętny jest wstawiany w określonym miejscu. Na przykład wynik 314159 będzie wyświetlany jako 3.14159, 3141.59 lub 314159, w zależności od miejsca po przecinku, które wybierzesz.

• Czas – na tablicach liderów z wyświetlanym czasem wyniki są podawane w godzinach / minutach / sekundach / setnych sekundy. Wyniki muszą być podawane w milisekundach, więc 66032 zostanie zinterpretowane jako 1:06.03.

• Waluta – tabele z wynikami w formie waluty. Przesyłane wyniki są wyrażone w 1/1 000 000 głównej jednostki waluty. Na przykład wynik 19 950 000 zostanie zinterpretowany jako $19.95, jeśli podasz walutę USD.

Tablice wyników liczbowych obsługują też jednostki niestandardowe. Jeśli na przykład w Twojej grze rekordy są mierzone w metrach, możesz ustawić „metry” jako domyślną jednostkę w tabeli wyników.

Tłumaczenia i formatowanie wyniku

Gdy mobilne biblioteki klienta proszą o dane z tablicy liderów z Usług Gier Google Play, podają język i lokalizację, w której mają być wyświetlane te wyniki. API REST umożliwia też określenie języka na podstawie lokalizacji. Usługi gier Play zwracają sformatowane wyniki na tablicy wyników odpowiednie dla danego języka i regionu. Sformatowane wyniki będą widoczne niezależnie od tego, czy dodasz tłumaczenia do swojej tabeli liderów.

W przypadku tablic liderów z liczbami format liczby wyświetla się inaczej w zależności od języka. (np. 12,345.78 w Stanach Zjednoczonych i 12 345,78 we Francji). Jeśli używasz jednostek niestandardowych i dodasz do gry tłumaczenia, musisz podać przetłumaczone jednostki dla każdego dodanego języka. Usługa wyświetla przetłumaczone jednostki w odpowiednich przypadkach.

W zależności od wybranego języka może być konieczne podanie różnych wersji nazw jednostek. W języku angielskim potrzebujesz wersji dla jednego elementu i innej dla wszystkich pozostałych (np. „meter” i „meters”). W języku polskim musisz natomiast podać wersję dla jednej jednostki, kilku jednostek i wielu jednostek oraz dla wszystkich innych. Więcej informacji o regułach liczby mnogiej znajdziesz w artykule Ilość(liczebniki).

W przypadku tablic liderów Czas format czasu jest wyświetlany zgodnie z językiem i ustawieniami regionalnymi gracza. Jest to szczególnie widoczne, jeśli używasz ułamków sekundy lub wartości godzin z większą liczbą cyfr niż 3 (np. 4,815:16:23.42 w Stanach Zjednoczonych i 4.815:16:23,42 w Niemczech).

W przypadku tabel liderów Waluta format waluty będzie wyświetlany zgodnie z językiem i ustawieniami regionalnymi gracza. Nie możesz jednak zmienić jednostki waluty. Jeśli na przykład podasz walutę w USD, w grze będzie wyświetlana wartość $19.95 w Stanach Zjednoczonych i 19,95 $ we Francji. Nie możesz jednak określić, że w Twojej grze dolary są wyświetlane w Stanach Zjednoczonych, a euro we Francji.

Wytyczne dotyczące ikon

Ikony powinny mieć wymiary 512 × 512 pikseli i format PNG lub JPEG. Ikony będą zmniejszane w większości klientów gier, dlatego nie twórz ikon z zbyt dużą ilością szczegółów. Możesz przesłać ikony z kanałem alfa, a przezroczystość zostanie zachowana. Ikona tabeli wyników będzie wyświetlana na ciemniejszym szarym tle na urządzeniach z Androidem, dlatego wybierz ikonę, która będzie dobrze wyglądać w tej sytuacji.

Ta sama ikona jest używana we wszystkich lokalizacjach, dlatego nie zalecamy umieszczania na niej tekstu ani treści zlokalizowanych.

Tworzenie tabeli wyników

Z tej sekcji dowiesz się, jak tworzyć tabele wyników dla nowych i dotychczasowych gier.

Tworzenie tabeli wyników dla nowej gry

Aby utworzyć tabelę wyników dla nowej, nieopublikowanej gry, otwórz jej wpis w Konsoli Google Play i kliknij Rozwój > Usługi gier Play > Konfiguracja i zarządzanie > Tabele wyników, a następnie kliknij przycisk Utwórz tabelę wyników.

Następnie wypełnij wymagane informacje na potrzeby tej tablicy liderów.

Kliknij Zapisz jako wersję roboczą, a tabela liderów będzie dostępna w stanie „Wersja robocza”. Po opublikowaniu gry wszystkie tabele wyników gry są publikowane razem z nią.

Tworzenie tabeli wyników dla opublikowanej gry

Aby utworzyć dodatkową tablicę liderów dla gry, która została już opublikowana, wykonaj te same czynności. Więcej informacji o testowaniu zaktualizowanej wersji gry znajdziesz w artykule Publikowanie zmian w grze.

Gdy przetestujesz tabelę wyników i będziesz zadowolony z jej działania, możesz ponownie opublikować grę z nowymi tabelami wyników, które zostaną udostępnione wszystkim graczom.

Edytowanie tabeli wyników

Aby edytować już utworzoną tabelę wyników, kliknij ją na karcie Tabele wyników w Konsoli Google Play. W tym momencie zobaczysz ten sam formularz, którego użyłaś/użyłeś podczas tworzenia tabeli wyników. Będziesz mieć możliwość edytowania dowolnego pola.

Gdy skończysz edytowanie tabeli wyników, kliknij przycisk Zapisz jako wersję roboczą. Nowo zmodyfikowana tabela wyników będzie miała stan „Wersja robocza”, co pozwoli Ci ją przetestować.

Jeśli wszystko działa prawidłowo, w polu u góry formularza tabeli wyników kliknij Opublikuj zmiany. Dzięki temu będziesz mieć możliwość ponownego opublikowania gry wraz ze wszystkimi zaktualizowanymi tabelami wyników.

Cofanie zmian

Jeśli uznasz, że nie podoba Ci się nowo zmodyfikowana tabela ligowa i chcesz wrócić do poprzedniej wersji, w polu u góry formularza tabeli ligowej kliknij Cofnij. Twoja tabela wyników wraca do już opublikowanej wersji.

Usuwanie tabeli wyników

Możesz usuwać tablice liderów, które są w stanie „Wersja robocza” lub które zostały opublikowane. Aby usunąć tabelę wyników w Konsoli Google Play, otwórz formularz tabeli i u góry kliknij Usuń tabelę wyników.

Możesz też zadzwonić pod numer Players.hide, aby ukryć tablicę wyników gracza w aplikacji.

Resetowanie tabeli wyników

Możesz zresetować dane o postępach graczy tylko w przypadku tabel draftu.

• Aby zresetować tabele wyników w Konsoli Google Play, kliknij Zresetuj postęp u góry formularza dla danego wydarzenia.
• Aby zresetować dane tabeli liderów za pomocą kodu, wywołaj metody interfejsu Management APIScores.

Dodawanie tłumaczeń tabel wyników

Możesz podać własne tłumaczenia tabel wyników powiązanych z Twoją grą. Zanim to zrobisz, wykonaj czynności opisane w artykule Dodawanie tłumaczeń do gry. Musisz też utworzyć co najmniej 1 tabelę wyników w swojej grze.

Aby dodać własne tłumaczenia tabel wyników, otwórz kartę Tabele wyników w Konsoli Google Play, a następnie wybierz istniejącą tabelę wyników. Na stronie z informacjami o tablicy wyników kliknij kartę z językiem, który został wcześniej dodany na karcie Szczegóły gry. Na stronie z informacjami o tablicy liderów dla danego języka edytuj formularz, podając tłumaczenia dla tej tabeli. Aby zapisać przetłumaczone szczegóły tabeli liderów, kliknij Zapisz.

Ukrywanie wyników w tabeli wyników

Usługi Google Play Games zapewniają funkcję ochrony przed nieuprawnionymi modyfikacjami, która sprawdza wyniki pod kątem podejrzenia o modyfikację i automatycznie je ukrywa. Ta funkcja jest dostępna tylko w przypadku gier na Androida.

Ochrona przed nieuprawnionymi modyfikacjami jest domyślnie włączona w przypadku nowych tabel wyników utworzonych dla Twojej gry na Androida, ale jest wyłączona w przypadku istniejących tabel. Aby włączyć ochronę przed nieuprawnionymi modyfikacjami w istniejących tabelach wyników, które zostały już opublikowane, wykonaj te czynności:

1. W Konsoli Google Play otwórz kartę Usługi gier, a następnie wybierz grę z listy.
2. Otwórz kartę Listy liderów, a potem wybierz instancję listy liderów, dla której chcesz włączyć ochronę przed modyfikacją.
3. Ustaw opcję Włącz ochronę przed nieuprawnionymi modyfikacjami tabeli na WŁ.
4. Kliknij Zapisz i kontynuuj.
5. Opublikuj grę.

Po włączeniu ochrony przed nieuprawnionymi modyfikacjami w tabeli wyników w Konsoli Google Play może minąć do 24 godzin, zanim ta funkcja zacznie działać. Wyniki przesłane przed włączeniem ochrony przed modyfikacją nie są ukrywane z powrotem.

W niektórych sytuacjach warto wyłączyć ochronę przed modyfikacją (na przykład, gdy gra działa nie tylko na Androidzie, ale też w przeglądarce i udostępnia listy liderów na obu platformach).

Implementacje klienta

Aby dowiedzieć się, jak wdrożyć tablice liderów na swojej platformie, zapoznaj się z tymi materiałami:

• Android
• Komputer
• Interfejs API C++
• Sprawdzone metody implementacji tabel liderów