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

Основные возможности

Основные свойства устройства​

ТипУстройства (DeviceType)​

Тип текущего устройства, с которым работает компонента.

Тип: Строка

Возможные значения:

  • VIDEODEVICE (синонимы: VIDEO, WEBCAMERA, WEB) — веб-камеры, сканеры и прочие видео устройства
  • IPCAMERA (синоним: IP) — IP-камеры, IP-видео серверы, RTSP-потоки
  • SCREEN (синонимы: SCREENRECORDING, SCREENREC) — запись экрана монитора

Пример:

Камера.ТипУстройства = "VIDEODEVICE";
Камера.ТипУстройства = "IPCAMERA";
Камера.ТипУстройства = "SCREEN";

ВидеоУстройство (VideoDevice)​

Текущее видео устройство при выборе типа VIDEODEVICE.

Тип: Число (порядковый номер устройства)

Возвращает: Номер выбранного видео устройства

Примечание: Используется вместе со свойством ВидеоУстройства() для получения списка доступных устройств.

ВидеоУстройствоСтрокой (VideoDeviceString)​

То же самое, что ВидеоУстройство, но значение передаётся строкой с описанием устройства.

Тип: Строка

Пример:

Камера.ВидеоУстройствоСтрокой = "USB 2.0 Camera";

АудиоУстройство (AudioDevice)​

Текущее аудио устройство для захвата звука.

Тип: Число (порядковый номер устройства)

Примечание: Выбирается из списка, полученного методом АудиоУстройства().

АудиоУстройствоСтрокой (AudioDeviceString)​

Аудио устройство, переданное строкой с описанием.

Тип: Строка

Пример:

Камера.АудиоУстройствоСтрокой = "Микрофон (High Definition Audio)";

IP-камеры​

АдресIPКамеры (IPCameraURL)​

Адрес IP-камеры или потока при выборе типа устройства IPCAMERA.

Тип: Строка

Формат: HTTP, RTSP или RTMP адрес

Пример:

Камера.АдресIPКамеры = "http://192.168.1.100:8080/stream";
Камера.АдресIPКамеры = "rtsp://камера.example.com/stream";

ТипАутентификацииIPКамеры (IPCameraAuthenticationType)​

Тип аутентификации для доступа к защищённой IP-камере.

Тип: Число

Возможные значения:

  • 0 — Публичная точка Windows Media Server
  • 1 — IP-камера (по умолчанию)
  • 2 — Потоковое видео

ИмяПользователяIPКамеры (IPCameraUserName)​

Имя пользователя для аутентификации на IP-камере.

Тип: Строка

Используется: Когда доступ к IP-камере защищён логином и паролем.

ПарольIPКамеры (IPCameraPassword)​

Пароль для аутентификации на IP-камере.

Тип: Строка

Используется: Когда доступ к IP-камере защищён логином и паролем.

Видео параметры​

ВидеоРазмер (VideoSize)​

Разрешение видео и фотографий.

Тип: Число (порядковый номер размера)

Возвращает: Номер выбранного разрешения

Примечание: Выбирается из списка, полученного методом ВидеоРазмеры().

Типичные разрешения:

  • 160x120
  • 320x240
  • 640x480
  • 800x600
  • 1280x720
  • 1920x1080

ВидеоРазмерСтрокой (VideoSizeString)​

Разрешение видео, переданное строкой.

Тип: Строка

Пример:

Камера.ВидеоРазмерСтрокой = "1920x1080";

ВидеоКомпрессор (VideoCompressor)​

Видео кодек для сжатия видео при записи.

Тип: Число (порядковый номер кодека)

Возвращает: Номер выбранного кодека

Примечание: Выбирается из списка, полученного методом ВидеоКомпрессоры().

ВидеоКомпрессорСтрокой (VideoCompressorString)​

Видео кодек, переданный строкой.

Тип: Строка

Примеры кодеков:

  • Xvid MPEG-4 Codec
  • MJPEG Compressor
  • Intel IYUV
  • Microsoft RLE

ФорматИзображения (ImageFormat)​

Формат сохраняемых изображений.

Тип: Строка

