Karmaşık 3D modelleri evrensel olarak görüntülenebilir bir formata dönüştürmek, mühendislik ve görselleştirme boru hatları için sık bir gereksinimdir. Aspose.Slides Cloud SDK for Node.js programlı olarak 3D dosyalarını Node.JS’te PDF formatına dönüştürmenizi sağlayan güçlü bir kütüphane sunar. Bu kılavuz, önkoşulları, kurulum adımlarını, ayrıntılı kod yürütmesini, tam bir örneği, REST cURL komutlarını ve temel yapılandırma seçeneklerini adım adım göstererek 3D’den PDF’ye dönüşümü uygulamalarınıza hızlıca entegre etmenizi sağlar.

Aspose.Slides Cloud SDK for Node.js’ı Kurma

Başlamadan önce, aşağıdakilere sahip olduğunuzdan emin olun:

  • Geliştirme makinenizde Node.js 14 ve üzeri yüklü olmalıdır.
  • Bir Aspose Cloud hesabı. Aspose portalında bir hesap oluşturun ve Client Id ve Client Secret bilgilerinizi not alın.
  • SDK’nın Aspose Slides Cloud hizmetine bağlanabilmesi için internet bağlantısı.

SDK’yı npm aracılığıyla kurun:

npm install asposeslidescloud

Ayrıca en son paketi sürüm sayfası üzerinden indirebilirsiniz. Kurulumdan sonra, SDK’yı içe aktarın ve kimlik bilgilerinizi aşağıdaki adım adım rehberde gösterildiği gibi yapılandırın. SDK hazır olduğunda, 3D dosyalarını dönüştürmeye başlamaya hazırsınız.

Adım Adım Oluşturma: Node.JS’te 3D’yi PDF’ye Dönüştürme

Adım 1: Slides API İstemcisini Başlatın

İstemci kimlik bilgilerinizi kullanarak bir yapılandırma nesnesi oluşturun ve SlidesApi sınıfını örnekleyin.

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

SlidesApi sınıf referansı tüm kullanılabilir yöntemleri açıklar.

Adım 2: Kaynak 3D Dosyasını Belirtin

Dönüştürmek istediğiniz 3D dosyasının adını sağlayın. SDK, OBJ, STL, ve FBX gibi formatları destekler.

let name = "sample.pptx";

Adım 3: Hedef Biçimi ve Çıktı Yolunu Tanımlama

İstenen çıktı biçimini pdf olarak ayarlayın ve dönüştürülen dosyanın nerede kaydedileceğini seçin.

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

Adım 4: Dönüşümü Gerçekleştir

convertAndSave fonksiyonunu çağırın ve başarıyı doğrulamak ya da hataları yakalamak için promise’ı işleyin.

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

Bu snippet, Aspose.Slides Cloud kütüphanesini kullanarak Node.JS’te 3D’yi PDF’ye dönüştürmenin temelini gösterir.

Tam Kod Örneği: 3D’yi PDF’ye Verimli Bir Şekilde Dönüştür

Aşağıdaki örnek, tüm parçaları tek bir çalıştırılabilir betikte bir araya getirir.

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

Not: Bu kod örneği temel işlevselliği göstermektedir. Projenizde kullanmadan önce, dosya yollarını ve yapılandırma değerlerini gerçek ortamınıza uygun şekilde güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde yüklendiğinden emin olun ve geliştirme ortamınızda kapsamlı bir şekilde test edin. Herhangi bir sorunla karşılaşırsanız, lütfen resmi belgeler adresine bakın veya destek ekibi ile iletişime geçin.

cURL Kullanarak REST API ile 3D’den PDF’ye Dönüştürme

Saf bir REST yaklaşımını tercih ediyorsanız, aynı dönüşüm cURL komutlarıyla gerçekleştirilebilir.

1. Erişim Token’ı Al

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. Kaynak 3D Dosyasını Yükleyin

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’ye Dönüştürme İsteği

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

4. Dönüştürülmüş PDF’yi İndir (doğrudan kaydedilmediyse)

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

Parametrelerin tam listesi ve ek seçenekler için, API referansına bakın.

3D’den PDF’ye Dönüşüm Ayarlarını Yapılandırma

SDK, dönüşüm çıktısını kontrol etmek için birkaç parametreyi ayarlamanıza olanak tanır. Aşağıda yaygın olarak kullanılan iki seçenek bulunmaktadır:

  • Çıktı Yolu - Dönüştürülen PDF’nin sunucuda nerede kaydedileceğini belirler.
let outPath = "custom_folder/converted.pdf";
  • Şifre Koruması - Güvenlik için oluşturulan PDF’ye bir şifre ekleyebilirsiniz. Bu seçenek, convertAndSave yöntemindeki password parametresi aracılığıyla ayarlanır (tam kullanım için API referansına bakın).

Bu ayarları değiştirmek, dönüşümü projenizin gereksinimlerine göre özelleştirmenize yardımcı olur.

Sonuç

Artık öğreticiyi tamamladığınıza göre, Aspose.Slides Cloud SDK for Node.js‘i kullanarak 3D slaytları doğrudan bir Node.js uygulamasından PDF dosyalarına dönüştürebilmelisiniz. SDK, render işleminin zorluğunu üstlenirken, temel REST API, istemci kitaplığı olmadan hizmeti çağırma esnekliği sağlar. Üretim ortamı için geçerli bir lisans almayı unutmayın; bunu Aspose fiyatlandırma sayfasından bir abonelik satın alarak ya da geçici lisans sayfasından geçici bir anahtar talep ederek yapabilirsiniz. Sağlanan örnek kod ve yapılandırma ipuçlarıyla, 3D‑to‑PDF dönüşümünü projelerinize hızlıca entegre edebilirsiniz.

SSS

Node.JS’de Aspose.Slides Cloud SDK kullanarak 3D’yi PDF’ye nasıl dönüştürebilirim?
İstemci kimlik bilgilerinizi yapılandırdıktan sonra SlidesApi sınıfının convertAndSave metodunu kullanın. Kaynak 3D dosya adını sağlayın, formatı "pdf" olarak ayarlayın ve bir çıktı yolu belirtin.

SDK PDF dönüşümü için hangi 3D dosya formatlarını destekliyor?
SDK, OBJ, STL, FBX, 3DS, GLTF ve birkaç diğer endüstri‑standardı 3D formatını destekler. Tam liste için belgelere bakın.

Manuel olarak kimlik doğrulama token’larını yönetmem gerekiyor mu?
Hayır. clientId ve clientSecret değerlerini yapılandırma nesnesine ayarladığınızda, SDK her istek için erişim token’ını otomatik olarak alır ve yeniler.

3D dosyalarının dönüştürülebileceği boyutla ilgili bir sınırlama var mı?
Bulut hizmeti 200 MB’a kadar dosyaları kabul eder. Daha büyük dosyalar yüklemeden önce bölünmeli veya sıkıştırılmış olmalıdır.

Daha Fazla