О чем этот пример

В разработке игр часто возникает задача анимировать множество объектов с одинаковым поведением. Рендерить каждый спрайт по отдельности неэффективно. В этой статье разберем, как использовать `Container` в Phaser для группировки игровых объектов и применения трансформаций ко всей группе сразу. Вы научитесь создавать сложные композиции с минимальными затратами производительности.

Версия Phaser: код и демо в этой статье рассчитаны на Phaser 3.90.0.

Живой запуск

Ниже встроен рабочий билд примера. Оригинальный источник: GitHub.

Исходный код


class Example extends Phaser.Scene
{
    preload ()
    {
        this.load.setBaseURL('https://raw.githubusercontent.com/phaserjs/examples/master/public/');
        // this.load.image('rick', 'assets/demoscene/purple-raster.png');
        this.load.image('rick', 'assets/demoscene/sunset-raster.png');
        this.load.image('rick2', 'assets/demoscene/rastercarpet32.png');
    }

    create ()
    {
        const sprite1 = this.add.sprite(0, 100, 'rick');
        const sprite2 = this.add.sprite(-100, 0, 'rick2').setAngle(90);
        const sprite3 = this.add.sprite(0, -100, 'rick').setAngle(180);
        const sprite4 = this.add.sprite(100, 0, 'rick2').setAngle(270);

        const containers = [];

        for (let i = 0; i < 128; i++)
        {
            const container = this.add.container(400, 300);

            if (i > 0)
            {
                container.setExclusive(false);
            }

            container.add([ sprite1, sprite2, sprite3, sprite4 ]);

            containers.push(container);
        }

        this.tweens.add({
            targets: sprite1,
            y: -100,
            ease: 'Quad.easeInOut',
            duration: 4000,
            repeat: -1,
            yoyo: true
        });

        this.tweens.add({
            targets: sprite2,
            x: 100,
            ease: 'Quad.easeInOut',
            duration: 4000,
            repeat: -1,
            yoyo: true
        });

        this.tweens.add({
            targets: sprite3,
            y: 100,
            ease: 'Quad.easeInOut',
            duration: 4000,
            repeat: -1,
            yoyo: true
        });

        this.tweens.add({
            targets: sprite4,
            x: -100,
            ease: 'Quad.easeInOut',
            duration: 4000,
            repeat: -1,
            yoyo: true
        });

        this.tweens.add({
            targets: containers,
            angle: { value: 360, duration: 6000 },
            scaleX: { value: 6, duration: 3000, yoyo: true, ease: 'Quart.easeInOut' },
            scaleY: { value: 0.1, duration: 3000, yoyo: true, ease: 'Quad.easeInOut' },
            repeat: -1,
            delay: function (target, key, value, index, total, tween)
            {
                return index * 16;
            }
        });
    }
}

const config = {
    type: Phaser.AUTO,
    width: 800,
    height: 600,
    backgroundColor: '#000000',
    parent: 'phaser-example',
    scene: Example
};

const game = new Phaser.Game(config);

Что такое Container и зачем он нужен

Container — это специальный игровой объект в Phaser, который выступает как родительский контейнер для других объектов (спрайтов, текста, частиц и даже других контейнеров). Все трансформации (позиция, масштаб, поворот, альфа), примененные к контейнеру, автоматически влияют на все его дочерние элементы.

Это мощный инструмент для: - Группировки логически связанных объектов (например, персонаж + оружие + индикатор здоровья). - Оптимизации отрисовки за счет батчинга. - Упрощения анимации сложных составных элементов.

В исходном примере один контейнер содержит четыре спрайта, образующих крест. Затем создается 128 таких контейнеров, и анимация применяется ко всем им сразу.

Создание спрайтов и их добавление в контейнер

В методе create() сначала создаются четыре независимых спрайта. Обратите внимание, их начальные координаты заданы так, чтобы они располагались вокруг точки (0, 0) — будущего центра контейнера. Каждому спрайту задан свой угол поворота методом .setAngle().

const sprite1 = this.add.sprite(0, 100, 'rick');
const sprite2 = this.add.sprite(-100, 0, 'rick2').setAngle(90);
const sprite3 = this.add.sprite(0, -100, 'rick').setAngle(180);
const sprite4 = this.add.sprite(100, 0, 'rick2').setAngle(270);

Далее в цикле создаются контейнеры. Ключевой момент: метод .add() контейнера принимает массив объектов для добавления. Важно, что одни и те же спрайты добавляются во все 128 контейнеров. Это возможно благодаря режиму setExclusive(false).

for (let i = 0; i < 128; i++)
{
    const container = this.add.container(400, 300);
    if (i > 0)
    {
        container.setExclusive(false);
    }
    container.add([ sprite1, sprite2, sprite3, sprite4 ]);
    containers.push(container);
}

Эксклюзивный и неэксклюзивный режимы контейнера

По умолчанию контейнер работает в эксклюзивном режиме. Это означает, что дочерний объект может принадлежать только одному контейнеру. Попытка добавить его в другой приведет к его удалению из первого.

Метод setExclusive(false) отключает это поведение. Объект может принадлежать множеству контейнеров одновременно. Именно это позволяет в примере использовать четыре созданных спрайта во всех 128 контейнерах. Это мощная оптимизация: в памяти и на GPU существует всего 4 текстуры и 4 объекта спрайтов, которые переиспользуются.

Однако будьте осторожны: прямое изменение свойств такого общего спрайта (например, sprite1.x = 10) будет видно во всех контейнерах, куда он добавлен.

Анимация дочерних спрайтов

Поведение общей анимации демонстрирует разделение ответственности. Твины применяются напрямую к оригинальным спрайтам (sprite1, sprite2 и т.д.).

this.tweens.add({
    targets: sprite1,
    y: -100,
    ease: 'Quad.easeInOut',
    duration: 4000,
    repeat: -1,
    yoyo: true
});

Поскольку эти спрайты добавлены во все контейнеры, их индивидуальная анимация (движение по осям Y и X) воспроизводится в каждом экземпляре контейнера. Это создает базовый, «внутренний» слой движения.

Анимация массива контейнеров

Самый эффектный твин применяется к массиву containers. Phaser позволяет анимировать сразу множество целей. Здесь заданы три одновременные трансформации: поворот на 360 градусов, масштабирование по X и Y.

this.tweens.add({
    targets: containers,
    angle: { value: 360, duration: 6000 },
    scaleX: { value: 6, duration: 3000, yoyo: true, ease: 'Quart.easeInOut' },
    scaleY: { value: 0.1, duration: 3000, yoyo: true, ease: 'Quad.easeInOut' },
    repeat: -1,
    delay: function (target, key, value, index, total, tween)
    {
        return index * 16;
    }
});

Ключевой параметр — delay. Это функция, которая возвращает задержку для каждого конкретного контейнера в массиве, основываясь на его индексе (index * 16 мс). Это создает волнообразный, каскадный эффект анимации, а не одновременное движение всех 128 объектов. Функция delay — мощный инструмент для создания сложных procedural-анимаций.

Что попробовать дальше

Контейнеры в Phaser — это фундаментальный инструмент для организации и оптимизации игровых сцен. Используя неэксклюзивный режим и анимацию массивов, вы можете создавать визуально насыщенные эффекты с тысячами элементов, сохраняя высокую производительность. Для экспериментов попробуйте изменить текстуры спрайтов, поиграть с параметрами твинов (длительность, easing-функции) или добавить интерактивность (например, вращение контейнеров курсором мыши).