Возможные значения:

  • BMP — точечный рисунок
  • PNG — с поддержкой прозрачности (по умолчанию)
  • JPEG — сжатый формат
  • GIF — анимированный формат

Пример:

Камера.ФорматИзображения = "PNG";

Аудио параметры​

АудиоКомпрессор (AudioCompressor)​

Аудио кодек для сжатия звука при записи видео.

Тип: Число (порядковый номер кодека)

Возвращает: Номер выбранного кодека

Примечание: Выбирается из списка, полученного методом АудиоКомпрессоры().

АудиоКомпрессорСтрокой (AudioCompressorString)​

Аудио кодек, переданный строкой.

Тип: Строка

Примеры кодеков:

  • PCM
  • IMA ADPCM
  • Microsoft ADPCM
  • LAME Audio Encoder

ЗаписыватьЗвук (AudioRecording)​

Включить запись звука при записи видео.

Тип: Булево

По умолчанию: Ложь

Пример:

Камера.ЗаписыватьЗвук = Истина;

АудиоИсточник (AudioSource)​

Тип источника звука.

Тип: Число

Возможные значения:

  • 0 — Использовать аудио выход видео устройства (если доступно), иначе текущее устройство записи звука
  • 1 — Использовать внешнее устройство записи звука

АудиоГромкость (AudioVolume)​

Громкость звука текущего аудио устройства.

Тип: Число (от 1 до 65536)

ВизуализироватьЗвуковойПоток (AudioDeviceRendering)​

Визуализировать звуковой поток во время предварительного просмотра или записи.

Тип: Булево

По умолчанию: Ложь

Параметры файлов​

ИмяФайла (FileName)​

Имя файла для записи или чтения изображений и видео.

Тип: Строка

Особенности:

  • Используется при записи видео для установки или извлечения имени файла
  • Если файл существует, он будет перезаписан
  • Если оставлено пустым, имя генерируется автоматически

Пример:

Камера.ИмяФайла = "C:\Videos\my_video.avi";

ПутьКХранилищу (StoragePath)​

Путь к папке для сохранения фото и видео при автоматическом генерировании имён.

Тип: Строка

Пример:

Камера.ПутьКХранилищу = "C:\Videos\";

АвтоИмяФайла (AutoFileName)​

Формат автоматического генерирования имён файлов.

Тип: Число

Возможные значения:

  • 0 — Имя на основе порядкового номера (file000001.avi, file000002.avi и т.д.)
  • 1 — Имя на основе даты и времени (file160401_102453_904.jpg и т.д.)
  • 2 — Как вариант 1, но перезаписывает существующие файлы

По умолчанию: 0

АвтоПрефиксФайла (AutoFilePrefix)​

Префикс для автоматического генерирования имён файлов.

Тип: Строка

По умолчанию: "file"

Пример:

Камера.АвтоПрефиксФайла = "запись";
// Создаст файлы: запись000001.avi, запись000002.avi и т.д.

РасширениеФайлаЗахвата (CaptureFileExt)​

Расширение файла для автоматически генерируемых имён.

Тип: Строка

По умолчанию: "avi"

Возможные значения:

  • avi — стандартный видео формат
  • mpg — MPEG формат
  • Оставить пустым для автоматического определения

АвтоФорматДатаВремяФайла (AutoFileNameDateTimeFormat)​

Формат даты и времени для имён файлов при автоматическом генерировании.

Тип: Строка

По умолчанию: "yymmdd_hhmmss"

Пример:

Камера.АвтоФорматДатаВремяФайла = "yyyy-mm-dd_hh-nn-ss";
// Создаст имена вида: file2025-12-11_11-42-30.avi

АвтоФорматМинимальноеЧислоЦифрФайла (AutoFileNameMinDigits)​

Минимальное число цифр в порядковом номере автоматического имени файла.

Тип: Число

По умолчанию: 6

Пример:

Камера.АвтоПрефиксФайла = "file";
Камера.АвтоФорматМинимальноеЧислоЦифрФайла = 6;
// Создаст: file000001.avi, file000002.avi

Обрезка видео​

Обрезка (Cropping)​

Включить или отключить обрезку кадров фото и видео.

Тип: Булево

