Руководство по Design Automation для 3Ds Max: 2. Создание Activity
Содержание
1. Авторизация
2. Создание Activity
3. Подготовка хранилища в облаке
5. Загрузка результатов выполнения задачи
Краткое описание
Activity описывает задачу, которая будет запускаться сервисом Design Automation. Создавая Activity, Вы описываете, что конкретно будет выполнять сервис, например, activity данного руководства получает в качестве исходных данных zip-архив с файлом 3ds Max, строку с именем этого файла в архиве, и скрипт 3d Max-а, который будет выполнен после загрузки сцены. Результатом выполнения задачи сервисом Design Automation будет zip-архив со всем содержимым распакованного исходного архива, скриптом 3d Max-а и всеми файлами, созданными в ходе выполнения задачи в рабочей папке/подпапках.
Используемые API
Базовый URL: https://developer.api.autodesk.com/da/us-east
1. Создание новой Activity - URL конечной точки - /v3/activities, метод - POST.
2. Назначение псевдонима (alias) Activity - URL конечной точки - /v3/activities/{id}/aliases, метод - POST.
Подробное описание доступно здесь.
Шаг 1. Создание новой Activity.
Создадим activity с id "ExecuteMaxscript". Запрос:
- curl -X POST 'https://developer.api.autodesk.com/da/us-east/v3/activities' -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' -H 'Content-Type: application/json' -d '{
- "id": "ExecuteMaxscript",
- "commandLine": "\"$(engine.path)/3dsmaxbatch.exe\" -sceneFile \"$(args[InputZip].path)/$(args[MaxFileName].value)\" \"$(args[MaxscriptToExecute].path)\"",
- "description": "Execute a maxscript on a max file provided in a zip",
- "appbundles": [
- ],
- "engine" : "Autodesk.3dsMax+2019",
- "parameters": {
- "InputZip": {
- "zip": true,
- "ondemand": false,
- "verb": "get",
- "description": "Zip file containing the max file and all its dependencies to be unzipped in the workingFolder",
- "required": true,
- "localName": "workingFolder"
- },
- "MaxFileName" : {
- "zip": false,
- "description": "Name of the max file in the zip file provided as InputZip parameter",
- "ondemand": false,
- "required": true,
- "verb": "read"
- },
- "MaxscriptToExecute": {
- "zip": false,
- "verb": "get",
- "description": "The maxscript to run using 3dsmaxbatch.exe",
- "ondemand": false,
- "required": true,
- "localName": "maxscriptToExecute.ms"
- },
- "OutputZip": {
- "zip": true,
- "ondemand": false,
- "verb": "put",
- "description": "Gather everything in the working folder inside a zip for output",
- "required": true,
- "localName": "workingFolder"
- }
- }
- }'
Ответ сервера:
- {
- "commandLine": [
- "\"$(engine.path)/3dsmaxbatch.exe\" -sceneFile \"$(args[InputZip].path)/$(args[MaxFileName].value)\" \"$(args[MaxscriptToExecute].path)\""
- ],
- "parameters": {
- "InputZip": {
- "zip": true,
- "verb": "get",
- "description": "Zip file containing the max file and all its dependencies to be unziped in the workingFolder",
- "required": true,
- "localName": "workingFolder"
- },
- "MaxFileName": {
- "verb": "read",
- "description": "Name of the max file in the zip file provided as InputZip parameter",
- "required": true
- },
- "MaxscriptToExecute": {
- "verb": "get",
- "description": "The maxscript to run using 3dsmaxbatch.exe",
- "required": true,
- "localName": "maxscriptToExecute.ms"
- },
- "OutputZip": {
- "zip": true,
- "verb": "put",
- "description": "Gather everything in the working folder inside a zip for output",
- "required": true,
- "localName": "workingFolder"
- }
- },
- "id": "YourNicknameOrForgeAppClientId.ExecuteMaxscript",
- "engine": "Autodesk.3dsMax+2019",
- "appbundles": [],
- "description": "Execute a maxscript on a max file provided in a zip",
- "version": 1
- }
Шаг 2. Создание псевдонима (alias) версии Activity.
Создадим псевдоним (alias) "tutorial" для версии 1 activity "ExecuteMaxscript", которую мы только что создали. Псевдоним (alias) указывает на конкретную версию activity и он необходим для получения fully qualified id, который необходим для большинства функций, предоставляемых сервисом Design Automation. Более подробная информация об идентификаторах доступна здесь. Запрос для создания псевдонима:
- curl -X POST 'https://developer.api.autodesk.com/da/us-east/v3/activities/ExecuteMaxscript/aliases' -H 'Content-Type: application/json' -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' -d '{
- "version": 1,
- "id": "tutorial"
- }'
Примечание: обратите особое внимание на строку запроса https://developer.api.autodesk.com/da/us-east/v3/activites/{id}/aliases. Здесь в качестве идентификатора указан unqualified id созданной activity, т.е. ExecuteMaxscript.
Ответ сервера:
- {
- "version": 1,
- "id": "tutorial"
- }
Назад к авторизации
Читать далее о подготовке хранилища в облаке
Источник: https://forge.autodesk.com/en/docs/design-automation/v3/tutorials/3dsmax/task-2-create-activity/
Обсуждение: http://adn-cis.org/forum/index.php?topic=
Опубликовано 31.07.2019