Grupa znajomych

Wykorzystaj interfejsy Friends API, aby uzupełnić i ulepszyć obecny system znajomych w grze i innych systemach społecznościowych, z których może korzystać gra. Umożliwia to graczom:

  • Znajdź ich znajomych w grze.

  • Porównuj wyniki ze znajomymi w tabelach wyników.

  • Może połączyć listę znajomych w Grach Play z dotychczasowymi listami w grze ze znajomymi.

  • Znajdź innego gracza za pomocą wyskakującego okienka profilu w grze. To wyskakujące okienko pokazuje pseudonim, który obecny gracz nadał swojemu znajomemu, aby wiadomo było, kto z którymi grają.

Importuj znajomych

Podstawy

Te interfejsy API pozwalają wykonywać następujące czynności:

  • Wczytaj znajomych: możesz sprawdzić, czy gracz zezwolił na dostęp do gry. Informacje o liście znajomych. Po przyznaniu dostępu możesz wyświetlić listę graczy obiekty odpowiadające znajomym zalogowanego odtwarzacza.
  • Otwieranie widoku profilu w Grach Play innego gracza: możesz otworzyć w tym widoku, by wyświetlić nazwę nadaną innemu graczowi przez zalogowanego . Ten widok oferuje również opcje zarządzania znajomością, dlatego nie możesz i wylogować się z gry.
  • Udostępniać użytkownikom kontrolę: użytkownik może zarządzać sposobem, w jaki Profil w Grach Play jest widoczny dla znajomych i w jaki sposób jest widoczna ich lista znajomych widoczne dla gier. Aby uzyskać dostęp do listy znajomych, użytkownik może wybrać automatycznie przyznawać dostęp wszystkim grom lub może to robić pojedynczo zatwierdzić dostęp dla każdej gry. Dlatego podczas wczytywania listy znajomych może to być wywołanie zwrotne z prośbą o dostęp.

Importowanie listy znajomych z Gier Play

Aby uzyskać listę Gier Play Twoich graczy, możesz użyć interfejsów Friends API znajomych i dodać ich do listy znajomych w grze.

Nowi użytkownicy będą mieli początkową listę znajomych, z którymi mogą grać, a także istniejący użytkownicy mogą zaimportować znajomych z Gier Play do dowolnej listy znajomych w grze. Dzięki temu użytkownicy będą mieli dostęp do największej możliwej liczby graczy. lub rywalizują ze sobą.

Dodaj znajomych z Gier Play do swojej gry

Dodaj znajomych w Grach Play do dowolnej listy znajomych w grze. Powiązanie identyfikatora w Grach Play z odpowiednimi informacjami o graczu do wewnętrznej bazy danych. Upewnij się, że masz przycisk w Grach Play obok tych znajomych, która wyświetla profil innego gracza po naciśnięciu, aby użytkownicy wiedzieli, kim są Twoi znajomi.

Jeśli używasz listy znajomych z serwera backendu, wczytuj ją bezpiecznie za pomocą interfejsu API REST, a nie przekazywania wyniku interfejsu API Androida. Upewnij się, do użycia identyfikatora odtwarzacza zwróconego przez players.get(me) w interfejsie API REST dla argumentu zalogowanym graczem, ponieważ takie same identyfikatory będą widoczne dla innych graczy.

Jeśli rozszerzona lista znajomych nie jest przechowywana (tylko używana w momencie wyświetlanie), nie musisz niczego więcej robić.

Przyznaj dostęp do Gier Play

Jeśli Twoja gra nie ma jeszcze dostępu do Gier Play, to dobry moment, jest wyświetlana użytkownikom z listy znajomych w grze. Dla: możesz na przykład dodać przycisk Importuj znajomych z Gier Play, który prosi użytkownika o zgodę po kliknięciu. (Pamiętaj, aby użyć atrybutu logo Gier Play na każdym przycisku, który informuje o usłudze.

Zobacz profil innego gracza

Możesz zezwolić zalogowanym graczowi na wyświetlanie profil w Grach Play. Dzięki temu zalogowany gracz może zobaczyć nazwę, podali danemu graczowi i czy są już znajomymi, i dodali kontekst do relacji. Jeśli gracze nie są jeszcze znajomymi, zalogowany gracz zobaczy w swoim profilu opcje zarządzania znajomością widok. Jeśli w grze tworzysz przyjaźnie, domyślne nazwy elementów Obaj gracze to ich imiona w grze (jeśli je podasz). Nazwa gra, w której doszło do nawiązania przyjaźni.

Zobacz profil innego gracza

Tablice wyników społecznościowych

Interfejsów Friends API można też używać do tworzenia tabel wyników. Za pomocą tej funkcji możesz wyświetlać pozycję bieżącego gracza w rankingu wśród znajomych w Grach Play. Pamiętaj, że te informacje dotyczą tylko użytkowników, którzy zdecydowali się udostępnić te informacje aplikacji oraz czy użytkownicy są znajomymi w Grach Play. Aby wspomóc gra daje użytkownikowi kontrolę. To ustawienie używa parametru collection, aby wybrać widok społecznościowy tabeli wyników. Aby się uczyć więcej informacji znajdziesz w sekcji na temat publicznych i społecznościowych tabel wyników.

Znajomi w tabeli wyników

Jeśli wdrożysz kolekcję tabel wyników społecznościowych, wywołanie pobrania wywołania Wyniki w tabeli mogą zwrócić wyjątek wymagający zgody użytkownika, podobnie jak że od loadFriends() Jeśli wdrożysz domyślny interfejs użytkownika Gier Play (na przykład getLeaderboardIntent()), robimy to automatycznie.

Dalsze kroki

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