Episode¶

Описание: Класс для представления эпизода сериала (версия API 1.4) Представляет информацию об отдельном эпизоде сериала согласно схеме Episode, включая номер, название, описание, дату выхода и кадр из эпизода. Используется в составе сезонов для детальной информации о структуре сериалов.

С версии: 1.0.0

Версия: 1.0.0

См. также:

• \KinopoiskDev\Models\Season: Для информации о сезонах
• \KinopoiskDev\Models\ShortImage: Для кадров из эпизодов

__construct()¶

Описание: Конструктор модели эпизода Создает новый экземпляр класса Episode с указанными параметрами. Большинство параметров являются опциональными и могут быть null при отсутствии соответствующей информации в источнике данных.

Параметры:

• $number (int|null): Номер эпизода
• $name (string|null): Название эпизода на русском языке
• $enName (string|null): Название эпизода на английском языке
• $date (string|null): Дата выхода эпизода (deprecated)
• $description (string|null): Описание эпизода на русском языке
• $still (ShortImage|null): Кадр из эпизода
• $airDate (string|null): Дата выхода эпизода
• $enDescription (string|null): Описание эпизода на английском языке

fromArray()¶

Описание: Создает объект Episode из массива данных API Фабричный метод для создания экземпляра класса Episode из массива данных, полученных от API Kinopoisk.dev. Безопасно обрабатывает отсутствующие значения и преобразует вложенные объекты в соответствующие классы.

Параметры:

• $data (array): Массив данных об эпизоде от API

Возвращает: \KinopoiskDev\Models\Episode Новый экземпляр класса Episode с данными из массива

Исключения:

• \KinopoiskDev\Exceptions\KinopoiskDevException:

toArray()¶

Описание: Преобразует объект в массив данных Конвертирует текущий экземпляр класса Episode в массив, совместимый с форматом API Kinopoisk.dev.

Возвращает: array Массив с данными об эпизоде

getName()¶

Описание: Возвращает наилучшее доступное название эпизода

Возвращает: string|null Название эпизода или null если не задано

getBestDescription()¶

Описание: Возвращает наилучшее доступное описание эпизода

Возвращает: string|null Описание эпизода или null если не задано

getActualAirDate()¶

Описание: Возвращает актуальную дату выхода эпизода Приоритет отдается airDate над deprecated полем date

Возвращает: string|null Дата выхода эпизода

hasStill()¶

Описание: Проверяет наличие кадра из эпизода

Возвращает: bool true если кадр доступен, иначе false

validate()¶

Описание: Валидирует данные модели

Возвращает: bool True если данные валидны