Grupa znajomych

Używaj interfejsów API Znajomości, aby uzupełnić i ulepszać istniejący system znajomych w grze oraz inne systemy społecznościowe, do których może mieć dostęp Twoja gra. Dzięki temu gracze mogą:

  • Znajdź ich znajomych w swojej grze.

  • porównywać swoje wyniki z wynikami znajomych w tabelach wyników;

  • Połącz listę znajomych z Gier Play z dotychczasowymi listami znajomych w grach.

  • identyfikować innego gracza za pomocą wyskakującego okienka z profilem w grze. To wyskakujące okienko zawiera pseudonim, który bieżący gracz nadał znajomemu, aby wiedzieć, z kim gra.

Importowanie znajomych

Podstawy

Te interfejsy API umożliwiają wykonywanie tych czynności:

  • Wczytaj znajomych: możesz sprawdzić, czy gracz zezwolił grze na dostęp do informacji z listy znajomych. Jeśli dostęp zostanie przyznany, możesz uzyskać listę obiektów Player odpowiadających znajomym zalogowanego gracza.
  • Otwórz widok profilu gracza w Grach Play: możesz otworzyć ten widok, aby wyświetlić nazwę nadaną przez zalogowanego gracza innemu graczowi. Ten widok zawiera też opcje zarządzania znajomymi i nie wyrzuca gracza z gry.
  • Zapewnij użytkownikom kontrolę: użytkownik ma kontrolę nad tym, jak jego profil w Grach Play jest widoczny dla znajomych i jak lista znajomych jest widoczna w grach. W przypadku dostępu do listy znajomych użytkownik może automatycznie przyznać dostęp do wszystkich gier lub zatwierdzić dostęp do każdej gry osobno. W związku z tym podczas wczytywania listy znajomych może zostać wywołana funkcja obsługi wywołania zwrotnego, która wyświetli prośbę o dostęp.

Importowanie listy znajomych z Gier Play

Interfejsy API dotyczące znajomych umożliwiają pobieranie listy znajomych graczy w Gry Play i dodawanie ich do listy znajomych w grze.

Nowi użytkownicy będą mieć początkową listę znajomych, z którymi mogą grać, a obecni użytkownicy mogą zaimportować swoich znajomych z Gier Play na dowolną listę znajomych w grze. Dzięki temu Twoi użytkownicy będą mogli grać z największą możliwą liczbą graczy lub rywalizować z nimi.

Dodawanie znajomych z Gier Play do gry

Dodaj znajomych z Gier Play do dowolnej listy znajomych w grze, powiązawszy ich identyfikatory z odpowiednimi informacjami o graczach w Twojej wewnętrznej bazie danych. Upewnij się, że obok tych znajomych znajduje się przycisk z ikoną Gier Play, który po naciśnięciu wyświetla profil innego gracza. Dzięki temu użytkownicy będą wiedzieć, kim są znajomi.

Jeśli używasz listy znajomych z serwera backendu, załaduj ją bezpiecznie za pomocą interfejsu API REST, a nie przekazując wyniku interfejsu API Androida. Pamiętaj, aby używać identyfikatora gracza zwracanego przez interfejs API REST w przypadku aktualnie zalogowanego gracza (players.get(me)), ponieważ będzie on zgodny z identyfikatorem widocznym dla innych graczy.

Jeśli rozszerzona lista znajomych nie jest przechowywana (ale jest używana tylko w momencie wyświetlania), nie trzeba nic więcej robić.

Przyznawanie dostępu do Gier Play

Jeśli Twoja gra nie ma jeszcze dostępu do Gier Play, dobrym momentem na wyświetlenie użytkownikom prośby o zgodę jest wtedy, gdy przeglądają oni listę znajomych w grze. Możesz na przykład dodać przycisk Importuj znajomych z Gier Play, który po kliknięciu wyświetla użytkownikowi prośbę o zgodę. (używaj logo Gry Play na każdym przycisku, który wspomina tę usługę).

Wyświetlanie profilu innego gracza

Możesz zezwolić zalogowanemu graczowi na wyświetlanie profilu innego gracza w Grach Play. Dzięki temu zalogowany gracz może zobaczyć nazwę nadaną przez siebie innemu graczowi oraz to, czy są już znajomymi, co daje mu dodatkowy kontekst na temat relacji. Jeśli gracze nie są jeszcze znajomymi, zalogowany gracz zobaczy opcje zarządzania znajomymi w widoku profilu. Gdy przyjaźnie są tworzone w grze, domyślne nazwy 2 graczy to ich nazwy w grze (jeśli zostały podane). Wyświetlana jest też nazwa gry, w której nawiązano znajomość.

Wyświetlanie profilu innego gracza

Tabele wyników społeczności

Interfejsy API dotyczące znajomych mogą też służyć do wyświetlania tabel liderów. Ta funkcja pozwala wyświetlić pozycję bieżącego gracza na liście znajomych w Grach Play. Pamiętaj, że dotyczy to tylko użytkowników, którzy zdecydowali się udostępnić te informacje Twojej aplikacji, oraz że są oni znajomymi w Gierach Play. Aby umożliwić tę funkcję, gra udostępnia użytkownikowi element sterujący. Ten element sterujący używa argumentu collection do wyboru widoku społecznościowego tabeli liderów. Więcej informacji znajdziesz w sekcji dotyczącej publicznych i społecznych tabel liderów.

Jeśli zaimplementujesz kolekcję tabel wyników społecznościowych, wywołanie do załadowania wyników tabeli wyników może zwrócić wyjątek dotyczący rozdzielczości wymagającej zgody podobny do tego z loadFriends(). Jeśli wdrożesz domyślne interfejs użytkownika udostępniany przez Gry Play (np. getLeaderboardIntent()), ta funkcja zostanie obsłużona automatycznie.

Dalsze kroki

Zanim zaczniesz korzystać z interfejsów API dotyczących znajomych: