Руководство по Autodesk Automation API: запуск задач 3ds Max и Revit в облаке

Autodesk Automation API позволяет запускать в облаке через Autodesk Platform Services (APS) повторяющиеся задачи CAD и задачи с большим объёмом вычислений. Документация Autodesk для разработчиков Version 3 охватывает движки AutoCAD, 3ds Max, Inventor, Revit и Fusion. Для команд в сфере архитектуры, интерьеров и визуализации такой подход даёт возможность передавать подходящие задачи, которые обычно выполняются вручную на компьютере, в сервис с помощью скриптов и плагинов. Ниже описаны процессы для 3ds Max и Revit на основе официальной документации.

Для каких задач можно использовать автоматизацию?

Automation API позволяет автоматизировать задачи с помощью основных API поддерживаемых CAD-движков в облачной среде. Autodesk позиционирует решение для часто повторяющихся, масштабных или требующих значительных вычислительных ресурсов задач. Способ выполнения зависит от используемого ПО: у каждого движка собственная среда разработки и инструменты.

Движок 3ds Max поддерживает MAXScript, Python и плагины. В документации перечислены импорт и экспорт файлов, запуск скриптов, изменение файлов, рендеринг и симуляции. Существующие скрипты и плагины также можно запускать в облачных задачах через 3ds Max Batch. Для Revit предлагается безголовый движок, работающий в облаке и предназначенный для создания, проверки и изменения данных RVT, RTE и RFA. Подготовка содержимого семейств, анализ данных модели, создание отчётов и автоматизация документации названы среди примеров в документации.

Эти возможности не означают, что готовый шаблон архитектурной автоматизации уже доступен. Чтобы выполнять конкретный офисный процесс через API, необходимо подготовить логику задачи, нужный скрипт или плагин, а также структуру входных и выходных данных.

Как отправить задачу 3ds Max в облако

В руководстве Autodesk Version 3 «Execute a 3ds Max MaxScript» описаны шесть основных этапов. Они показывают общий порядок действий — от подготовки задачи до получения результатов:

1. Получите токен доступа. Он необходим для аутентификации при работе с API. После этого сервис сможет обрабатывать последующие запросы.

2. Создайте nickname. На этом этапе задаётся имя, которое будет использоваться в дальнейших операциях. В документации создание nickname указано как отдельный шаг рабочего процесса.

3. Опубликуйте activity. Передайте сервису описание выполняемой операции. Этот шаг входит в процесс, определяющий, в рамках какой задачи автоматизации будет выполнена работа.

4. Подготовьте облачное хранилище. Продумайте передачу необходимых для задачи файлов и результатов. Подготовленные входные и выходные данные помогают выполнить отправленную задачу с нужными файлами.

5. Отправьте WorkItem. Передайте подготовленную задачу сервису. После этого она будет отправлена на выполнение.

6. Скачайте результаты. Когда задача будет завершена, получите созданные файлы и используйте их на следующем этапе проекта.

Autodesk указывает, что помимо MAXScript и Python для 3ds Max можно загружать и использовать собственные плагины на C++, MAXScript или Python. С помощью плагинов можно реализовать логику, взаимодействующую с разными компонентами 3ds Max. Однако не следует считать, что любой плагин, работающий в настольной среде, будет без проблем работать и в облачном движке. В документации подчёркивается, что у движков собственные среды разработки; поэтому плагины и форматы файлов нужно проверить в целевом рабочем процессе.

Чем отличается рабочий процесс Revit?

Руководство для Revit начинается с преобразования плагина Revit. Затем следуют получение токена доступа, создание nickname, загрузка AppBundle, публикация activity, подготовка облачного хранилища, отправка WorkItem и скачивание результата. Общая логика этого процесса похожа на описанный для 3ds Max MaxScript, однако он включает специфичные для Revit процессы работы с плагинами и данными.

Безголовый движок Revit в облаке позволяет работать с Revit DB API без установки настольного ПО. В документации Autodesk к возможным сценариям относятся создание и изменение моделей, приведение существующих моделей к корпоративным стандартам, проверка данных, автоматическая генерация отчётов и подготовка документации. Для начала Autodesk рекомендует руководство «Execute a Revit add-in», а затем пример кода Count/Delete Revit elements.

Для обоих приложений полезно сначала чётко определить задачу, которую нужно автоматизировать: какие файлы будут обрабатываться, какой скрипт или плагин будет использоваться и какой результат ожидается. Такая подготовка упрощает отправку задачи в сервис и проверку результатов.

На что обратить внимание в рабочих процессах архитектуры и визуализации?

Если студия хочет, например, автоматизировать повторяющуюся обработку файлов или создание отчётов на основе данных модели, сначала нужно описать существующий рабочий процесс. Затем можно провести небольшой тест, следуя официальному руководству для соответствующего движка. Для 3ds Max отправной точкой станет руководство по MAXScript, для Revit — руководство по плагинам. Совместимость процесса с собственными файлами и плагинами необходимо проверять отдельно.

Отправка задач в облако позволяет меньше зависеть от вычислительных ресурсов локального компьютера и пропускной способности сети; Autodesk описывает этот подход как способ выполнять задачи в большем масштабе. При этом в источниках не указаны требования к оборудованию, стоимость использования API или время выполнения конкретной задачи. Ссылка на информацию о ценах есть, но суммы не приведены, поэтому стоимость следует рассчитывать отдельно по официальным данным о ценах.

Распространённые ошибки

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

• Не определять входные и выходные данные: до отправки WorkItem выясните, какие файлы будут обрабатываться и какие результаты нужно получить.

• Путать руководства для разных программ: шаги для Revit и 3ds Max отличаются; следуйте руководству для нужного движка.

• Делать предположения о цене или требованиях к оборудованию: в исходной документации нет конкретных цен или требований к оборудованию; перед принятием решения проверьте актуальную официальную информацию.

Automation API даёт командам, которые хотят масштабировать повторяющиеся задачи в облаке, основу для разработки. Надёжнее всего начать с одной задачи, следовать официальному руководству для подходящего движка и постепенно расширять процесс, проверяя результаты.