تبدیل مدل‌های سه‌بعدی پیچیده به فرمت قابل مشاهده به‌صورت جهانی، یک نیاز مکرر در خطوط لوله مهندسی و تجسم است. 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 تمام روش‌های موجود را توضیح می‌دهد.

مرحله ۲: مشخص کردن فایل ۳D منبع

نام فایل ۳D که می‌خواهید تبدیل کنید را ارائه دهید. SDK از فرمت‌هایی مانند OBJ, STL, و FBX پشتیبانی می‌کند.

let name = "sample.pptx";

مرحله 3: تعریف قالب هدف و مسیر خروجی

قالب خروجی مورد نظر را به pdf تنظیم کنید و مکان ذخیره‌سازی فایل تبدیل‌شده را انتخاب کنید.

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

مرحله 4: اجرای تبدیل

convertAndSave را فراخوانی کنید و promise را مدیریت کنید تا موفقیت را تأیید یا خطاها را ضبط کنید.

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 مراجعه کنید.

پیکربندی تنظیمات تبدیل برای 3D به PDF

SDK به شما امکان می‌دهد چندین پارامتر را تنظیم کنید تا خروجی تبدیل را کنترل کنید. در زیر دو گزینه معمولاً استفاده‌شده آورده شده است:

  • مسیر خروجی - تعیین می‌کند که PDF تبدیل‌شده در کجا بر روی سرور ذخیره شود.
let outPath = "custom_folder/converted.pdf";
  • Password Protection - می‌توانید یک رمز عبور به PDF تولید شده برای امنیت اضافه کنید. این گزینه از طریق پارامتر password در متد convertAndSave تنظیم می‌شود (برای استفاده دقیق به مرجع API مراجعه کنید).

تنظیم این گزینه‌ها به شما کمک می‌کند تا تبدیل را بر اساس نیازهای پروژه‌تان تنظیم کنید.

نتیجه‌گیری

اکنون که شما آموزش را تکمیل کرده‌اید، باید بتوانید اسلایدهای 3D را به‌صورت مستقیم از یک برنامه Node.js به فایل‌های PDF تبدیل کنید با استفاده از 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 MB می‌پذیرد. فایل‌های بزرگتر باید قبل از بارگذاری تقسیم یا فشرده شوند.

بیشتر بخوانید