복잡한 3D 모델을 보편적으로 볼 수 있는 형식으로 변환하는 것은 엔지니어링 및 시각화 파이프라인에서 자주 요구되는 작업입니다. Aspose.Slides Cloud SDK for Node.js는 3D 파일을 Node.JS에서 PDF로 프로그래밍 방식으로 변환할 수 있는 강력한 라이브러리를 제공합니다. 이 가이드는 사전 요구 사항, 설치 단계, 자세한 코드 walkthrough, 완전한 예제, REST cURL 명령 및 주요 구성 옵션을 안내하여 3D를 PDF로 변환하는 기능을 애플리케이션에 빠르게 통합할 수 있도록 도와줍니다.
Aspose.Slides Cloud SDK for Node.js 설정
시작하기 전에 다음 항목을 준비하십시오:
- 개발 머신에 Node.js 14 이상 설치되어 있어야 합니다.
- Aspose Cloud 계정. Aspose 포털에서 계정을 만들고 Client Id와 Client Secret을 기록해 두세요.
- SDK가 Aspose Slides Cloud 서비스를 호출할 수 있도록 인터넷 연결이 필요합니다.
npm을 통해 SDK를 설치합니다:
npm install asposeslidescloud
최신 패키지는 릴리스 페이지에서 다운로드할 수 있습니다. 설치 후, SDK를 가져오고 아래 안내에 표시된 대로 자격 증명을 구성하십시오. SDK가 준비되면 3D 파일 변환을 시작할 준비가 됩니다.
단계별 구축: Node.JS에서 3D를 PDF로 변환
1단계: Slides API 클라이언트 초기화
클라이언트 자격 증명을 사용하여 구성 객체를 생성하고 SlidesApi 클래스를 인스턴스화합니다.
let configuration = new SlidesApi.Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
let api = new SlidesApi.SlidesApi(configuration);
SlidesApi 클래스 참조는 사용 가능한 모든 메서드를 설명합니다.
2단계: 원본 3D 파일 지정
변환하려는 3D 파일의 이름을 제공하십시오. SDK는 OBJ, STL, 및 FBX와 같은 형식을 지원합니다.
let name = "sample.pptx";
3단계: 대상 형식 및 출력 경로 정의
원하는 출력 형식을 pdf 로 설정하고 변환된 파일을 저장할 위치를 선택합니다.
let format = "pdf";
let outPath = "output.pdf";
단계 4: 변환 실행
convertAndSave를 호출하고, 성공을 확인하거나 오류를 포착하기 위해 프라미스를 처리합니다.
api.convertAndSave(name, format, outPath, null, null, null, null, null)
.then(() => console.log("Converted"))
.catch(err => console.error(err));
이 스니펫은 Aspose.Slides Cloud 라이브러리를 사용하여 Node.JS에서 3D를 PDF로 변환하는 핵심 방법을 보여줍니다.
전체 코드 예제: 3D를 PDF로 효율적으로 변환
다음 예제는 모든 조각을 하나의 실행 가능한 스크립트로 결합합니다.
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));
참고: 이 코드 예제는 핵심 기능을 보여줍니다. 프로젝트에 사용하기 전에 파일 경로와 구성 값을 실제 환경에 맞게 업데이트하고, 모든 필수 종속성이 올바르게 설치되었는지 확인하며, 개발 환경에서 충분히 테스트하십시오. 문제가 발생하면 공식 문서를 참조하거나 지원 팀에 문의하십시오.
cURL을 사용한 REST API를 통한 3D PDF 변환 수행
순수 REST 방식을 선호한다면, 동일한 변환을 cURL 명령으로 수행할 수 있습니다.
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"
2. 소스 3D 파일 업로드
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로 변환 요청
curl -X POST "https://api.aspose.cloud/v3.0/slides/sample.pptx/convert/pdf" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o "output.pdf"
4. 변환된 PDF 다운로드 (직접 저장되지 않은 경우)
curl -X GET "https://api.aspose.cloud/v3.0/slides/storage/file/output.pdf" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o "output.pdf"
전체 매개변수 목록 및 추가 옵션은 API 참조를 참조하십시오.
3D를 PDF로 변환하기 위한 설정 구성
SDK를 사용하면 변환 출력물을 제어하기 위해 여러 매개변수를 조정할 수 있습니다. 아래는 일반적으로 사용되는 두 가지 옵션입니다:
- Output Path - 변환된 PDF가 서버에 저장될 위치를 결정합니다.
let outPath = "custom_folder/converted.pdf";
- Password Protection - 결과 PDF에 보안을 위해 비밀번호를 추가할 수 있습니다. 이 옵션은
convertAndSave메서드의password매개변수를 통해 설정됩니다 (정확한 사용법은 API 참조를 확인하세요).
이러한 설정을 조정하면 프로젝트 요구 사항에 맞게 변환을 맞춤화할 수 있습니다.
결론
이제 튜토리얼을 마쳤으니 Node.js 앱에서 Aspose.Slides Cloud SDK for Node.js를 사용하여 3D 슬라이드를 PDF 파일로 직접 변환할 수 있어야 합니다. SDK는 렌더링의 무거운 작업을 처리하고, 기본 REST API는 클라이언트 라이브러리 없이도 서비스를 호출할 수 있는 유연성을 제공합니다. 프로덕션 배포를 위해서는 유효한 라이선스를 확보해야 합니다. 이를 위해 Aspose 가격 페이지에서 구독을 구매하거나 임시 라이선스 페이지에서 임시 키를 요청하십시오. 제공된 샘플 코드와 구성 팁을 활용하면 3D‑to‑PDF 변환을 자신의 프로젝트에 빠르게 삽입할 수 있습니다.
자주 묻는 질문
Node.JS에서 Aspose.Slides Cloud SDK를 사용하여 3D를 PDF로 변환하려면 어떻게 해야 하나요?
클라이언트 자격 증명을 구성한 후 SlidesApi 클래스의 convertAndSave 메서드를 사용하십시오. 원본 3D 파일 이름을 제공하고, 형식을 "pdf" 로 설정한 다음, 출력 경로를 지정합니다.
SDK가 PDF 변환을 위해 지원하는 3D 파일 형식은 무엇인가요?
SDK는 OBJ, STL, FBX, 3DS, GLTF, 및 기타 여러 산업 표준 3D 형식을 지원합니다. 전체 목록은 문서를 확인하세요.
인증 토큰을 수동으로 관리해야 하나요?
아니요. 구성 객체에 clientId와 clientSecret를 설정하면 SDK가 각 요청마다 액세스 토큰을 자동으로 가져오고 갱신합니다.
3D 파일을 변환할 때 크기 제한이 있나요?
클라우드 서비스는 최대 200 MB까지 파일을 허용합니다. 더 큰 파일은 업로드하기 전에 분할하거나 압축해야 합니다.