最小 SDK バージョン: 2.0.0
このセクションでは、Facebook アカウントを使用してゲーム内でのプレイヤーの認証を設定する以下のシナリオについて説明します。
ノート: 以下のコード例は、プレイヤーの Facebook アクセストークンをすでに取得済みであることを前提としています。
- Facebook アカウントサインインを設定する
- 戻ってきたプレイヤーをサインインする、または新しいプレイヤーを作成する。
- 匿名ログインから Facebook アカウントを介したプラットフォームログインへとプレイヤーを更新する。
ゲーム内のプレイヤーに Facebook サインインのオプションを提供するには、Facebook 開発者ポータルでアプリケーションを作成し、Facebook SDK for Unity をインストールしてプレイヤーをサインインし、アクセストークンを取得してください。
Facebook アカウントサインインを設定する
以下の手順では、Facebook アプリケーションを設定済みであることを前提としています。
Facebook の入門ドキュメント に従って、Facebook SDK を設定し、インストールします。
Facebook を Unity Authentication 用の ID プロバイダーとして追加します。
- Unity エディターメニューで、Edit (編集) > Project Settings... (プロジェクト設定...) を選択し、ナビゲーションメニューから Services (サービス) > Authentication を選択します。
- ID Providers (ID プロバイダー) を Facebook に設定し、Add (追加) をクリックします。
- App ID テキストフィールドにアプリケーション ID (ステップ 1 で確認) を入力します。
- App Secret テキストフィールドにアプリケーションシークレットを入力し、Save (保存) をクリックします。
こちらのサンプルコードを使用 して Facebook サインインを実装します。
ノート: Unity Authentication SDK では現在、エクスプレスサインイントークンはサポートされていません。
ノート: Facebook SDK は Unity 2021.1 の再生モードで動作しません。こちらの Github の問題 で追跡されています。回避策として、こちらの Pull requests を使用 して新しい Facebook.Unity.dll をビルドしてください。
現時点では、"コンシューマー" および "ビジネス" アプリケーションタイプがサポートされています。
参照先のパッケージは、Unity によって開発、所有、運営されているものではありません。非 Unity パッケージの扱いについては、Unity の ベストプラクティス を参照してください。
using System.Collections.Generic;
using UnityEngine;
// Other needed dependencies
using Facebook.Unity;
public class FacebookExampleScript : MonoBehaviour
{
public string Token;
public string Error;
// Awake function from Unity's MonoBehaviour
void Awake()
{
if (!FB.IsInitialized)
{
// Initialize the Facebook SDK
FB.Init(InitCallback, OnHideUnity);
}
else
{
// Already initialized, signal an app activation App Event
FB.ActivateApp();
}
}
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");
}
}
void OnHideUnity(bool isGameShown)
{
if (!isGameShown)
{
// Pause the game - we will need to hide
Time.timeScale = 0;
}
else
{
// Resume the game - we're getting focus again
Time.timeScale = 1;
}
}
public void Login()
{
// Define the permissions
var perms = new List<string>() { "public_profile", "email" };
FB.LogInWithReadPermissions(perms, result =>
{
if (FB.IsLoggedIn)
{
Token = AccessToken.CurrentAccessToken.TokenString;
Debug.Log($"Facebook Login token: {Token}");
}
else
{
Error = "User cancelled login";
Debug.Log("[Facebook Login] User cancelled login");
}
});
}
}戻ってきたプレイヤーのサインインまたは新しいプレイヤーの作成
SignInWithFacebookAsync メソッドを使用して、以下のいずれかを行うことができます。
- Facebook の認証情報を使用して新しい Unity Authentication プレイヤーを作成する。
- Facebook の認証情報を使用して既存のプレイヤーをサインインする。
プロジェクト内の Unity Authentication プレイヤーが認証情報と関連付けられていない場合、SignInWithFacebookAsync は新しいプレイヤーを作成します。プロジェクト内の Unity Authentication プレイヤーが認証情報と関連付けられている場合、SignInWithFacebookAsync はそのプレイヤーのアカウントにサインインします。この関数ではキャッシュされたプレイヤーは考慮されません。SignInWithFacebookAsync はキャッシュされたプレイヤーを置き換えます。
async Task SignInWithFacebookAsync(string accessToken)
{
try
{
await AuthenticationService.Instance.SignInWithFacebookAsync(accessToken);
Debug.Log("SignIn is successful.");
}
catch (AuthenticationException ex)
{
// Compare error code to AuthenticationErrorCodes
// Notify the player with the proper error message
Debug.LogException(ex);
}
catch (RequestFailedException ex)
{
// Compare error code to CommonErrorCodes
// Notify the player with the proper error message
Debug.LogException(ex);
}
}プレイヤーを匿名から Facebook アカウントへと更新する
匿名認証を設定した後、プレイヤーが匿名からアップグレードし、Facebook アカウントを作成して Facebook を使用してサインインすることを希望する場合は、ゲームのプレイヤーにプロンプトを表示し、Facebook サインインをトリガーして Facebook からアクセストークンを取得するよう求める必要があります。その後、LinkWithFacebookAsync API を呼び出して、プレイヤーを Facebook アクセストークンにリンクします。
キャッシュされたプレイヤーが SDK に存在する場合は、キャッシュされたプレイヤーを Facebook アカウントにリンクできます。
SignInAnonymouslyAsyncを使用して、キャッシュされたプレイヤーのアカウントにサインインします。LinkWithFacebookAsyncを使用して、キャッシュされたプレイヤーのアカウントを Facebook アカウントにリンクします。
キャッシュされたプレイヤーについて詳しくは、キャッシュされたプレイヤーのサインイン セクションを参照してください。
async Task LinkWithFacebookAsync(string accessToken)
{
try
{
await AuthenticationService.Instance.LinkWithFacebookAsync(accessToken);
Debug.Log("Link is successful.");
}
catch (AuthenticationException ex) when (ex.ErrorCode == AuthenticationErrorCodes.AccountAlreadyLinked)
{
// Prompt the player with an error message.
Debug.LogError("This user is already linked with another account. Log in instead.");
}
catch (AuthenticationException ex)
{
// Compare error code to AuthenticationErrorCodes
// Notify the player with the proper error message
Debug.LogException(ex);
}
catch (RequestFailedException ex)
{
// Compare error code to CommonErrorCodes
// Notify the player with the proper error message
Debug.LogException(ex);
}
}プレイヤーがサインインするか新しいプレイヤープロファイルを作成して Facebook サインインをトリガーする場合、Facebook アクセストークンを受け取ったら、以下の API を呼び出してプレイヤーの認証を行います。
async Task SignInWithFacebookAsync(string accessToken)
{
try
{
await AuthenticationService.Instance.SignInWithFacebookAsync(accessToken);
Debug.Log("SignIn is successful.");
}
catch (AuthenticationException ex)
{
// Compare error code to AuthenticationErrorCodes
// Notify the player with the proper error message
Debug.LogException(ex);
}
catch (RequestFailedException ex)
{
// Compare error code to CommonErrorCodes
// Notify the player with the proper error message
Debug.LogException(ex);
}
}Facebook サインイン認証を実装する
プレイヤーが Facebook サインインをトリガーしてサインインするか新しいプレイヤーを作成する場合、Facebook アクセストークンを受け取ったら、以下の API を呼び出してプレイヤーをサインインします: SignInWithFacebookAsync(string accessToken)。
Facebook アカウントをリンク解除する
UnlinkFacebookAsync API を使用して、プレイヤーが自身の Facebook アカウントをリンク解除できるようにします。リンク解除後、そのアカウントが他のどの ID にもリンクされていない場合、そのアカウントは匿名アカウントに遷移します。
async Task UnlinkFacebookAsync(string idToken)
{
try
{
await AuthenticationService.Instance.UnlinkFacebookAsync(idToken);
Debug.Log("Unlink is successful.");
}
catch (AuthenticationException ex)
{
// Compare error code to AuthenticationErrorCodes
// Notify the player with the proper error message
Debug.LogException(ex);
}
catch (RequestFailedException ex)
{
// Compare error code to CommonErrorCodes
// Notify the player with the proper error message
Debug.LogException(ex);
}
}