How to integrate Facebook in a Windows 8 Metro Style Application

In ziua de azi aproape toate aplicatile pentru un consumator normal au nevoie de integrare cu Facebook. Chiar daca noua, dezvoltatorilor, ne place sau nu trebuie sa facem acest lucru.

Cand scriem o aplicatie Windows Metro Style trebuie sa luam cateva decizii legate de modul in care o sa ne integram cu Facebook.

O varianta pe care o avem la indemana este sa ne folosim de Windows 8 "Contracts". Desi in prima faza este destul de simplu, in cazul in care avem un flow mai complex, o sa ne dam seama ca nu ne este atat de usor sa facem acest lucru. Si asa ajungem la a doua varianta, care implica apeluri directe spre Facebook. Nu faceti greseala sa incepeti sa reinventati roata.

In primul rand avem niste librari ajutatoare in .NET, care ne ajuta sa facem toata partea de autentificare. Acest brower ne cere sa setam doar adresa de logare si url de redirectare. Toata magina care se intampla in spate pentru OAuth este rezolvata. .NET se ocupa se afisearea unui pop-up unde userul sa isi introduca credentialele and so on. Mai jos gasiti un exemplu de autentificare pentru o aplicatie Windows Metro Style:

 WebAuthenticationResult result =
    await WebAuthenticationBroker.AuthenticateAsync(
    WebAuthenticationOptions.None,
     new Uri("loginUri"),
     new Uri("redirectUri"));

Rezultatul returnat o sa contine o proprietate ResponseStatus, pe baza careia putem sa stim daca autentificare a fost cu success, userul a dat cancel sau a aparut o eroare in acest proces. Datele pe care serverul le returneaza precum auth. token pot sa fie gasite in result.ResponseData.

Exista deja o librarie pentru acest lucru oferita de catre Prabir. Aceasta este deja la versiunea a sasea. Din punctul meu de vedere este una din cele mai mature librarii pentru Facebook care exista in momentul de fata.

Ce mi-a placut cel mai mult la aceasta librarie este modul in care se executa o comanda. In loc sa aibe un API complex si greu de tinut la zi, iti permite sa setezi comanda (metoda) pe care vrei sa o apelezi si toti parametrii aferenti, iar apoi sa executi un GET sau POST prin intermediul clasei FacebookClient.

Primul pas este sa ne logam pe Facebook. Avem nevoie de url-ul pentru logare si de o modalitate de a extrage access token din rezultat. Acest lucru se poate face usor face ne folosim de FacebookClient. Aceasta clasa contine metoda GetLoginUrl, prin intermediul careia putem sa obtinem url pentru login, iar metoda ParseOAuthCallbackUrl parseaza ResponseData returnat de catre WebAuthenticationBroker a.i. sa putem accesa fara nici o problema toate datele:

FacebookClient fbClient = new FacebookClient();
fbClient.AppId = "1234";
WebAuthenticationResult result = await WebAuthenticationBroker.AuthenticateAsync(
     WebAuthenticationOptions.None,
     fbClient.GetLoginUrl(CreateLoginParameters()),
     new Uri("https://www.facebook.com/connect/login_success.html));

Este bine de stiut ca AppId (application id) trebuie setat in cazul in care avem nevoie ca aplicatia noastra de Facebok sa poata accesa datele clientului.

Urmatorul pas este sa verificam care este statusu la result, daca acesta este in regula atunci putem sa extragem AccessToken. O sa avem nevoie de acesta cand o sa dorim sa executasm anumite actiuni.

if (result.ResponseStatus == WebAuthenticationStatus.Success)
{
    FacebookOAuthResult fbResult = fbClient.ParseOAuthCallbackUrl(new Uri(result.ResponseData));
    accessToken = fbResult.AccessToken;
}

Prin intermediul comenzii GetTaskAsync putem sa executam orice metoda din API de Facebook. Rezultatul returnat este de tip dynamic. In exemplul de mai jos extragem toate datele unui user.

dynamic userInfo = await fbClient.GetTaskAsync("me");
Trace.WriteLine(userInfo.name);
Trace.WriteLine(userInfo.id);

In cazul unor comenzi mai complexe, este nevoie sa ne cream un obiect de tip ExpandoObject si sa setam toti parametrii pe care commanda ii cere. Avem si cateva objecte ajutatoare care ne ajuta sa comunicam cu Facebook. Unu din ele este FacebookMediaObject, prin intermediul caruia putem sa facem upload sau download la continut media. In exemplul de mai jos putem vedea cum putem sa facem upload la o poza pe Facebook.

byte[] imageBytes = null;
FacebookClient fbClient = new FacebookClient(accessToken);
dynamic fbParams = new ExpandoObject();
fbParams.access_token = accessToken;
fbParams.caption = "Romania";
fbParams.method = "facebook.photos.upload";
fbParams.uid = "12344314232342323";
FacebookMediaObject fbMediaObject = new FacebookMediaObject()
{
  FileName = "MyRomaniaPicture",
  ContentType = "image/jpg"
};
fbMediaObject.SetValue(await _mediaFileManipulator.GetBytes(imageBytes));
fbParams.source = fbMediaObject;
dynamic result = await fbClient.PostTaskAsync(fbParams);

Mi s-a parut destul de usor de folosit acest SDK pentru Facebook si va invit sa il incercati si voi.