Перейти к основному содержимому

Метаданные (подробная информация)

Теперь ваш каталог фильмов работает. При клике на фильм пользователи видят базовую информацию. Добавим подробные метаданные, чтобы сделать контент более информативным.

Метаданные — это расширенная информация об элементе: описание, актёры, рейтинги и т. д.

Когда нужны свои метаданные​

EMET Surf автоматически подгружает метаданные для фильмов с валидными IMDb ID. Свои метаданные нужны, когда:

  • Инди‑фильмы или оригинальный контент
  • Собственные видео
  • Нишевые источники
  • Нет стандартного IMDb ID

Обновляем манифест​

{
    "id": "my.first.emet.addon",
    "version": "1.0.0",
    "name": "Hello, World",
    "description": "My first EMET Surf add-on",
    "logo": "https://example.com/logo-256.png",
    "resources": [
        "catalog",
        {"name": "meta", "types": ["movie"], "idPrefixes": ["hiwrld_"]}
    ],
    "types": ["movie"],
    "catalogs": [{"id": "movieCatalog", "type": "movie", "name": "Hello, Movies"}]
}

Изменения:

  • Добавлен ресурс meta с types и idPrefixes
  • idPrefixes указывает, какие ID обслуживает дополнение

Добавляем кастомный контент в каталог​

{
    "metas": [
        {"type": "movie", "id": "tt0032138", "name": "The Wizard of Oz", "poster": "https://images.metahub.space/poster/medium/tt0032138/img", "genres": ["Adventure", "Family", "Fantasy", "Musical"]},
        {"type": "movie", "id": "tt0017136", "name": "Metropolis", "poster": "https://images.metahub.space/poster/medium/tt0017136/img", "genres": ["Drama", "Sci-Fi"]},
        {"id": "hiwrld_jellyfish", "type": "movie", "name": "Jellyfish", "poster": "https://images.unsplash.com/photo-1496108493338-3b30de66f9be", "genres": ["Demo", "Nature"]}
    ]
}

Структура папок метаданных​

Windows:

mkdir meta
mkdir meta\movie

macOS/Linux:

mkdir -p meta/movie

Структура:

my-emet-addon/
├── manifest.json
├── catalog/
│   └── movie/
│       └── movieCatalog.json
└── meta/
    └── movie/
        └── hiwrld_jellyfish.json

Подробные метаданные​

meta/movie/hiwrld_jellyfish.json:

{
    "meta": {
        "id": "hiwrld_jellyfish",
        "type": "movie",
        "name": "Jellyfish",
        "poster": "https://images.unsplash.com/photo-1496108493338-3b30de66f9be",
        "genres": ["Demo", "Nature"],
        "description": "Красивый ролик с медузами в их естественной среде. Подходит для теста потоков и расслабляющего просмотра.",
        "cast": ["Various jellyfish species"],
        "director": ["Nature"],
        "logo": "https://example.com/jellyfish-logo.png",
        "background": "https://images.unsplash.com/photo-1461783470466-185038239ee3",
        "runtime": "30 sec",
        "releaseInfo": "2024",
        "imdbRating": 8.5,
        "year": 2024
    }
}

Внешние ID и genreIds поддерживаются так же, как в оригинале.

Тестирование​

  • Обновите манифест ресурсом meta
  • Добавьте кастомный элемент в каталог
  • Создайте JSON метаданных
  • Переустановите дополнение и проверьте, что детали отображаются