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ą.
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.
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.
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:
- Pobierz i sprawdź przykładowy kod:
- Java
- Przykładowa aplikacja Unity przy użyciu wtyczki Unity
- Zapoznaj się z zaleceniami opisanymi w Lista kontrolna jakości.
- Zaimplementuj tag Interfejsy API Friends w kliencie Java.