Aller au contenu principal

Référence API Flutter

Référence de l’API du SDK Azeoo pour Flutter. Le flux recommandé est AzeooSDK.initialize(apiKey, options: ...) puis AzeooSDK.connect(token: ..., gender: ..., height: Height(...), weight: Weight(...)) ; voir Flutter Quick Start et SDK API.

AzeooSDK (static)​

  • initialize(apiKey, {options}) — Initialise une seule fois ; options est un AzeooSDKInitOptions optionnel (locale, theme, deepLinks, safeArea, analyticsEnabled, offlineSupport, connector).
  • connect({token, gender, height, weight}) — Attache l’utilisateur ; requis avant d’utiliser les modules UI. Note : height est un Height, weight est un Weight.
  • disconnect() — Déconnecte l’utilisateur.
  • isInitialized, isConnected, userId, user, config, container — Statut et accès à la session/configuration.
  • AzeooSDKModules.nutrition, AzeooSDKModules.training — Modules UI Flutter (navigation/écrans).
  • changePrimaryColor, setCustomThemes, getCurrentThemeMode, setLightMode/setDarkMode/setSystemMode/toggleThemeMode — Aides pour le thème.

Table des matières​

Properties​

  • apiKey: String - Clé API utilisée pour l’initialisation
  • isInitialized: bool (static) - Indique si le client est initialisé
  • tokenManager: TokenManager - Accès au gestionnaire de jetons
  • analytics: AnalyticsService - Accès au service d’analytics

Methods​

validateApiKey​

Future<bool> validateApiKey()

Valide la clé API auprès du serveur.

Retour : Future<bool> - true si valide, sinon false

getSubscriptions​

List<String> getSubscriptions()

Récupère la liste des abonnements actifs.

Retour : List<String> - Liste des identifiants d’abonnement

AzeooUser​

Gestion utilisateur et opérations de profil.

Initialization​

AzeooUser({required AzeooClient client, required String userId})

Crée une nouvelle instance de AzeooUser.

Paramètres :

  • client (AzeooClient) : Instance AzeooClient initialisée
  • userId (String) : Identifiant unique de l’utilisateur

Methods​

logout​

static Future<void> logout()

Déconnecte l’utilisateur courant et efface les données spécifiques à l’utilisateur.

changeHeight​

Future<void> changeHeight(double height)

Met à jour la taille de l’utilisateur.

Paramètres :

  • height (double) : Taille en centimètres

changeWeight​

Future<void> changeWeight(double weight)

Met à jour le poids de l’utilisateur.

Paramètres :

  • weight (double) : Poids en kilogrammes

getProfile​

Future<UserProfile> getProfile()

Récupère les informations de profil de l’utilisateur.

Retour : Future<UserProfile> - Le profil de l’utilisateur

getToken​

Future<String> getToken()

Récupère le jeton d’authentification courant.

Retour : Future<String> - Le jeton d’authentification

update​

Future<void> update(Map<String, dynamic> data)

Met à jour les informations utilisateur.

Paramètres :

  • data (Map<String, dynamic>) : Données utilisateur à mettre à jour

delete​

Future<void> delete()

Supprime le compte utilisateur.

AzeooUI​

Composants UI et gestion de navigation.

Initialization​

static Future<void> initialize({
  required AzeooClient client,
  required AzeooUIConfig config,
  ProviderContainer? container,
})

Initialise le SDK UI.

Paramètres :

  • client (AzeooClient) : Instance AzeooClient initialisée
  • config (AzeooUIConfig) : Configuration UI
  • container (ProviderContainer?, optionnel) : Container provider optionnel

Instance Access​

static AzeooUI get instance

Récupère l’instance singleton.

Properties​

  • nutrition: NutritionModule - Accès au module nutrition
  • config: AzeooUIConfig - Configuration courante

Theme Methods​

changePrimaryColor​

void changePrimaryColor(Color newColor)

Change la couleur principale pour les thèmes clair et sombre.

setLightMode​

void setLightMode()

Passe le thème en mode clair.

setDarkMode​

void setDarkMode()

Passe le thème en mode sombre.

setSystemMode​

void setSystemMode()

Suit le thème système.

toggleThemeMode​

Future<void> toggleThemeMode()

Bascule entre les modes clair et sombre.

Reset​

static Future<void> reset()

Réinitialise le SDK en effaçant les données spécifiques à l’utilisateur.

Nutrition Module​

Accès via AzeooSDKModules.nutrition.

Methods​

showMainScreen​

void showMainScreen({bool? bottomSafeArea})

Affiche l’écran principal de nutrition.

showNutritionPlans​

void showNutritionPlans()

Affiche l’écran des plans nutrition.

showNutritionPlan​

void showNutritionPlan(String planId)

Affiche un plan nutrition spécifique.

showUserNutritionPlan​

void showUserNutritionPlan()

Affiche le plan nutrition de l’utilisateur.

showRecipes​

void showRecipes()

Affiche l’écran des recettes.

showRecipe​

void showRecipe(int recipeId, {String? recipeName})

Affiche une recette spécifique.

showBarcodeScanner​

void showBarcodeScanner()

Affiche le scanner de code‑barres.

showMobileScanner​

void showMobileScanner()

Affiche le scanner mobile.

showCart​

void showCart()

Affiche le panier.

showNutritionSearch​

void showNutritionSearch()

Affiche l’écran de recherche nutrition.

showAddSelection​

void showAddSelection()

Affiche l’écran d’ajout de sélection.

showAddFood​

void showAddFood()

Affiche l’écran d’ajout d’aliment.

showAddMeal​

void showAddMeal()

Affiche l’écran d’ajout de repas.

Configuration Types​

AzeooUIConfig​

Configuration UI principale.

AzeooUIConfig({
  required String userId,
  required String authToken,
  String? locale,
  required bool analyticsEnabled,
  required bool offlineSupport,
  required SafeAreaConfig safeArea,
  ThemeConfig? theme,
  DeepLinkConfig? deepLinkConfig,
})

ThemeConfig​

Configuration du thème.

ThemeConfig({
  Color? lightPrimaryColor,
  Color? lightSecondaryColor,
  Color? lightTertiaryColor,
  Color? lightBackgroundColor,
  Color? darkPrimaryColor,
  Color? darkSecondaryColor,
  Color? darkTertiaryColor,
  Color? darkBackgroundColor,
  Color? success,
  Color? error,
  Color? warning,
})

SafeAreaConfig​

Configuration de la safe area.

SafeAreaConfig({
  bool top = true,
  bool bottom = true,
  bool left = true,
  bool right = true,
})

DeepLinkConfig​

Configuration des deep links.

DeepLinkConfig({
  String? scheme,
  String? host,
  String? removePathPrefix,
})

Error Handling​

SDKInitializationException​

Levé lorsque l’initialisation du SDK échoue.

try {
  await AzeooSDK.initialize(
    'your-sdk-api-key',
    options: AzeooSDKInitOptions(),
  );
} on SDKInitializationException catch (e) {
  print('Échec de l’initialisation : ${e.message}');
}

Pour aller plus loin​