По умолчанию: Ложь

ОбрезкаВерх (CroppingTop)​

Верхняя координата точки обрезки в пикселях.

Тип: Число

По умолчанию: 0

ОбрезкаЛево (CroppingLeft)​

Левая координата точки обрезки в пикселях.

Тип: Число

По умолчанию: 0

ОбрезкаШирина (CroppingWidth)​

Ширина области обрезки в пикселях (начиная от ОбрезкаЛево).

Тип: Число

ОбрезкаВысота (CroppingHeight)​

Высота области обрезки в пикселях (начиная от ОбрезкаВерх).

Тип: Число

Оверлей (логотип и текст)​

ОверлейноеИзображениеВидимость (OverlayImageVisible)​

Выводить логотип или водяной знак на видео.

Тип: Булево

По умолчанию: Ложь

ОверлейноеИзображениеЛево (OverlayImageLeft)​

Левая координата логотипа в пикселях.

Тип: Число

По умолчанию: 10

ОверлейноеИзображениеВерх (OverlayImageTop)​

Верхняя координата логотипа в пикселях.

Тип: Число

По умолчанию: 10

ОверлейноеИзображениеШирина (OverlayImageWidth)​

Ширина логотипа в пикселях.

Тип: Число

По умолчанию: 100

ОверлейноеИзображениеВысота (OverlayImageHeight)​

Высота логотипа в пикселях.

Тип: Число

По умолчанию: 100

ОверлейноеИзображениеПрозрачность (OverlayImageAlphaBlend)​

Использовать прозрачность логотипа.

Тип: Булево

По умолчанию: Ложь

ОверлейноеИзображениеЗначениеПрозрачности (OverlayImageAlphaBlendValue)​

Степень прозрачности логотипа.

Тип: Число (от 0 до 255)

Значения:

  • 0 — полностью непрозрачно
  • 255 — максимально прозрачно

ОверлейноеИзображениеУголПоворота (OverlayImageRotationAngle)​

Угол поворота логотипа в градусах.

Тип: Вещественное число (от 0.0 до 360.0)

ОверлейноеИзображениеРастягиватьПоВидеоРазмеру (OverlayImageStretchToVideoSize)​

Растянуть логотип по всему размеру видео.

Тип: Булево

По умолчанию: Ложь

Используется с: ОверлейноеИзображениеПрозрачность и ОверлейноеИзображениеЗначениеПрозрачности

ОверлейныйТекстВидимость (OverlayTextVisible)​

Выводить текстовый оверлей на видео.

Тип: Булево

По умолчанию: Ложь

ОверлейныйТекст (OverlayText)​

Текст для вывода на видео. Поддерживает специальные переменные.

Тип: Строка

Специальные переменные:

  • %sys_time[dd.mm.yy hh:nn:ss]% — текущая системная дата и время
  • %frame_count% — количество кадров
  • %time_full% — время в текущем кадре (hh:mm:ss:cc)
  • %time_sec% — время в секундах с 2 десятичными знаками
  • %time_100ns% — время в единицах 100 наносекунд

Пример:

Камера.ОверлейныйТекст = "Запись: %sys_time[dd.mm.yy hh:nn:ss]% Кадр: %frame_count%";

ОверлейныйТекстШрифт (OverlayTextFontName)​

Название шрифта для текстового оверлея.

Тип: Строка

По умолчанию: "Verdana"

ОверлейныйТекстРазмерШрифта (OverlayTextFontSize)​

Размер шрифта для текстового оверлея.

Тип: Число

По умолчанию: 14

ОверлейныйТекстЦветШрифта (OverlayTextFontColor)​

Цвет текста в формате #RRGGBB.

Тип: Строка

Примеры:

  • #FF0000 — красный
  • #00FF00 — зелёный
  • #0000FF — синий
  • #FFFFFF — белый
  • #000000 — чёрный
  • #FFE97F — жёлтый

ОверлейныйТекстЛево (OverlayTextLeft)​

Левая координата текстового оверлея в пикселях.

Тип: Число

По умолчанию: 0

ОверлейныйТекстВерх (OverlayTextTop)​

Верхняя координата текстового оверлея в пикселях.

