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

Visibility

На 40 гравців снапшот усієї кімнати годиться. На 200 — уже ні. Хто що отримує, вирішує зона видимості. Це оголошений предикат, а не перемикач, який ви клацаєте для кожного об’єкта. Загальне розсилання й персональні пакети — два оголошені режими доставки однієї моделі, тож перейти з одного на інший можна налаштуванням, без переписування коду. Це оптимізація каналу, а не дозвіл: про дозволи читайте на сторінці Access & Roles.

Одну оголошену модель — предикат, шари, рівні деталізації — можна прочитати двома способами:

Те, що не повинно витекти, відсутнє в пакеті, а не сховане на клієнті. Платформа просто не надсилає ці дані, тому це властивість безпеки, а не економії трафіку.

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

• Ваші кімнати (room) переросли розсилання всієї кімнати: 200 гравцям потрібен для кожного клієнта власний потік даних про околиці, а не кожна дельта.
• Стан не повинен витікати: туман війни й поля (field), доступні лише власникові, взагалі не слід надсилати, а не ховати на клієнті.
• Кілька сесій ділять одну мапу (map) і не повинні бачити одна одну: шар — це ще один предикат.
• Розмір пакета в натовпі має бути передбачуваним: обмежте кількість об’єктів і оголосіть порядок відбору, щоб «найближчі N» були обіцянкою, а не випадковістю щільності.
• Гравець біля межі має бачити, що за нею: оголосіть, які сусідні області видно, бо за замовчуванням видно лише його власну.
• Не потрібно, якщо кімната невелика. З цим упорається режим доставки загальним пакетом.

Хто що робить

Коротко

[Entity("tank")]
[Visible(Radius = 60)]                           // spatial
[Visible(Rule.SameLayer)]                        // layers of one map
public class Tank
{
    [Sync] public Vector3 Position;
    [Sync(To = Scope.Owner)] public int Ammo;    // per-field scope
}

@Entity('tank')
@Visible({ radius: 60 })                       // spatial
@Visible(Rule.SameLayer)                       // layers of one map
export class Tank {
  @Sync() position!: Vector3;
  @Sync({ to: Scope.Owner }) ammo = 0;         // per-field scope
}

@entity("tank")
@visible(radius=60)                              # spatial
@visible(Rule.SAME_LAYER)                        # layers of one map
class Tank:
    position: Vector3 = sync()
    ammo: int = sync(to=Scope.OWNER)             # per-field scope

// multi-entry values are one quoted list (a specifier value is a single token)
UCLASS(PSEntity = "tank",
       PSVisible = "radius:60, rule:SameMapInstance")   // spatial + instances of one map
class UTank : public UObject
{
    GENERATED_BODY()

    UPROPERTY(PSSync)                  FVector3f Position;
    UPROPERTY(PSSync = (To = "Owner")) int32     Ammo;   // per-field scope
};
// declarations compile into the same pushed model — playserv push from the UE project or CI

[Entity("tank")]
[Visible(Radius = 60)]                           // spatial
[Visible(Rule.SameLayer)]                        // layers of one map
public class Tank
{
    [Sync] public Vector3 Position;
    [Sync(To = Scope.Owner)] public int Ammo;    // per-field scope
}

Модель

Що оголошує правило видимості.

Що справджується для будь-якої зони.

Помилки

• Неоголошена ціль підписки (subscription) — відмова під час валідації.
• Немає дозволу на підписку — відповідь forbidden або not found, залежно від того, чи є таємницею саме існування цілі: відмова не повинна видавати те, у чому відмовляє.
• Позиція відновлення, яку не вдалося розібрати, — це некоректний запит, а не мовчазний перезапуск із поточного моменту.
• Підписка, яку закрила платформа, і вичерпаний ліміт підписок — обидва випадки є конфліктом.
• Розширити подання (view) можна лише з fn. Коли сесія гравця намагається видати розширене подання чи налаштувати рівні деталізації (detail tier), платформа відмовляє з forbidden, і подання не змінюється. Клієнт глядача не може розширити власні видані права (grant).
• Екземпляр, якого немає в поданні того, хто викликає, відповідає not found — так само, як неіснуючий. Відповідь forbidden підтвердила б, що за стіною щось є.
• Читати вартість персональних пакетів можна лише з fn adm : із хмарної функції або панелі, але ніколи з клієнта.

Обмеження

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

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