Grupa znajomych

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

  • znajdować swoich znajomych w Twojej grze;

  • porównywać wyniki ze znajomymi w tabelach wyników;

  • łączyć listę znajomych z Gier Play z obecnymi listami znajomych w grze;

  • identyfikować innego gracza za pomocą wyskakującego okienka profilu w grze. Wyskakujące okienko zawiera pseudonim, który bieżący gracz nadał swojemu znajomemu, dzięki czemu wie, z kim gra.

Importowanie znajomych

Podstawy

Te interfejsy API umożliwiają wykonywanie tych działań:

  • Wczytywanie 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 gracza odpowiadających znajomym uwierzytelnionego gracza.
  • Uruchamianie widoku profilu innego gracza w Grach Play: możesz otworzyć ten widok, aby wyświetlić nazwę, którą uwierzytelniony gracz nadał innemu graczowi. Ten widok zawiera też elementy sterujące zarządzaniem znajomymi i nie spowoduje wyjścia gracza z Twojej gry.
  • Udostępnianie elementów sterujących użytkownika: użytkownik ma możliwość zarządzania widocznością swojego profilu w Grach Play dla znajomych oraz widocznością listy znajomych dla gier. 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łane wywołanie zwrotne, aby wyświetlić prośbę o dostęp.

Importowanie listy znajomych z Gier Play

Za pomocą interfejsów API znajomych możesz uzyskać listę znajomych swoich graczy z Gier Play i dodać ich do listy znajomych w grze.

Nowi użytkownicy będą mieli początkową listę znajomych, z którymi mogą grać, a obecni użytkownicy mogą importować znajomych z Gier Play do dowolnych list znajomych w grze. Dzięki temu użytkownicy będą mieli jak największy zestaw graczy, z którymi mogą grać lub rywalizować.

Dodawanie znajomych z Gier Play do gry

Dodaj znajomych z Gier Play do dowolnej listy znajomych w grze, łącząc ich identyfikator w Grach Play z odpowiednimi informacjami o graczu w 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, aby użytkownicy mogli wiedzieć, kim są znajomi.

Jeśli używasz listy znajomych z serwera backendowego, wczytuj ją bezpiecznie za pomocą interfejsu REST API, a nie przekazując wynik interfejsu Android API. Upewnij się że używasz identyfikatora gracza zwróconego przez players.get(me) w interfejsie REST API dla aktualnie uwierzytelnionego gracza, ponieważ będzie on zgodny z identyfikatorem widocznym dla innych graczy.

Jeśli rozszerzona lista znajomych nie jest przechowywana (tylko używana w momencie wyświetlania), nie trzeba wykonywać żadnych dodatkowych czynności.

Przyznawanie dostępu do Gier Play

Jeśli Twoja gra nie ma jeszcze dostępu do Gier Play, dobrym momentem na poproszenie użytkowników o zgodę jest wyświetlenie listy znajomych w grze. Możesz na przykład dodać przycisk Importuj znajomych z Gier Play, który po kliknięciu wyświetla prośbę o zgodę. (Upewnij się, że na każdym przycisku, który odwołuje się do usługi, używasz logo Gier Play).

Wyświetlanie profilu innego gracza

Możesz zezwolić uwierzytelnionemu graczowi na wyświetlanie profilu w Grach Play innego gracza. Dzięki temu uwierzytelniony gracz może zobaczyć nazwę, którą nadał innemu graczowi, oraz to, czy są już znajomymi, co daje mu dodatkowy kontekst dotyczący relacji. Jeśli gracze nie są jeszcze znajomymi, uwierzytelniony gracz zobaczy w widoku profilu elementy sterujące zarządzaniem znajomymi. Gdy znajomości są tworzone w grze, domyślne nazwy obu 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ściowych

Interfejsy API znajomych można też używać w tabelach wyników. Użyj tej funkcji, aby wyświetlić ranking bieżącego gracza wśród jego znajomych z Gier Play. Pamiętaj, że dotyczy to tylko użytkowników, którzy zdecydowali się udostępniać te informacje Twojej aplikacji, oraz jeśli użytkownicy są znajomymi w Grach Play. Aby obsługiwać tę funkcję, gra udostępnia użytkownikowi element sterujący. Ten element sterujący używa argumentu collection, aby wybrać widok społecznościowy tabeli wyników. Więcej informacji znajdziesz w sekcji dotyczącej publicznych i społecznościowych tabel wyników.

Jeśli zaimplementujesz kolekcję tabel wyników społecznościowych, wywołanie wczytujące wyniki w tabeli wyników może zwrócić wyjątek wymagający zgody podobny do tego z loadFriends(). Jeśli zaimplementujesz domyślny interfejs użytkownika udostępniany przez Gry Play (np. getLeaderboardIntent()), zostanie to automatycznie obsłużone.

Dalsze kroki

Zanim zaczniesz korzystać z interfejsów API znajomych, wykonaj te czynności: