GettingStarted.md

Getting Started

If developing an application that supports iOS and Android, make sure you installed the NuGet package into your PCL project and Client projects.

Setup

• Facebook Setup
• Android Setup
• iOS Setup

Login

Here some examples on how to login depending on your use case:

Login with read permissions requesting email permission.

 await CrossFacebookClient.Current.LoginAsync( new string[] {"email"});

Login with publish permissions

  await CrossFacebookClient.Current.LoginAsync( new string[] {"user_friends"},FacebookPermissionType.Publish);

Login with read permissions & get user data

 await CrossFacebookClient.Current.RequestUserDataAsync(new string[] { "email", "first_name", "gender", "last_name", "birthday" }, new string[] { "email", "user_birthday" });

Note: This method will check if has the requested permissions granted, if so will just get the user data, if not will prompt login requesting the missing permissions and after granted will get the user data.

Logout

 CrossFacebookClient.Current.Logout();

Permissions

There are some methods & properties to verify the current state of facebook permissions:

CrossFacebookClient.Current.ActivePermissions : List of granted permissions.

CrossFacebookClient.Current.DeclinedPermissions : List of declined permissions.

CrossFacebookClient.Current.VerifyPermission : Verify if a specific permission has been granted.

Usage:

CrossFacebookClient.Current.VerifyPermission("user_friends");

CrossFacebookClient.Current.HasPermissions : Verify if all the permissions specified have been granted.

Usage:

CrossFacebookClient.Current.HasPermissions(new string[]{"user_friends","user_likes"});

More information about available permissions here:

https://developers.facebook.com/docs/facebook-login/permissions/?locale=en_EN

Sharing

Simple Share

 await CrossFacebookClient.Current.SharePhotoAsync(myPhotoBytes, captionText);

Share multiple photos

FacebookSharePhoto photo = new FacebookSharePhoto(text, imageBytes);
FacebookSharePhoto photo2 = new FacebookSharePhoto(text2, imageBytes2);
FacebookSharePhoto[] photos = new FacebookSharePhoto[] { photo, photo2 };                    
FacebookSharePhotoContent photoContent = new FacebookSharePhotoContent(photos);
 var ret = await CrossFacebookClient.Current.ShareAsync(photoContent);

More information on Sharing Content section.

Game Request

FacebookGameRequestContent gameRequest = new FacebookGameRequestContent(){
    Title = "This is the request title",
    Message = "This is the request message"
};
 await CrossFacebookClient.Current.RequestGameRequestDialogAsync(gameRequest);

Facebook Graph Requests

Get all my likes

  await CrossFacebookClient.Current.QueryDataAsync("me/likes", new string[]{ "user_likes"});
  

More information on Facebook Graph Requests section.

Facebook Response

All async methods response is a FacebookResponse<T> where the type of T is relevant to the caller method:

• On login method returns a bool.

• On sharing/user data/app invite returns a dictionary with the data response.

• On Facebook graph request methods returns a raw string with the request response

Response

Type: FacebookResponse<T>

Properties:

• Data: Response data (T)

• Status: Response status

  FacebookActionStatus.Canceled - If Request was canceled

  FacebookActionStatus.Unauthorized - If Request was not authorized due to lack of permissions required

  FacebookActionStatus.Completed - If Request was completed succesfully

  FacebookActionStatus.Error - If Request failed

• Message: Error message string

Note: If response Status isn't FacebookActionStatus.Completed, Data property will be null and should have a value on Message property with the error.

Events

All async methods also trigger events:

Login event:

  CrossFacebookClient.Current.OnLogin += (s,a)=> 
  {
     switch (a.Status)
      {
         case FacebookActionStatus.Completed:
          //Logged in succesfully
         break;
      }
  };

RequestUserData event:

  CrossFacebookClient.Current.OnUserData += (s,a)=> 
  {
     switch (a.Status)
      {
         case FacebookActionStatus.Completed:
          //Got user data
         break;
      }
      
  };

Sharing event:

  CrossFacebookClient.Current.OnSharing += (s,a)=> 
  {
      switch (a.Status)
      {
         case FacebookActionStatus.Completed:
          //Shared post succesfully
         break;
      }
  };

Game Request event:

  CrossFacebookClient.Current.OnGameRequest += (s,a)=> 
  {
      switch (a.Status)
      {
         case FacebookActionStatus.Completed:
          //Game request succesfully
         break;
      }
  };

Request event:

  CrossFacebookClient.Current.OnRequestData += (s,a)=> 
  {
      switch (a.Status)
      {
         case FacebookActionStatus.Completed:
      
         break;
      }
  };

<= Back to Table of Contents