Guía del Usuario¶
¡Bienvenido a la guía del usuario de d-back! Esta guía integral cubre todo lo que necesita para usar efectivamente d-back como servidor WebSocket para su simulación de vida ambiental d-zone u otras aplicaciones en tiempo real.
Introducción¶
Esta guía está diseñada para usuarios que ya han completado el tutorial de Primeros Pasos y desean profundizar en las características y capacidades de d-back. Ya sea que esté buscando personalizar el comportamiento del servidor, integrar con datos reales de Discord u optimizar su configuración, encontrará la información que necesita aquí.
La guía del usuario está organizada en tres áreas principales:
- Configuración: Aprenda cómo configurar d-back a través de opciones de línea de comandos, variables de entorno y configuraciones programáticas
- Callbacks y Personalización: Descubra cómo personalizar el comportamiento del servidor usando funciones callback para recuperación de datos, autenticación y más
- Proveedores de Datos Personalizados: Reemplace datos simulados con integración real de la API de Discord o sus propias fuentes de datos personalizadas
Estructura de la Guía¶
-
Configuración
Aprenda sobre opciones de línea de comandos, variables de entorno y configuraciones del servidor
-
Callbacks y Personalización
Personalice el comportamiento del servidor con funciones callback para recuperación de datos y autenticación
-
Proveedores de Datos Personalizados
Reemplace datos simulados con integración real de la API de Discord o fuentes de datos personalizadas
Casos de Uso Comunes¶
¿Necesita lograr una tarea específica? Aquí hay enlaces rápidos a escenarios comunes:
| Escenario | Dónde Buscar |
|---|---|
| Quiero cambiar el puerto del servidor | Configuración → Opciones de Línea de Comandos |
| Quiero servir mis propios archivos estáticos | Configuración → Servicio de Archivos Estáticos |
| Quiero usar datos reales de Discord | Proveedores de Datos Personalizados |
| Quiero agregar autenticación OAuth2 | Callbacks → Validación OAuth2 |
| Quiero transmitir mensajes personalizados | Callbacks → Métodos de Difusión |
| Quiero personalizar el formato de datos de usuario | Callbacks → Callback de Datos de Usuario |
Referencia Rápida¶
Aquí hay un resumen de conceptos clave que encontrará en esta guía:
| Concepto | Descripción |
|---|---|
| WebSocketServer | Clase principal del servidor que maneja conexiones WebSocket, solicitudes HTTP y difusión de mensajes |
| MockDataProvider | Generador de datos de prueba integrado que simula actividad de usuario de Discord |
| Callbacks | Ganchos de personalización que permiten anular el comportamiento predeterminado (p. ej., on_get_user_data, on_get_server_data) |
| Servicio de Archivos Estáticos | Servidor HTTP integrado para entregar activos de frontend como HTML, CSS y JavaScript |
| Difusión | Métodos para enviar actualizaciones en tiempo real a clientes conectados (presencia, mensajes, etc.) |
| Integración OAuth2 | Soporte para autenticación OAuth2 de Discord y validación de tokens |
¿Necesita Detalles de la API?
Para documentación detallada de la API incluyendo firmas de métodos, parámetros y tipos de retorno, consulte la Referencia de API.
¿Qué Sigue?¶
¿Listo para personalizar su configuración de d-back? Comience con:
- Configuración - Configure su servidor con las configuraciones correctas
- Callbacks y Personalización - Aprenda cómo personalizar el comportamiento
- Proveedores de Datos Personalizados - Integre fuentes de datos reales
¿Preguntas?
Si no puede encontrar lo que está buscando, consulte la Referencia de API o visite nuestras GitHub Discussions.