Bonjour à tous et bienvenue dans la fin de ce tutoriel sur l’API Facebook pour Android. Dans le précédent article, nous avions fait la configuration du projet et du compte développeur et qui s’était achevé avec l’implémentation de la connexion via Facebook et de l’affichage du nom d’utilisateur.
Dans cet article, nous allons voir comment récupérer l’adresse mail et l’image de profil d’un utilisateur.
Récupération de l’image de profil
L’image de profil fait partie des informations publiques d’un profil Facebook, il n’y a donc pas de permission supplémentaire à demander. Cependant, celle-ci n’est pas disponible directement dans l’objet Profile qui fournit uniquement l’URL de l’image à l’aide de la fonction getProfilePictureUri(int width, int height) (qui prend en paramètres la taille voulue pour l’image).
Il faut donc télécharger l’image. Pour cela, je vous propose de créer une nouvelle classe qui hérite AsyncTask afin de télécharger l’image. Une solution serait de créer une interface OnImageDownloadedListener et l’implémenter dans l’activité principale, mais le plus simple dans notre cas est de passer notre ImageView à la construction de la tâche et d’afficher l’image si le téléchargement a réussi (rappelons que la méthode onPostExecute de AsyncTask s’exécute dans le thread UI).
Voici un exemple d’implémentation pour la classe FetchProfilePictureTask :
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 |
package fr.etienne_boespflug.samples.facebook_api_sample; import android.graphics.Bitmap; import android.graphics.BitmapFactory; import android.net.Uri; import android.os.AsyncTask; import android.util.Log; import android.widget.ImageView; import java.io.IOException; import java.io.InputStream; import java.net.URL; public class FetchProfilePictureTask extends AsyncTask<Uri, Void, Bitmap> { private ImageView imageView; public FetchProfilePictureTask(ImageView imageView) { this.imageView = imageView; } protected Bitmap doInBackground(Uri... urls) { Bitmap img = null; try { InputStream in = new URL(urls[0].toString()).openStream(); img = BitmapFactory.decodeStream(in); } catch (IOException e) { Log.e("fetch_profile_pic", Log.getStackTraceString(e)); } return img; } protected void onPostExecute(Bitmap result) { if(result != null) imageView.setImageBitmap(result); } } |
Vous pouvez également ajouter une véritable gestion des exceptions MalformedURLException et IOException (pour prévenir l’utilisateur d’une absence de connexion internet par exemple), mais cela n’est pas important pour notre exemple.
Il n’est pas nécessaire d’actualiser l’image si le résultat est null. En effet, cela aurait pour effet de supprimer l’image lors d’un échec de téléchargement. Préférez effacer manuellement le contenu de votre ImageView lorsque l’utilisateur est déconnecté.
À présent, il nous faut modifier displayProfileData pour qu’elle appelle la tâche de téléchargement de l’image :
|
1 2 3 4 5 6 7 8 9 10 11 12 |
private void displayProfileData(Profile profile) { TextView nameView = (TextView) findViewById(R.id.name_view); ImageView picView = (ImageView) findViewById(R.id.profile_picture_view); if(profile != null) { nameView.setText(profile.getName()); new FetchProfilePictureTask(picView).execute(profile.getProfilePictureUri(300, 300)); } else { nameView.setText(""); picView.setImageResource(0); } } |
Vous pouvez maintenant relancer l’application, l’image de profil devrait s’afficher correctement :
Récupération de l’adresse mail de l’utilisateur
La dernière étape de ce tutoriel consiste en l’affichage de l’adresse email de l’utilisateur. Si l’utilisateur a fourni les permissions nécessaires, il est possible d’y accéder.
La récupération de l’adresse mail fait intervenir une API fondamentale du SDK Android de Facebook : la Graph API. Celle-ci permet la lecture et l’écriture sur le graphe du réseau social (pour récupérer l’adresse mail ou pour poster à la place de l’utilisateur si celui-ci l’a autorisé par exemple).
Obtention de l’AccessToken
Lorsque l’authentification Facebook est réussie, il est possible de récupérer un jeton d’accès qui sera utilisé lors des requêtes de la Graph API. Ce jeton permet à Facebook d’identifier l’application qui tente d’accéder au graphe et de s’assurer que l’utilisateur correspondant lui a bien donné les autorisations correspondantes. Le jeton dispose d’une durée de vie limitée, la méthode isExpired permet de déterminer s’il est encore valide ou non.
Dans la méthode
onSuccess de la callback du bouton de login, le paramètre
loginResult possède une fonction
getAccessToken() permettant de récupérer le jeton. La méthode statique
AccessToken.getCurrentAccessToken() est également disponible.
De la même façon que pour le
Profile, nous allons utiliser un
AccessTokenTracker que nous allons initialiser dans la méthode
onCreate. Celui-ci se chargera d’appeler la méthode
displayGraphAPIResult(AccessToken) qui sera créée par la suite :
|
1 2 3 4 5 6 7 8 9 10 11 12 |
profileTracker.startTracking(); displayGraphAPIResult(AccessToken.getCurrentAccessToken()); accessTokenTracker = new AccessTokenTracker() { @Override protected void onCurrentAccessTokenChanged(AccessToken oldToken, AccessToken newToken) { displayGraphAPIResult(newToken); } }; accessTokenTracker.startTracking(); facebookLoginButton = (LoginButton) findViewById(R.id.facebook_login_button); |
Ici, un premier appel à displayGraphAPIResult est effectué puisque contrairement au ProfileTracker, le tracker du jeton n’est pas appelé au démarrage de l’activité (si l’utilisateur est déjà connecté).
À nouveau, assurez vous que le tracking soit arrêté à la fermeture de l’activité, lancez l’affichage dans la méthode onResume et mettez à jour la méthode onSuccess de la callback pour appeler la méthode displayGraphAPIResult :
|
1 2 3 4 5 6 |
@Override protected void onStop() { super.onStop(); profileTracker.stopTracking(); accessTokenTracker.stopTracking(); } |
|
1 2 3 4 5 6 |
@Override protected void onResume() { super.onResume(); displayProfileData(Profile.getCurrentProfile()); displayGraphAPIResult(AccessToken.getCurrentAccessToken()); } |
|
1 2 3 4 5 |
@Override public void onSuccess(LoginResult loginResult) { displayProfileData(Profile.getCurrentProfile()); displayGraphAPIResult(loginResult.getAccessToken()); } |
La GraphRequest
Il reste maintenant à implémenter la fonction displayGraphAPIResult. Celle-ci prend donc en paramètre un AccessToken :
|
1 2 3 4 5 6 7 8 9 |
private void displayGraphAPIResult(AccessToken accessToken) { final TextView emailView = (TextView) findViewById(R.id.email_view); if(accessToken == null || accessToken.isExpired()) emailView.setText(""); else { /* Do the request */ } } |
L’adresse mail de l’utilisateur sera affichée dans la TextView qui avait été déclarée précédemment dans le xml. Celle-ci doit être final puisqu’elle sera utilisée dans une callback de la GraphRequest (la closure ne peut être faite que sur des attributs finaux en Java).
Il est bien entendu nécessaire de vérifier que le jeton n’est pas null, puisque la méthode est susceptible d’être appelée alors qu’aucun AccessToken n’est disponible. Cela permet également de détecter une déconnexion et donc de vider le contenu de la view. De plus, si le jeton est expiré, il n’y a pas de raison d’effectuer la requête qui va de toute façon échouer.
La GraphRequest est créée à l’aide de la méthode statique GraphRequest.newMeRequest. Celle-ci prend en argument un AccessToken (valide) et une GraphRequest.GraphJSONObjectCallback possédant la méthode onCompleted qu’il nous faudra surcharger :
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
GraphRequest request = GraphRequest.newMeRequest( accessToken, new GraphRequest.GraphJSONObjectCallback() { @Override public void onCompleted(JSONObject object, GraphResponse response) { if(object == null) return; String email = null; try { email = object.getString("email"); } catch (JSONException e) { Log.e("graph_api_result", "Null email" + Log.getStackTraceString(e)); } if(email != null) emailView.setText(email); } }); |
La réponse est composée d’un objet JSON, contenant les valeurs demandées en cas de succès et d’une GraphResponse définissant le statut de la réponse.
Ici, il n’est pas obligatoire de s’intéresser à la GraphResponse puisque la nullité du JSONObject retourné est testée et que l’obtention de la valeur de l’email est englobé dans un bloc try-catch. En pratique, pour des requêtes plus complexes, la GraphResponse contient des informations utile pour gérer les cas d’erreur avec notamment les méthodes getError, getConnexion et getRequest.
Le champ contenant l’email se nomme simplement email. Si le champ est présent et non-nul, alors sa valeur est affichée dans la vue correspondante.
Une fois la GraphRequest créée, il faut l’exécuter. Pour ce faire, nous devons lui préciser les informations qui nous intéressent. Cela se fait à l’aide d’un Bundle :
|
1 2 3 4 |
Bundle parameters = new Bundle(); parameters.putString("fields", "email"); request.setParameters(parameters); request.executeAsync(); |
Puisque nous demandons des valeurs spécifiques, le premier paramètre est fields, la chaîne suivante contient tous les paramètres demandés séparés par des virgules (par exemple “email, id” si nous souhaitions également l’id). À nouveau, la documentation précise le nom de champ correspondant à chaque donnée du graphe. Voici un exemple de JSON retourné par une GraphRequest demandant les informations basiques sur un utilisateur :
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
{ "id": "12345678", "birthday": "1/1/1950", "first_name": "Chris", "gender": "male", "last_name": "Colm", "link": "http://www.facebook.com/12345678", "location": { "id": "110843418940484", "name": "Seattle, Washington" }, "locale": "en_US", "name": "Chris Colm", "timezone": -8, "updated_time": "2010-01-01T16:40:43+0000", "verified": true } |
Le code pour la requête de l’email de l’utilisateur est maintenant terminé et prêt à être testé :
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 |
package fr.etienne_boespflug.samples.facebook_api_sample; import android.content.Intent; import android.support.v7.app.AppCompatActivity; import android.os.Bundle; import android.util.Log; import android.widget.ImageView; import android.widget.TextView; import com.facebook.AccessToken; import com.facebook.AccessTokenTracker; import com.facebook.CallbackManager; import com.facebook.FacebookCallback; import com.facebook.FacebookException; import com.facebook.FacebookSdk; import com.facebook.GraphRequest; import com.facebook.GraphResponse; import com.facebook.Profile; import com.facebook.ProfileTracker; import com.facebook.appevents.AppEventsLogger; import com.facebook.login.LoginResult; import com.facebook.login.widget.LoginButton; import org.json.JSONException; import org.json.JSONObject; public class MainActivity extends AppCompatActivity { LoginButton facebookLoginButton; CallbackManager callbackManager; ProfileTracker profileTracker; AccessTokenTracker accessTokenTracker; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); // Initialize Facebook SDK. FacebookSdk.sdkInitialize(getApplicationContext()); AppEventsLogger.activateApp(getApplication()); setContentView(R.layout.activity_main); callbackManager = CallbackManager.Factory.create(); profileTracker = new ProfileTracker() { @Override protected void onCurrentProfileChanged(Profile oldProfile, Profile newProfile) { displayProfileData(newProfile); } }; profileTracker.startTracking(); displayGraphAPIResult(AccessToken.getCurrentAccessToken()); accessTokenTracker = new AccessTokenTracker() { @Override protected void onCurrentAccessTokenChanged(AccessToken oldToken, AccessToken newToken) { displayGraphAPIResult(newToken); } }; accessTokenTracker.startTracking(); facebookLoginButton = (LoginButton) findViewById(R.id.facebook_login_button); facebookLoginButton.setReadPermissions("email"); // facebookLoginButton.setFragment(this); // If using in a fragment. // Callback registration facebookLoginButton.registerCallback(callbackManager, new FacebookCallback<LoginResult>() { @Override public void onSuccess(LoginResult loginResult) { displayProfileData(Profile.getCurrentProfile()); displayGraphAPIResult(loginResult.getAccessToken()); } @Override public void onCancel() { /* NOP */ } @Override public void onError(FacebookException e) { Log.e("facebook_login", e.getMessage()); } }); } private void displayProfileData(Profile profile) { TextView nameView = (TextView) findViewById(R.id.name_view); ImageView picView = (ImageView) findViewById(R.id.profile_picture_view); if(profile != null) { nameView.setText(profile.getName()); new FetchProfilePictureTask(picView).execute(profile.getProfilePictureUri(300, 300)); } else { nameView.setText(""); picView.setImageResource(0); } } private void displayGraphAPIResult(AccessToken accessToken) { final TextView emailView = (TextView) findViewById(R.id.email_view); if(accessToken == null || accessToken.isExpired()) emailView.setText(""); else { GraphRequest request = GraphRequest.newMeRequest( accessToken, new GraphRequest.GraphJSONObjectCallback() { @Override public void onCompleted(JSONObject object, GraphResponse response) { if(object == null) return; String email = null; try { email = object.getString("email"); } catch (JSONException e) { Log.e("graph_api_result", "Null email" + Log.getStackTraceString(e)); } if(email != null) emailView.setText(email); } }); Bundle parameters = new Bundle(); parameters.putString("fields", "email"); request.setParameters(parameters); request.executeAsync(); } } @Override protected void onStop() { super.onStop(); profileTracker.stopTracking(); accessTokenTracker.stopTracking(); } @Override protected void onResume() { super.onResume(); displayProfileData(Profile.getCurrentProfile()); displayGraphAPIResult(AccessToken.getCurrentAccessToken()); } @Override protected void onActivityResult(int requestCode, int responseCode, Intent intent) { super.onActivityResult(requestCode, responseCode, intent); callbackManager.onActivityResult(requestCode, responseCode, intent); } } |
Publication de l’application
La partie implémentation est désormais terminée. Cependant, l’application est toujours phase de développement et il faut encore configurer le mode Release pour que n’importe quel utilisateur puisse se connecter avec votre application.
Pour cela, il est nécessaire de fournir un second Key Hash, appelé “Release Key Hash” (clef de production). La manipulation est la même que pour la génération du Development Key Hash à la différence que la clef à fournir est celle avec laquelle vous allez signer votre application. Utilisez donc le keystore de release correspondant à votre application.
Une fois encore, il est possible d’utiliser la fonction getFacebookKey qui avait été présentée pour la génération du Development Key Hash. Je rappelle qu’il ne faut pas laisser l’affichage d’une clef en production et cela est d’autant plus vrai pour la clef de production.
Ajoutez ensuite le hash généré à la liste de Key Hashes sur votre console développeur de Facebook.
À présent, vous pouvez publier l’application comme vous l’auriez fait pour n’importe-quelle application Android. La console développeur Facebook pourra cependant vous donner des informations complémentaires à Google Play concernant l’utilisation de votre application.
Aller plus loin
Maintenant que avec eu un aperçu du fonctionnement du SDK Facebook Android, vous pouvez poursuivre en essayant d’intégrer des fonctionnalités plus avancées. Voici quelques liens qui pourront vous être utiles :
- Intégration des fonctionnalités de partage sur Android : facebook.com | Partage sur Android
- Utilisez App Link pour Android : [EN] facebook.com | App Link on Android
- Aller plus loin avec l’API Graph: facebook.com | Utiliser la Graph API ([EN] documentation)
- Les autorisations Facebook sur Android : facebook.com | Autorisations sur Android
Si vous êtes intéressé par le fait de proposer un lien de partage prédéfini pour facebook, vous pouvez choisir de créer un bouton de partage sans passer par le Android SDK à l’aide des Social Plugins.
You must log in to post a comment.