Introducción a la aplicación de referencia de Android
La aplicación de referencia de Android demuestra cómo crear experiencias de reuniones modernas y escalables usando la API de video de Vonage en dispositivos Android. Se trata de un proyecto de código abierto que muestra 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 previsualización del dispositivo y la introducción del nombre de la pantalla
- 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 alineados con la 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
- vonage-feature-chat - Chat opcional durante las reuniones
- herramientas de construcció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 (proporcionado en el repositorio de aplicaciones de referencia de React) para generar ID de sesión y fichas para entrar en salas de vídeo. La URL de 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 activa de altavoces
- Diseños adaptablesincluyendo las vistas de altavoz activo y rejilla
- Gestión dinámica de baldosas que reacciona a los eventos de entrada/salida y conserva 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 puede personalizarse sin modificar el código fuente. La configuración se realiza mediante archivos JSON en el directorio config carpeta.
Configuración de funciones
Los indicadores de funciones y la configuración de las aplicaciones 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.
En 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 la interfaz de usuario
Puede personalizar los colores de la aplicación editando el archivo config/theme.json con los valores de combinación de colores que desee.
En ThemeGeneratorPlugin El plugin Gradle genera los recursos del tema en el archivo compose en el momento de la compilación.
Próximos pasos
Para instalar, configurar y ejecutar la aplicación de referencia de Android, siga las instrucciones de instalación proporcionadas en el archivo README del repositorio: