Migration ZegoCloud → Agora

1. Contexte de la migration

1.1 Problèmes avec ZegoCloud

• Impossible de créer des groupes côté serveur avec un ID auto-généré
• L'API serveur nécessitait un GroupId personnalisé (consulting1195) tandis que le SDK mobile générait des IDs différents (#AbWyGIH9S)
• Synchronisation iOS/Android impossible : chaque plateforme créait son propre groupe
• L'API UserRegister retournait des erreurs de format (code 660000002)
• saveGroupId devait être appelé depuis le mobile pour synchroniser

1.2 Avantages d'Agora

• L'API REST Agora auto-génère les group_id côté serveur
• Laravel est la source unique de vérité : création du groupe + stockage du group_id
• Le mobile ne crée plus de groupes — il rejoint uniquement
• UIKit pré-construit (EaseUIKit) avec interface complète de chat
• Système de tokens unifié pour Chat et RTC
• saveGroupId depuis le mobile n'est plus nécessaire

2. Nouvelle architecture

2.1 Concepts clés

2.2 Flux — Consultation programmée (scheduled)

2.3 Flux — Consultation immédiate (immediate)

3. Endpoints API

3.1 POST agora/chat-token

Authentification : Bearer Token (Sanctum)
Entrées : Aucune — l'utilisateur est déduit de l'authentification.
Utilisation : Appelé par le mobile avant d'ouvrir l'écran de chat. Le token retourné est passé à AgoraChatHelper.login().

Réponse :

{
  "status": true,
  "message": "success",
  "data": {
    "token": "007eJxTYOhdrv0y6GdG0CVlX6WC...",
    "username": "u346"
  },
  "errors": []
}

3.2 POST agora/rtc-token

Authentification : Bearer Token (Sanctum)

Paramètres d'entrée :

Réponse :

{
  "status": true,
  "message": "success",
  "data": {
    "token": "007eJxTYMg66/4v/P6ZxBwPRd3I...",
    "channel_name": "consulting1380",
    "uid": 0,
    "app_id": "cdc6c95ed75d45cda0a45ee86a4c6c64"
  },
  "errors": []
}

4. Connexion Agora Chat — AgoraChatHelper

La classe AgoraChatHelper gère toute la logique de connexion à Agora Chat. Elle remplace ZIMKit.connectUser().

4.1 Méthode principale : login(userId, token, callback)

Code complet :

// 1. Sanitize
String username = sanitizeUsername(userId); // "346" → "u346"

// 2. Autre utilisateur connecté ? → logout d'abord
if (isLoggedIn && currentUser != username) {
    ChatClient.logout() → then doLogin(username, token);
    return;
}

// 3. Même utilisateur ET connecté ? → succès immédiat
if (isLoggedIn && currentUser == username && isConnected()) {
    callback.onSuccess();
    return;
}

// 4. Login réel
ChatClient.loginWithAgoraToken(username, token, callback);

// 5. Si erreur 218 → force logout + retry une fois

4.2 Fonction sanitizeUsername()

4.3 Quand le login est appelé

5. Flux complet du Chat — AgoraChatActivity

5.1 Ouverture de l'écran

Quand l'utilisateur (patient ou médecin) appuie sur le bouton "Entrer dans la session" :

5.2 setConsulting() — Callback du backend

Cette méthode est appelée automatiquement par le CallPresenter quand la réponse de getConsulting() arrive :

@Override
public void setConsulting(Consulting cons) {
    // cons contient les données fraîches de la consultation
    // y compris group_id créé par Laravel

    if (cons.getGroup_id() != null && !cons.getGroup_id().trim().isEmpty()) {
        // ✅ group_id existe → le sauvegarder localement
        this.groupId = cons.getGroup_id();
        isGroupIdReady = true;
        tryOpenChat(); // Tente d'ouvrir le chat
    } else {
        // ❌ Pas de group_id → le backend n'a pas encore créé le groupe
        // Cas possible : consultation immédiate, médecin pas encore assigné
        Toast.makeText(this, "المحادثة غير جاهزة", Toast.LENGTH_SHORT).show();
    }
}

5.3 showChatFragment() — Affichage du UIKit

private void showChatFragment(String groupId) {
    EaseChatFragment fragment = new EaseChatFragment.Builder(
            groupId,                              // "315697874927617"
            EaseChatType.GROUP_CHAT               // Type : groupe (pas 1-to-1)
    )
    .useHeader(false)                         // On utilise notre propre toolbar
    .build();

    getSupportFragmentManager()
        .beginTransaction()
        .replace(R.id.fra_message, fragment)   // FrameLayout dans le layout XML
        .commit();
}

Le EaseChatFragment fournit automatiquement :

• Liste des messages (texte, images, fichiers, audio)
• Barre de saisie avec emoji, envoi de fichiers, prise de photo
• Statut de livraison des messages
• Défilement automatique
• Support RTL (arabe)

5.4 Layout XML

<!-- Votre toolbar personnalisée (nom, avatar, boutons appel) -->
<Toolbar android:id="@+id/chatToolbar" ... />

<!-- Le UIKit fragment remplit tout l'espace restant -->
<FrameLayout
    android:id="@+id/fra_message"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

<!-- Plus besoin de RecyclerView, EditText, ou bouton Send -->
<!-- Le EaseChatFragment fournit tout ça automatiquement -->

6. Flux des appels Vidéo/Audio

6.1 Démarrage d'un appel

6.2 Mode audio vs vidéo

7. Modifications Backend Laravel

7.1 Configuration .env

AGORA_APP_ID=cdc6c95ed75d45cda0a45ee86a4c6c64
AGORA_APP_CERTIFICATE=votre_certificat
AGORA_CHAT_ORG_NAME=41200031602
AGORA_CHAT_APP_NAME=200043726
AGORA_CHAT_DOMAIN=a41.chat.agora.io

7.2 AgoraChatService.php

7.3 Où createGroupAgora() est appelé

7.4 Dépendance

composer require boogiefromzk/agora-token

7.5 Fichiers supprimés

8. Modifications Android

8.1 Dépendances Gradle

8.2 Nouveaux fichiers

8.3 Fichiers modifiés

8.4 Fichiers supprimés

9. Modifications iOS

9.1 Dépendances

# Podfile
pod 'AgoraChat', '~> 1.3.0'
pod 'AgoraChat_iOS', '~> 1.3.0'    # UIKit
pod 'AgoraRtcEngine_iOS', '~> 4.3.0'

9.2 Changements principaux

• Supprimer ZIMKit.createGroup() de partout
• Supprimer l'appel à saveGroupId depuis le mobile
• Ajouter appel API POST /api/agora/chat-token avant le login
• Ajouter appel API POST /api/agora/rtc-token avant les appels
• Se connecter avec AgoraChatClient.shared.login(username, agoraToken)
• Ouvrir la conversation avec le group_id reçu du backend
• Pour les appels, utiliser AgoraRtcEngineKit avec le token du backend

10. Identifiants Agora

11. Résumé comparatif