Immersív dokumentumok létrehozása, amelyek lehetővé teszik a felhasználók számára a 3‑dimenziós modellek forgatását, nagyítását és felfedezését közvetlenül egy PDF belsejében, hatékony módja a termékkatalógusok, mérnöki jelentések és képzési kézikönyvek fejlesztésének. Az Aspose.Words Cloud SDK for .NET felhőalapú könyvtárat biztosít, amely megkönnyíti a 3D tartalom beágyazását és megőrzését a DOCX fájlok PDF‑re konvertálásakor. Ebben az útmutatóban megtanulja, hogyan generáljon interaktív 3D PDF‑et C#‑ban, megtekintheti a teljes kódmintát, felfedezheti a megfelelő cURL REST hívásokat, és megértheti a valós alkalmazások telepítési szempontjait.

A 3D PDF generálási forgatókönyv követelményei

A mérnöki portálokat vagy interaktív termékkatalógusokat építő fejlesztők gyakran szükségük van arra, hogy olyan PDF-eket szállítsanak, amelyek beágyazott 3D modelleket tartalmaznak. A tipikus követelmények a következők:

  • A forrásdokumentumnak DOCX-nek kell lennie, amely már tartalmaz egy 3D modellt U3D vagy PRC formátumban.
  • A létrehozott PDF-nek meg kell őriznie a 3D adatokat, hogy az Adobe Acrobat-hoz hasonló megjelenítők interaktívan renderelhessék azt.
  • A konverziós folyamatnak automatizáltnak kell lennie, szerveren kell futnia, és nagy mennyiségű kötegelt feldolgozást kell támogatnia manuális beavatkozás nélkül.

Tradicionális asztali eszközöket nem lehet megbízhatóan szkriptelni egy felhő környezetben, és gyakran eltávolítják a 3D adatfolyamokat a konverzió során. Ezért elengedhetetlen egy programozott megoldás, amely megőrzi a 3D modellt, miközben PDF/A megfelelőséget biztosít.

A megközelítés: Az Aspose.Words Cloud használata 3D PDF-hez

Aspose.Words Cloud SDK for .NET egy sor REST‑alapú műveletet kínál, amelyek az Aspose biztonságos szerverein futnak. A szcenáriót lefedő kulcsfontosságú képességek a következők:

  • DOCX fájlok közvetlen feltöltése az Aspose Cloud tárhelyre.
  • PdfSaveOptionsData, amely lehetővé teszi a PDF megfelelőség, a mezőfrissítések vezérlését, és különösen a beágyazott 3D tartalom megőrzését.
  • Aszinkron konverziós módszerek, amelyek stream-et adnak vissza, lehetővé téve a kimeneti fájl közvetlen írását a lemezre.

Ezek a funkciók együtt egy tiszta 3D‑PDF munkafolyamatot tesznek lehetővé, amely integrálható CI csővezetékekbe, webszolgáltatásokba vagy háttérfeladatokba. Részletes API‑információk a hivatalos dokumentációban és az API hivatkozásban érhetők el.

Interaktív 3D PDF generálása C#-ban: Implementáció

Az alábbiakban lépésről‑lépésre bemutatjuk a megvalósítást. Minden lépés egy rövid kódrészletet tartalmaz, amely közvetlenül a teljes példából származik.

Telepítse az Aspose.Words Cloud SDK for .NET

Először adja hozzá a NuGet csomagot a projektjéhez.

dotnet add package Aspose.Words-Cloud

A bináris fájlokat letöltheti a letöltési oldalról.

A WordsApi kliens konfigurálása

Hozzon létre egy Configuration objektumot a kliens hitelesítő adataival, és példányosítsa a WordsApi‑t.

var config = new Configuration
{
    ClientId = "YOUR_CLIENT_ID",
    ClientSecret = "YOUR_CLIENT_SECRET"
};
var wordsApi = new WordsApi(config);

A WordsApi osztály dokumentálva van az API referenciában.

Töltsön fel egy DOCX-et, amely beágyazott 3D modellt tartalmaz

Nyissa meg a helyi DOCX fájlt, és töltse fel az Aspose Cloud tárolóba, felülírva minden azonos nevű meglévő fájlt.

using (var fileStream = File.OpenRead(localDocxPath))
{
    var uploadRequest = new UploadFileRequest(fileStream, remoteFileName);
    await wordsApi.UploadFileAsync(uploadRequest);
}

Győződjön meg arról, hogy a DOCX már tartalmaz egy U3D vagy PRC modellt; ez a 3D modellformátum, amelyet az SDK megőriz.

Állítsa be a PDF mentési beállításokat a 3D tartalom megőrzéséhez

Állítsa be a PdfSaveOptionsData-t úgy, hogy megtartsa a 3D adatfolyamokat, és PDF/A‑1b megfelelőséget használjon.

var pdfOptions = new PdfSaveOptionsData
{
    UpdateFields = false,
    Compliance = PdfCompliance.PdfA1b,
    SaveFormat = "pdf"
};

Ezek a beállítások a 3D to PDF Workflow részei, amelyek biztosítják, hogy az interaktív modell érintetlen maradjon.

Konvertálás és letöltés az interaktív 3D PDF-hez

Hívja meg a konverziós kérést, és írja a kapott adatfolyamot egy helyi PDF fájlba.

var convertRequest = new ConvertDocumentRequest(
    remoteFileName,
    format: "pdf",
    saveOptions: pdfOptions
);

using (var pdfStream = await wordsApi.ConvertDocumentAsync(convertRequest))
using (var fileWriter = File.Create(outputPdfPath))
{
    await pdfStream.CopyToAsync(fileWriter);
}

Az átalakítás után opcionálisan törölheti az ideiglenes fájlt a felhő tárolóból.

Teljes kódrészlet: Interaktív 3D PDF generálás C#-ban

Az alábbi kód bemutatja a teljes folyamatot a kezdetektől a végéig.

using System;
using System.IO;
using System.Threading.Tasks;
using Aspose.Words.Cloud.Sdk;
using Aspose.Words.Cloud.Sdk.Model;
using Aspose.Words.Cloud.Sdk.Model.Requests;

namespace Generate3DPdfExample
{
    class Program
    {
        static async Task Main(string[] args)
        {
            // -----------------------------------------------------------------
            // 1. Configure Aspose.Words Cloud client (replace with your credentials)
            // -----------------------------------------------------------------
            var config = new Configuration
            {
                ClientId = "YOUR_CLIENT_ID",
                ClientSecret = "YOUR_CLIENT_SECRET"
            };
            var wordsApi = new WordsApi(config);

// -----------------------------------------------------------------
            // 2. Define file names and paths (generic placeholders)
            // -----------------------------------------------------------------
            const string localDocxPath = "input.docx";   // DOCX that already contains an embedded 3D model (U3D/PRC)
            const string remoteFileName = "input.docx"; // Name used in Aspose Cloud storage
            const string outputPdfPath = "output.pdf";

// -----------------------------------------------------------------
            // 3. Upload the DOCX to Aspose Cloud storage (overwrites if exists)
            // -----------------------------------------------------------------
            using (var fileStream = File.OpenRead(localDocxPath))
            {
                var uploadRequest = new UploadFileRequest(fileStream, remoteFileName);
                await wordsApi.UploadFileAsync(uploadRequest);
            }

// -----------------------------------------------------------------
            // 4. Prepare PDF save options – enable 3D content preservation
            // -----------------------------------------------------------------
            var pdfOptions = new PdfSaveOptionsData
            {
                // Preserve the embedded 3D model; the option name may vary depending on API version.
                // Setting 'UpdateFields' to false speeds up conversion when fields are not required.
                UpdateFields = false,
                // Use PDF/A-1b compliance to keep the document portable while still supporting 3D.
                Compliance = PdfCompliance.PdfA1b,
                // Ensure the output is a single PDF file.
                SaveFormat = "pdf"
            };

// -----------------------------------------------------------------
            // 5. Convert the uploaded DOCX to PDF with the defined options
            // -----------------------------------------------------------------
            var convertRequest = new ConvertDocumentRequest(
                remoteFileName,
                format: "pdf",
                saveOptions: pdfOptions
            );

using (var pdfStream = await wordsApi.ConvertDocumentAsync(convertRequest))
            using (var fileWriter = File.Create(outputPdfPath))
            {
                await pdfStream.CopyToAsync(fileWriter);
            }

// -----------------------------------------------------------------
            // 6. Clean up remote file (optional)
            // -----------------------------------------------------------------
            var deleteRequest = new DeleteFileRequest(remoteFileName);
            await wordsApi.DeleteFileAsync(deleteRequest);

Console.WriteLine($"3D PDF generated successfully at '{Path.GetFullPath(outputPdfPath)}'.");
        }
    }
}

