Tạo PDF 3D tương tác bằng C#

Tạo ra các tài liệu hấp dẫn cho phép người dùng xoay, phóng to và khám phá các mô hình ba‑chiều trực tiếp trong một PDF là một cách mạnh mẽ để nâng cao danh mục sản phẩm, báo cáo kỹ thuật và sổ tay đào tạo. Aspose.Words Cloud SDK for .NET cung cấp một thư viện dựa trên đám mây giúp dễ dàng nhúng và bảo tồn nội dung 3D khi chuyển đổi các tệp DOCX sang PDF. Trong hướng dẫn này, bạn sẽ học cách tạo PDF 3D tương tác bằng C#, xem mẫu mã đầy đủ, khám phá các cuộc gọi REST cURL tương đương, và hiểu các cân nhắc triển khai cho các ứng dụng thực tế.

Các yêu cầu cho kịch bản tạo PDF 3D

Các nhà phát triển xây dựng các cổng kỹ thuật hoặc brochure sản phẩm tương tác thường cần cung cấp các tệp PDF chứa các mô hình 3D nhúng. Các yêu cầu điển hình là:

Tài liệu nguồn phải là một DOCX đã bao gồm mô hình 3D ở định dạng U3D hoặc PRC .
PDF đầu ra phải giữ lại dữ liệu 3D để các trình xem như Adobe Acrobat có thể hiển thị tương tác .
Quy trình chuyển đổi nên được tự động hoá, chạy trên máy chủ và hoạt động với các lô lớn mà không cần can thiệp thủ công .

Các công cụ truyền thống trên máy tính để bàn không thể được lập trình một cách đáng tin cậy trong môi trường đám mây, và chúng thường loại bỏ các luồng 3D trong quá trình chuyển đổi. Do đó, một giải pháp lập trình bảo tồn mô hình 3D đồng thời đáp ứng tiêu chuẩn PDF/A là cần thiết.

Phương pháp: Tận dụng Aspose.Words Cloud cho PDF 3D

Aspose.Words Cloud SDK for .NET cung cấp một bộ các thao tác dựa trên REST chạy trên các máy chủ bảo mật của Aspose. Các khả năng chính đáp ứng kịch bản bao gồm:

Tải lên trực tiếp các tệp DOCX lên lưu trữ Aspose Cloud.
PdfSaveOptionsData cho phép bạn kiểm soát việc tuân thủ PDF, cập nhật trường, và quan trọng nhất là việc bảo tồn nội dung 3D nhúng.
Các phương pháp chuyển đổi bất đồng bộ trả về một luồng, cho phép bạn ghi tệp đầu ra trực tiếp vào đĩa.

Cùng nhau, các tính năng này cho phép quy trình làm việc 3D sang PDF sạch sẽ có thể được tích hợp vào các pipeline CI, dịch vụ web hoặc công việc nền. Thông tin chi tiết về API có sẵn trong tài liệu chính thức và tham chiếu API.

Tạo PDF 3D tương tác trong C#: Triển khai

Dưới đây là hướng dẫn chi tiết từng bước về việc triển khai. Mỗi bước bao gồm một đoạn mã ngắn được lấy trực tiếp từ ví dụ đầy đủ.

Cài đặt Aspose.Words Cloud SDK cho .NET

Đầu tiên, thêm gói NuGet vào dự án của bạn.

dotnet add package Aspose.Words-Cloud

Bạn cũng có thể tải xuống các tệp nhị phân từ trang tải xuống.

Cấu hình WordsApi Client

Tạo một đối tượng Configuration với thông tin xác thực client của bạn và khởi tạo WordsApi.

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

Lớp WordsApi được tài liệu hoá trong tài liệu tham khảo API.

Tải lên một DOCX chứa mô hình 3D nhúng

Mở tệp DOCX cục bộ và tải lên lưu trữ Aspose Cloud, ghi đè bất kỳ tệp nào đã tồn tại cùng tên.

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

Đảm bảo tệp DOCX đã bao gồm mô hình U3D hoặc PRC; đây là 3D Model Format mà SDK giữ lại.

Đặt tùy chọn lưu PDF để bảo tồn nội dung 3D

Cấu hình PdfSaveOptionsData để giữ các luồng 3D và sử dụng tuân thủ PDF/A‑1b.

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

Các tùy chọn này là một phần của Quy trình 3D sang PDF giúp đảm bảo mô hình tương tác vẫn nguyên vẹn.

Chuyển đổi và Tải xuống PDF 3D Tương tác

Gọi yêu cầu chuyển đổi và ghi luồng kết quả vào một tệp PDF cục bộ.

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

Sau khi chuyển đổi, bạn có thể tùy chọn xóa tệp tạm thời khỏi lưu trữ đám mây.

Ví dụ mã hoàn chỉnh: Tạo PDF 3D tương tác trong C#

Đoạn mã sau đây minh họa toàn bộ quá trình từ đầu đến cuối.

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)}'.");
        }
    }
}

Lưu ý: Ví dụ mã này minh họa chức năng cốt lõi. Trước khi sử dụng trong dự án của bạn, hãy chắc chắn cập nhật các đường dẫn tệp (input.docx, output.pdf, v.v.) cho phù hợp với vị trí tệp thực tế của bạn, xác minh rằng tất cả các phụ thuộc cần thiết đã được cài đặt đúng cách, và kiểm tra kỹ lưỡng trong môi trường phát triển. Nếu bạn gặp bất kỳ vấn đề nào, vui lòng tham khảo tài liệu chính thức hoặc liên hệ với đội hỗ trợ để được trợ giúp.

Thực hiện chuyển đổi PDF 3D bằng cURL và REST API

Phép thao tác tương tự có thể được thực hiện thông qua các cuộc gọi cURL tới các endpoint REST của Aspose.Words Cloud.

Lấy token truy cập (thay thế các placeholder bằng thông tin xác thực của bạn).

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"

Tải lên DOCX chứa mô hình 3D.

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

Yêu cầu chuyển đổi PDF với việc bảo tồn 3D

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

Tải xuống PDF kết quả (lệnh trước đã lưu nó cục bộ, nhưng bạn cũng có thể tải trực tiếp).

Để biết thêm chi tiết về các thân yêu cầu và các tham số bổ sung, xem tài liệu API chính thức.

Các cân nhắc triển khai cho việc tạo PDF 3D

Khi tích hợp giải pháp này vào môi trường sản xuất, hãy lưu ý các điểm sau:

Vị trí máy chủ - Quá trình chuyển đổi chạy trên máy chủ đám mây của Aspose, vì vậy hãy đảm bảo mạng của bạn cho phép lưu lượng HTTPS outbound tới api.aspose.cloud.
Giấy phép - Cần có giấy phép thương mại cho việc sử dụng trong môi trường sản xuất. Bạn có thể bắt đầu với giấy phép tạm thời từ trang giấy phép tạm thời.
Khả năng mở rộng - Vì API không trạng thái, bạn có thể thực hiện tải lên và chuyển đổi song song trên nhiều instance worker để xử lý các lô dữ liệu khối lượng lớn, hỗ trợ đầy đủ 3D to PDF Automation.

Kết luận

Tạo PDF 3D tương tác trong C# trở nên đơn giản với Aspose.Words Cloud SDK for .NET. Bằng cách làm theo các bước ở trên, bạn có thể nhúng các mô hình U3D hoặc PRC, giữ chúng nguyên trong quá trình chuyển đổi PDF và tự động hoá quy trình làm việc bằng thư viện .NET hoặc các cuộc gọi REST trực tiếp. Hãy nhớ mua giấy phép phù hợp cho môi trường sản xuất và kiểm tra các PDF đã tạo trong một trình xem hỗ trợ 3D, chẳng hạn như Adobe Acrobat. Với khả năng này, bạn có thể cung cấp các tài liệu phong phú hơn, hấp dẫn hơn cho các kịch bản kỹ thuật, marketing và đào tạo.

Câu hỏi thường gặp

Làm thế nào để tạo PDF 3D tương tác trong C# bằng Aspose.Words Cloud?
Sử dụng SDK để tải lên một tệp DOCX đã chứa mô hình U3D hoặc PRC, cấu hình PdfSaveOptionsData để giữ các luồng 3D, và gọi ConvertDocumentAsync. Ví dụ mã đầy đủ trong bài viết này cho thấy trình tự chính xác.

Các định dạng mô hình 3D nào tôi có thể nhúng cho việc chuyển đổi PDF?
Aspose.Words Cloud hỗ trợ các định dạng U3D và PRC, là các định dạng tiêu chuẩn cho nội dung 3D tương tác trong PDF.

Có thể thực hiện chuyển đổi mà không viết bất kỳ mã C# nào không?
Có, cùng một quy trình có thể được thực hiện bằng các lệnh cURL đối với Aspose.Words Cloud REST API, như đã trình bày trong phần cURL.

Tôi có thể tìm thông tin về giá cả và giấy phép ở đâu?
Chi tiết về giấy phép thương mại có sẵn trên trang sản phẩm, và bạn có thể nhận giấy phép tạm thời để đánh giá từ trang giấy phép tạm thời.

Các yêu cầu cho kịch bản tạo PDF 3D#

Phương pháp: Tận dụng Aspose.Words Cloud cho PDF 3D#

Tạo PDF 3D tương tác trong C#: Triển khai#

Cài đặt Aspose.Words Cloud SDK cho .NET#

Cấu hình WordsApi Client#

Tải lên một DOCX chứa mô hình 3D nhúng#

Đặt tùy chọn lưu PDF để bảo tồn nội dung 3D#

Chuyển đổi và Tải xuống PDF 3D Tương tác#

Ví dụ mã hoàn chỉnh: Tạo PDF 3D tương tác trong C##

Thực hiện chuyển đổi PDF 3D bằng cURL và REST API#

Các cân nhắc triển khai cho việc tạo PDF 3D#

Kết luận#

Câu hỏi thường gặp#

Đọc thêm#