Grupa znajomych

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

  • znajdować znajomych w Twojej grze;

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

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

  • Identyfikuj innych graczy za pomocą wyskakującego okienka z profilem w grze. 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 działań:

  • 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 uwierzytelnionego gracza.
  • Uruchamianie widoku profilu innego gracza w Grach Play: możesz otworzyć ten widok, aby wyświetlić nazwę nadaną innemu graczowi przez uwierzytelnionego gracza. Ten widok zawiera też elementy sterujące zarządzaniem znajomymi i nie powoduje wyjścia gracza z gry.
  • Zapewnij użytkownikom kontrolę: 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 zezwolić na dostęp do wszystkich gier automatycznie lub zatwierdzać 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 graczy w Gry 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 dotychczasowi użytkownicy mogą importować znajomych z Gier Play na dowolne listy znajomych w grze. Dzięki temu Twoi użytkownicy będą mieli największy możliwy zbiór graczy, z którymi mogą grać lub rywalizować.

Dodawanie znajomych z Gier Play do gry

Dodawaj znajomych z Gier Play do dowolnej listy znajomych w grze, przypisując ich identyfikatory z Gier Play do odpowiednich informacji o graczach 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 korzystasz z listy znajomych z serwera backendu, wczytuj ją bezpiecznie za pomocą interfejsu API REST, a nie przekazuj wyniku interfejsu API Androida. Upewnij się, że w interfejsie API REST używasz identyfikatora gracza zwróconego przez players.get(me) dla aktualnie uwierzytelnionego gracza, ponieważ będzie on zgodny z identyfikatorem widocznym dla innych graczy.

Jeśli rozszerzona lista znajomych nie jest przechowywana (a jedynie używana w momencie wyświetlania), nie musisz podejmować żadnych dodatkowych działań.

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świetli prośbę o zgodę użytkownika. (Pamiętaj, aby na każdym przycisku, który odnosi się do usługi, używać logo Gier Play).

Wyświetlanie profilu innego gracza

Możesz zezwolić uwierzytelnionemu graczowi na wyświetlanie profilu innego gracza w Grach Play. Umożliwia to uwierzytelnionemu graczowi zobaczenie nazwy, jaką nadał drugiemu graczowi, oraz sprawdzenie, 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 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

Tablice wyników graczy

Interfejsy API znajomych mogą być też używane w przypadku tablic wyników. Użyj tej funkcji, aby wyświetlić miejsce, które zajmuje obecny gracz wśród znajomych w Grach Play. Pamiętaj, że dotyczy to tylko użytkowników, którzy zdecydowali się udostępnić te informacje Twojej aplikacji i 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 do wybrania widoku społecznościowego tablicy wyników. Więcej informacji znajdziesz w sekcji publiczne i społecznościowe tablice wyników.

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

Dalsze kroki

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