Megjegyzés: Ez a kódrészlet a fő funkciókat mutatja be. Mielőtt a projektjében használná, győződjön meg arról, hogy frissíti a fájl útvonalakat (input.docx, output.pdf, stb.) a tényleges helyeknek megfelelően, ellenőrizze, hogy minden szükséges függőség megfelelően telepítve van, és alaposan tesztelje a fejlesztési környezetben. Ha problémákkal találkozik, kérjük, tekintse meg a hivatalos dokumentációt vagy lépjen kapcsolatba a támogató csapattal segítségért.

3D PDF átalakítás végrehajtása cURL és a REST API segítségével

Ugyanez a művelet végrehajtható cURL hívásokkal az Aspose.Words Cloud REST endpoints felé.

  1. Szerezzen hozzáférési tokent (cserélje ki a helyőrzőket a hitelesítő adataival).
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"
  1. Töltsd fel a DOCX-et amely tartalmazza a 3D modellt.
curl -X PUT "https://api.aspose.cloud/v4.0/words/storage/file/input.docx" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/octet-stream" \
  --data-binary @input.docx
  1. Kérje a PDF konvertálást 3D megőrzéssel.
curl -X POST "https://api.aspose.cloud/v4.0/words/input.docx/saveAs/pdf" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "PdfSaveOptions": {
            "UpdateFields": false,
            "Compliance": "PdfA1b"
        }
      }' \
  -o output.pdf
  1. Töltse le a keletkezett PDF-et (az előző parancs már helyben elmentette, de letöltheti közvetlenül is).

A kérés testekre és további paraméterekre vonatkozó részletekért tekintse meg a hivatalos API dokumentációt.

Telepítési szempontok a 3D PDF generálásához

A megoldás termelési környezetbe történő integrálásakor vegye figyelembe a következő pontokat:

  • Szerverhely - A konverzió az Aspose felhő szerverein fut, ezért győződjön meg róla, hogy hálózata engedélyezi a kimenő HTTPS forgalmat a api.aspose.cloud felé.
  • Licencelés - Gyártási használathoz kereskedelmi licenc szükséges. Kezdhet egy ideiglenes licenccel az ideiglenes licenc oldal segítségével.
  • Skálázhatóság - Mivel az API állapotfüggetlen, párhuzamosan feltöltheti és konvertálhatja a fájlokat több munkavállaló példányban, hogy nagy mennyiségű kötegelt feldolgozást kezeljen, teljes 3D PDF automatizálás támogatásával.

Összegzés

A C#-ban interaktív 3D PDF generálása egyszerűvé válik az Aspose.Words Cloud SDK for .NET segítségével. A fentiekben leírt lépéseket követve beágyazhat U3D vagy PRC modelleket, megőrizheti őket a PDF konverzió során, és automatizálhatja a munkafolyamatot akár a .NET könyvtár, akár közvetlen REST hívások használatával. Ne felejtse el megfelelő licencet beszerezni a termeléshez, és tesztelni a generált PDF-eket egy 3D-t támogató megjelenítőben, például az Adobe Acrobatban. Ezzel a képességgel gazdagabb, vonzóbb dokumentumokat kínálhat mérnöki, marketing és képzési forgatókönyvekhez.

GYIK

Hogyan generálhatok interaktív 3D PDF-et C#-ban az Aspose.Words Cloud használatával?
Használja az SDK-t egy olyan DOCX feltöltéséhez, amely már tartalmaz U3D vagy PRC modellt, konfigurálja a PdfSaveOptionsData-t a 3D adatfolyamok megtartásához, és hívja meg a ConvertDocumentAsync-t. A cikkben található teljes kódrészlet pontosan bemutatja a sorrendet.

Milyen 3D modellformátumokat ágyazhatok be a PDF konverzióhoz?
Aspose.Words Cloud támogatja az U3D és PRC formátumokat, amelyek a PDF-ekben található interaktív 3D tartalom szabványos formátumai.

Lehetséges a konverzió futtatása anélkül, hogy C# kódot írnánk?
Igen, ugyanaz a folyamat végrehajtható cURL parancsokkal az Aspose.Words Cloud REST API ellen, ahogyan a cURL szakaszban bemutatják.

Hol találhatók az ár- és licencinformációk?
A kereskedelmi licenc részletei elérhetők a termékoldalon, és a ideiglenes licenc oldal linkről ideiglenes licencet szerezhet a kiértékeléshez.

Read More