Integracja wtyczki Facebook
Masz już prostą grę lub aplikację na Facebooku. Używając obiektu Facebook w programie Construct 2 możesz dodać funkcje oferowane przez Facebooka.
Dodaj do gry obiekt Facebook. W pasku właściwości musisz podać App ID (ID aplikacji).
Identyfikator znajduje się na opisanej wyżej stronie aplikacji.
Jeśli chcesz zamieszczać na Facebooku najlepsze wyniki, wprowadź też App Secret. Nie wprowadzaj go jeśli nie zamierzasz korzystać z najlepszych wyników! App Secret nie powinien być wprowadzany w ogóle, ale jest on potrzebny do działania systemu najlepszych wyników.
Dodawanie funkcji Facebooka
Aby dodać integrację, musisz skorzystać z akcji Log in (zaloguj) wtyczki Facebook. Nie możesz tej akcji uruchamiać automatycznie - dodaj odpowiedni przycisk, który użytkownik musi kliknąć. Facebook otworzy okno z prośbą o przyznanie aplikacji dostępu do konta. Użytkownik musi kliknąć przycisk Zezwól aby się zalogować.
Użytkownik może korzystać z aplikacji jeśli nie jest zalogowany, ale wtyczka Facebook nie będzie mogła nic zrobić.
Uprawnienia o które zostanie poproszony użytkownik zależą od parametrów ustawionych w akcji Log in.
Należy pamiętać, że im mniej uprawnień zażądasz od użytkownika, tym większa szansa, że się na nie zgodzi. Innymi słowy, nie proś o uprawnienia, których zdecydowanie nie potrzebujesz. Użytkownicy zwykle unikają logowania się w aplikacjach, które proszą o zbyt wiele.
Do czego wtyczka Facebook ma dostęp w zależności od uprawnień:
Brak uprawnień (oba parametry ustawione na None)
- Nadal możesz odczytać nazwisko użytkownika (np. aby wyświetlić komunikat "Witaj, Jan Kowalski!").
- Możesz korzystać z akcji Prompt to share link (poproś o udostępnienie linku), Prompt wall post (poproś o dodanie postu na tablicy) i Prompt to share this app (poproś o udostępnienie tej aplikacji). Akcje te wyświetlą okna, dając użytkownikowi możliwość potwierdzenia lub anulowania. Dla wielu gier i aplikacji to wystarczy i nie potrzebujesz do tego żadnych uprawnień!
Uprawnienie Publish to stream (publikacja w strumieniu)
- Masz dostęp do wszystkiego co podano wyżej oraz do akcji Publish wall post (opublikuj post na tablicy) i Publish link (opublikuj link). Te akcje publikują zawartość bez pytanie użytkownika o zgodę. Powinieneś korzystać z tych akcji bardzo ostrożnie - w przeciwnym wypadku użytkownik może się zdenerwować i zablokować Twoją aplikację. Zawsze pytaj użytkownika o zgodę i publikuj jak najmniej.
Szczerze mówiąc, stosowanie tego uprawnienia nie jest zalecane. Prawdopodobnie lepiej jest korzystać z akcji pytających o publikację, które nie wymagają uprawnień, ponieważ użytkownik ma kontrolę nad treścią wpisu i może go odrzucić. Uprawnienie to jest jednak dostępne na wypadek gdyby okazało się przydatne w pewnych aplikacjach.
Uprawnienie Publish scores (publikacja wyników)
- Oczywiście masz dostęp do funkcji niewymagających uprawnień, ale możesz też korzystać z API wyników.
- Oznacza to dostęp do akcji Publish score (opublikuj wynik), Request hi-score board (poproś o listę najlepszych wyników) i innych. Zamieszczony wyżej zrzut ekranu okna logowania dla gry Space Blaster pokazuje jak wygląda prośba o zalogowanie: jednym z uprawnień jest "Publish games and app activity" (publikacja aktywności w grach i aplikacjach).
Musisz wprowadzić App Secret aby korzystać z funkcji najlepszych wyników. Nie wprowadzaj App Secret jeśli nie korzystasz z tej funkcji!
Zdarzenia obiektu Facebook
Obiekt Facebook posiada zdarzenia umożliwiające ustalenie stanu użytkownika.
Zdarzenie Is ready (jest gotowy) jest prawdziwe gdy obiekt Facebook jest gotowy do użycia. Jeśli obiekt nie jest gotowy, funkcje Facebooka są jeszcze wczytywane. Nie możesz skorzystać z akcji Log in dopóki obiekt Facebook nie jest gotowy.
Zdarzenie On user logged in (po zalogowaniu się użytkownika) zostaje wyzwolone gdy użytkownik kliknie przycisk Zezwól w oknie otwartym przez akcję Log in. Nazwisko użytkownika nie jest jednak jeszcze dostępne - zostanie ono udostępnione niedługo.
Zdarzenie On user logged in zostaje wyzwolone również gdy użytkownik uruchomi aplikację ponownie, a stan zalogowania jest zapamiętany. Zostaje ono również wyzwolone na początku każdego planu (co jest pomocne gdy użytkownik wróci na ekran tytułowy - zdarzenie wciąż zostaje wyzwolone.)
Zdarzenie On name available (po uzyskaniu dostępu do nazwiska) zostaje wyzwolone zaraz po On user logged in. Nazwisko użytkownika jest teraz dostępne i możesz odczytać je używając wyrażeń obiektu Facebook. Do czasu udostępnienia nazwiska wyrażenia te będą zwracać puste ciągi znaków.