Tabele wyników

Tabele wyników mogą być świetną metodą na zwiększenie rywalizacji wśród graczy – zarówno tych najbardziej twardych kibiców, którzy będą walczyć o pierwsze miejsce na publicznej tablicy wyników, jak i tych, którzy odprężają się (będą oni chcieli porównać swoje postępy ze znajomymi).

Aby dowiedzieć się, jak wdrożyć tabele wyników na swojej platformie, przeczytaj artykuł Implementacje klientów.

Informacje o tabelach wyników

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

  1. Po zakończeniu gry (lub w określonym przez Ciebie momencie) gra przesyła wynik gracza do jednej lub kilku utworzonych przez Ciebie tabel wyników w grze.
  2. Usługi gier Google Play sprawdzają, czy ten wynik jest lepszy od aktualnego wyniku gracza – dziennego, tygodniowego lub wszech czasów. Jeśli tak jest, Usługi gier Google Play zaktualizują odpowiednie tabele o nowy wynik.
  3. Usługi gier Google Play wysyłają do klienta gry raport dotyczący wyników. Ten raport informuje klienta, czy jest to nowy wynik dzienny, tygodniowy czy wszech czasów. Jeśli nie, Usługi gier Google Play informują klienta o tym, jaki jest obecny wynik dzienny, tygodniowy lub rekordowy dla tego gracza.
  4. Aby pobrać wyniki gracza na tablicy wyników, możesz wybrać przedział czasowy (dzienny, tygodniowy lub cały okres) i decydować, czy użytkownik chce zobaczyć tablicę społecznościową czy publiczną. Usługa Gry wykonuje niezbędne czynności, a potem przesyła wyniki z powrotem do klienta.
  5. Jeśli jest wiele wyników do zgłoszenia, usługa Gry wysyła tylko dane dotyczące najlepszych wyników. Możesz też pobrać nieprzetworzone dane dotyczące najlepszych wyników lub wyników obok gracza.

Wiele tabel wyników

Gry mogą mieć wiele tabel wyników, ale nie więcej niż 70. Na przykład wielopoziomowa gra może mieć osobną tabelę wyników dla każdego poziomu, a gra wyścigowa może mieć osobną tabelę wyników dla każdego toru.

Przedział czasowy tabeli wyników

Pakiet SDK do gier Play automatycznie tworzy dzienne, tygodniowe i zawsze dostępne wersje wszystkich tabel wyników. Nie musisz tworzyć osobnych tabel wyników dla poszczególnych przedziałów czasu.

Codzienne tabele wyników resetują się o czasu UTC-7 (czyli „północny czas pacyficzny letni”) przez cały rok.

Cotygodniowe tabele wyników są resetowane o północy między sobotę a niedzielą, w tej samej strefie czasowej co tabele wyników (UTC-7).

Publiczne i społecznościowe tabele wyników

Pakiet SDK do gier Play może wyświetlać w odtwarzaczu 2 różne wersje każdej tabeli:

Tablica tabel społecznościowych to tablica wyników obejmująca osoby w kręgach użytkownika (lub dokładniej: osoby z kręgów, które zdecydował się udostępnić Twojej aplikacji), które zdecydowały się udostępnić swoją aktywność w grze.

Publiczna tabela wyników to grupa zawierająca graczy, którzy publicznie udostępniają informacje o swoich działaniach. Jeśli Twój gracz nie zdecydował się publicznie udostępniać swojej aktywności, nie będzie widoczny w tej tabeli.

Wyświetlanie tablic wyników

W bibliotekach klienta mobilnego nie chodzi o formatowanie ani wyświetlanie tabel wyników. Możesz określić, czy gracz ma widzieć konkretną tabelę wyników czy listę wszystkich tabel.

Możesz też zaimplementować własne tabele wyników, korzystając z danych bezpośrednio z bibliotek klienta.

Atrybuty

Aby tworzyć tabele wyników i nimi zarządzać, zapoznaj się z tymi atrybutami:

Podstawy

Te podstawowe elementy są powiązane z każdą tabelą:

  • ID to unikalny ciąg generowany przez Konsolę Google Play. Ten unikalny identyfikator będzie służyć jako punkt odniesienia do tabeli wyników w Twoich klientach gier.
  • Nazwa to krótka nazwa tabeli wyników (np. „Rekordy” lub „Poziom 3”). Może mieć do 100 znaków.
  • Ikona to kwadratowa ikona, która zostanie powiązana z tabelą wyników. Sprawdzone metody tworzenia ikon tablicy wyników znajdziesz poniżej w sekcji Wskazówki dotyczące ikon.
  • Kolejność na liście to kolejność, w jakiej długi baner pojawia się, gdy gracz przegląda tabele wyników powiązane z Twoją grą.
  • Limity są wartościami opcjonalnymi, które określają dolne i górne limity wyników w tabeli wyników. Pomaga to odrzucić przesłane w wynikach oceny, które są nieuczciwe. Możesz też użyć funkcji Players.hide, aby ukryć graczy, którzy Twoim zdaniem przesłali fałszywe wyniki przed wszystkimi tabelami w aplikacji.

Kolejność

Tabele wyników mogą zawierać 1 z 2 typów zamówień:

  • Domyślnie tabele wyników są lepsze. Zwykle jest to widoczne w większości gier, w których gracze zdobywają punkty.
  • Niższe wyniki są lepsze – czasami używa się tabel wyników, gdy niższy wynik jest lepszy. Najpopularniejszymi przykładami tabel wyników są gry wyścigowe, w których wynik pokazuje czas zawodnika na dokończenie wyścigu.

Format wyniku

Wszystkie wyniki są przesyłane do tablic wyników i przechowywane wewnętrznie jako długie liczby całkowite, ale usługa Gry może wyświetlać je użytkownikowi w kilku różnych formatach:

  • Wyniki liczbowe wyświetlają się jako liczby. Mogą to być liczby całkowite lub rzeczywiste z ustaloną liczbą miejsc po przecinku. Wyniki podajesz jako liczby całkowite, a wartość dziesiętna w określonej lokalizacji. Wynik 314159 może np. być wyświetlany jako 3.14159, 3141.59 lub 314159, zależnie od podanego miejsca dziesiętnego.

  • Tablice wyników czasu przedstawiają godziny w minutach, minutach, sekundach lub setnych. Wyniki musisz podawać w milisekundach, więc ciąg 66032 będzie interpretowany jako 1:06.03.

  • Tabele wyników w sekcji Waluta przedstawiają wyniki w formacie waluty. Wyniki przesyłasz jako 1/1 000 000 głównej jednostki waluty. Na przykład wynik równy 19 950 000 będzie interpretowany jako $19.95 przy założeniu, że waluta została określona jako USD.

Długie tabele wyników obsługują również jednostki niestandardowe. Jeśli np. gra mierzy wysokie wyniki w metrach, możesz ustawić „metry” jako domyślną jednostkę w tabeli wyników.

Tłumaczenia i formatowanie wyników

Gdy biblioteki klienta mobilnego żądają danych tablicy wyników z gier, określają język i region, w którym mają być wyświetlane wyniki. Interfejs REST API pozwala określić język lokalny. Usługa Gier wyświetla sformatowane wyniki w tabeli, które są odpowiednie dla danego języka i regionu. Sformatowane wyniki pojawią się niezależnie od tego, czy dodano tłumaczenia do tabeli wyników.

W przypadku tabel wyników format liczb jest wyświetlany inaczej w poszczególnych językach. na przykład 12,345.78 w Stanach Zjednoczonych i 12 345,78 we Francji. Jeśli używasz jednostek niestandardowych i dodajesz do gry tłumaczenia, musisz dostarczyć przetłumaczone jednostki dla każdego dodanego języka. Następnie w odpowiednich przypadkach wyświetlają one przetłumaczone jednostki.

W zależności od wybranego języka konieczne może być podanie różnych wersji nazw jednostek. W języku angielskim potrzebujesz wersji dla jednego elementu i drugiej dla wszystkich elementów (np. „metr” i „metr”). W Polsce trzeba podać wersję jednej, kilku i wszystkich jednostek. Więcej informacji o regułach w liczbie mnogiej znajdziesz na stronie dotyczącej ilości ciągów(mnogi).

W przypadku tabel wyników Time format godziny jest wyświetlany zgodnie z językiem i regionem gracza. Jest to widoczne szczególnie wtedy, gdy używasz ułamków sekund lub wartości godzinowych powyżej 3 cyfr (na przykład 4,815:16:23.42 w Stanach Zjednoczonych i 4.815:16:23,42 w Niemczech).

W przypadku tabel wyników Waluta format waluty będzie wyświetlany zgodnie z językiem i regionem gracza. Nie można jednak zmienić jednostki waluty. Jeśli na przykład ustawisz walutę w USD, gra będzie wyświetlać się $19.95 w Stanach Zjednoczonych i 19,95 $ we Francji. Nie można jednak określić, że gra ma wyświetlać się w Stanach Zjednoczonych i euro we Francji.

Wytyczne dotyczące ikon

Ikony należy tworzyć w formacie PNG lub JPEG o wymiarach 512 x 512 pikseli. W przypadku większości klientów gier ikony zostaną zmniejszone, więc nie twórz zbyt wielu szczegółów. Możesz przesłać ikony z kanałem alfa, a przejrzystość zostanie zachowana. Ikona Długiego banera jest wyświetlana na ciemniejszym szarym tle na urządzeniach z Androidem, więc wybierz ikonę, która sprawdza się w tej sytuacji.

Ta sama ikona jest używana we wszystkich językach, dlatego nie zalecamy dodawania w niej tekstu ani zlokalizowanych treści.

Tworzenie tabeli wyników

Z tej sekcji dowiesz się, jak tworzyć tabele wyników w nowych lub dotychczasowych grach.

Tworzenie tabeli wyników dla nowej gry

