Тип данных Video

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

Описание

Этот объект представляет собой видеофайл.

Поле Тип Описание
file_id String Идентификатор этого файла, который можно использовать для загрузки или повторного использования файла
file_unique_id String Уникальный идентификатор этого файла, который должен оставаться неизменным с течением времени и для разных ботов. Не может использоваться для загрузки или повторного использования файла.
width Integer Ширина видео, указанная отправителем
height Integer Высота видео, указанная отправителем
duration Integer Продолжительность видео в секундах, указанная отправителем
thumbnail PhotoSize Необязательный. Миниатюра видео
cover Array of PhotoSize Необязательный. Доступные размеры обложки видео в сообщении
start_timestamp Integer Необязательный. Временная метка в секундах, с которой начнется воспроизведение видео в сообщении
file_name String Необязательный. Оригинальное имя файла, указанное отправителем
mime_type String Необязательный. MIME-тип файла, указанный отправителем
file_size Integer Необязательный. Размер файла в байтах. Он может быть больше 2^31, и некоторые языки программирования могут испытывать трудности/иметь скрытые дефекты при его интерпретации. Однако он имеет не более 52 значащих битов, поэтому для хранения этого значения безопасно использовать знаковое 64-битное целое число или число двойной точности с плавающей запятой.

Примеры

json

{
  "file_id": "BAACAgIAAxkBAAIB",
  "file_unique_id": "AgADbQADWQ24Uw",
  "width": 1920,
  "height": 1080,
  "duration": 60,
  "thumbnail": {
    "file_id": "AAMCBAADGQEAAgE",
    "file_unique_id": "CQADbQADWQ24Uw",
    "width": 320,
    "height": 180,
    "file_size": 12345
  },
  "cover": [
    {
      "file_id": "AAMCBAADHQEAAgI",
      "file_unique_id": "CQADbQADWQ24Ux",
      "width": 640,
      "height": 360,
      "file_size": 45678
    }
  ],
  "start_timestamp": 10,
  "file_name": "example_video.mp4",
  "mime_type": "video/mp4",
  "file_size": 10485760
}

История изменений

  • API 4.5. Обновлен объект Video: Добавлено поле file_unique_id
  • API 5.0. Обновлен объект Video: Добавлено поле file_name
  • API 6.6. Обновлен объект Video: Переименовано поле thumb в thumbnail
  • API 8.3. Обновлен объект Video: Добавлены поля cover и start_timestamp для обложки и временной метки начала видео

Дополнительно

  • PhotoSize - Объект, представляющий один размер фотографии или миниатюры файла/стикера с метаданными файла.
Комментарии