Η μετατροπή ενός 3D μοντέλου σε έγγραφο PDF ανοίγει τη δυνατότητα εύκολης κοινής χρήσης και εκτύπωσης σε οποιαδήποτε πλατφόρμα. Το Aspose.Email Cloud SDK for PHP παρέχει μια ισχυρή βιβλιοθήκη βασισμένη στο cloud που διαχειρίζεται τη μετατροπή 3D σε PDF σε PHP με λίγες κλήσεις API. Σε αυτό το tutorial θα δείτε πώς να διαμορφώσετε τα διαπιστευτήριά σας, να ανεβάσετε ένα αρχείο OBJ, να ενεργοποιήσετε τη μετατροπή, να κατεβάσετε το προκύπτον PDF και να ρυθμίσετε μερικές επιλογές. Στο τέλος θα έχετε ένα επαναχρησιμοποιήσιμο script PHP που μπορεί να ενσωματωθεί σε οποιαδήποτε web ή desktop εφαρμογή.

Πριν ξεκινήσετε: Προαπαιτούμενα και εγκατάσταση

Χρειάζεστε ένα περιβάλλον ανάπτυξης PHP (συνιστάται PHP 8.0+) και εγκατεστημένο Composer. Εγγραφείτε για έναν λογαριασμό Aspose Cloud για να λάβετε το Client Id και το Client Secret.

Εγκαταστήστε το SDK με το Composer:

composer require aspose/aspose-email-cloud

Κατεβάστε το πακέτο SDK εάν προτιμάτε μια χειροκίνητη εγκατάσταση: URL λήψης.

Το παρακάτω απόσπασμα δείχνει το μπλοκ διαμόρφωσης που θα χρησιμοποιήσετε ξανά αργότερα. Αντικαταστήστε τις τιμές placeholder με τα διαπιστευτήρια από τον πίνακα ελέγχου του Aspose Cloud.

<?php
require_once __DIR__ . '/vendor/autoload.php';

use Aspose\ThreeD\Configuration;

// -----------------------------------------------------------------------------
// Configuration – replace with your actual Aspose Cloud client credentials
// -----------------------------------------------------------------------------
$config = new Configuration();
$config->setAppSid('YOUR_CLIENT_ID');          // Client Id
$config->setAppKey('YOUR_CLIENT_SECRET');     // Client Secret
$config->setHost('https://api.aspose.cloud'); // Base URL (default)

Με το SDK εγκατεστημένο και τα διαπιστευτήρια έτοιμα, μπορείτε να προχωρήσετε στα πραγματικά βήματα μετατροπής.

Δημιουργώντας το βήμα προς βήμα: Μετατροπή 3D σε PDF με PHP

Βήμα 1: Φόρτωση διαμόρφωσης και ορισμός διαπιστευτηρίων

Πρώτα, δημιουργήστε ένα αντικείμενο Configuration και ορίστε το client ID, το secret και το host. Αυτό το αντικείμενο θα περάσει σε όλες τις παρουσίες του API.

$config = new Configuration();
$config->setAppSid('YOUR_CLIENT_ID');
$config->setAppKey('YOUR_CLIENT_SECRET');
$config->setHost('https://api.aspose.cloud');

Βήμα 2: Αρχικοποίηση των αντικειμένων API

Δημιουργήστε στιγμιότυπα του StorageApi και του ThreeDApi χρησιμοποιώντας το αντικείμενο διαμόρφωσης.

use Aspose\ThreeD\Api\ThreeDApi;
use Aspose\ThreeD\Api\StorageApi;

$storageApi = new StorageApi(null, $config);
$threeDApi   = new ThreeDApi(null, $config);

Βήμα 3: Ανέβασμα Πηγαίου Αρχείου 3D

Ανεβάστε το τοπικό αρχείο OBJ στο Aspose Cloud storage ώστε η υπηρεσία μετατροπής να μπορεί να το προσπελάσει.

use Aspose\ThreeD\Model\UploadFileRequest;

$source3DFile = 'sample.obj';   // Input 3D model file
$uploadRequest = new UploadFileRequest($source3DFile, $source3DFile);
$storageApi->uploadFile($uploadRequest);

Βήμα 4: Μετατροπή 3D σε PDF

Αιτηθείτε τη μετατροπή από OBJ σε PDF. Το όνομα του αρχείου προορισμού ορίζεται από $targetPdfFile.

use Aspose\ThreeD\Model\Convert3DRequest;

$targetPdfFile = 'sample.pdf';  // Desired output PDF name
$convertRequest = new Convert3DRequest($source3DFile, $targetPdfFile, 'pdf');
$threeDApi->convert3D($convertRequest);

Βήμα 5: Λήψη του παραγόμενου PDF

Ανακτήστε το νεοδημιουργημένο PDF από την αποθήκευση cloud και αποθηκεύστε το τοπικά.

use Aspose\ThreeD\Model\DownloadFileRequest;

$downloadRequest = new DownloadFileRequest($targetPdfFile);
$response = $storageApi->downloadFile($downloadRequest);
$localPdfPath = __DIR__ . '/output.pdf';
file_put_contents($localPdfPath, $response->getContent());

Βήμα 6: Καθαρισμός αποθήκευσης

Προαιρετικά διαγράψτε το αρχικό OBJ και το παραγόμενο PDF από την αποθήκευση στο cloud για να διατηρήσετε τον λογαριασμό σας τακτοποιημένο.

$storageApi->deleteFile(new \Aspose\ThreeD\Model\DeleteFileRequest($source3DFile));
$storageApi->deleteFile(new \Aspose\ThreeD\Model\DeleteFileRequest($targetPdfFile));

Με την ολοκλήρωση αυτών των βημάτων, έχετε εκτελέσει με επιτυχία μια μετατροπή 3D σε PDF σε PHP.

Πλήρες Παράδειγμα PHP Script: Μετατροπή 3D σε PDF σε PHP - Πλήρες Script

Το παρακάτω παράδειγμα δείχνει τη πλήρη ροή εργασίας σε ένα μόνο αρχείο. Αντιγράψτε το σε ένα έργο PHP και προσαρμόστε τα placeholders διαπιστευτηρίων.

<?php
require_once __DIR__ . '/vendor/autoload.php';

use Aspose\ThreeD\Configuration;
use Aspose\ThreeD\Api\ThreeDApi;
use Aspose\ThreeD\Api\StorageApi;
use Aspose\ThreeD\Model\UploadFileRequest;
use Aspose\ThreeD\Model\Convert3DRequest;
use Aspose\ThreeD\Model\DownloadFileRequest;

// -----------------------------------------------------------------------------
// Configuration – replace with your actual Aspose Cloud client credentials
// -----------------------------------------------------------------------------
$config = new Configuration();
$config->setAppSid('YOUR_CLIENT_ID');          // Client Id
$config->setAppKey('YOUR_CLIENT_SECRET');     // Client Secret
$config->setHost('https://api.aspose.cloud'); // Base URL (default)

// -----------------------------------------------------------------------------
// Initialise API instances
// -----------------------------------------------------------------------------
$storageApi = new StorageApi(null, $config);
$threeDApi   = new ThreeDApi(null, $config);

// -----------------------------------------------------------------------------
// Define source 3D file and target PDF file (paths are relative to the project)
// -----------------------------------------------------------------------------
$source3DFile = 'sample.obj';   // Input 3D model file
$targetPdfFile = 'sample.pdf';  // Desired output PDF name

// -----------------------------------------------------------------------------
// Upload the 3D file to Aspose Cloud storage
// -----------------------------------------------------------------------------
$uploadRequest = new UploadFileRequest($source3DFile, $source3DFile);
$storageApi->uploadFile($uploadRequest);

// -----------------------------------------------------------------------------
// Perform the conversion: 3D → PDF
// -----------------------------------------------------------------------------
$convertRequest = new Convert3DRequest($source3DFile, $targetPdfFile, 'pdf');
$threeDApi->convert3D($convertRequest);

// -----------------------------------------------------------------------------
// Download the resulting PDF back to local storage
// -----------------------------------------------------------------------------
$downloadRequest = new DownloadFileRequest($targetPdfFile);
$response = $storageApi->downloadFile($downloadRequest);
$localPdfPath = __DIR__ . '/output.pdf';
file_put_contents($localPdfPath, $response->getContent());

// -----------------------------------------------------------------------------
// Clean‑up: optionally delete files from cloud storage
// -----------------------------------------------------------------------------
$storageApi->deleteFile(new \Aspose\ThreeD\Model\DeleteFileRequest($source3DFile));
$storageApi->deleteFile(new \Aspose\ThreeD\Model\DeleteFileRequest($targetPdfFile));

echo "3D to PDF conversion completed. PDF saved to: {$localPdfPath}\n";

Σημείωση: Αυτό το παράδειγμα κώδικα δείχνει τη βασική λειτουργικότητα. Πριν το χρησιμοποιήσετε στο έργο σας, βεβαιωθείτε ότι έχετε ενημερώσει τυχόν διαδρομές αρχείων και τιμές ρυθμίσεων ώστε να ταιριάζουν με το πραγματικό σας περιβάλλον, επαληθεύστε ότι όλες οι απαιτούμενες εξαρτήσεις είναι σωστά εγκατεστημένες και δοκιμάστε ενδελεχώς στο περιβάλλον ανάπτυξής σας. Εάν αντιμετωπίσετε προβλήματα, παρακαλούμε ανατρέξτε στην επίσημη τεκμηρίωση ή επικοινωνήστε με την ομάδα υποστήριξης για βοήθεια.

Μετατροπή 3D μοντέλων χρησιμοποιώντας cURL και το REST API

Αν προτιμάτε να εργάζεστε απευθείας με τα REST endpoints, οι παρακάτω εντολές cURL επιτυγχάνουν το ίδιο αποτέλεσμα.

  1. Αυθεντικοποίηση και λήψη διακριτικού πρόσβασης

Αντικαταστήστε το YOUR_CLIENT_ID και το YOUR_CLIENT_SECRET με τα διαπιστευτήριά σας.

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"

Η απάντηση περιέχει ένα access_token που χρησιμοποιείται σε επόμενες κλήσεις.

  1. Ανεβάστε το Πηγαίο αρχείο OBJ
curl -X PUT "https://api.aspose.cloud/v3.0/3d/storage/file/sample.obj" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -T "sample.obj"
  1. Εκτελέστε τη Μετατροπή
curl -X POST "https://api.aspose.cloud/v3.0/3d/convert/sample.obj?format=pdf&outPath=sample.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  1. Κατεβάστε το PDF εξόδου
   curl -X GET "https://api.aspose.cloud/v3.0/3d/storage/file/sample.pdf" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -o "output.pdf"

Για μια πλήρη λίστα παραμέτρων και διαχείρισης σφαλμάτων, δείτε την αναφορά API.

Επιλογές Μετατροπής: Ρυθμίσεις και Βελτιώσεις

Το SDK εκθέτει πολλές ιδιότητες που μπορείτε να ρυθμίσετε πριν καλέσετε convert3D:

  • Μορφή εξόδου - Το τρίτο όρισμα του Convert3DRequest ορίζει τη μορφή προορισμού (pdf σε αυτό το tutorial). Αλλάξτε το σε png ή jpeg για έξοδο εικόνας.
  • URL κεντρικού υπολογιστή - Εάν χρησιμοποιείτε περιφερειακό σημείο λήψης Aspose Cloud, τροποποιήστε $config->setHost('https://api-eu.aspose.cloud');.
  • Χρονικά όρια - Τόσο StorageApi όσο και ThreeDApi δέχονται προαιρετικές ρυθμίσεις πελάτη HTTP, όπου μπορείτε να ορίσετε χρονικά όρια αιτήσεων για μεγάλα αρχεία.

Αυτές οι επιλογές σας επιτρέπουν να προσαρμόσετε τη διαδικασία μετατροπής στις απαιτήσεις απόδοσης και συμμόρφωσης. Για πλήρη λίστα, ανατρέξτε στην αναφορά API.

Συμπέρασμα

Τώρα έχετε κατακτήσει τη μετατροπή 3D σε PDF σε PHP χρησιμοποιώντας το Aspose.Email Cloud SDK for PHP. Ο οδηγός κάλυψε όλα, από τη ρύθμιση του περιβάλλοντος μέχρι ένα πλήρες, έτοιμο για παραγωγή σενάριο και μια εναλλακτική λύση cURL. Θυμηθείτε ότι το SDK είναι εμπορικό προϊόν· μπορείτε να ελέγξετε τις λεπτομέρειες τιμολόγησης στη σελίδα του προϊόντος και να αποκτήσετε προσωρινή άδεια για αξιολόγηση στη σελίδα προσωρινής άδειας. Ενσωματώστε αυτή τη ροή εργασίας στις δικές σας εφαρμογές για να παρέχετε απρόσκοπτη διαχείριση 3D εγγράφων στους χρήστες σας.

Συχνές ερωτήσεις

  • Ποιος είναι ο πιο εύκολος τρόπος για να εκτελέσετε τη μετατροπή 3D σε PDF σε PHP;
    Χρησιμοποιώντας το Aspose.Email Cloud SDK for PHP είναι η πιο απλή μέθοδος. Η βιβλιοθήκη αφαιρεί τις κλήσεις REST και σας επιτρέπει να μετατρέψετε μοντέλα 3D σε PDF με λίγες μόνο γραμμές κώδικα.

  • Μπορώ να μετατρέψω άλλες μορφές 3D εκτός από OBJ με αυτή τη βιβλιοθήκη;
    Ναι, το SDK υποστηρίζει STL, FBX, 3DS και άλλες κοινές μορφές 3D. Απλώς αλλάξτε το όνομα του αρχείου πηγής και το SDK θα διαχειριστεί τη μετατροπή σε PDF.

  • Πώς μπορώ να διαχειριστώ μεγάλα αρχεία 3D κατά τη μετατροπή;
    Ανεβάστε το αρχείο στην αποθήκη Aspose Cloud πρώτα, στη συνέχεια ενεργοποιήστε τη μετατροπή. Αυτό διατηρεί τη χρήση μνήμης χαμηλή στον διακομιστή σας. Για πολύ μεγάλα αρχεία, σκεφτείτε να τα χωρίσετε ή να χρησιμοποιήσετε το ασύγχρονο API μετατροπής.

  • Υπάρχει τρόπος να προσαρμόσετε την έξοδο PDF, όπως το μέγεθος ή τον προσανατολισμό της σελίδας;
    Το API μετατροπής σας επιτρέπει να καθορίσετε πρόσθετες παραμέτρους στο σώμα του αιτήματος. Ανατρέξτε στην αναφορά API για την πλήρη λίστα των υποστηριζόμενων επιλογών.

Διαβάστε περισσότερα