GameService.Sdk.Auth 1.0.5

GameService Auth SDK

The Auth SDK handles user authentication, session management, and basic player profile operations (balance, daily rewards). It is the entry point for any application connecting to the GameService.

Installation

Include GameService.Sdk.Auth.dll and its dependencies in your project.

Usage

1. Initialize the Client

using GameService.Sdk.Auth;

var authClient = new AuthClient("http://localhost:5525");

2. Login or Register

Guest Login

Quickly create a temporary account.

var result = await authClient.GuestLoginAsync();
if (result.Success)
{
    Console.WriteLine($"Logged in as guest!");
    var session = result.Session;
}

Email/Password Login

var result = await authClient.LoginAsync("user@example.com", "password123");

Register

var result = await authClient.RegisterAsync("user@example.com", "password123");
if (result.Success)
{
    // Now login
}

3. Managing the Session

The LoginResult returns a GameSession object which manages your access tokens and provides access to authenticated features.

var session = result.Session;

// Check balance
var balance = await session.GetBalanceAsync();

// Get Profile
var profile = await session.GetProfileAsync();
Console.WriteLine($"User: {profile.UserName}, Coins: {profile.Coins}");

// Claim Daily Rewards
var claim = await session.ClaimDailyLoginAsync();
if (claim.Success)
{
    Console.WriteLine($"Claimed {claim.Reward} coins!");
}

4. Connecting to Game Server

The session provides a helper to connect to the real-time game hub.

var gameClient = await session.ConnectToGameAsync();

5. Token Refresh

The GameSession automatically handles token expiration and refreshing when you use its methods or ConnectToGameAsync.

Get Started with Unity

The Auth SDK handles user authentication and profile management.

Key Classes

• AuthClient: Authentication operations
• GameSession: User session with token management
• PlayerProfile: User profile data

Authentication Flow

using GameService.Sdk.Auth;

public class AuthManager : MonoBehaviour
{
    private AuthClient authClient;
    private GameSession session;
    
    private void Start()
    {
        authClient = new AuthClient("https://your-server.com");
    }
    
    // Guest login (no registration required)
    public async Task<bool> LoginAsGuest()
    {
        var result = await authClient.GuestLoginAsync();
        if (result.Success)
        {
            session = result.Session;
            Debug.Log("Guest login successful!");
            return true;
        }
        
        Debug.LogError($"Guest login failed: {result.Error}");
        return false;
    }
    
    // Email/password registration
    public async Task<bool> Register(string email, string password)
    {
        var result = await authClient.RegisterAsync(email, password);
        if (result.Success)
        {
            Debug.Log("Registration successful!");
            return await Login(email, password);
        }
        
        Debug.LogError($"Registration failed: {result.Error}");
        return false;
    }
    
    // Email/password login
    public async Task<bool> Login(string email, string password)
    {
        var result = await authClient.LoginAsync(email, password);
        if (result.Success)
        {
            session = result.Session;
            Debug.Log("Login successful!");
            return true;
        }
        
        Debug.LogError($"Login failed: {result.Error}");
        return false;
    }
    
    // Google OAuth login
    public async Task<bool> LoginWithGoogle(string idToken)
    {
        var result = await authClient.GoogleLoginAsync(idToken);
        if (result.Success)
        {
            session = result.Session;
            Debug.Log("Google login successful!");
            return true;
        }
        
        Debug.LogError($"Google login failed: {result.Error}");
        return false;
    }
}

Profile Management

// Get user profile
var profile = await session.GetProfileAsync();
if (profile != null)
{
    Debug.Log($"User: {profile.UserName}");
    Debug.Log($"Email: {profile.Email}");
    Debug.Log($"Coins: {profile.Coins}");
}

// Get coin balance
var balance = await session.GetBalanceAsync();
Debug.Log($"Balance: {balance} coins");

// Daily rewards
var loginReward = await session.ClaimDailyLoginAsync();
if (loginReward.Success)
{
    Debug.Log($"Daily login: +{loginReward.Reward} coins!");
    Debug.Log($"New balance: {loginReward.NewBalance}");
}

var spinReward = await session.ClaimDailySpinAsync();
if (spinReward.Success)
{
    Debug.Log($"Daily spin: +{spinReward.Reward} coins!");
}

// Transaction history
var history = await session.GetTransactionHistoryAsync(page: 1, pageSize: 20);
foreach (var transaction in history.Items)
{
    Debug.Log($"{transaction.CreatedAt}: {transaction.Amount} coins - {transaction.Description}");
}

Session to GameClient

// Connect to game hub using session
var gameClient = await session.ConnectToGameAsync();

// The session automatically handles token refresh
Debug.Log($"Connected with token: {session.AccessToken}");