Vanessa Automation. Как начать создавать видеоинструкции
Автоматические видеоинструкции на основе сценариев тестирования поражают воображение. Но многие сталкиваются с проблемами при попытке создать собственные фичи для видео. В ходе мастер класса на онлайн-митапе «DevOps в 1С» Светлана Попова рассмотрела особенности создания видеоинструкций с помощью Vanessa Automation для SikuliX и веб-клиента. И рассказала, какие подводные камни нужно учесть при их написании.
- Описание
- Подробнее
Описание
Конечно, видеоинструкции – это не то, с чего мы начинаем тестирование. В первую очередь мы пишем сценарии для тестирования бизнес-процессов. А видеоинструкции – это, скорее, приятное дополнение.
Хотя по созданию видеоинструкций есть статьи на Инфостарте, все равно возникают вопросы по тому, как начать, какое программное обеспечение нужно, какие есть фишки. Все познается в работе. Так же, как и со сценариями тестирования, вначале будет тяжело, но, набивая руку, дальнейшее создание видеоинструкций становится более простым.
Зачем писать видеоинструкции
Во-первых, это стильно, модно, молодежно.
В наш век никто не хочет писать документацию – сейчас актуален тренд, что все хотят смотреть видео на YouTube. И в целом, Vanessa Automation предоставляет такую возможность – ваши сценарии для тестирования бизнес-процессов можно легко перевести в видео и показать пользователям.
Важная особенность – то, что автоматические видеоинструкции легко перезаписать. Если у вас меняется сценарий тестирования, добавляются новые реквизиты (какая-то галочка, включение которой нужно показать), вам не нужно самому перезаписывать это видео целиком – вы вставили шаги, запустили сценарий, и видео готово.
ПО для видеоинструкций

У меня есть проект на GitHub, в котором я собрала сценарии и настройки, которые я буду показывать в сегодняшнем докладе, чтобы вы могли скачать, посмотреть, попробовать.
В репозитории есть файлик со списком ПО. Обратите внимание, что для некоторых продуктов в этом списке критично скачивать конкретные версии, потому что не все последние версии поддерживаются для создания видеоинструкций.
Главная ссылка ведет на репозиторий Vanessa Automation. Вы можете скачать собранный фреймворк из релизов репозитория или, если хотите получить самые новые возможности, скачайте архив из ветки develop и с помощью compile.bat запустите сборку обработки. После обработки скрипта будет собрана обработка и все вспомогательные файлы.
Все свои вопросы по видеоинструкциям вы можете задавать в чате по тестированию в 1С. Там обсуждается не только Vanessa Automation, но и Vanessa ADD, Тестер и другие инструменты тестирования.
Для работы с видеоинструкциями вам также понадобится OneScript – его нужно установить и указать путь к нему в переменную PATH.
ImageMagick – здесь указана ссылка, где можно скачать релизы. Необходимо, чтобы в названии пакета было указано dll – только в такой версии есть все нужные компоненты для видеоинструкций. При установке важно поставить галочки «Install FFmpeg» и «Install legacy utilities», чтобы были установлены утилиты ffmpeg и convert. Также при установке нужно поставить галочку «Add application directory to your system path», чтобы путь к ImageMagick прописался в переменную среды PATH.
Нужна VLC версии 2.1.5 или версии 3.0.2 и выше. Было несколько релизов VLC (2.2, 3.0.0 и 3.0.1), которые выдавали ошибку при записи видео – на них видеоинструкции работать не будут.
Для работы SikuliX нам понадобится Java. У меня стоит Liberika. Можно использовать любую. Необходимо прописать путь к Java в переменную среды PATH.
SikuliX для записи видеоинструкций должен быть именно версии 1.1. Версия 2.х не работает. Скачивается SikuliX в виде jar-файла. Для его установки нужно выполнить команду java -jar sikulixsetup-1.1.3.jar. При установке нужно поставить галочку для варианта использования Pack1 и дополнительно поставить галочку Python (Juthon) (default) – о том, что вы собираетесь использовать Python, как скриптовый язык. Дальше все по умолчанию.
Для озвучки текста нужно зарегистрироваться либо на Yandex Speech Kit, либо на Amazon Polly. Я использую Yandex Speech Kit – на мой взгляд, там самый лучший русский язык. Те голоса, которые предоставляет Amazon Polly, по-русски говорят с небольшим акцентом – это смотрится не очень хорошо. Зато у Amazon Polly большой выбор других языков. Они как раз с акцентами, которые отредактированы под этническую принадлежность говорящего, поэтому, если вы записываете видеоинструкцию для иностранных пользователей, лучше использовать Amazon Polly.
По сценариям, которые я буду показывать, я записала несколько видео на YouTube – ссылки на них также есть в репозитории на GitHub, вы можете посмотреть, что получилось.
И здесь также приведены ссылки на статьи Инфостарта по настройке видеоинструкций – частично я сейчас буду на информацию из них ссылаться, но в целом, собираюсь рассказать больше, чем там есть.
Настройки Vanessa Automation

Давайте теперь перейдем непосредственно к настройкам.
На закладке Сервис в обработке Vanessa Automation мы:
устанавливаем флаг «Создавать видеоинструкцию»;
указываем каталог для видеоинструкции, в который у нас будут записываться промежуточные файлы и сгенерированное видео – оттуда его нужно копировать, потому что каждый раз при запуске сценариев оно будет затираться;
указываем каталог проекта;
часть настроек для видео можно заполнить, нажав кнопку «Загрузить настройки по умолчанию». После заполнения, настройки можно отредактировать – например, если у вас ImageMagick другой версии, укажите путь к нему;
и, я рекомендую, если вы используете видеовставки, кешировать видеовставки – это ускоряет сборку видео. Первый раз оно будет собираться долго, но в следующие разы гораздо быстрее.

Перейдем к вкладке «Страница аудио». Здесь мы как раз выбираем, какой вид озвучки мы будем использовать:
Microsoft
Yandex
Amazon Polly.
Как я уже говорила, я использую Yandex. У него есть триальный период два месяца, и потом совсем небольшая оплата за количество слов, которое вы озвучиваете – в целом получается не очень дорого.
Что здесь можно выбрать:
язык;
голос, которым будет идти озвучка – по умолчанию Vanessa Automation, если вы смотрели ролики на YouTube по работе с ней, говорит голосом Оксана (oksana);
эмоцию, с которой будет говорить голос;
можно установить скорость произнесения;
также вам понадобится идентификатор каталога сайта Yandex Speech Kit и токен доступа к нему;
желательно установить флаг «Кэшировать файлы TTS» – кэш аудио даже более важен, чем кэш видео, чтобы не платить лишние деньги за синтез голоса, этот флаг лучше устанавливать;
и очень хорошая возможность – это тест голоса. Чтобы не прогонять сценарий и потом в результирующем видео не смотреть, что получилось, можно здесь вбивать короткие фразы, слова – смотреть, как это произносится. Это может быть полезно, если нужно подобрать правильное ударение для произношения – как менять ударение в словах, я вам тоже покажу.
с помощью поля «Каталог музыки» можно задавать подложку из музыки, регулируя ее громкость, чтобы видеоинструкции смотрелись более красиво.

Вот наш сценарий. Он предназначен для создания партнера в конфигурации «Управление торговлей 11» – мы создаем партнера и создаем к нему контрагента. Сценарий достаточно простой, чтобы видео не были очень длинные.


