Steam

最小 SDK バージョン: 2.0.0

• Steam アカウントサインインを設定する。
• 戻ってきたプレイヤーをサインインする、または新しいプレイヤーを作成する。
• 匿名ログインから Steam アカウントを介したプラットフォームログインへとプレイヤーを更新する。

Steam アカウントサインインの設定

1. アプリケーションを作成し、Steamworks のドキュメント に従ってアプリケーション ID をメモします。
2. ウェブ API キーを使用した認証 のドキュメントに従って、パブリッシャーウェブ API キーを作成します。
3. Unity 用に SDK をインストールするための手順 に従って、SteamWorks.Net SDK をインストールします。
   1. SteamWorks.Net SDK をプロジェクトの Assets/ フォルダーにコピーします。
   2. Unity プロジェクトのルートにある steam_appid.txt ファイルを開き、480 を自分のアプリケーション ID に置き換えます。
   3. シーン内のゲームオブジェクトに Steam Manager ゲームコンポーネントを追加します。これにより、Steam ライブラリが初期化されます。
   4. テストを行う前に、Steam がインストールされ、サインインされていることを確認してください。Steam ユーザーのライブラリには、開発中のゲームが表示されます。
4. Unity Authentication について、ID プロバイダーを Steam に設定します。
   1. Unity エディターメニューで、Edit (編集) > Project Settings... (プロジェクト設定...) を選択し、ナビゲーションメニューから Services (サービス) > Authentication を選択します。
   2. ID Providers (ID プロバイダー) を Steam に設定し、Add (追加) を選択します。
   3. App ID テキストフィールドにアプリケーション ID を入力します。
   4. Key テキストフィールドにパブリッシャーウェブ API キーを入力し、Save (保存) を選択します。
   注

   (任意) Demo、PlayTest、Alpha ビルド用の App ID を追加します。まだ Authentication Settings (認証設定) 内です。

   1. Additional App ID (追加の App ID) の横にある矢印を選択します。
   2. 展開されたビューの下部にある Add App ID (App ID を追加) を選択します。
   3. App ID と Description (説明) を入力します。
   4. Save (保存) を選択します。
5. 以下のサンプルコードを使用して Steam サインインを実装します。GetAuthTicketForWebApi のドキュメントを参照してください。Unity Authentication SDK は Steam セッションチケットのみを受け入れます。暗号化されたアプリケーションチケットは受け入れられません。

Callback<GetTicketForWebApiResponse_t> m_AuthTicketForWebApiResponseCallback;string m_SessionTicket;string identity = "unityauthenticationservice"void SignInWithSteam(){    // It's not necessary to add event handlers if they are     // already hooked up.    // Callback.Create return value must be assigned to a     // member variable to prevent the GC from cleaning it up.    // Create the callback to receive events when the session ticket    // is ready to use in the web API.    // See GetAuthSessionTicket document for details.    m_AuthTicketForWebApiResponseCallback = Callback<GetTicketForWebApiResponse_t>.Create(OnAuthCallback);    SteamUser.GetAuthTicketForWebApi(identity);}void OnAuthCallback(GetTicketForWebApiResponse_t callback){    m_SessionTicket = BitConverter.ToString(callback.m_rgubTicket).Replace("-", string.Empty);    m_AuthTicketForWebApiResponseCallback.Dispose();    m_AuthTicketForWebApiResponseCallback = null;    Debug.Log("Steam Login success. Session Ticket: " + m_SessionTicket);    // Call Unity Authentication SDK to sign in or link with Steam, displayed in the following examples, using the same identity string and the m_SessionTicket.}

GetAuthTicketForWebApi

identity

戻ってきたプレイヤーのサインインまたは新しいプレイヤーの作成

SignInWithSteamAsync

• Steam の認証情報を使用して新しい Unity Authentication プレイヤーを作成する。
• Steam の認証情報を使用して既存のプレイヤーをサインインする。

SignInWithSteamAsync

SignInWithSteamAsync

SignInWithSteamAsync

async Task SignInWithSteamAsync(string ticket, string identity){    try    {        await AuthenticationService.Instance.SignInWithSteamAsync(ticket, identity);        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);    }}

プレイヤーを匿名から Steam アカウントへと更新する

1. SignInAnonymouslyAsync

   を使用して、キャッシュされたプレイヤーのアカウントにサインインします。

2. LinkWithSteamAsync

   を使用して、キャッシュされたプレイヤーのアカウントを Steam アカウントにリンクします。

async Task LinkWithSteamAsync(string ticket, string identity){    try    {        await AuthenticationService.Instance.LinkWithSteamAsync(ticket, identity);        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 (Exception ex)    {        Debug.LogError("Link failed.");        Debug.LogException(ex);    }}

async Task SignInWithSteamAsync(string ticket, string identity){    try    {        await AuthenticationService.Instance.SignInWithSteamAsync(ticket, identity);    }    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);    }}

戻ってきたプレイヤーをサインインするか、追加の App ID 用に新しいプレイヤーを作成する

SignInWithSteamAsync

GetAuthTicketForWebApi

identity

async Task SignInWithSteamAsync(string ticket, string identity, string appId){    try    {        await AuthenticationService.Instance.SignInWithSteamAsync(ticket, identity, appId);        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);    }}

Steam サインイン認証を実装する

SignInWithSteamAsync(string ticket, string identity)

Unlink Steam account#Use the `UnlinkSteamAsync` API so your players can unlink their Steam account. Once unlinked, if their account isn’t linked to any additional identity, it transitions to an anonymous account.async Task UnlinkSteamAsync(string idToken){   try   {       await AuthenticationService.Instance.UnlinkSteamAsync(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);   }}