Gaming Services Unity3D SDK

Al integrar el inicio de sesión con Facebook, la opción para compartir en Facebook o Facebook Gaming, determinados eventos de la aplicación se registran y recopilan automáticamente para el Administrador de eventos, a menos que desactives el registro automático de eventos de la aplicación. Recomendamos que todos los desarrolladores de aplicaciones que usen el inicio de sesión con Facebook, la opción para compartir en Facebook o Facebook Gaming comprendan el funcionamiento de esta característica. Para obtener información más detallada sobre los datos que se recopilan y cómo desactivar el registro automático de eventos de la aplicación, consulta Registro automático de eventos de la aplicación.

Gaming Services is available as a new component in the official Facebook SDK for Unity3D. Using Facebook official SDKs is the recommended approach and makes it easy to access services enabled by Facebook Login for Gaming including the Player Finder and Sharing (for Gaming) experiences.

Prerequisites

Your application needs to enroll in Gaming Services to access features in this document. Follow the instructions to enroll your application.
Make sure you have the minimal version of Facebook Unity3D SDK and above. Download the latest version.

Implementation

Facebook Login for Gaming

Facebook Login for Gaming enables a new login method for games. It supports the same implementation and SDK methods as Facebook Login. If this is the first time you're integrating the Facebook SDK into your App, refer to the configuration guide before proceeding.

Instead of receiving public_profile, your application will receive gaming_profile as the default permission. Other requestable permissions include user_friends, email, and gaming_user_picture.

Gaming Graph Domain

After integrating with Facebook Login for Gaming, your application will receive an access token for use on Gaming graph domain (graph.fb.gg), instead of the Facebook graph domain (graph.facebook.com). Read more about gaming graph domain.

You can check if the current User has connected with Facebook Login For Gaming by verifying the Graph Domain to be gaming in the Access Token:

// (c) Facebook, Inc. and its affiliates. Confidential and proprietary.
...
using Facebook.Unity;
...
AccessToken currentAccessToken = AccessToken.CurrentAccessToken;
if (currentAccessToken != null && currentAccessToken.GraphDomain == "gaming") {
  // current user has been migrated to Facebook Login for Gaming
}

Player Finder and Sharing for Gaming

Below is a Unity3D sample code showing how to implement Player Finder and Sharing (for Gaming).

// (c) Facebook, Inc. and its affiliates. Confidential and proprietary.
using Facebook.Unity;
...

// this is a general purpose IResult handler
// that can be used with the examples below.
protected void HandleResult(IResult result)
{
    if (result == null)
    {
      LogView.AddLog("Null Response\n");
      return;
    }

    // Some platforms return the empty string instead of null.
    if (!string.IsNullOrEmpty(result.Error))
    {
      // handle error case here.
    }
    else if (result.Cancelled)
    {
      // a dialog was cancelled.
    }
    else if (!string.IsNullOrEmpty(result.RawResult))
    {
       // success case! Do something useful with this.
    }
    else
    {
      // we got an empty response
    }
}
...

// binding Player Finder to a button
if (GUILayout.Button("Player Finder Button"))
{
  FBGamingServices.OpenFriendFinderDialog(HandleResult);
}
...

// Uploading an Image to use with Sharing (for Gaming)
FBGamingServices.UploadImageToMediaLibrary(
                        "test Image",
                        new Uri("/path/to/image/in/phone.jpg"),
                        true,
                        HandleResult);
...

// Uploading a Video to use with Sharing (for Gaming)
FBGamingServices.UploadVideoToMediaLibrary(
                        "test Video",
                        new Uri("/path/to/video/in/phone.mp4"),
                        HandleResult);