Преобразование сложных 3D‑моделей в универсальный формат просмотра является частой задачей для инженерных и визуализационных конвейеров. Aspose.Slides Cloud SDK for Node.js предоставляет мощную библиотеку, позволяющую программно конвертировать 3D‑файлы в PDF в Node.JS. Это руководство проведёт вас через предварительные требования, шаги установки, подробный разбор кода, полный пример, команды REST cURL и ключевые параметры конфигурации, чтобы вы могли быстро интегрировать конвертацию 3D в PDF в свои приложения.

Настройка Aspose.Slides Cloud SDK for Node.js

Прежде чем начать, убедитесь, что у вас есть следующее:

  • Node.js 14 или более поздняя версия, установленная на вашей машине разработки.
  • Учётная запись Aspose Cloud. Создайте её на портале Aspose и запишите ваш Client Id и Client Secret.
  • Подключение к Интернету, необходимое SDK для вызова сервиса Aspose Slides Cloud.

Установите SDK через npm:

npm install asposeslidescloud

Вы также можете загрузить последнюю версию пакета со страницы релизов. После установки импортируйте SDK и настройте свои учетные данные, как показано в руководстве ниже. С готовым SDK вы готовы начать конвертацию 3D‑файлов.

Создание пошагово: преобразование 3D в PDF в Node.JS

Шаг 1: Инициализация клиента Slides API

Создайте объект конфигурации с вашими учетными данными клиента и создайте экземпляр класса SlidesApi.

let configuration = new SlidesApi.Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
let api = new SlidesApi.SlidesApi(configuration);

Справочник класса SlidesApi объясняет все доступные методы.

Шаг 2: Укажите исходный 3D‑файл

Укажите имя 3D‑файла, который вы хотите конвертировать. SDK поддерживает форматы, такие как OBJ, STL, и FBX.

let name = "sample.pptx";

Шаг 3: Определить целевой формат и путь вывода

Установите желаемый формат вывода как pdf и выберите, где будет сохранён преобразованный файл.

let format = "pdf";
let outPath = "output.pdf";

Шаг 4: Выполнить конвертацию

Вызовите convertAndSave и обработайте обещание, чтобы подтвердить успешное выполнение или зафиксировать ошибки.

api.convertAndSave(name, format, outPath, null, null, null, null, null)
    .then(() => console.log("Converted"))
    .catch(err => console.error(err));

Этот фрагмент демонстрирует основу того, как конвертировать 3D в PDF в Node.JS с помощью Aspose.Slides Cloud library.

Полный пример кода: Конвертация 3D в PDF эффективно

Следующий пример собирает все части вместе в едином, исполняемом скрипте.

let SlidesApi = require("asposeslidescloud");
let configuration = new SlidesApi.Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
let api = new SlidesApi.SlidesApi(configuration);
let name = "sample.pptx";
let format = "pdf";
let outPath = "output.pdf";
api.convertAndSave(name, format, outPath, null, null, null, null, null)
    .then(() => console.log("Converted"))
    .catch(err => console.error(err));

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

Выполнение преобразования 3D в PDF через REST API с использованием cURL

Если вы предпочитаете чисто REST‑подход, тот же процесс конвертации можно выполнить с помощью команд cURL.

1. Получить токен доступа

curl -X POST "https://api.aspose.cloud/connect/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"

2. Загрузка исходного 3D‑файла

curl -X PUT "https://api.aspose.cloud/v3.0/slides/storage/file/sample.pptx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -T "./sample.pptx"

3. Запрос конвертации в PDF

curl -X POST "https://api.aspose.cloud/v3.0/slides/sample.pptx/convert/pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o "output.pdf"

4. Скачивание преобразованного PDF (если не сохранён напрямую)

curl -X GET "https://api.aspose.cloud/v3.0/slides/storage/file/output.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o "output.pdf"

Для полного списка параметров и дополнительных опций см. справку API.

Настройка параметров конвертации 3D в PDF

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

  • Путь вывода – Определяет, где на сервере будет сохранён преобразованный PDF.
let outPath = "custom_folder/converted.pdf";
  • Защита паролем - Вы можете добавить пароль к полученному PDF для обеспечения безопасности. Эта опция задаётся через параметр password в методе convertAndSave (см. справочник API для точного использования).

Настройка этих параметров помогает адаптировать конвертацию к требованиям вашего проекта.

Заключение

Теперь, когда вы прошли учебник, вы сможете преобразовывать 3D‑слайды в PDF‑файлы непосредственно из приложения Node.js, используя Aspose.Slides Cloud SDK for Node.js. SDK берет на себя тяжелую работу по рендерингу, в то время как базовый REST API предоставляет гибкость вызова сервиса без клиентской библиотеки. Не забудьте обеспечить наличие действующей лицензии для любого производственного развертывания, либо приобретя подписку на странице ценообразования Aspose , либо запросив временный ключ на странице временной лицензии. С предоставленным примером кода и советами по конфигурации вы сможете быстро внедрить преобразование 3D‑в‑PDF в свои проекты.

Часто задаваемые вопросы

Как я могу конвертировать 3D в PDF в Node.JS с использованием Aspose.Slides Cloud SDK?
Используйте метод convertAndSave класса SlidesApi после настройки учетных данных клиента. Укажите имя исходного 3D файла, установите формат "pdf" и задайте путь вывода.

Какие форматы 3D‑файлов поддерживает SDK для конвертации в PDF?
SDK поддерживает OBJ, STL, FBX, 3DS, GLTF, а также несколько других отраслевых стандартных 3D‑форматов. См. документацию для полного списка.

Нужно ли мне управлять токенами аутентификации вручную?
Нет. Как только вы задаете clientId и clientSecret в объекте конфигурации, SDK автоматически получает и обновляет токен доступа для каждого запроса.

Есть ли ограничение на размер 3D‑файлов, которые я могу конвертировать?
Облачный сервис принимает файлы размером до 200 МБ. Большие файлы следует разбивать или сжимать перед загрузкой.

Читать дальше