ユーザー認証

Sequence インフラスタックを用いた web3 ゲーム向け Unreal SDK API のセッション管理に関するドキュメントです。

​

必要環境

• 必要なログイン方法を Sequence Builder で有効にしていることを確認してください。
• プラットフォーム要件 ページで、選択した認証方法がUnrealプロジェクトで正しく設定されているかの詳細をご確認ください。

​

メールログインの開始

任意のメールアドレスでユーザーをサインインさせると、ワンタイムパスワードが受信箱に届きます。 Email Requires Code イベントをリッスンしてください。

ブループリント

C++

const TFunction<void()> OnApiSuccess = [] { };
const FFailureCallback OnApiFailure = [](const FSequenceError& Error) { };

USequenceSessions* Sessions = NewObject<USequenceSessions>();
Sessions->StartEmailLogin(Email, OnApiSuccess, OnApiFailure);

​

メールログインのコード確認

任意のメールアドレスでユーザーをサインインさせると、ワンタイムパスワードが受信箱に届きます。 Email Requires Code イベントをリッスンしてください。

ブループリント

C++

const FString Code = "123456";

const TFunction<void()> OnApiSuccess = [] { };
const FFailureCallback OnApiFailure = [](const FSequenceError& Error) { };
const TFunction<void(FFederationSupportData)> OnApiFederationRequired = [this](const FFederationSupportData& FederationData) { };

USequenceSessions* Sessions = NewObject<USequenceSessions>();
Sessions->ConfirmEmailLoginWithCode(Code, OnApiSuccess, OnApiFailure, OnApiFederationRequired);

​

ゲストとしてサインイン

ゲストとしてユーザーをサインインさせることができます。ただし、アプリをアンインストールまたはサインアウトするとウォレットへのアクセスが失われます。 ウォレットへのアクセスを維持するために、アカウント連携機能を活用して、他のメールやソーシャルアカウントとウォレットを連携しましょう。

ブループリント

C++

const TFunction<void()> OnApiSuccess = [] { };
const FFailureCallback OnApiFailure = [](const FSequenceError& Error) { };

USequenceSessions* Sessions = NewObject<USequenceSessions>();
Sessions->StartGuestSession(OnApiSuccess, OnApiFailure);

​

ソーシャルサインイン

デスクトップで SSO 認証を開始するには、必要な id_token を取得するためにブラウザへ遷移する必要があります。 モバイルでは、統合プラグインを使って SDK がこの処理を自動で行います。

デスクトッププラットフォームでは、Sign in Web View Required イベントをリッスンし、返された Sign In URL を開いてください。 モバイルプラットフォームでは、Id Token Received イベントをリッスンしてください。

Sign In 関数を呼び出したら、SequenceSessionsBP サブシステムで Session Established イベントをリッスンし、サインインが成功したか確認します。問題が発生した場合は Session Creation Failure をリッスンしてください。

​

Google Id トークンを取得

ブループリント

C++

USequenceSessions* Sessions = NewObject<USequenceSessions>();
if (Sessions->IsBrowserRequired)
    const FString Url = this->Sessions->GetGoogleSignInUrl();
else
    Sessions->GetGoogleTokenId(this);

​

Apple Id トークンを取得

ブループリント

C++

USequenceSessions* Sessions = NewObject<USequenceSessions>();
if (Sessions->IsBrowserRequired)
    const FString Url = this->Sessions->GetAppleSignInUrl();
else
    Sessions->GetAppleTokenId(this);

​

Google でサインイン

有効なGoogle Idトークンでサインインします。Google Idトークンの取得方法ノードをご参照ください。

ブループリント

C++

const FString IdToken = "ey1234";

const TFunction<void()> OnApiSuccess = []() { };
const FFailureCallback OnApiFailure = [](const FSequenceError& Error) { };
const TFunction<void(FFederationSupportData)> OnApiFederationRequired = [](const FFederationSupportData& FederationData) { };

USequenceSessions* Sessions = NewObject<USequenceSessions>();
Sessions->StartOidcSession(IdToken, OnApiSuccess, OnApiFailure, OnApiFederationRequired);

​

Apple でサインイン

有効なApple Idトークンでサインインします。Apple Idトークンの取得方法ノードをご参照ください。

ブループリント

C++

const FString IdToken = "ey1234";

const TFunction<void()> OnApiSuccess = []() { };
const FFailureCallback OnApiFailure = [](const FSequenceError& Error) { };
const TFunction<void(FFederationSupportData)> OnApiFederationRequired = [](const FFederationSupportData& FederationData) { };

USequenceSessions* Sessions = NewObject<USequenceSessions>();
Sessions->StartOidcSession(IdToken, OnApiSuccess, OnApiFailure, OnApiFederationRequired);

​

Epic でサインイン

有効な Epic Games Id トークンでサインインします。Unreal 用 EOS プラグイン を参照してください。

ブループリント

C++

const FString IdToken = "ey1234";

const TFunction<void()> OnApiSuccess = []() { };
const FFailureCallback OnApiFailure = [](const FSequenceError& Error) { };
const TFunction<void(FFederationSupportData)> OnApiFederationRequired = [](const FFederationSupportData& FederationData) { };

USequenceSessions* Sessions = NewObject<USequenceSessions>();
Sessions->StartOidcSession(IdToken, OnApiSuccess, OnApiFailure, OnApiFederationRequired);

​

OIDC Id トークンでセッション開始

Google、Apple、Epic Games から取得した有効な Id トークンを使ってセッションを開始する場合にこの方法を利用します。

ブループリント

C++

const FString IdToken = "ey1234";

const TFunction<void()> OnApiSuccess = []() { };
const FFailureCallback OnApiFailure = [](const FSequenceError& Error) { };
const TFunction<void(FFederationSupportData)> OnApiFederationRequired = [](const FFederationSupportData& FederationData) { };

USequenceSessions* Sessions = NewObject<USequenceSessions>();
Sessions->StartOidcSession(IdToken, OnApiSuccess, OnApiFailure, OnApiFederationRequired);

​

PlayFab

設定時に SequenceConfig.ini ファイルへPlayFabタイトルIDを記載し、BuilderでPlayFabの設定も行ってください。

​

PlayFab登録

ブループリント

C++

const TFunction<void()> OnApiSuccess = [this, OnSuccess]() { };
const FFailureCallback OnApiFailure = [this, OnFailure](const FSequenceError& Error) { };
const TFunction<void (FFederationSupportData)> OnApiFederationRequired = [this](const FFederationSupportData& FederationData) { };

USequenceSessions* Sessions = NewObject<USequenceSessions>();
Sessions->PlayFabRegistration(UsernameIn, EmailIn, PasswordIn, OnApiSuccess, OnApiFailure, OnApiFederationRequired);

​

PlayFabログイン

ブループリント

C++

const TFunction<void()> OnApiSuccess = [this, OnSuccess]() { };
const FFailureCallback OnApiFailure = [this, OnFailure](const FSequenceError& Error) { };
const TFunction<void (FFederationSupportData)> OnApiFederationRequired = [this](const FFederationSupportData& FederationData) { };

USequenceSessions* Sessions = NewObject<USequenceSessions>();
Sessions->PlayFabLogin(UsernameIn, PasswordIn, OnApiSuccess, OnApiFailure, OnApiFederationRequired);

​

PlayFabセッションチケットによる認証

ブループリント

C++

const TFunction<void()> OnApiSuccess = [this, OnSuccess]() { };
const FFailureCallback OnApiFailure = [this, OnFailure](const FSequenceError& Error) { };
const TFunction<void (FFederationSupportData)> OnApiFederationRequired = [this](const FFederationSupportData& FederationData) { };

USequenceSessions* Sessions = NewObject<USequenceSessions>();
Sessions->PlayFabAuthenticateWithSessionTicket(SessionTicket, OnApiSuccess, OnApiFailure, OnApiFederationRequired);

​

アカウントフェデレーション

別のアカウントをウォレットに連携するには、同じ認証方法を再利用するだけです。 SDKは既存のセッションが保存されているかを確認し、自動的にそのアカウントとの連携を試みます。