Перетворення складних 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.

Повний приклад коду: ефективне перетворення 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 reference.

Налаштування параметрів конвертації для 3D у PDF

SDK дозволяє налаштовувати кілька параметрів для контролю вихідного результату конвертації. Нижче наведено два найчастіше використовувані параметри:

  • Output Path - Визначає, де на сервері буде збережено конвертований 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 МБ. Великі файли слід розділити або стиснути перед завантаженням.

Read More