SDK Overview

The Virtual Stadium Data SDK provides a comprehensive suite of services for integrating chat, betting, and social features into your Android and iOS applications. Built on Kotlin Multiplatform, the SDK delivers a consistent API across both platforms while leveraging native capabilities.

#What Is the Data SDK?

The Data SDK is the foundation for building custom Virtual Stadium experiences in your mobile applications. It provides direct access to:

• Chat Functionality - Real-time messaging with reactions and replies
• Bet Sharing - Share and copy bets within chat channels
• User Management - Authentication, profiles, and user state tracking
• Match Insights - Real-time betting data and match statistics
• Settings & Configuration - Customizable chat settings and odds formatting

The SDK handles all backend communication, state management, and data synchronization, allowing you to focus on building your user interface.

#SDK Architecture

The Virtual Stadium Data SDK uses Koin for dependency injection and provides a suite of specialized services:

• LoginManager - Handles JWT-based authentication and session management
• UserProvider - Tracks current user state including bans, timeouts, and permissions
• ChatManager - Manages chat channel lifecycle and organization
• ChatChannel - Provides messaging, reactions, and bet sharing for individual channels
• SettingsProvider - Delivers channel settings like message limits and reaction types
• OddsFormatProvider - Handles odds formatting (US, EU, UK)
• ProfileProvider - Manages user profile data and avatar URLs

All services expose reactive state flows that update automatically as data changes, enabling responsive UI development.

#How the SDK Works

The SDK follows a clear initialization and usage pattern:

1. Initialize the SDK - Set up the SDK in your application
2. Authenticate - Log in with a JWT token using LoginManager
3. Create Channels - Initialize chat channels with ChatManager
4. Observe States - Subscribe to state flows for real-time updates
5. Perform Actions - Send messages, share bets, react to content

This architecture ensures efficient resource usage and provides a predictable development experience.

#Next Steps

Ready to integrate the Virtual Stadium Data SDK? Follow these guides to get started: