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

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

Версия 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/large-raster32.png');

        // this.load.image('rick', 'assets/demoscene/doc-ball.png');
        // this.load.image('rick2', 'assets/demoscene/rastercarpet32.png');
        this.load.image('rick2', 'assets/demoscene/blue-raster.png');
    }

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

        const containers = [];

        for (let i = 0; i < 256; 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: -200,
            ease: 'Sine.easeInOut',
            duration: 2000,
            repeat: -1,
            yoyo: true
        });

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

        this.tweens.add({
            targets: sprite3,
            y: 200,
            ease: 'Sine.easeInOut',
            duration: 2000,
            repeat: -1,
            yoyo: true
        });

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

        this.tweens.add({
            targets: containers,
            angle: { value: 360, duration: 6000 },
            scaleX: { value: 0.5, duration: 3000, yoyo: true, ease: 'Quart.easeInOut' },
            scaleY: { value: 16, 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);

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

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

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

Массовое создание контейнеров и управление эксклюзивностью

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

Метод container.setExclusive(false) отключает это поведение для всех контейнеров, кроме первого (условие if (i > 0)). Это позволяет одним и тем же четырем спрайтам (sprite1, sprite2, sprite3, sprite4) быть добавленными во все 256 контейнеров одновременно. Без этого флага каждый спрайт мог бы принадлежать только одному контейнеру.

for (let i = 0; i < 256; 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(). Каждый спрайт движется по своей оси (X или Y) с разной продолжительностью (duration). Параметры repeat: -1 и yoyo: true делают анимацию бесконечно повторяющейся и возвращающейся в исходную точку. Эти анимации применяются напрямую к спрайтам и наследуются всеми контейнерами, так как спрайты являются общими.

this.tweens.add({
    targets: sprite1,
    y: -200,
    ease: 'Sine.easeInOut',
    duration: 2000,
    repeat: -1,
    yoyo: true
});
// ... аналогичные твины для sprite2, sprite3, sprite4

Сложная анимация самих контейнеров

Самый интересный твин применяется к массиву containers. Он одновременно вращает, масштабирует по X и масштабирует по Y каждый контейнер. Ключевая особенность — функция delay. Она вычисляет задержку старта анимации для каждого контейнера в массиве, основываясь на его индексе (index). Это создает эффект волны или последовательности.

Функция delay возвращает index * 16, что означает: первый контейнер (индекс 0) начнет анимацию сразу, второй — через 16 мс, третий — через 32 мс и так далее.

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

Итоговый визуальный эффект — это комбинация: 1) независимого движения четырех спрайтов, 2) вращения 256 контейнеров вокруг своей оси, 3) пульсирующего масштабирования контейнеров по осям X и Y с разной интенсивностью и 4) последовательного запуска анимации контейнеров, создающего спиральный узор.

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

Этот пример демонстрирует всю мощь контейнеров Phaser для создания сложной композиционной анимации с минимальным количеством исходных объектов. Для экспериментов попробуйте: изменить количество контейнеров, поиграть с формулой задержки в функции delay (например, index * 32 или Math.sin(index) * 100), заменить спрайты на частицы или текстуры с прозрачностью, а также применить разные функции ease для масштабирования, чтобы получить еще более причудливые визуальные эффекты.