Erste Schritte mit der Android-Referenz-App

Die Android-Referenz-App demonstriert, wie moderne, skalierbare Meeting-Erlebnisse mit der Vonage Video API auf Android-Geräten aufgebaut werden können. Es handelt sich dabei um ein vollständig quelloffenes Projekt, das die empfohlene Architektur, die Konfigurationssysteme und die Benutzeroberflächenmuster für die Bereitstellung hochwertiger Videoanrufe mit mehreren Teilnehmern vorstellt.

Vonage

Was es beinhaltet

Die Android-Referenz-App bietet:

  • Ein kompletter Sitzungsablauf (Landing Page → Warteraum → Sitzungsraum → Post-Call-Bildschirm)
  • Unterstützung für bis zu 25 Teilnehmer
  • Ein Warteraum für die Gerätevorschau und die Eingabe des Anzeigenamens
  • Eine Post-Call-Seite mit Navigationsoptionen und Archivsichtbarkeit
  • Konfigurierbare Funktionen und UI-Thematisierung über JSON-Dateien
  • Eine modulare Codebasis zur Erweiterung oder Wiederverwendung von Komponenten
  • Auf die Produktion abgestimmte Integrationsmuster für die Vonage Video API

Architektur

Die Android Reference App ist in eine Reihe klar definierter Module gegliedert:

  • app - Hauptanwendungsmodul, das Bildschirme und Navigation mit Jetpack Compose zusammenstellt
  • kotlin - Kerngeschäftslogik, Vonage Video SDK-Integration, Domänenmodelle und optionale Funktionsplugins
  • verfassen. - Wiederverwendbare UI-Komponenten und Material Design 3 Thematisierung
  • vonage-feature-chat - Optionale In-Meeting-Chat-Funktion
  • build-tools - Benutzerdefinierte Gradle-Plugins zum Lesen von Konfigurationsdateien und zur Erzeugung von Build-Time-Ressourcen

Die Anwendung stützt sich auf ein leichtgewichtiges Backend (das im React-Referenzanwendungs-Repository bereitgestellt wird), um die Sitzungs-IDs und Token für den Beitritt zu Videoräumen. Die Backend-URL wird über die App-Konfiguration bereitgestellt.

Hauptmerkmale

Das in der Android-Referenz-App demonstrierte Meeting-Erlebnis umfasst:

  • Aktive Lautsprechererkennung
  • Adaptive Layoutseinschließlich Aktivlautsprecher- und Rasteransicht
  • Dynamische Kachelverwaltung die auf Beitritts-/Austrittsereignisse reagiert und Bandbreite spart
  • Teilnehmerliste mit Audio-Stummschaltungsanzeigen
  • Bildschirmfreigabe
  • Dienst im Vordergrund Unterstützung der Aufrechterhaltung von Anrufen, während die Anwendung im Hintergrund läuft
  • Optionaler Chat (durch Konfiguration aktiviert)
  • Warteraum mit Audio-/Videovorschau
  • Bildschirm nach dem Anruf mit Archivsichtbarkeit

Diese Funktionen folgen empfohlenen Praktiken für Leistung, UX und Skalierbarkeit auf Android-Geräten.

Personalisierung

Die Android Reference App kann ohne Änderung des Quellcodes angepasst werden. Die Konfiguration erfolgt über JSON-Dateien in der config Ordner.

Konfiguration der Merkmale

Funktionskennzeichen und Anwendungseinstellungen werden in definiert:

  • app-config.json - Funktionskennzeichen und Anwendungseinstellungen.
  • theme.json - Konfiguration des UI-Themas.

Ein benutzerdefiniertes Gradle-Plugin (JsonConfigPlugin) liest diese Konfigurationsdateien zur Build-Zeit und generiert die notwendige Build-Konfiguration.
Die app-config.json Datei können Sie Funktionskennzeichen wie z. B.:

  • Chat
  • Untertitel
  • Bildschirmfreigabe
  • Hintergrund Unschärfe

Einige Funktionen verwenden Produktvarianten (z. B. das Chat-Modul mit aktivierten und deaktivierten Varianten).

Eine vollständige Beschreibung des Konfigurationssystems finden Sie unter docs/CONFIG-SYSTEM.md im Repository.

Thema und UI-Anpassung

Sie können die Farben der App anpassen, indem Sie die config/theme.json Datei mit den gewünschten Werten für das Farbschema.
Die ThemeGeneratorPlugin Das Gradle-Plugin erzeugt die Ressourcen des Themas in der Datei compose Modul zur Erstellungszeit.

Vonage

Nächste Schritte

Um die Android Reference App einzurichten, zu konfigurieren und auszuführen, folgen Sie den Installationsanweisungen im README des Repositorys: