Aspose.3D Cloud SDK for Java به توسعه‌دهندگان امکان می‌دهد تا به‌صورت برنامه‌نویسی با فرمت‌های فایل 3D در برنامه‌های Java کار کنند. این کتابخانه تبدیل، رندرینگ و دستکاری با کارایی بالا برای مدل‌های 3D محبوب مانند GLB و OBJ را فراهم می‌کند. این راهنما نشان می‌دهد چگونه فایل‌های GLB را به فرمت OBJ در Java تبدیل کنید، داده‌های متریال را حفظ کنید و مدل‌های متعدد را برای خطوط لوله بزرگ‌مقیاس به‌صورت دسته‌ای پردازش کنید.

پیش‌نیازها و تنظیمات

برای دنبال کردن این آموزش به موارد زیر نیاز دارید:

  • Java Development Kit (JDK) 8 یا بالاتر.
  • Maven برای مدیریت وابستگی‌ها.
  • یک حساب Aspose Cloud با client ID و client secret.

آخرین نسخه را از این صفحه دانلود کنید.

<!-- Maven dependency -->
<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-3d-cloud</artifactId>
    <version>22.12</version>
</dependency>

وابستگی را به فایل pom.xml خود اضافه کنید و برای دریافت کتابخانه، mvn install com.aspose:aspose-3d-cloud را اجرا کنید.

مراحل تبدیل GLB به OBJ

  1. ایجاد کلاینت API: کلاس ThreeDApi را با اعتبارهای کلاینت خود مقداردهی اولیه کنید. این کلاس در مرجع API مستند شده است.

  2. بارگذاری فایل GLB: از متد UploadFile برای ذخیره مدل منبع در Aspose Cloud storage استفاده کنید.

  3. پیکربندی گزینه‌های تبدیل: ExportOptions را تنظیم کنید تا مواد و بافت‌ها حفظ شوند. کلاس ExportOptions به شما امکان می‌دهد تنظیمات خاص فرمت را کنترل کنید.

  4. اجرای تبدیل: تابع Convert را با نام فایل منبع، فرمت هدف obj و گزینه‌های آماده‌شده فراخوانی کنید.

  5. دانلود نتیجه OBJ: فایل تبدیل‌شده را با استفاده از DownloadFile دریافت کنید و به‌صورت محلی ذخیره کنید.

ویژگی‌های کلیدی Aspose.3D Cloud SDK for Java

  • پشتیبانی از فرمت: پردازش GLB، OBJ، FBX، STL و بسیاری از فرمت‌های دیگر 3D.
  • حفظ مواد: نگهداری نقشه‌های بافت، رنگ‌ها و ویژگی‌های مواد در طول تبدیل.
  • پردازش ابری: بارگذاری رندرینگ و تبدیل سنگین به سرورهای Aspose برای آزادسازی منابع محلی.
  • عملیات دسته‌ای مقیاس‌پذیر: پشتیبانی از بارگذاری‌ها و تبدیل‌های موازی برای کتابخانه‌های بزرگ مدل.

درک فرمت‌های GLB و OBJ

GLB نسخه باینری glTF است، یک فرمت مدرن و کارآمد برای انتقال صحنه‌های سه‌بعدی با بافت‌های جاسازی‌شده. OBJ یک فرمت متنی قدیمی است که به‌طور گسترده‌ای توسط ابزارهای CAD و رندرینگ پشتیبانی می‌شود، اما برای تعریف مواد به فایل‌های جداگانه .mtl نیاز دارد. تبدیل بین این دو اغلب شامل استخراج داده‌های بافت و بازسازی ارجاعات مواد می‌شود.

پیکربندی گزینه‌های تبدیل در Aspose.3D Cloud SDK

شیء ExportOptions پرچم‌هایی مانند preserveMaterials، exportTextures و exportNormals را فراهم می‌کند. تنظیم صحیح این‌ها اطمینان می‌دهد که فایل OBJ حاصل شامل یک فایل .mtl متطابق و تصاویر بافت مرتبط باشد.

مدیریت بافت‌ها و مواد با Aspose.3D Cloud SDK

زمانی که یک فایل GLB حاوی بافت‌های جاسازی‌شده باشد، SDK آن‌ها را به پوشه ذخیره‌سازی ابری استخراج می‌کند. در طول تبدیل، کتابخانه یک فایل .mtl تولید می‌کند که این بافت‌ها را با مسیر نسبی ارجاع می‌دهد. اطمینان حاصل کنید که پوشه خروجی برای موتور رندرینگ شما قابل دسترسی باشد.

بهینه‌سازی عملکرد برای تبدیل دسته‌ای با استفاده از Aspose.3D Cloud SDK

  • بارگذاری‌های موازی: از ExecutorService جاوا برای بارگذاری همزمان چندین فایل GLB استفاده کنید.
  • استفاده مجدد از کلاینت API: یک نمونهٔ ThreeDApi ایجاد کنید و آن را بین رشته‌ها به اشتراک بگذارید.
  • بارگیری‌های تکه‌ای: فایل‌های بزرگ OBJ را به صورت بخش‑بخش دریافت کنید تا از افزایش ناگهانی حافظه جلوگیری شود.

مدیریت خطا و عیب‌یابی در Aspose.3D Cloud SDK

تمام فراخوانی‌های API یک شیء Response برمی‌گردانند. فیلدهای statusCode و errorMessage را بررسی کنید. مشکلات رایج شامل اعتبارنامه‌های نامعتبر، ویژگی‌های پشتیبانی‌نشده فایل یا محدودیت‌های سهمیه ذخیره‌سازی هستند. برای کدهای خطای دقیق به مستندات رسمی مراجعه کنید.

بهترین روش‌ها برای مقیاس‌پذیری و استقرار با Aspose.3D Cloud SDK

  • اطلاعات اعتبار مشتری را به‌صورت ایمن ذخیره کنید، به عنوان مثال در متغیرهای محیطی یا یک مدیر رازها.
  • منطق تلاش مجدد را با تاخیر افزایشی نمایی برای خطاهای موقت شبکه پیاده‌سازی کنید.
  • استفاده از API را از طریق داشبورد Aspose Cloud نظارت کنید تا در محدوده محدودیت‌های برنامه خود بمانید.

تبدیل GLB به OBJ در جاوا - مثال کامل کد

این مثال نشان می‌دهد که چگونه احراز هویت کنید، یک فایل GLB را بارگذاری کنید، آن را به OBJ تبدیل کنید در حالی که مواد را حفظ می‌کند، و نتیجه را دانلود کنید.

توجه: این مثال کد عملکرد اصلی را نشان می‌دهد. قبل از استفاده از آن در پروژه خود، اطمینان حاصل کنید که مسیرهای فایل (model.glb, C:/Models/, C:/Converted/) را به مکان‌های واقعی خود به‌روز کنید، بررسی کنید که تمام وابستگی‌های مورد نیاز به‌درستی نصب شده‌اند و به‌طور کامل در محیط توسعه خود تست کنید. اگر با مشکلی مواجه شدید، لطفاً به مستندات رسمی مراجعه کنید یا برای دریافت کمک به تیم پشتیبانی مراجعه نمایید.

تبدیل GLB به OBJ از طریق REST API با استفاده از cURL

تبدیل مشابه می‌تواند به‌صورت مستقیم از طریق نقاط انتهایی REST Aspose انجام شود که برای اسکریپت‌ها یا خطوط لوله CI مفید است.

  1. دریافت توکن دسترسی
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. بارگذاری فایل GLB
curl -X PUT "https://api.aspose.cloud/v3.0/3d/storage/file/temp/model.glb" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary "@C:/Models/model.glb"
  1. شروع تبدیل
curl -X POST "https://api.aspose.cloud/v3.0/3d/storage/file/temp/model.glb/convert?format=obj&preserveMaterials=true&exportTextures=true" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Accept: application/json"
  1. دانلود نتیجه OBJ
curl -X GET "https://api.aspose.cloud/v3.0/3d/storage/file/temp/model.obj" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o "C:/Converted/model.obj"

برای دریافت فهرست کامل پارامترها و نقاط انتهایی، مستندات رسمی API را ببینید.

نتیجه‌گیری

در این راهنما نحوه تبدیل فایل‌های GLB به فرمت OBJ در جاوا با استفاده از Aspose.3D Cloud SDK for Java را پوشش دادیم. شما یاد گرفتید که کتابخانه را تنظیم کنید، مدل‌ها را به صورت دسته‌ای پردازش کنید، داده‌های متریال را حفظ کنید و هم از API جاوا و هم از تماس‌های مستقیم REST با cURL استفاده کنید. برای استقرارهای تولیدی، یک لایسنس مناسب از صفحه قیمت‌گذاری دریافت کنید و برای ارزیابی، لایسنس موقت را در نظر بگیرید. با Aspose.3D Cloud می‌توانید خطوط لوله 3D مقیاس‌پذیر و خودکار بسازید که کتابخانه‌های بزرگ مدل را به‌صورت کارآمد مدیریت می‌کنند.

سوالات متداول

چگونه می‌توانم چندین فایل GLB را در یک اجرا تبدیل کنم؟
فهرست فایل‌های خود را پیمایش کنید، هر GLB را به ذخیره‌سازی ابری بارگذاری کنید، و متد convertFile را داخل یک حلقه یا با استفاده از یک استخر رشته‌ها فراخوانی کنید. این کتابخانه ایمن برای استفاده در چندین رشته است و برای سناریوهای دسته‌ای به خوبی کار می‌کند.

اگر فایل GLB من حاوی ارجاع‌های تکسچر خارجی باشد؟
اطمینان حاصل کنید که تمام تکسچرها داخل GLB (binary glTF) بسته‌بندی شده‌اند. فرآیند تبدیل به‌صورت خودکار آن‌ها را استخراج می‌کند؛ در غیر این صورت، باید تکسچرها را به‌صورت جداگانه بارگذاری کنید و در گزینه‌های تبدیل به آن‌ها ارجاع دهید.

آیا می‌توانم از این کتابخانه در یک سرور بدون رابط گرافیکی استفاده کنم؟
بله، کتابخانه Aspose.3D Cloud بر روی هر زمان اجرا جاوا بدون محیط گرافیکی اجرا می‌شود. فقط اعتبارنامه‌های مورد نیاز و دسترسی شبکه به سرویس‌های Aspose Cloud را فراهم کنید.

آیا راهی برای تست تبدیل بدون داشتن لایسنس پرداختی وجود دارد؟
یک لایسنس ارزیابی موقت در دسترس است، اما برای هر بار کاری تولیدی باید لایسنس خریداری کنید. جزئیات در صفحه لایسنس موقت موجود است.

بیشتر بخوانید