Objeto

Objeto representa una entidad de red concreta. Vincula la identidad del objeto de Unity con un canal, un propietario, datos sincronizados y el despacho de llamadas remotas.

Identidad

uint id = objeto.id;
ulong uid = objeto.uid;
int canal = objeto.channelID;

id pertenece al contexto del canal. uid combina la identidad necesaria para resolver el objeto entre contextos de red.

Estado y datos

objeto.Set("vida", 100);
int vida = objeto.Get<int>("vida", 100);
Nodo nodo = objeto.Get("vida");

El patrón es clave/valor sobre Nodo. Set actualiza localmente y genera la sincronización cuando la autoridad y el estado de conexión permiten transmitirla.

Autoridad

if (objeto.isMine)
{
    objeto.Set("vida", nuevaVida);
}

Cuando el emisor no es propietario, el cambio puede requerir una solicitud al propietario. No utilices isMine como sistema de seguridad: las reglas críticas deben validarse en el lado con autoridad.

PuedeEnviar

if (objeto.PuedeEnviar)
{
    objeto.Send("Actualizar", Objetivo.Otros, valor);
}

Esta propiedad evita enviar cuando el objeto todavía no está registrado, está destruido, no pertenece a un canal válido o atraviesa una transición en la que el protocolo no admite todavía la operación.

RFC

Los métodos remotos se declaran en Componente y se ejecutan dentro del contexto del Objeto:

public class Unidad : Componente
{
    [RMR]
    void RecibirDaño(int cantidad)
    {
        // validar y aplicar
    }
}

El objeto proporciona identidad y destinatario; el componente proporciona el método remoto.

Instanciación y destrucción

Desde la fachada:

Eco.Instanciar(canal, rcrID, nombreRcr, prefab, persistente, parametros);

Desde un componente:

Instantiate("CrearUnidad", "Units/Soldier", false, posicion);
DestroySelf();

Las operaciones de destrucción deben respetar la autoridad correspondiente.

Ownership

El propietario puede cambiarse únicamente bajo las reglas de Eco para objetos dinámicos y jugadores del mismo canal. No edites directamente ownerID para simular una transferencia sin ejecutar el flujo de ownership correspondiente.

Transferencia de canal

La transferencia entre canales cambia el contexto del objeto y puede producir un nuevo id. onTransfer permite actualizar referencias locales:

objeto.onTransfer += (nuevoCanal, nuevoID) =>
{
    // Invalidar referencias basadas en el ID anterior.
};

Persistencia

Un objeto persistente y un objeto estático de escena no son equivalentes. Los objetos persistentes del servidor se reconstruyen a partir del estado guardado del canal y de las operaciones necesarias para restaurarlos.

Eventos

Entre los eventos relevantes están la destrucción y transferencia. Suscríbelos para sincronizar sistemas locales que dependen del ciclo de vida del objeto.

Búsqueda

Cuando el código debe resolver una entidad recibida por protocolo, utiliza el identificador y el canal con los mecanismos de búsqueda de Eco en lugar de mantener referencias globales a GameObject.

Equivalencia TNet