Aby utworzyć tabelę wyników dla nowej i nieopublikowanej gry, otwórz jej pozycję w Konsoli Google Play i wybierz Rozwój > Gry Play > Konfiguracja i zarządzanie > Tabele wyników, a potem kliknij przycisk Utwórz tabelę wyników.

Przycisk „Dodaj tablicę wyników” w głównym panelu

Następnie podaj informacje wymagane w tabeli wyników.

Wypełniony formularz tablicy wyników „Najlepsza runda”.

Kliknij Zapisz jako wersję roboczą. Twoja tabela wyników jest dostępna jako „Wersja robocza”. Gdy opublikujesz grę, zostaną w niej opublikowane wszystkie tabele wyników.

Tworzenie tabeli wyników opublikowanej gry

Aby utworzyć dodatkową tablicę wyników gry, która została już opublikowana, wykonaj powyższe kroki. Więcej informacji o testowaniu zaktualizowanej wersji gry znajdziesz w artykule Publikowanie zmian w grze.

Kiedy przetestujesz już swoją tablicę wyników, która Ci się podoba, możesz opublikować ją ponownie w nowych tabelach, aby udostępnić je światu.

Edytowanie tabeli wyników

Aby edytować utworzoną wcześniej tabelę wyników, kliknij ją na karcie Tabele wyników w Konsoli Google Play. Zobaczysz wtedy ten sam formularz, który został przez Ciebie użyty podczas tworzenia pierwszej tabeli wyników, i będziesz mieć możliwość edytowania dowolnych pól.

Po zakończeniu edytowania tablicy wyników kliknij przycisk Zapisz jako wersję roboczą. Nowo edytowana tabela wyników jest w „wersji roboczej”, co umożliwia przetestowanie jej.

Jeśli działa prawidłowo, wybierz Opublikuj zmiany w polu u góry formularza tabeli wyników. Umożliwi Ci to ponowne opublikowanie gry i wszystkich zaktualizowanych tablic wyników.

Cofnij zmianę

Jeśli nie podoba Ci się nowo zmieniona tabela wyników, ale chcesz wrócić do poprzedniej iteracji, po prostu wybierz Cofnij w polu u góry formularza tabeli wyników. W tabeli wyników przywracana jest już wersja opublikowana.

Usuwanie tabeli wyników

Możesz usunąć tabele wyników ze stanem „Wersja robocza” lub opublikowane. Aby usunąć tabelę wyników w Konsoli Google Play, przejdź do formularza i kliknij Usuń tabelę wyników u góry formularza.

Możesz też wywołać metodę Players.hide, aby ukryć tablicę wyników gracza w aplikacji.

Resetowanie tabeli wyników

Możesz zresetować dane postępów graczy tylko w tabelach roboczych.

  • Aby zresetować tabele wyników w Konsoli Google Play, kliknij Resetuj postęp u góry formularza danego wydarzenia.
  • Aby automatycznie zresetować dane w tabeli wyników, wywołaj metody interfejsu API zarządzania Scores.

Dodawanie tłumaczeń tablic wyników

Możesz określić własne tłumaczenia tabel wyników powiązanych z Twoją grą. Zanim to zrobisz, wykonaj czynności opisane w sekcji Dodawanie tłumaczeń do gry. Musisz też utworzyć jedną lub więcej tabel wyników z gry.

Jeśli chcesz dodać własne tłumaczenia do tabel wyników, otwórz kartę Tabele wyników w Konsoli Google Play, a potem wybierz tabelę wyników. Na stronie z informacjami o tabeli wyników kliknij kartę języka dodanego wcześniej na karcie Szczegóły gry. Na stronie z informacjami o tabeli wyników w tym języku edytuj formularz wraz z tłumaczeniami. Kliknij Zapisz, aby zapisać przetłumaczone szczegóły długiego banera.

Ukryj wyniki w tabeli

Usługi gier Google Play udostępniają funkcję ochrony przed nieuprawnionymi modyfikacjami, która sprawdza wyniki i ukrywa je automatycznie. Ta funkcja jest dostępna tylko w grach na Androida.

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

  1. W Konsoli Google Play otwórz kartę Usługi gier i wybierz grę z listy.
  2. Otwórz kartę Tabele wyników i wybierz instancję tabeli wyników, dla której chcesz włączyć ochronę przed nieuprawnionymi modyfikacjami.
  3. Włącz opcję Włącz ochronę przed nieuprawnionymi modyfikacjami tabeli wyników.
  4. Kliknij Zapisz i kontynuuj.
  5. Opublikuj grę.

Po włączeniu ochrony przed nieuprawnionymi modyfikacjami w tabeli wyników w Konsoli Google Play zastosowanie tej funkcji może potrwać do 24 godzin. Wyniki przesłane przed włączeniem ochrony przed nieuprawnionymi modyfikacjami nie są ukryte.

W niektórych przypadkach możesz wyłączyć ochronę przed nieuprawnionymi modyfikacjami (np. gdy gra działa nie tylko na Androidzie, ale też udostępnia tablice wyników na tych platformach).

Implementacje klienta

Aby dowiedzieć się, jak wdrożyć tabele wyników na swojej platformie, skorzystaj z tych zasobów: