Facebook - tworzenie aplikacji real-time updates.pdf

(104 KB) Pobierz
Facebookowe
Graph API
udostępnia ciekawą funkcjonalność, dzięki której nasza aplikacja może
być automatycznie powiadamiana o zmianie danych użytkownika lub strony, a także o odwołaniu
któregoś z udzielonych wcześniej zezwoleń. Przyjrzyjmy się jak działają real-time updates i jak
możemy z nich skorzystać.
Głównym celem udostępnienia tej funkcjonalności przez
Facebooka
było umożliwienie poprawy
wydajności i czasu ładowania aplikacji poprzez trzymanie danych po stronie aplikacji i
aktualizowanie ich tylko w momencie gdy się zmieniają, co owocuje mniejszą ilością odwołań do
Graph API.
Można oczywiście wykorzystać real-time updates do innych celów, na przykład do
wykonywania jakiejś akcji w momencie gdy interesujące nas dane ulegną zmianie.
Aby Facebook wysyłał naszej aplikacji powiadomienia o zmianach danych musimy zgłosić chęć ich
otrzymywania. Na chwilę obecną subskrybować można zmiany w obiektach
user,
permissions
i
page
(tylko dane dostępne publicznie). Niestety, w przypadku obiektu
user
(dane użytkownika) nie mamy dostępu do wszystkich informacji - na dzień dzisiejszy możemy
zasubskrybować zmiany w połączeniach
feed
(tablica użytkownika),
friends
(lista znajomych),
activities
(aktywność),
interests
(zainteresowania),
music
(muzyka),
books
(książki),
movies
(filmy),
television
(telewizja),
likes
(lubiane strony) i
checkins
(aktualnie
niedostępne w Polsce). Ekipa Facebook obiecuje jednak, że lista dostępnych powiadomień będzie
się powiększać, tak więc warto raz na jakiś czas zerknąć do
dokumentacji.
Zacznijmy od zasubskrybowania powiadomień o zmianach danych użytkownika. Aby to zrobić
musimy pobrać token
OAuth
dla naszej aplikacji, a następnie posługując się nim wysłać
odpowiednie żądanie do
Graph API.
Może to wyglądać na przykład tak:
Kod:
Zaznacz cały
require('fb/facebook.php');
$facebook = new Facebook(array(
'appId' => '_id_naszej_aplikacji_',
'secret' => '_sekretny_kod_naszej_aplikacji_',
'cookie' => true,
));
// pobieramy token OAuth dla naszej aplikacji
$params = array('grant_type'
=> 'client_credentials',
'client_id'
=> $facebook->getAppId(),
'client_secret' => $facebook->getAppSecret());
$ch = curl_init();
$url = 'https://graph.facebook.com/oauth/access_token';
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HEADER, false);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $params);
$return = curl_exec($ch);
curl_close($ch);
$return_array = explode('=', $return);
$app_token = $return_array[1];
// dodajemy nową subskrypcję
$params = array('access_token' => $app_token,
'object' => 'user',
'fields' => 'television,books,music,movies',
'verify_token' => 'aaabbbccc',
'callback_url' => 'http://nasz-
serwer.pl/katalog/rt_receive.php');
$ch = curl_init();
$url = 'https://graph.facebook.com/'.$facebook-
>getAppId().'/subscriptions';
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HEADER, false);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $params);
$return = curl_exec($ch);
curl_close($ch);
Fragment kodu odpowiedzialny za dodawanie nowej subskrypcji wymaga kilku słów wyjaśnienia -
w tablicy
$params
mamy bowiem dwa parametry, o których wcześniej nie wspomniałem.
Parametr
verify_token
to dowolny ciąg znaków, służący do weryfikacji żądania przez skrypt
odbierający powiadomienia. Adres tego skryptu należy podać w parametrze
callback_url
-
musi być on dostępny w momencie dodawania subskrypcji i musi zwrócić poprawną odpowiedź.
Przykładowy, prosty skrypt odbierający (nazwijmy go
rt_receive.php)
może wyglądać tak:
Kod:
Zaznacz cały
// ten sam token co w skrypcie dodającym subskrypcję
define('VERIFY_TOKEN', 'aaabbbccc');
$method = $_SERVER['REQUEST_METHOD'];
if($method == 'GET' && $_GET['hub_mode'] == 'subscribe' &&
$_GET['hub_verify_token'] == VERIFY_TOKEN)
{
echo($_GET['hub_challenge']);
}
elseif($method == 'POST')
{
// obsługa powiadomienia
$updates = json_decode(file_get_contents("php://input"), true);
file_put_contents('updates_log.txt', 'updates = ' . print_r($updates,
true));
}
Skrypt ten pełni dwie funkcje: odpowiada na żądanie dodania subskrypcji (dane przysłane metodą
GET)
i odbiera powiadomienia o zmianie danych (dane przysyłane metodą
POST).
Odbieraniem
danych zajmiemy się później.
Jeśli wszystko poszło zgodnie z planem, to nasza aplikacja ma w tym momencie aktywną
subskrypcję zmian danych w polach
television, books, music
i
movies
w obiekcie
użytkownika. Od tej pory jeśli któryś z użytkowników naszej aplikacji zmieni dane w tych polach
(np. polubi stronę jakiegoś serialu czy filmu albo usunie tego typu stronę ze swojego profilu), nasz
skrypt
rt_receive.php
otrzyma powiadomienie.
Aby pobrać aktywne subskrypcje można użyć takiego skryptu:
Kod:
Zaznacz cały
// pobieramy aktywne subskrypcje
$ch = curl_init();
$url = 'https://graph.facebook.com/'.$facebook->getAppId().'/subscriptions?
access_token='.$app_token;
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HEADER, false);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
$return = curl_exec($ch);
var_dump(json_decode($return, true));
Warto dodać, że modyfikację aktywnych subskrypcji wykonuje się w taki sam sposób jak dodanie
nowej. Przykładowo, jeśli mamy aktywną subskrypcję na pola
television, music, books
i
movies,
a następnie wyślemy zgłoszenie subskrypcji pól
television
i
music,
to nasza
subskrypcja będzie obejmować tylko te dwa pola - pozostałe zostaną usunięte.
Jeśli zachodzi konieczność usunięcia wszystkich subskrypcji lub subskrypcji dla całego obiektu (np.
user),
należy wywołać API metodą
DELETE.
Nie jest to typowe działanie, tak więc można
posłużyć się poniższym przykładem:
Kod:
Zaznacz cały
// usuwanie subskrypcji
$ch = curl_init();
$url = 'https://graph.facebook.com/'.$facebook->getAppId().'/subscriptions?
access_token='.$app_token.'&object=user';
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HEADER, false);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'DELETE');
$return = curl_exec($ch);
curl_close($ch);
Wróćmy teraz do odbierania powiadomień przez nasz skrypt
rt_receive.php.
Powiadomienia
otrzymujemy w formacie
JSON,
który transformujemy do tablicy (Array) funkcją
json_decode().
Skrypt zapisał otrzymane dane do pliku
updates_log.txt,
tak więc możemy
zobaczyć jak te dane wyglądają. Mogą mieć one na przykład taką formę:
Kod:
Zaznacz cały
Array
(
[object] => user
[entry] => Array
(
[0] => Array
(
[uid] => 990000505646950
[id] => 990000505646950
[time] => 1294519765
[changed_fields] => Array
(
[0] => television
)
)
[1] => Array
(
[uid] => 990000505646952
[id] => 990000505646952
[time] => 1294519765
[changed_fields] => Array
(
[0] => music,
[1] => movies
)
)
)
)
Jak widać, powiadomienie zawiera tylko informacje o danych, które uległy zmianie (w tym
przypadku u dwóch użytkowników) - nie zawiera dodanych lub usuniętych danych. Jeśli mamy
dostęp do danych użytkownika (zezwolenie
offline_access),
to możemy pobrać wartości
zmodyfikowanych pól już na etapie odbierania powiadomienia o zmianach. Trzeba jednak
pamiętać, że skrypt odbierający powiadomienia musi zakończyć działanie w czasie krótszym niż 15
sekund - jeśli tak się nie stanie, to Facebook potraktuje to jako timeout (przekroczenie
maksymalnego czasu odpowiedzi) i wyśle powiadomienie ponownie.
Zakładając, że mamy zezwolenie
offline_access,
możemy zmodyfikowane dane pobrać w
taki sposób:
Kod:
Zaznacz cały
// zmienna $updates zawiera tablicę (Array) z informacjami o zmianach
danych otrzymanymi od Facebooka
$params = array('access_token' => $app_token);
foreach($updates['entry'] as $entry)
{
foreach($entry['changed_fields'] as $field)
{
// pobieranie zmodyfikowanych danych użytkownika
$data = $facebook->api('/'.$entry['uid'].'/'.$field, 'get',
$params);
// zobaczmy co dostaliśmy
var_dump($data);
}
}
Oczywiście w prawdziwej aplikacji nie będziemy wyświetlać pobranych danych - możemy je
zapisać do bazy lub wykorzystać je w inny sposób, na przykład umieszczając wpis na tablicy
użytkownika, wysyłając mu e-mail czy wykonując jakąś akcję w naszej aplikacji. Jeśli
zasubskrybujemy zmiany w liście znajomych (object: user, fields: friends), możemy na przykład
stworzyć aplikację powiadamiającą użytkownika o tym, że ktoś usunął go ze znajomych.

Plik z chomika:

Inne pliki z tego folderu:

Inne foldery tego chomika:

Zgłoś jeśli naruszono regulamin