Руководство по форматам

Lottie в TGS: руководство по совместимости

Работающая Lottie-анимация сама по себе не подтверждает совместимость с Telegram. Проверьте её возможности до создания TGS.

Проверить готовый TGS

Это руководство не импортирует Lottie JSON. Проверка по ссылке принимает готовые файлы .tgs.

Отделите анимацию от её упаковки

Lottie JSON описывает формы, слои, преобразования и время. В TGS содержится JSON анимации для Telegram, сжатый gzip. Сжатие меняет способ хранения данных, но не заменяет неподдерживаемый слой, не восстанавливает отсутствующую картинку и не исправляет движение.

Этот сайт не импортирует произвольный Lottie JSON и не конвертирует загруженный JSON в TGS. Если у вас есть исходный проект анимации, исправьте совместимость в его редакторе и используйте экспортёр TGS для этого процесса. Полученный TGS можно проверить нашим инструментом.

Что проверить до сжатия

Telegram указывает холст 512 × 512, цикл до трёх секунд, 60 FPS и готовый файл не больше 64 КБ. Объекты должны оставаться в пределах холста. В опубликованных ограничениях также перечислены изображения, живой текст, маски, эффекты слоёв и выражения.

Успешное воспроизведение в Lottie-плеере не доказывает выполнение этих требований. Посмотрите исходный проект и экспортированные данные, особенно если анимация создавалась для сайта и использовала внешние ресурсы.

Сравните читаемый JSON с его TGS

Ниже доступна программно созданная учебная пара: pulse-circle.lottie.json и pulse-circle.tgs. В примере один слой с фигурой и двухсекундное изменение масштаба. TGS занимает 394 байта; после распаковки он содержит те же данные анимации, что и читаемый JSON.

Эта пара показывает связь форматов. Маленький размер и простые возможности образца не означают, что любой другой JSON заработает после gzip. Пример также не является результатом конкретного пресета нашего SVG-редактора.

Как это работает

Что делать с уже существующей анимацией

Определите, какой исходник у вас есть

Сохраните проект редактора, если он доступен. JSON не является исходным SVG, а смена расширения не превращает его в TGS.
Проверьте возможности и время

Сопоставьте слои, ресурсы, холст, частоту кадров и длительность с требованиями Telegram. Замените несовместимые эффекты в исходном проекте.
Экспортируйте подходящим инструментом

Используйте экспортёр TGS для вашего проекта. Telegram описывает Bodymovin-TG для After Effects; этот сайт не предоставляет импорт или исправление Lottie JSON.
Проверьте готовый TGS

Откройте файл .tgs в проверке: она покажет размер, время, холст и структурные замечания. Исправьте проблемы в редакторе и экспортируйте заново.
Посмотрите результат в Telegram

Оцените весь цикл и края движущихся объектов, затем попробуйте файл в @Stickers. Структурная проверка не гарантирует корректную отрисовку или принятие.

Сценарии

Где подходит этот workflow

Готовьте векторную графику для стикеров, кастомных эмодзи и брендовых наборов Telegram.

Готовый TGS уже есть

Переходите сразу к проверке файла. Загружать исходную анимацию в SVG-конвертер не требуется.

Есть JSON и исходный проект

Проверьте неподдерживаемые возможности, исправьте проект и экспортируйте из того же процесса.

Простая иконка доступна в SVG

Создайте новую анимацию из векторного исходника в поддерживаемом процессе SVG в TGS.

Формат

Альтернативный путь через SVG для простой графики

Для логотипа или символа можно экспортировать чистый SVG из исходного дизайн-редактора и создать новое движение в конвертере. Этот путь не сохраняет прежнюю временную шкалу Lottie и не извлекает её слои в SVG автоматически.

Конвертация SVG и скачивание TGS бесплатны после входа через Telegram. Диагностическая копия выбранного SVG отправляется сервису, а анимация и экспорт вычисляются в браузере. Отдельная проверка TGS не требует входа и читает выбранный TGS локально.

Советы и требования

Что не исправляется сменой упаковки

Переименование .json в .tgs не создаёт gzip-контейнер.
Сжатие gzip не превращает растровые ресурсы в векторные контуры.
Добавление маркера TGS не удаляет несовместимые возможности и не восстанавливает ссылки на ресурсы.
Смена только частоты кадров в метаданных может изменить длительность, но не пересоздаёт задуманное движение.
Сохраняйте редактируемый проект: проверка сообщает о проблемах, но не ремонтирует анимацию.

Пример SVG и готового TGS

Скачайте SVG для проверки конвертера или посмотрите небольшой пример анимированного TGS.

FAQ

Частые вопросы

Можно прямо здесь конвертировать Lottie JSON?

Нет. Это руководство по совместимости. Редактор принимает SVG, а отдельная проверка — готовый TGS. Ни один из этих инструментов не импортирует произвольный Lottie JSON для конвертации.

Можно просто сжать любой Lottie JSON через gzip?

Gzip упакует JSON, но не сделает неподдерживаемые возможности совместимыми. Сама анимация и её структура должны соответствовать требованиям целевого формата.

Почему Lottie-плеер показывает анимацию, а Telegram отклоняет её?

Плеер может поддерживать возможности, ресурсы или параметры времени, которые не подходят стикерам Telegram. Проверяйте исходный проект и TGS, а не считайте воспроизведение в другом плеере подтверждением совместимости.

Проверка конвертирует или исправляет файл?

Нет. Она исследует готовый TGS и сообщает о структурных проблемах. Она не экспортирует JSON в TGS, не исправляет контуры, не отрисовывает анимацию и не подтверждает плавность цикла.

Сохранится исходная Lottie-анимация при загрузке SVG?

Нет. SVG начинает новую анимацию в конвертере. Ключи Lottie не импортируются, поэтому для сохранения прежнего движения нужен исходный проект.

Начать

Готовый TGS уже экспортирован?

Откройте файл в проверке, затем оцените его движение и попробуйте результат в Telegram.

Проверить готовый TGS