La conversion de modèles 3D complexes en un format universellement visualisable est une exigence fréquente pour les pipelines d’ingénierie et de visualisation. Aspose.Slides Cloud SDK for Node.js fournit une bibliothèque puissante qui vous permet de convertir programmatique des fichiers 3D en PDF avec Node.JS. Ce guide vous accompagne à travers les prérequis, les étapes d’installation, une analyse détaillée du code, un exemple complet, les commandes REST cURL, ainsi que les options de configuration clés afin que vous puissiez intégrer rapidement la conversion 3D vers PDF dans vos applications.

Configuration d’Aspose.Slides Cloud SDK pour Node.js

Avant de commencer, assurez‑vous d’avoir ce qui suit :

  • Node.js 14 ou version ultérieure installé sur votre machine de développement.
  • Un compte Aspose Cloud. Créez‑en un sur le portail Aspose et notez votre Client Id et Client Secret.
  • Connectivité Internet pour que le SDK puisse appeler le service Aspose Slides Cloud.

Installez le SDK via npm:

npm install asposeslidescloud

Vous pouvez également télécharger le dernier package depuis la page de publication. Après l’installation, importez le SDK et configurez vos identifiants comme indiqué dans le guide ci‑dessous. Le SDK étant prêt, vous êtes prêt à commencer la conversion de fichiers 3D.

Construire étape par étape : Convertir le 3D en PDF avec Node.JS

Étape 1 : Initialiser le client Slides API

Créez un objet de configuration avec vos identifiants client et instanciez la classe SlidesApi.

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

La référence de la classe SlidesApi explique toutes les méthodes disponibles.

Étape 2 : Spécifier le fichier 3D source

Fournissez le nom du fichier 3D que vous souhaitez convertir. Le SDK prend en charge des formats tels que OBJ, STL, et FBX.

let name = "sample.pptx";

Étape 3 : Définir le format cible et le chemin de sortie

Définissez le format de sortie souhaité sur pdf et choisissez où le fichier converti sera enregistré.

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

Étape 4 : Exécuter la conversion

Appelez convertAndSave et gérez la promesse pour confirmer le succès ou capturer les erreurs.

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

Cet extrait montre le cœur de la façon de convertir du 3D en PDF dans Node.JS en utilisant la bibliothèque Aspose.Slides Cloud.

Exemple complet de code : Convertir le 3D en PDF efficacement

L’exemple suivant assemble toutes les pièces dans un script unique et exécutable.

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

Remarque : Cet exemple de code démontre la fonctionnalité principale. Avant de l’utiliser dans votre projet, assurez‑vous de mettre à jour tous les chemins de fichiers et les valeurs de configuration pour qu’ils correspondent à votre environnement réel, vérifiez que toutes les dépendances requises sont correctement installées et testez soigneusement dans votre environnement de développement. Si vous rencontrez des problèmes, veuillez consulter la documentation officielle ou contacter l’équipe de support pour obtenir de l’aide.

Réalisation de la conversion 3D en PDF via l’API REST avec cURL

Si vous préférez une approche REST pure, la même conversion peut être réalisée avec des commandes cURL.

1. Obtenir un jeton d’accès

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. Téléverser le fichier 3D source

curl -X PUT "https://api.aspose.cloud/v3.0/slides/storage/file/sample.pptx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -T "./sample.pptx"

3. Demande de conversion en 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. Télécharger le PDF converti (si non enregistré directement)

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

Pour une liste complète des paramètres et des options supplémentaires, consultez la référence de l’API.

Configuration des paramètres de conversion 3D vers PDF

Le SDK vous permet d’ajuster plusieurs paramètres afin de contrôler la sortie de la conversion. Voici deux options couramment utilisées :

  • Chemin de sortie - Détermine où le PDF converti sera enregistré sur le serveur.
let outPath = "custom_folder/converted.pdf";
  • Protection par mot de passe - Vous pouvez ajouter un mot de passe au PDF résultant pour la sécurité. Cette option est définie via le paramètre password dans la méthode convertAndSave (voir la référence API pour l’utilisation exacte).

Ajuster ces paramètres vous aide à adapter la conversion aux exigences de votre projet.

Conclusion

Maintenant que vous avez suivi le tutoriel, vous devriez être capable de transformer des diapositives 3D en fichiers PDF directement depuis une application Node.js en utilisant le Aspose.Slides Cloud SDK for Node.js. Le SDK se charge du travail lourd de rendu, tandis que l’API REST sous-jacente vous offre la flexibilité d’appeler le service sans la bibliothèque cliente. N’oubliez pas d’obtenir une licence valide pour tout déploiement en production, soit en achetant un abonnement sur la page de tarification Aspose, soit en demandant une clé temporaire sur la page de licence temporaire. Avec le code d’exemple et les conseils de configuration fournis, vous pouvez rapidement intégrer la conversion 3D‑vers‑PDF dans vos propres projets.

FAQ

Comment puis‑je convertir un fichier 3D en PDF dans Node.JS en utilisant Aspose.Slides Cloud SDK ?
Utilisez la méthode convertAndSave de la classe SlidesApi après avoir configuré vos informations d’identification client. Fournissez le nom du fichier 3D source, définissez le format sur "pdf" et indiquez un chemin de sortie.

Quels formats de fichiers 3D le SDK prend‑il en charge pour la conversion PDF ?
Le SDK prend en charge OBJ, STL, FBX, 3DS, GLTF, et plusieurs autres formats 3D standards de l’industrie. Voir la documentation pour la liste complète.

Dois-je gérer les jetons d’authentification manuellement ?
Non. Une fois que vous avez défini le clientId et le clientSecret dans l’objet de configuration, le SDK obtient et rafraîchit automatiquement le jeton d’accès pour chaque requête.

Y a-t-il une limite à la taille des fichiers 3D que je peux convertir ?
Le service cloud accepte les fichiers jusqu’à 200 Mo. Les fichiers plus volumineux doivent être divisés ou compressés avant le téléchargement.

Read More