Inicio rapido

Integra SouthGames en tu app Flutter en 5 minutos.

1. Crea tu cuenta

Registrate en southgames.ai y crea tu organizacion. Obtendras un slug (ej: mi-empresa) y podras generar API keys desde la consola.

2. Instala el SDK

Agrega southgames_flutter a tu pubspec.yaml:

dependencies:
  southgames_flutter: ^0.6.0

flutter pub get

3. Inicializa el SDK

En tu main(), antes de runApp():

import 'package:southgames_flutter/southgames_flutter.dart';

void main() {
  WidgetsFlutterBinding.ensureInitialized();

  SouthGamesSDK.init(
    apiKey: 'sg_live_xxxxxxxxxxxxxxxx',
    orgId: 'mi-empresa',
  );

  runApp(const MyApp());
}

4. Identifica al usuario

Llama a identify() cuando conozcas la identidad del usuario:

final res = await SouthGamesSDK.identify(
  externalId: 'user_123',
  email: 'usuario@app.com',
);
print('Client ID: ${res.clientId}');

5. Muestra campanas y juega

// Listar campanas activas
final campaigns = await SouthGamesSDK.getCampaigns();

// Jugar
final play = await SouthGamesSDK.play(
  campaignId: campaigns.first.id,
  externalUserId: 'user_123',
);

if (play.won && play.prizeCode != null) {
  print('Ganaste! Codigo: ${play.prizeCode}');
}

Siguiente paso

Revisa la autenticacion para entender como funcionan las API keys, o ve directo a la referencia del Flutter SDK.