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ą:

  • znajdować znajomych w Twojej 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 pokazuje 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 o liście 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ę gracza, który zalogował się w Grach Play. Ten widok zawiera też opcje zarządzania znajomymi i nie wyrzuca gracza z gry.
  • Zapewnij użytkownikom kontrolę: użytkownik ma opcje zarządzania 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 wystąpić wywołanie zwrotne z prośbą o dostęp.

Importowanie listy znajomych z Gier Play

Za pomocą interfejsów API dotyczących znajomych możesz pobrać listę znajomych graczy w Gry Play i dodać 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 istniejącej listy znajomych w grze, powiązawszy ich identyfikator w Grach Play 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 korzystasz z listy znajomych z serwera backendu, załaduj ją bezpiecznie za pomocą interfejsu API REST, a nie przekazując wyniku interfejsu API Androida. Upewnij się, że używasz identyfikatora gracza zwróconego przez interfejs API REST w players.get(me) w przypadku aktualnie zalogowanego gracza, 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 wyświetlają oni listę znajomych w grze. Możesz na przykład dodać przycisk Importuj znajomych z Gier Play, który po kliknięciu wyświetli 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ż przyjaciółmi, 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 przyjaźń.

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ługiwana automatycznie.

Dalsze kroki

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