Primeros pasos con la aplicación de referencia de Android
La aplicación de referencia de Android muestra cómo crear experiencias de reunión modernas y escalables utilizando la Video API de Vonage en dispositivos Android. Se trata de un proyecto totalmente de código abierto que presenta la arquitectura recomendada, los sistemas de configuración y los patrones de interfaz de usuario para ofrecer videollamadas multipartitas de alta calidad.

Qué incluye
La aplicación de referencia de Android proporciona:
- Un flujo de reuniones completo (página de aterrizaje → sala de espera → sala de reuniones → pantalla postconferencia).
- Admite hasta 25 participantes
- Una sala de espera para la vista previa del dispositivo y la introducción del nombre que se mostrará
- Una página posterior a la llamada con opciones de navegación y visibilidad del archivo
- Funciones configurables y tematización de la interfaz de usuario mediante archivos JSON
- Una base de código modular para ampliar o reutilizar componentes
- Patrones de integración adaptados a entornos de producción para la Video API de Vonage
Arquitectura
La aplicación de referencia de Android está organizada en un conjunto de módulos claramente definidos:
- aplicación - Módulo principal de la aplicación que compone pantallas y navegación utilizando Jetpack Compose
- Kotlin - Lógica empresarial básica, integración del SDK de Vonage Video, modelos de dominio y complementos de funciones opcionales
- componer - Componentes de interfaz de usuario reutilizables y tematización Material Design 3
- función-de-chat-de-Vonage - Chat opcional durante las reuniones
- herramientas de compilación - Plugins Gradle personalizados para leer archivos de configuración y generar recursos en tiempo de compilación
La aplicación se basa en un backend ligero (incluido en el repositorio de la aplicación de referencia de React) para generar ID de sesión y fichas para unirse a salas de vídeo. La URL del backend se proporciona a través de la configuración de la aplicación.
Características principales
La experiencia de reunión demostrada en la aplicación de referencia para Android incluye:
- Detección de altavoces activos
- Diseños adaptablesincluyendo las vistas de altavoz activo y rejilla
- Gestión dinámica de mosaicos que reacciona ante los eventos de conexión y desconexión y ahorra ancho de banda
- Lista de participantes con indicadores de silencio de audio
- Compartir pantalla
- Servicio de primer plano soporte para mantener las llamadas activas mientras la aplicación está en segundo plano
- Chat opcional (activado mediante configuración)
- Sala de espera con previsualizaciones de audio y vídeo
- Pantalla posterior a la llamada con visibilidad de archivo
Estas funciones siguen las prácticas recomendadas para el rendimiento, la experiencia del usuario y la escalabilidad en dispositivos Android.
Personalización
La aplicación de referencia de Android se puede personalizar sin modificar el código fuente. La configuración se gestiona mediante archivos JSON en el config carpeta.
Configuración de funciones
Los indicadores de funciones y la configuración de la aplicación se definen en:
app-config.json- Banderas de características y configuración de aplicaciones.theme.json- Configuración del tema de interfaz de usuario.
Un plugin personalizado de Gradle (JsonConfigPlugin) lee estos archivos de configuración en tiempo de compilación y genera la configuración de compilación necesaria.
El app-config.json le permite configurar opciones como:
- Chat
- Leyendas
- Compartir pantalla
- Desenfoque de fondo
Algunas funciones utilizan variantes del producto (por ejemplo, el módulo de chat con variantes activadas y desactivadas).
Para una descripción completa del sistema de configuración, consulte docs/CONFIG-SYSTEM.md en el repositorio.
Personalización del tema y de la interfaz de usuario
Puedes personalizar los colores de la aplicación editando el config/theme.json con los valores de combinación de colores que desee.
El ThemeGeneratorPlugin El plugin Gradle genera los recursos del tema en el archivo compose módulo en el momento de la compilación.

Próximos pasos
Para instalar, configurar y ejecutar la aplicación de referencia de Android, sigue las instrucciones de instalación que se incluyen en el archivo README del repositorio: