Sala VK para Android

Aplicación Android independiente para ver el directo público de VK Video Live de redbreake y participar en el chat de Twitch de kalathraslolweapon desde una misma pantalla.

El vídeo se carga directamente desde el embed oficial de VK y el chat se conecta de forma nativa al IRC de Twitch.

Funciones principales

• Reproductor de VK y chat de Twitch en una interfaz roja y negra.
• Diseño responsive: vídeo arriba en vertical y vídeo/chat lado a lado en horizontal.
• Pantalla completa sin chat, recarga manual y Picture-in-Picture desde Android 8.
• Entrada automática en PiP al minimizar la aplicación.
• Candado activado por defecto para evitar pausas accidentales; al desbloquearlo se pueden usar los controles internos de VK, incluidos calidad y Live.
• Identidad de escritorio exclusiva para VK, utilizada para evitar falsos avisos de VPN que aparecen en la variante móvil del reproductor.
• Chat IRC de Twitch en tiempo real, legible sin iniciar sesión.
• Inicio de sesión oficial de Twitch mediante Device Code para escribir en el chat.
• Emotes oficiales de Twitch, emotes disponibles para la cuenta y emotes de 7TV.
• Insignias, respuestas, menciones y eventos de moderación del chat.
• Recuperación de hasta una hora de mensajes recientes y caché local de 200 mensajes.
• Reconexión progresiva cuando se interrumpe la red.
• Tokens OAuth cifrados mediante Android Keystore.

Captura conceptual

┌──────────────────────────┬───────────────┐
│                          │ Chat Twitch   │
│        VK Video          │ mensajes      │
│                          │ emotes        │
│                          │ escribir      │
└──────────────────────────┴───────────────┘

En vertical, el reproductor ocupa la parte superior y el chat continúa debajo.

Requisitos

• Android 7.0 o posterior (minSdk 24).
• Android System WebView actualizado.
• Conexión a Internet.
• Cuenta de Twitch únicamente si se desea escribir.
• Para compilar: JDK 17 y Android SDK 36.

Compilar

En Windows:

.\gradlew.bat testDebugUnitTest lintDebug assembleDebug

En Linux o macOS:

./gradlew testDebugUnitTest lintDebug assembleDebug

El APK de depuración queda en:

app/build/outputs/apk/debug/app-debug.apk

La configuración del SDK debe estar en local.properties, archivo que no se publica:

sdk.dir=C\:\\Android\\Sdk

Configuración rápida

Los canales están definidos actualmente en código:

• VK: VK_LIVE_EMBED_URL en VkPlayer.kt.
• Twitch: TWITCH_CHANNEL en SalaVkApp.kt.

El Client ID de Twitch es un identificador público de aplicación, no un secreto. Para utilizar otra aplicación OAuth o publicar una variante propia, consulta Configuración.

Documentación

• Arquitectura y flujo de datos
• Configuración y personalización
• Chat de Twitch
• Reproductor de VK
• Seguridad y privacidad
• Compilación, pruebas y publicación
• Solución de problemas
• Historial de cambios
• Informe histórico de estabilidad
• Hoja de ruta

Servicios externos

La app se comunica con VK Video Live, Twitch, 7TV, Decapi y el servicio público Recent Messages de Robotty. Consulta el documento de seguridad y privacidad para conocer qué información se intercambia con cada servicio.

Estado actual

Versión: 1.5.4 (versionCode 11).

Validación local más reciente:

• 20 pruebas unitarias correctas.
• Android Lint sin errores.
• APK de depuración compilado correctamente.
• Candado táctil verificado en ambos estados.
• PiP automático verificado en Android 15.

Avisos

• La disponibilidad, calidad y controles del vídeo dependen del embed de VK.
• El historial remoto reciente usa un servicio comunitario y puede no estar disponible.
• Cada emisor es responsable de contar con los derechos necesarios sobre el contenido que transmite.
• Twitch, VK y 7TV son marcas y servicios de sus respectivos propietarios. Este proyecto no está afiliado oficialmente con ellos.