logo
ReferenciaAPI

Jugador

Identidad, nombre, aliases y datos sincronizados de un participante de Eco.

Jugador

Jugador representa a un participante de la sesión de red. Incluye una identidad asignada por el servidor y un Nodo de datos asociado.

Identidad

int id = jugador.id;
string nombre = jugador.name;

El id es asignado por el servidor y es la identidad estable que debe utilizarse al referirse a un jugador durante una sesión.

Comparación

Eco define la igualdad de Jugador en función de su identificador. Esto permite comparar referencias procedentes de distintas partes del cliente sin depender de que sean la misma instancia de C#.

if (jugador == Eco.Jugador)
{
    // Es el jugador local.
}

Datos

Jugador hereda de DataNodeContainer, por lo que dispone de:

jugador.Set("Perfil/Nivel", 10);
int nivel = jugador.Get<int>("Perfil/Nivel", 1);

Para el jugador local, normalmente utiliza la fachada:

Eco.EstablecerDatosJugador("Perfil/Nivel", 10);

Aliases

Los aliases permiten asociar identificadores adicionales al jugador, por ejemplo un Steam ID, ID de cuenta o identificador de plataforma.

jugador.AddAlias(steamId);
bool coincide = jugador.HasAlias(steamId);

Los aliases pueden utilizarse por el servidor en sus mecanismos de administración y bloqueo.

ID frente a alias

El id de Jugador pertenece a la sesión de Eco. Un alias identifica externamente al usuario y no debe sustituir al ID de red como referencia de gameplay durante una sesión.

Eventos

Los cambios de jugadores pueden observarse desde Eco mediante eventos como:

Eco.alEntrarJugador += OnPlayerJoin;
Eco.alSalirJugador += OnPlayerLeave;
Eco.alRenombrarJugador += OnPlayerRename;

API relacionada

Eco

Acceso al jugador local y búsqueda de jugadores remotos.

Canal

Colección de jugadores que participan en el canal.

Datos del jugador

Workflow práctico para sincronizar playerData.

Jugador.cs

Implementación actual.

On this page