Цю сторінку ще не перекладено — показано англійську версію.

Data

Змінили поле — і синхронізація відбулася сама. Data — це механіка під кожним синхронізованим полем: дельти відносно останнього підтвердженого стану, аспект як одиниця політики, пріоритет і частота надсилання, підписки, які можна відновити, вікно зберігання і хуки до та після зміни.

Ви звертаєтеся до сутностей (entity), а не до таблиць. Як читати й змінювати дані (шукати, фільтрувати, сортувати, гортати сторінки, підписуватися на вибірку), описано на сторінці Entity, а тут — механіка під цим. Шляху до таблиці в споживача немає, як немає й другого способу запису: зміна — це операція Entity, а дельта — її наслідок.

Коли це потрібно

• Потрібно реплікувати стан на клієнти без коду для снапшотів: змінити поле — це і є вся синхронізація (sync).
• Поля (field) відрізняються терміновістю чи аудиторією: для кожного аспекту задають пріоритет і верхню межу частоти надсилання, а для туману війни — предикат видимості.
• Клієнт, що перепідключається, не має мовчки розійтися зі станом: пропуск виявляють і повідомляють про нього, а на пропуск, довший за вікно зберігання (retained window), відповідають повним станом.
• Потрібне недавнє минуле: саме вікно зберігання дельт з індексом за sim_time читають передбачення (prediction) і компенсація лагів.
• Правило валідації має жити в одному місці: хук до зміни обмежує значення або забороняє зміну, ще до того як її застосують.
• Не чіпайте налаштувань, якщо вам треба лише читати чи робити запити. Інтерфейс Entity працює поверх цієї механіки, нічого в ній не змінюючи.

Хто що робить

Коротко

public class Motion
{
    public Vector3 Position;
    [Sync(Hz = 4)] public float Fuel;                    // one field overrides the aspect
}

public class Loadout { public int Ammo; }

[Entity("tank")]
public class Tank
{
    [Aspect("motion", Priority = 10, Hz = 30)]           // policy lives on the aspect
    public Motion Motion = new();

    [Aspect("loadout", Visible = "owner == caller.player")]
    public Loadout Loadout = new();

    public float InternalHeat;                           // in no aspect — never leaves the server
}

tank.Motion.Position = next;   // ← the change; the delta is its consequence

export class Motion {
  position!: Vector3;
  @Sync({ hz: 4 }) fuel = 0;                             // one field overrides the aspect
}

export class Loadout { ammo = 0; }

@Entity('tank')
export class Tank {
  @Aspect('motion', { priority: 10, hz: 30 })            // policy lives on the aspect
  motion = new Motion();

  @Aspect('loadout', { visible: 'owner == caller.player' })
  loadout = new Loadout();

  internalHeat = 0;                                      // in no aspect — never leaves the server
}

tank.motion.position = next;   // ← the change; the delta is its consequence

class Motion:
    position: Vector3
    fuel: float = sync(hz=4)                             # one field overrides the aspect

class Loadout:
    ammo: int = 0

@entity("tank")
class Tank:
    motion: Motion = aspect("motion", priority=10, hz=30)          # policy lives on the aspect
    loadout: Loadout = aspect("loadout", visible="owner == caller.player")
    internal_heat: float = 0.0                           # in no aspect — never leaves the server

tank.motion.position = next_pos   # ← the change; the delta is its consequence

// declarations compile into the same pushed model — playserv push from the UE project or CI
USTRUCT()
struct FMotion
{
    GENERATED_BODY()

    UPROPERTY() FVector3f Position;
    UPROPERTY(PSSync = (Hz = 4)) float Fuel;             // one field overrides the aspect
};

USTRUCT()
struct FLoadout
{
    GENERATED_BODY()

    UPROPERTY() int32 Ammo;
};

UCLASS(PSEntity = "tank")
class UTank : public UObject
{
    GENERATED_BODY()

    UPROPERTY(PSAspect = (Name = "motion", Priority = 10, Hz = 30))   // policy lives on the aspect
    FMotion Motion;

    UPROPERTY(PSAspect = (Name = "loadout", Visible = "owner == caller.player"))
    FLoadout Loadout;

    float InternalHeat = 0.f;                            // no UPROPERTY, in no aspect — never leaves the server
};

Tank->Motion.Position = Next;   // ← the change; the delta is its consequence

public class Motion
{
    public Vector3 Position;
    [Sync(Hz = 4)] public float Fuel;                    // one field overrides the aspect
}

public class Loadout { public int Ammo; }

[Entity("tank")]
public class Tank
{
    [Aspect("motion", Priority = 10, Hz = 30)]           // policy lives on the aspect
    public Motion Motion = new();

    [Aspect("loadout", Visible = "owner == caller.player")]
    public Loadout Loadout = new();

    public float InternalHeat;                           // in no aspect — never leaves the server
}

tank.Motion.Position = next;   // ← the change; the delta is its consequence

Модель

Що несе дельта.

Що оголошує аспект.

Усе це задають атрибутом — на аспекті чи на окремому полі, — і ніколи викликом під час роботи. Аспект задає значення за замовчуванням, а поле може його перевизначити. Одиницею політики лишається аспект, бо інакше не було б із чого збирати пресети.

Що містить підписка.

Що справджується для будь-якого потоку.

Що і коли може робити хук.

[Before(Data.Change, aspect: "tank.motion")]
public static Verdict ClampFuel(Change<Motion> change) =>
    change.Next.Fuel < 0 ? Hook.Reject("negative fuel") : Hook.Continue(change);

export const clampFuel = before(Data.change, { aspect: 'tank.motion' }, (change: Change<Motion>) =>
  change.next.fuel < 0 ? Hook.reject('negative fuel') : Hook.continue(change));

@before(data.change, aspect="tank.motion")
def clamp_fuel(change: Change[Motion]) -> Verdict:
    return hook.reject("negative fuel") if change.next.fuel < 0 else hook.proceed(change)

Хуки на видалення вішають на Entity, де й живе видалення; цей примітив перехоплює зміну.

Помилки

• Неоголошена ціль підписки — це відмова валідації.
• Немає дозволу підписатися — відповідь forbidden або not found, залежно від того, чи саме існування цілі є таємницею: відмова не має ставати оракулом.
• Позиція відновлення, яку не вдалося розібрати, — це хибний запит, а не мовчазний перезапуск із поточної миті.
• Підписка, яку закрила платформа, — це конфлікт, і його видно: closed у машині станів кінцевий, і клієнтові не треба здогадуватися, що підписку закрито.
• Вичерпано кількість підписок — це конфлікт: дозвіл є, але місця не лишилося.

Обмеження

Конкретні числа з’являться разом із розділом про обмеження платформи, а що стається на кожній межі, визначено вже зараз.

• Вікно зберігання дельт: якщо продовжити з позиції, старшої за вікно, прийде повний стан, а не відмова.
• Підписки на одного актора: нову відхиляють, а наявні працюють далі.
• Розмір дельти: дельту ділять, а не обрізають, і поділ видно.
• Частота надсилання: верхня межа, а не гарантія.
• Вартість персонального пакета: коли бюджет вичерпано, відбувається оголошена деградація до shared packet.