Вы загрузили сферическое фото на Facebook или YouTube, а сервис показывает его как обычную плоскую картинку без возможности вращения — почти наверняка в файле отсутствуют метаданные 360°, и именно эту задачу решает Spatial Media Metadata Injector. Это небольшая утилита, которая вписывает в медиафайл специальные теги, сообщающие платформам: «это панорама, показывай её в интерактивном режиме».
Инструмент распространяется как проект с открытым исходным кодом и изначально был опубликован командой Google на GitHub. Он работает с фотографиями в формате JPEG и видео в контейнере MP4, добавляя данные по открытым спецификациям: для фото — через XMP-разметку, для видео — через атомы метаданных внутри контейнера. Ниже разберём, как пользоваться программой, какие настройки выбирать и что делать, если платформа всё равно не видит панораму.
Что такое метаданные 360° и зачем они нужны
Сама по себе сферическая панорама — это обычное изображение в эквидистантной проекции (equirectangular), где сфера «развёрнута» в прямоугольник с соотношением сторон 2:1. Плеер или соцсеть не может отличить такую картинку от обычной фотографии по внешнему виду — для этого нужна служебная пометка.
Эту пометку и добавляет инжектор: набор полей, указывающих тип проекции, полный охват по горизонтали и вертикали, а также начальную точку обзора. Без этих полей платформа просто не знает, что файл нужно рендерить как интерактивную сферу.
- 📷 ProjectionType — тип проекции, как правило equirectangular;
- 🌐 FullPanoWidth / FullPanoHeight — полные размеры сферы в пикселях;
- 🎯 PoseHeadingDegrees — направление начального взгляда зрителя;
- 🎬 для видео — флаг сферического контента внутри MP4-контейнера.
Где скачать и как установить Spatial Media Metadata Injector
Официальный источник — репозиторий проекта spatial-media на GitHub. Программа написана на Python, поэтому для запуска графической версии вам понадобится установленный интерпретатор Python соответствующей версии — требования указаны в описании репозитория, сверяйтесь именно с ним, так как зависимости могут меняться.
Есть два варианта работы: графический интерфейс (запускается файлом gui.py) и консольная утилита spatialmedia, удобная для пакетной обработки. Графическая версия подходит для разовых задач, консольная — если нужно обработать десятки файлов одной командой.
Пошаговая инструкция: добавление метаданных в фото 360°
Откройте программу, нажмите кнопку открытия файла и укажите путь к вашей панораме в формате JPEG. Утилита прочитает существующие метаданные и покажет, есть ли уже пометка о сферичности.
Далее отметьте чекбокс My image is spherical (360) и нажмите кнопку инжекции. Программа создаст рядом новый файл — как правило, с добавлением injected в имени. Исходник при этом не изменяется.
☑️ Проверка перед загрузкой панорамы
После обработки загрузите полученный файл на нужную платформу. Если всё сделано верно, Facebook распознает фото как 360° автоматически — при публикации появится характерный значок компаса.
Инжекция метаданных в видео 360°
С видео процедура аналогична, но есть нюанс: поддерживаются файлы MP4, и обработка больших роликов занимает заметное время, поскольку утилита переписывает структуру контейнера. Откройте видеофайл, отметьте опцию сферического видео и при необходимости включите режим 3D сверху-вниз (top-bottom), если ролик стереоскопический.
Для консольной обработки используется команда вида:
python spatialmedia -i input.mp4 output_injected.mp4Флаг -i указывает на режим инжекции. Для стереоскопического видео добавляется отдельный параметр — точный синтаксис смотрите в справке утилиты (--help), так как он может отличаться между версиями.
⚠️ Внимание: инжекция метаданных не превращает обычное видео в 360°. Если исходник снят обычной камерой, пометка лишь сломает отображение — платформа попытается «растянуть» плоский кадр на сферу.
Сравнение способов добавления метаданных 360°
Spatial Media Metadata Injector — не единственный способ пометить панораму. Некоторые камеры (например, 360-камеры Ricoh Theta или Insta360) вписывают метаданные автоматически при съёмке, а часть редакторов умеет экспортировать уже «помеченные» файлы.
| Способ | Подходит для | Ограничения |
|---|---|---|
| Spatial Media Metadata Injector | Фото и видео из любых источников | Требует Python, ручная обработка |
| Метаданные из камеры 360° | Файлы прямо с устройства | Теряются при перекодировании в редакторах |
| Экспорт из видеоредактора | Смонтированные ролики | Зависит от поддержки в конкретной программе |
| Консольный режим spatialmedia | Пакетная обработка | Нужны базовые навыки командной строки |
Ключевая ловушка: многие видеоредакторы при экспорте стирают сферические метаданные, даже если они были в исходнике. Поэтому инжекцию правильно выполнять последним шагом — уже после финального рендера.
Типичные ошибки и их решение
Самая частая жалоба — «после инжекции YouTube всё равно не показывает 360°». Возможные причины: обработка ролика на стороне платформы ещё не завершилась (для сферических видео распознавание может занимать заметное время после загрузки), либо файл был повторно перекодирован уже после инжекции.
- 🔁 Проверьте, что загружали именно обработанный файл с суффиксом
injected, а не исходник; - ⏳ Дождитесь полной обработки видео на платформе — интерактивный режим включается не мгновенно;
- 📐 Убедитесь, что кадр действительно в эквидистантной проекции с соотношением 2:1;
- 🧪 Проверьте файл повторным открытием в инжекторе — он покажет, есть ли метаданные.
⚠️ Внимание: не прогоняйте файл через инжектор дважды «для надёжности». Если метаданные уже присутствуют, повторная обработка не нужна — сначала проверьте файл функцией чтения метаданных в самой утилите.
Альтернативы и смежные инструменты
Если графический инжектор по какой-то причине не подходит, метаданные XMP для фото можно добавить через ExifTool — универсальную консольную утилиту для работы с метаданными. Это требует точного указания полей и значений, поэтому способ ориентирован на опытных пользователей.
Для просмотра результата на компьютере перед публикацией подойдут плееры с поддержкой сферического видео — например, VLC умеет воспроизводить 360°-контент с интерактивным вращением. Это удобный способ убедиться, что панорама сшита корректно, ещё до загрузки.
Как проверить метаданные без инжектора
Откройте файл в ExifTool или в самом инжекторе — он умеет читать и отображать существующие сферические теги. Для видео наличие метаданных также можно косвенно проверить, загрузив ролик в VLC: если плеер автоматически включил режим 360°, метаданные на месте.
FAQ: частые вопросы
Изменяет ли инжектор качество фото или видео?
Нет. Утилита дописывает только служебные метаданные и не перекодирует само изображение или видеопоток, поэтому качество контента остаётся исходным.
Почему Facebook не распознаёт моё фото как 360°?
Проверьте, что загружали обработанный файл, а не оригинал, и что соотношение сторон панорамы — 2:1. Также метаданные могут теряться, если фото прошло через редактор или мессенджер уже после инжекции.
Можно ли обработать сразу несколько файлов?
Да, для этого предназначен консольный режим утилиты — его можно вызвать в цикле или скрипте для пакетной обработки. Графическая версия работает с одним файлом за раз.
Работает ли инжектор с видео не в формате MP4?
Надёжно поддерживается контейнер MP4. Файлы в других контейнерах предварительно конвертируйте в MP4 любым кодировщиком, а инжекцию выполняйте уже после конвертации.
Нужно ли удалять метаданные 360°, если панорама неполная?
Если панорама не покрывает полную сферу, это задаётся соответствующими полями охвата (CroppedArea), а не удалением метаданных. Точные параметры зависят от спецификации платформы — сверяйтесь с её документацией для частичных панорам.