Тип: Число

По умолчанию: 0

Детектор движения​

ДетекторДвиженияВключен (MotionDetectorEnabled)​

Включить или отключить детектор движения.

Тип: Булево

По умолчанию: Ложь

ДетекторДвиженияСетка (MotionDetectorGrid)​

Конфигурация сетки детектора движения.

Тип: Строка

Описание: Сетка представляет матрицу, где каждое число (0-9) указывает чувствительность в этой ячейке. Числа разделены пробелами, строки разделены пробелами.

Пример 2x2 сетки:

"0 6
 6 6"

Каждая цифра означает:

  • 0 — без обнаружения движения
  • 1-8 — промежуточная чувствительность
  • 9 — максимальная чувствительность

Как работает: Видеокадр разбивается на равные прямоугольники в соответствии с размерностью сетки, каждая ячейка обрабатывается отдельно с заданной чувствительностью.

ДетекторДвиженияМакисмумДвиженийОбнаруженныхВСекунду (MotionDetectorMaxDetectionsPerSecond)​

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

Тип: Число

Таймер записи​

ТаймерЗаписи (RecordingTimer)​

Включить запись по таймеру.

Тип: Число

Возможные значения:

  • 0 — отключено (по умолчанию)
  • 1 — новый файл записи генерируется каждые N секунд (задано в ИнтервалТаймераЗаписи)
  • 2 — запись прекращается через N секунд
  • 3 — запись начинается в режиме предпросмотра через N секунд

ИнтервалТаймераЗаписи (RecordingTimerInterval)​

Интервал времени для таймера записи в секундах.

Тип: Число

СоздаватьНовыйФайлПриПаузеВЗаписи (RecordingPauseCreatesNewFile)​

Создавать новый файл каждый раз при паузе записи.

Тип: Булево

По умолчанию: Ложь

Как работает: При вызове ПаузаЗаписи создаётся новый файл, при ПродолжитьЗапись кадры записываются в новый файл без потерь.

Специальные параметры​

ПаузаМс (PauseMs)​

Пауза в миллисекундах при создании фото для стабилизации изображения.

Тип: Число

По умолчанию: 1500 (1.5 секунды)

Назначение: После инициализации веб-камеры изображение может быть искажено. Задержка позволяет картинке принять нормальный вид.

ПредварительныйПросмотр (Preview)​

Использовать предварительный просмотр при создании фото или записи видео.

Тип: Булево

По умолчанию: Истина

Примечание: Используется с методом ПолучитьКадр. Если отключено, делается пауза на ПаузаМс миллисекунд для стабилизации.

ПоверхВсехОкон (StayOnTop)​

Выводить окна предпросмотра поверх всех окон.

Тип: Булево

По умолчанию: Ложь

ЭкранМонитораЗаписи (ScreenRecordingMonitor)​

Номер экрана монитора при записи экрана.

Тип: Число

По умолчанию: 0 (первый монитор)

Значения:

  • 0 — первый монитор
  • 1 — второй монитор
  • -1 — весь расширенный рабочий стол на всех мониторах

КачествоJPEG (QualityJPEG)​

Качество JPEG при сохранении изображений.

Тип: Число (от 1 до 100)

По умолчанию: 85

Логирование и активация​

ВестиЛог (UseLog)​

Вести логирование всех событий компоненты.

Тип: Булево

По умолчанию: Ложь

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

ИмяЛогФайла (LogFileName)​

Имя файла логов, если ведётся логирование.

Тип: Строка

КлючАктивации (ActivationKey)​

Ключ активации компоненты.

Тип: Строка

Используется: Вместе со свойством ИдентификаторКомпьютера для активации компоненты.

ТекущаяКамера (CurrentCamera)​

Номер текущей камеры для работы.

Тип: Число

По умолчанию: 0

Примечание: После инициализации одна камера создаётся автоматически. Используйте функцию ДобавитьКамеру() для добавления других камер.

Пример:

// Добавить две камеры
камера1 = Камера.ДобавитьКамеру();
камера2 = Камера.ДобавитьКамеру();

// Переключиться на первую камеру
Камера.ТекущаяКамера = камера1;