A komplex 3D modellek univerzálisan megtekinthető formátumba konvertálása gyakori követelmény a mérnöki és vizualizációs folyamatokban. Aspose.Slides Cloud SDK for Node.js egy erőteljes könyvtárat biztosít, amely lehetővé teszi, hogy programozott módon 3D fájlokat PDF formátumba konvertáljon Node.JS‑ben. Ez az útmutató végigvezeti Önt az előkövetelményeken, a telepítési lépéseken, egy részletes kódfutáson, egy teljes példán, REST cURL parancsokon és a kulcsfontosságú konfigurációs beállításokon, hogy gyorsan integrálhassa a 3D‑ról PDF‑re konvertálást alkalmazásaiba.

Az Aspose.Slides Cloud SDK for Node.js beállítása

Mielőtt elkezdené, győződjön meg arról, hogy a következőkkel rendelkezik:

  • Node.js 14 vagy újabb telepítve a fejlesztői gépére.
  • Egy Aspose Cloud fiók. Hozzon létre egyet az Aspose portálon, és jegyezze fel a Client Id és Client Secret értékeket.
  • Internetkapcsolat a SDK számára, hogy meghívja az Aspose Slides Cloud szolgáltatást.

Telepítse az SDK-t npm segítségével:

npm install asposeslidescloud

Letöltheti a legújabb csomagot a kiadási oldalon. A telepítés után importálja az SDK-t, és állítsa be a hitelesítő adatait a lenti útmutató szerint. Az SDK készen áll, így készen áll a 3D fájlok konvertálására.

Lépésről lépésre felépítve: 3D konvertálása PDF-be Node.JS-ben

1. lépés: A Slides API kliens inicializálása

Hozzon létre egy konfigurációs objektumot a kliens hitelesítő adataival, és példányosítsa a SlidesApi osztályt.

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

A SlidesApi osztályreferencia magyarázza az összes elérhető metódust.

2. lépés: A forrás 3D fájl megadása

Adja meg a konvertálni kívánt 3D fájl nevét. Az SDK támogatja az olyan formátumokat, mint az OBJ, STL, és a FBX.

let name = "sample.pptx";

3. lépés: Célformátum és kimeneti útvonal meghatározása

Állítsa be a kívánt kimeneti formátumot pdf-re, és válassza ki, hogy hová legyen mentve a konvertált fájl.

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

4. lépés: A konverzió végrehajtása

Hívja meg a convertAndSave függvényt, és kezelje a promise-t a siker megerősítéséhez vagy a hibák rögzítéséhez.

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

Ez a kódrészlet bemutatja a lényeget, hogyan convert 3D to PDF in Node.JS az Aspose.Slides Cloud könyvtár segítségével.

Teljes kódpélda: 3D konvertálása PDF-be hatékonyan

Az alábbi példa egyetlen, futtatható szkriptben egyesíti az összes részt.

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));

Megjegyzés: Ez a kódrészlet bemutatja a fő funkciót. Mielőtt a projektjében használná, győződjön meg róla, hogy frissítette az összes fájlútvonalat és konfigurációs értéket a tényleges környezetének megfelelően, ellenőrizze, hogy minden szükséges függőség megfelelően telepítve van, és alaposan tesztelje a fejlesztői környezetben. Ha bármilyen problémába ütközik, kérjük, tekintse meg a hivatalos dokumentációt vagy lépjen kapcsolatba a támogatási csapattal segítségért.

3D PDF konverzió végrehajtása REST API használatával cURL segítségével

Ha inkább tiszta REST megközelítést részesít előnyben, ugyanaz a konverzió elérhető cURL parancsokkal.

1. Hozzon létre egy hozzáférési tokent

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. A forrás 3D fájl feltöltése

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 konvertálás kérése

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

4. A konvertált PDF letöltése (ha nem mentették közvetlenül)

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

A paraméterek teljes listájáért és további lehetőségekért tekintse meg az API referenciát.

3D konverziós beállítások konfigurálása PDF-hez

Az SDK lehetővé teszi, hogy több paramétert állítson be a konverziós kimenet szabályozásához. Az alábbiakban két gyakran használt lehetőséget mutatunk be:

  • Kimeneti útvonal - Meghatározza, hogy a konvertált PDF hol lesz mentve a szerveren.
let outPath = "custom_folder/converted.pdf";
  • Jelszóvédelem - Hozzáadhat egy jelszót a létrehozott PDF-hez a biztonság érdekében. Ez a beállítás a password paraméterrel állítható be a convertAndSave metódusban (tekintse meg az API referencia pontos használatát).

Ezen beállítások módosítása segít a konverziót a projekt követelményeihez igazítani.

Következtetés

Most, hogy végigvitted a bemutatót, képesnek kell lenned 3D-s diák PDF-fájlokká alakítására közvetlenül egy Node.js alkalmazásból az Aspose.Slides Cloud SDK for Node.js használatával. Az SDK végzi a renderelés nehéz részét, míg a mögöttes REST API rugalmasságot biztosít a szolgáltatás hívásához anélkül, hogy a klienskönyvtárat használnád. Ne feledd, hogy érvényes licencet szerezz be minden éles környezethez, akár előfizetést vásárolva az Aspose árazási oldalon vagy ideiglenes kulcsot kérve a ideiglenes licenc oldalról. A megadott példakód és konfigurációs tippek segítségével gyorsan beágyazhatod a 3D‑PDF konverziót saját projektjeidbe.

Gyakran Ismételt Kérdések

Hogyan konvertálhatom a 3D-t PDF-re Node.JS-ben az Aspose.Slides Cloud SDK használatával?
Használja a convertAndSave metódust a SlidesApi osztályban, miután beállította az ügyfél hitelesítő adatait. Adja meg a forrás 3D fájl nevét, állítsa be a formátumot "pdf"-ra, és adja meg a kimeneti útvonalat.

Milyen 3D fájlformátumokat támogat a SDK a PDF konvertáláshoz?
Az SDK támogatja az OBJ, STL, FBX, 3DS, GLTF, és több más iparági szabványú 3D formátumot. Tekintse meg a dokumentációt a teljes listaért.

Szükséges-e manuálisan kezelni a hitelesítési tokeneket?
Nem. Miután beállítja a clientId és a clientSecret értékeket a konfigurációs objektumban, az SDK automatikusan lekéri és frissíti a hozzáférési tokent minden kéréshez.

Van korlátozás a 3D fájlok méretére, amelyeket konvertálhatok?
A felhőszolgáltatás legfeljebb 200 MB méretű fájlokat fogad el. Nagyobb fájlokat fel kell osztani vagy tömöríteni a feltöltés előtt.

További információk