Поделиться через


Image Класс

Описание основных свойств для создания эскизов из входного видео.

Вероятно, вы хотите использовать подклассы, а не этот класс напрямую. Известные подклассы: JpgImage, PngImage

Для отправки в Azure необходимо заполнить все необходимые параметры.

Наследование
azure.mgmt.media.models._models_py3.Video
Image

Конструктор

Image(*, start: str, label: str | None = None, key_frame_interval: timedelta | None = None, stretch_mode: str | _models.StretchMode | None = None, sync_mode: str | _models.VideoSyncMode | None = None, step: str | None = None, range: str | None = None, **kwargs)

Параметры Keyword-Only

Имя Описание
label
str

Необязательная метка для кодека. Метку можно использовать для управления поведением мультиплексирования.

key_frame_interval

Расстояние между двумя ключевыми кадрами. Значение должно быть ненулевым в диапазоне [0,5, 20] секунд, указанном в формате ISO 8601. Значение по умолчанию — 2 секунды (PT2S). Обратите внимание, что этот параметр игнорируется, если задан параметр VideoSyncMode.Passthrough, где значение KeyFrameInterval будет следовать за параметром источника входных данных.

stretch_mode
str или StretchMode

Режим изменения размера — изменение размера входного видео в соответствии с требуемым разрешением вывода. Значение по умолчанию — AutoSize. Известные значения: None, AutoSize и AutoFit.

sync_mode

Режим синхронизации видео. Известные значения: "Auto", "Passthrough", "Cfr" и "Vfr".

start
str

Позиция во входном видео, с которого начинается создание эскизов. Значение может быть в формате ISO 8601 (например, PT05S начнет процесс на 5 секундах), в количестве кадров (например, значение 10 начнет захват на 10-м кадре) или в относительном значении по отношению к продолжительности потоковой передачи (например 10 % начнет процесс на 10 % длительности передачи). Также поддерживается макрос {Best}, который указывает кодирующему устройству выбрать лучший эскиз из первых нескольких секунд видео и создать только один эскиз независимо от других настроек, установленных для параметров шага и диапазона. Значение по умолчанию — макрос {Best}. Обязательный.

step
str

Интервалы, с которыми создаются эскизы. Значение может быть в формате ISO 8601 (например, PT05S для одного изображения каждые 5 секунд), количество кадров (например, 30 для одного изображения каждые 30 кадров) или относительное значение длительности потока (например, 10 % для одного изображения каждые 10 % продолжительности потока). Примечание. Значение шага повлияет на первый созданный эскиз, который может отличаться от указанного в предустановленное время начала преобразования. Это связано с тем, что кодировщик пытается выбрать лучший эскиз между временем начала и положением шага от времени начала в качестве первого выходных данных. Так как значение по умолчанию равно 10 %, это означает, что если поток имеет длинную длительность, первый созданный эскиз может находиться далеко от указанного во время запуска. Попробуйте выбрать разумное значение для шага, если ожидается, что первый эскиз близок к времени начала, или задайте значение Range равным 1, если во время начала требуется только один эскиз.

range
str

Позиция относительно предустановленного времени начала преобразования во входном видео, при котором прекращается создание эскизов. Значение может быть в формате ISO 8601 (например, PT5M30S для остановки в 5 минутах и 30 секундах от времени начала) или число кадров (например, 300 для остановки на 300-м кадре от кадра во время начала). Если это значение равно 1, это означает создание только одного эскиза во время начала) или относительное значение длительности потока (например, 50 % для остановки на половине длительности потока с момента начала). Значение по умолчанию — 100 %, значит, остановка будет в конце потоковой передачи.

Переменные

Имя Описание
odata_type
str

Дискриминатор для производных типов. Обязательный.

label
str

Необязательная метка для кодека. Метку можно использовать для управления поведением мультиплексирования.

key_frame_interval

Расстояние между двумя ключевыми кадрами. Значение должно быть ненулевым в диапазоне [0,5, 20] секунд, указанном в формате ISO 8601. Значение по умолчанию — 2 секунды (PT2S). Обратите внимание, что этот параметр игнорируется, если задан параметр VideoSyncMode.Passthrough, где значение KeyFrameInterval будет следовать за параметром источника входных данных.

stretch_mode
str или StretchMode

Режим изменения размера — изменение размера входного видео в соответствии с требуемым разрешением вывода. Значение по умолчанию — AutoSize. Известные значения: None, AutoSize и AutoFit.

sync_mode

Режим синхронизации видео. Известные значения: "Auto", "Passthrough", "Cfr" и "Vfr".

start
str

Позиция во входном видео, с которого начинается создание эскизов. Значение может быть в формате ISO 8601 (например, PT05S начнет процесс на 5 секундах), в количестве кадров (например, значение 10 начнет захват на 10-м кадре) или в относительном значении по отношению к продолжительности потоковой передачи (например 10 % начнет процесс на 10 % длительности передачи). Также поддерживается макрос {Best}, который указывает кодирующему устройству выбрать лучший эскиз из первых нескольких секунд видео и создать только один эскиз независимо от других настроек, установленных для параметров шага и диапазона. Значение по умолчанию — макрос {Best}. Обязательный элемент.

step
str

Интервалы, с которыми создаются эскизы. Значение может быть в формате ISO 8601 (например, PT05S для одного изображения каждые 5 секунд), количество кадров (например, 30 для одного изображения каждые 30 кадров) или относительное значение длительности потока (например, 10 % для одного изображения каждые 10 % продолжительности потока). Примечание. Значение шага повлияет на первый созданный эскиз, который может отличаться от указанного в предустановленное время начала преобразования. Это связано с тем, что кодировщик пытается выбрать лучший эскиз между временем начала и положением шага от времени начала в качестве первого выходных данных. Так как значение по умолчанию равно 10 %, это означает, что если поток имеет длинную длительность, первый созданный эскиз может находиться далеко от указанного во время запуска. Попробуйте выбрать разумное значение для шага, если ожидается, что первый эскиз близок к времени начала, или задайте значение Range равным 1, если во время начала требуется только один эскиз.

range
str

Позиция относительно предустановленного времени начала преобразования во входном видео, при котором прекращается создание эскизов. Значение может быть в формате ISO 8601 (например, PT5M30S для остановки в 5 минутах и 30 секундах от времени начала) или число кадров (например, 300 для остановки на 300-м кадре от кадра во время начала). Если это значение равно 1, это означает создание только одного эскиза во время начала) или относительное значение длительности потока (например, 50 % для остановки на половине длительности потока с момента начала). Значение по умолчанию — 100 %, значит, остановка будет в конце потоковой передачи.