Démarrer avec l'application de référence Android
L'application de référence Android montre comment créer des expériences de réunion modernes et évolutives à l'aide de l'In-App Video de Vonage sur les appareils Android. Il s'agit d'un projet entièrement libre qui présente l'architecture recommandée, les systèmes de configuration et les modèles d'interface utilisateur pour offrir des appels vidéo multipartites de haute qualité.
Ce qu'il comprend
L'application de référence Android fournit
- Un flux de réunion complet (page d'accueil → salle d'attente → salle de réunion → écran post-appel)
- Prise en charge de jusqu'à 25 participants
- Une salle d'attente pour la prévisualisation de l'appareil et la saisie du nom d'affichage
- Une page après l'appel avec des options de navigation et une visibilité des archives
- Fonctionnalités configurables et thématisation de l'interface utilisateur par le biais de fichiers JSON
- Une base de code modulaire pour l'extension ou la réutilisation des composants
- Modèles d'intégration alignés sur la production pour l'API Video de Vonage
Architecture
L'application de référence Android est organisée en un ensemble de modules clairement définis :
- application - Module d'application principal qui compose les écrans et la navigation à l'aide de Jetpack Compose.
- kotlin - Logique commerciale de base, intégration du SDK vidéo de Vonage, modèles de domaine et modules d'extension optionnels.
- composer - Composants réutilisables de l'interface utilisateur et thématique Material Design 3
- vonage-feature-chat - Fonction optionnelle de chat en réunion
- outils de construction - Plugins Gradle personnalisés pour la lecture des fichiers de configuration et la génération de ressources au moment de la construction
L'application s'appuie sur un backend léger (fourni dans le dépôt de l'application de référence React) pour générer les données suivantes ID de session et jetons pour rejoindre des salles vidéo. L'URL du backend est fournie par la configuration de l'application.
Principales caractéristiques
L'expérience de réunion démontrée dans l'application de référence Android comprend
- Détection active du haut-parleur
- Modèles adaptatifsy compris les vues de haut-parleurs actifs et de grilles
- Gestion dynamique des tuiles qui réagit aux événements d'entrée et de sortie et conserve la bande passante
- Liste des participants avec indicateurs de coupure du son
- Partage d'écran
- Service de première ligne possibilité de maintenir les appels actifs lorsque l'application est en arrière-plan
- Chat facultatif (activée par la configuration)
- Salle d'attente avec prévisualisation audio/vidéo
- Écran après appel avec visibilité des archives
Ces fonctionnalités respectent les pratiques recommandées en matière de performances, d'interface utilisateur et d'évolutivité sur les appareils Android.
Personnalisation
L'application de référence Android peut être personnalisée sans modifier le code source. La configuration est gérée par des fichiers JSON dans le répertoire config dossier.
Configuration des fonctionnalités
Les indicateurs de fonctionnalité et les paramètres d'application sont définis dans :
app-config.json- Les drapeaux de caractéristiques et les paramètres de l'application.theme.json- Configuration du thème de l'interface utilisateur.
Un plugin Gradle personnalisé (JsonConfigPlugin) lit ces fichiers de configuration au moment de la construction et génère la configuration de construction nécessaire.
Les app-config.json vous permet de configurer des indicateurs de fonctionnalité tels que
- Chat
- Légendes
- Partage d'écran
- Flou d'arrière-plan
Certaines fonctionnalités utilisent des variantes de produits (par exemple, le module de chat avec des variantes activées et désactivées).
Pour une description complète du système de configuration, voir docs/CONFIG-SYSTEM.md dans le référentiel.
Personnalisation du thème et de l'interface utilisateur
Vous pouvez personnaliser les couleurs de l'application en modifiant le fichier config/theme.json avec les valeurs de la palette de couleurs souhaitées.
Les ThemeGeneratorPlugin Le plugin Gradle génère les ressources du thème dans le fichier compose au moment de la construction.
Prochaines étapes
Pour installer, configurer et exécuter l'application de référence Android, suivez les instructions d'installation fournies dans le README du référentiel :