Эта страница ещё не переведена — показана английская версия.

Auth & Players

Вход — это шаг, который можно переопределить, а не чёрный ящик. Провайдеры, сессии, привязка учётных записей, баны. Каждая точка сценария — до и после входа, до и после привязки, до и после слияния, при смене статуса — объявлена как точка расширения определённого вида. Это либо проверка, которая может отклонить шаг, либо наблюдатель, который этого не может.

Когда это нужно

• Игроки (player) должны входить в игру — через устройство, email, Apple, Google, Steam или собственный провайдер. Создание игрока при первом входе (sign-in) включается флагом, а не отдельным сценарием.
• Гостевой аккаунт позже нужно превратить в постоянный: Link привязывает Steam без потери прогресса, а слияние (merge) сводит два аккаунта в одного игрока.
• Политика должна выполняться там, где её не обойти: регион проверяется до входа, а стартовый набор выдаётся после того входа, при котором игрок был создан.
• Модерация должна срабатывать сразу: отозвать сессии, приостановить аккаунт, забанить устройство — и событие banned услышат все работающие системы.
• Объявленный контекст (регион, платформа, сборка) должен доходить до всех последующих хуков, чтобы ни одному из них не пришлось заново читать игрока ради этих данных.
• Облегчённой замены у этого модуля нет. Все остальные модули узнают, кто их вызывает, через него. Пока хоть одному из них нужен актор-игрок, auth выключить нельзя: конфигуратор модулей откажет и перечислит зависимые модули.

Кто что делает

Коротко

// client — one call per provider; create-on-first-sign-in is a flag
var session = await PlayServ.Auth.SignIn(Provider.Device, create: true);
await PlayServ.Auth.Link(Provider.Steam);          // one player, many identities

// client — one call per provider; create-on-first-sign-in is a flag
const session = await PlayServ.auth.signIn(Provider.Device, { create: true });
await PlayServ.auth.link(Provider.Steam);    // one player, many identities

# client — one call per provider; create-on-first-sign-in is a flag
session = await playserv.auth.sign_in(Provider.DEVICE, create=True)
await playserv.auth.link(Provider.STEAM)     # one player, many identities

// client — one call per provider; create-on-first-sign-in is a flag
Client->Auth->SignInWithProvider(FPSProviderId::Device, Credential,
    TPSOnResult<FPSSession>::CreateWeakLambda(this, [this](const TPSResult<FPSSession>& Result)
    {
        if (!Result.HasValue()) { return; }
        // one player, many identities — add Steam to the same account
        Client->Auth->Providers->Link(FPSProviderId::Steam, SteamCredential);
    }));
// co_await support ships later: a built-in SDK coroutine wrapper that respects Unreal's GC and threading.

// client — one call per provider; create-on-first-sign-in is a flag
var session = await PlayServ.Auth.SignIn(Provider.Device, create: true);
await PlayServ.Auth.Link(Provider.Steam);          // one player, many identities

Каждая точка настраивается там же, где объявлена. Все формы, которые может принимать обработчик, собраны на странице Extensibility:

[Before(Auth.SignIn)]                          // a gate: it may refuse, and it is fail-closed
public static Verdict GateRegion(SignInAttempt a) =>
    a.Region == "sanctioned"
        ? Hook.Reject(Problem.Forbidden, "region not served")
        : Hook.Continue(a);

[After(Auth.SignIn, created: true)]            // an observer: it watches, it cannot refuse
public static async Task GrantStarterPack(Player player)
{
    await player.Inventory.Grant("chest.gold", count: 1);
}

// a gate: it may refuse, and it is fail-closed
export const gateRegion = before(Auth.signIn, (a: SignInAttempt) =>
  a.region === 'sanctioned'
    ? Hook.reject(Problem.forbidden, 'region not served')
    : Hook.continue(a));

// an observer: it watches, it cannot refuse
export const grantStarterPack = after(Auth.signIn, { created: true },
  async (player: Player) => {
    await player.inventory.grant('chest.gold', { count: 1 });
  });

@before(auth.sign_in)                          # a gate: it may refuse, and it is fail-closed
def gate_region(a: SignInAttempt) -> Verdict:
    if a.region == "sanctioned":
        return Hook.reject(Problem.FORBIDDEN, "region not served")
    return Hook.continue_(a)

@after(auth.sign_in, created=True)             # an observer: it watches, it cannot refuse
async def grant_starter_pack(player: Player):
    await player.inventory.grant("chest.gold", count=1)

Админ-панель показывает именно объявленную форму: у каждой точки видны её обработчики, их вид и итоговый порядок вызова. От вида зависит, что происходит, когда обработчик падает:

Модель

Игрок — это носитель учётных записей, а не строка в вашей схеме (schema). Его идентификатор стабилен и никогда не используется повторно — даже при слиянии: id объединённого игрока по-прежнему разрешается и не становится висячей ссылкой. Привязка — это тройка провайдер · внешний субъект · игрок.

Три машины состояний.

Что объявляете вы.

Где настраивается провайдер. На операторском уровне, а не в коде: учётным данным магазина не место в репозитории. Объявленное попадает в админ-консоль только для чтения.

Что даёт выдача роли. Роли — забота не только оператора. У игрока есть операции выдачи и отзыва, поэтому игра может своим кодом назначить офицера гильдии или передать организатору турнира его полномочия.

Из чего состоят роли и что они открывают, описано на странице Access & Roles.

Ошибки

• Нет учётных данных или они истекли — ответ not authenticated, и помогает обновление. Отозванные учётные данные дают тот же ответ, но обновление уже не поможет — только новый вход.
• Повторно предъявленные учётные данные, которые уже прошли ротацию, — конфликт. Именно поэтому ротацию можно обнаружить, а не молча терпеть.
• Забаненный или приостановленный игрок, как и забаненный отпечаток устройства, получают forbidden, и повторять запрос бессмысленно.
• Пара провайдер+субъект уже занята — это конфликт, и повторить можно после того, как выбрано слияние. Вторая учётная запись того же провайдера — конфликт, который повтор не исправит.
• Отвязать последний способ входа нельзя — это отказ валидации: получился бы аккаунт, в который никто не может войти.
• Слияние уже объединённого игрока — конфликт: merged — конечное состояние.
• Если провайдер недоступен, ответ — unavailable, и стоит повторять с нарастающей задержкой. Если провайдер отверг учётные данные, ответ — not authenticated: стоит повторить один раз, но не в цикле.
• При превышении частоты попыток входа ответ относится к категории ограничения частоты и содержит срок, после которого можно повторить.

Ограничения

Конкретные числа появятся вместе с главой об ограничениях платформы, а поведение на каждой границе уже определено.

• Одновременные сессии игрока: по объявленной политике — либо вытеснение самой старой с событием, либо отказ новой. Значения по умолчанию нет.
• Попытки входа за период и попытки привязать занятую пару: ограничение частоты со сроком повтора, а счётчик попыток остаётся в истории.
• Привязки на игрока: привязка ещё одного провайдера отклоняется как конфликт.
• Время жизни учётных данных: not authenticated, после обновления можно повторить. Время жизни учётных данных для обновления: только новый вход.
• Хранение анонимного игрока, который не входит в игру: удаление по объявленной политике, с событием. Политику объявляют явно, значения по умолчанию нет.
• Записи в бан-листе отпечатков: новая запись отклоняется, а старые никогда не вытесняются молча.