Get started
Follow this workflow to create a Unity account, link your project, and install the SDK to get started with Unity Authentication.
Read time 1 minuteLast updated 3 months ago
To use Authentication, you need to:
- Create a Unity account if you don't already have one.
- Link your Unity Editor project to a Unity cloud project.
- Install the SDK in your game code.
- Initialize the SDK.
Install the SDK
To install the latest Authentication package for Unity:- In the Unity Editor, open Window > Package Manager.
- In the Package Manager, select the Unity Registry list view.
- Search for Authentication, or locate it in the package list.
- Select the package, then select Install.
Initialize the Unity Services SDK
To implement Unity Authentication in your game, initialize all the Unity Services SDKs included in the project following this code snippet:using System;using Unity.Services.Core;using UnityEngine;public class InitializationExample : MonoBehaviour{ async void Awake() { try { await UnityServices.InitializeAsync(); } catch (Exception e) { Debug.LogException(e); } }}
Register authentication events
To receive updates about the status of your player, register a function to theSignedInSignInFailedSignedOut// Setup authentication event handlers if desiredvoid SetupEvents() { AuthenticationService.Instance.SignedIn += () => { // Shows how to get a playerID Debug.Log($"PlayerID: {AuthenticationService.Instance.PlayerId}"); // Shows how to get an access token Debug.Log($"Access Token: {AuthenticationService.Instance.AccessToken}"); }; AuthenticationService.Instance.SignInFailed += (err) => { Debug.LogError(err); }; AuthenticationService.Instance.SignedOut += () => { Debug.Log("Player signed out."); }; AuthenticationService.Instance.Expired += () => { Debug.Log("Player session could not be refreshed and expired."); };}