How to Integrate Facebook API in Unity 3D

In Picture 2 choose a name for your app and enter your e-mail address (the e-mail address connected to your Facebook account).
Then click on the Create App ID button.

Tips: Don’t use negative words… anyway, you will receive an alert if you do something wrong here :).

Ok, now that the hardest part is done, we can go to the next step!

Now select your app from the right panel. Select Settings and then select Basic.
(My apps → Settings → Basic)

Here you will see some information about your app. You can edit some parameters, but for now, we will minimize the page, so that we can continue with the rest of the steps in this tutorial.

I. 3 Facebook SDK for Unity 3D

Now we will need Facebook SDK for Unity 3D. 

Here is the link: https://developers.facebook.com/docs/unity/downloads/

Download the latest version. For me, it is 7.14.1 

Download the content, save the files in a new folder on your computer and after all folders have been extracted, open the Facebook SDK folder. There you will see a type of unity package file. Don’t open it yet, because we will need to open a project of Unity 3D.

II. Unity 3D

II. 1 Unity 3D configuration

Open Unity 3D, log in with your account (if you want to do this), create a 3D app (for now it doesn't matter if is 2D or 3D) and open the project. If you want to have a similar layout as mine, please check Picture 3.

Picture 3

First, we must import the Facebook SDK in our empty project. Find the folder where you saved the SDK and double-click on it.

And now you should see a panel like in Picture 4.

Picture 4

Click Import and wait for the SDK to be installed.

Now we must set some parameters in Unity 3D.

II. 2 Facebook configuration in Unity 3D

Up in the menu items, you will see Facebook as shown in Picture 5. Click on it and then click Edit Settings.

Picture 5

Picture 6

Here we must enter the app name (Facebook app name) and the app ID.

After you complete the app ID, the warning message will disappear. The next step is to create a basic UI. 

II. 3 UI elements in Unity 3D

In the Hierarchy tab, right-click and select Create Empty. And because we are good developers, we must rename this GameObject with “Facebook Manager”.

In the same tab, right-click again and select UI and create three buttons. Select each button and rename them (e.g. “btnLogin”, ”btnLogout”, and ”btnGetName”).

If you are done, wait for me to do the same…

Picture 7

Voila! To see all three buttons in the game view tab, we must select btnLogin for example and click on the desired elements (e.g. like in Picture 8) to access the different positions and then use alt to drag and drop the elements.

See Picture 9 for Logout, and Picture 10 for GetName.

Picture 8

Picture 9

Picture 10

Now the game view must look like Picture 11.

Picture 11

Because we don’t like to see three buttons with the same name, we will change them. To do this, select each button in the Hierarchy tab, click on the drop-down arrow and select text. In the right panel, you will see a text tab. Change the names to "Login", "Logout", and "Name".

Now we’ve arrived at the fun part.

III. Coding

III. 1 Scripting in Unity 3D

In the Project View, select Assets. Right-click on it, and select create, then folder. Name the folder “Scripts” and double-click on it.

In the “Scripts” folder, right click on empty space and create a C# script. Name it FacebookManager and open it. I use visual studio for editing scripts.

First of all, add the libraries that are necessary for your script to work. In our case, this is what we used:

using System.Collections.Generic;
using UnityEngine;
using Facebook.Unity;
using UnityEngine.UI;

Next, you must create button variables.

public class FacebookManager : MonoBehaviour
{
    public Button btnLogin, btnLogout, btnName;

Moving on, you must initialize the Facebook API. For this, the following function is required:

 private void Awake()
    {
        if (!FB.IsInitialized)
        {
            // Initialize the Facebook SDK
            FB.Init(InitCallback, OnHideUnity);
        }
        else
        {
            // Already initialized, signal an app activation App Event
            FB.ActivateApp();
        }
    }

Then you must create these two functions: InitCallback and OnHideUnity.

  private void InitCallback()
    {
        if (FB.IsInitialized)
        {
            // Signal an app activation App Event
            FB.ActivateApp();
            // Continue with Facebook SDK
            // ...
        }
        else
        {
            Debug.Log("Failed to Initialize the Facebook SDK");
        }
    }

    private void OnHideUnity(bool isGameShown)
    {
        if (!isGameShown)
            Time.timeScale = 0;
        else
            Time.timeScale = 1;
    }

Cool, if you don’t have any errors, let’s start to create the login and logout functions:

  public void FacebookLogin()
    {
        var permissions = new List<string>() { "public_profile", "email", "user_friends" };
        FB.LogInWithReadPermissions(permissions, AuthCallback);
    }

If you want more permissions, check Facebook developers documents and search for what you want to use.

private void AuthCallback(ILoginResult result)
    {
        if (FB.IsLoggedIn)
        {
            // AccessToken class will have session details
            var aToken = Facebook.Unity.AccessToken.CurrentAccessToken;
            // Print current access token's User ID
            Debug.Log(aToken.UserId);
            // Print current access token's granted permissions
            foreach (string perm in aToken.Permissions)            
                Debug.Log(perm);            
        }
        else
        {
            Debug.Log("User cancelled login");
        }
    }
    public void FacebookLogout()
    {
        FB.LogOut();
    }

And for your profile name, use this function:

public void GetName()
    {
        FB.API("me?fields=name", Facebook.Unity.HttpMethod.GET, delegate (IGraphResult result)
        {
            if (result.ResultDictionary != null)
            {
                foreach (string key in result.ResultDictionary.Keys)
                {
                    Debug.Log(key + " : " + result.ResultDictionary[key].ToString());
                    if (key == "name")
                        btnName.GetComponentInChildren<Text>().text = result.ResultDictionary[key].ToString();
                }
            }
        });
    }

And the last function is the Start function for our buttons:

  void Start()
    {
        btnLogin.onClick.AddListener(() => FacebookLogin());
        btnLogout.onClick.AddListener(() => FacebookLogout());
        btnName.onClick.AddListener(() => GetName());
    }
}

And now our scripts are complete. For a better understanding, you can also see how my entire script looks like (Pictures 12 and 13).