Cómo integrar flutter_unity_widget en apps móviles
Pasos para embeber escenas Unity en Flutter con flutter_unity_widget: configuración Android/iOS, comunicación bidireccional y errores frecuentes.
Lectura estimada · 8 min
Por qué combinar Flutter y Unity
Muchas apps necesitan experiencias 3D o mini-juegos sin renunciar al ecosistema Flutter para el resto del producto. El paquete flutter_unity_widget permite embeber una vista Unity dentro de Flutter y comunicar eventos en ambas direcciones.
La keyword «cómo integrar flutter_unity_widget» refleja intención informativa con alta especificidad: quien la busca ya tiene el stack decidido y necesita pasos concretos, no un pitch genérico de desarrollo móvil.
Configuración por plataforma
En Android exportas el proyecto Unity como librería y enlazas el módulo en Gradle. En iOS generas un framework o usa el export recomendado por el plugin y configura el Embed & Sign en Xcode.
Mantén versiones compatibles entre el editor Unity, el plugin y el canal estable de Flutter. Documenta la matriz de versiones en el README del repo para evitar builds rotos en CI.
- Export Unity con escena de arranque única y sin UI duplicada con Flutter.
- Registrar el widget en el árbol Flutter con tamaño y lifecycle claros.
- Probar en dispositivo real: el simulador suele fallar con GLES y plugins nativos.
Comunicación bidireccional
Usa un canal de mensajes (JSON pequeño) para enviar comandos desde Flutter a Unity y eventos de vuelta (p. ej. fin de partida, compra completada). Evita payloads grandes en cada frame.
Si la experiencia Unity es pesada, considera precargar la escena y mostrar un placeholder en Flutter mientras inicializa, mejorando la percepción de rendimiento.