JavaScript에서 프레젠테이션 열기

이 페이지의 내용

JavaScript에서 PowerPoint 및 OpenDocument 프레젠테이션을 여는 방법, 열기 비밀번호 제공, 리소스 로딩 제어, 그리고 Aspose.Slides for Node.js via Java를 사용하여 메모리 사용량을 줄이는 방법을 배웁니다.

소개

Aspose.Slides for Node.js via Java는 파일과 스트림에서 PowerPoint 및 OpenDocument 프레젠테이션을 로드할 수 있습니다. 프레젠테이션이 로드된 후에는 구조를 검사하고, 슬라이드를 편집하고, 리소스를 관리하며, 원본 형식이나 다른 지원 형식으로 저장할 수 있습니다.

로드 동작은 LoadOptions 클래스를 통해 사용자 지정할 수 있습니다. 예를 들어, 열기 비밀번호를 제공하고, 대용량 바이너리 객체를 Node.js 메모리 외부에 보관하고, 외부 리소스를 제어하거나 임베드된 바이너리 데이터를 생략할 수 있습니다.

프레젠테이션 열기

파일이나 스트림을 로드한 후, 원본 프레젠테이션 형식 확인을 통해 애플리케이션이 이를 어떻게 처리할지 선택할 수 있습니다.

기존 프레젠테이션을 열려면 파일 경로를 Presentation 생성자에 전달합니다. 사용이 끝난 뒤 프레젠테이션을 Dispose하여 파일 핸들, 임시 데이터 및 기타 리소스가 즉시 해제되도록 합니다.

다음 JavaScript 예제는 프레젠테이션을 열고 슬라이드 수를 가져오는 방법을 보여줍니다:

const slides = require("aspose.slides.via.java");

const presentation = new slides.Presentation("sample.pptx");
try {
    console.log("Slide count: " + presentation.getSlides().size());
} finally {
    presentation.dispose();
}

비밀번호로 보호된 프레젠테이션 열기

열기 비밀번호는 프레젠테이션 내용을 암호화합니다. 전체 프레젠테이션을 로드하려면 올바른 비밀번호를 LoadOptions.setPassword 에 전달하고 해당 옵션을 Presentation 생성자에 제공하십시오. 비밀번호가 없거나 잘못된 경우 로드에 실패합니다.

const slides = require("aspose.slides.via.java");

const loadOptions = new slides.LoadOptions();
loadOptions.setPassword("open_password");

const presentation = new slides.Presentation("encrypted-presentation.pptx", loadOptions);
try {
    console.log("Slide count: " + presentation.getSlides().size());
} finally {
    presentation.dispose();
}

비밀번호 감지, 검증 및 암호화 워크플로에 대해서는 비밀번호로 보호된 프레젠테이션을 참조하십시오. 암호화된 프레젠테이션이 공개 문서 속성으로 저장된 경우 비밀번호 없이 해당 속성을 읽을 수 있습니다; 프레젠테이션 속성 관리를 보세요.

대용량 프레젠테이션 열기

LoadOptions.getBlobManagementOptions 은 이미지, 오디오 및 비디오와 같은 대용량 바이너리 객체를 Aspose.Slides가 처리하는 방식을 제어하는 옵션을 반환합니다. 소스 파일을 잠근 상태로 유지하고, 임시 파일을 허용하며, 메모리에 유지되는 BLOB 데이터 양을 제한할 수 있습니다.

다음 JavaScript 코드는 대용량 프레젠테이션(예: 2 GB)을 로드하는 방법을 보여줍니다:

const slides = require("aspose.slides.via.java");

const filePath = "large-presentation.pptx";

const loadOptions = new slides.LoadOptions();
loadOptions.getBlobManagementOptions().setPresentationLockingBehavior(slides.PresentationLockingBehavior.KeepLocked);
loadOptions.getBlobManagementOptions().setTemporaryFilesAllowed(true);
loadOptions.getBlobManagementOptions().setMaxBlobsBytesInMemory(10 * 1024 * 1024);

const presentation = new slides.Presentation(filePath, loadOptions);
try {
    presentation.getSlides().get_Item(0).setName("Large presentation");
    presentation.save("large-presentation-copy.pptx", slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Note

PresentationLockingBehavior.KeepLocked를 사용하면 프레젠테이션 인스턴스가 Dispose될 때까지 소스 파일이 잠긴 상태로 유지됩니다. 해당 인스턴스가 살아 있는 동안 소스 파일을 이동, 덮어쓰기 또는 삭제하지 마세요.

Aspose.Slides는 로드 중에 입력 스트림의 내용을 복사할 수 있습니다. 대용량 프레젠테이션의 경우 파일 경지가 일반적으로 스트림보다 더 효율적입니다. 추가적인 저장 및 메모리 관리 옵션은 BLOB 관리를 참조하세요.

외부 리소스 제어

LoadOptions.setResourceLoadingCallback 은 IResourceLoadingCallback 구현을 받습니다. 콜백을 사용해 대체 데이터를 제공하거나, 리소스를 재지정하거나, 기본 로더를 사용하거나, 리소스를 건너뛸 수 있습니다. 이는 프레젠테이션에 외부 이미지가 포함되어 있고 애플리케이션별 보안 또는 저장 규칙에 따라 처리해야 할 때 유용합니다.

const slides = require("aspose.slides.via.java");
const fs = require("fs");
const java = require("java");

const imageLoadingHandler = java.newProxy("com.aspose.slides.IResourceLoadingCallback", {
    resourceLoading: function(args) {
        const isJpeg = args.getOriginalUri().toLowerCase().endsWith(".jpg");
        const approvedImagePath = "approved-image.jpg";
        if (!isJpeg || !fs.existsSync(approvedImagePath)) {
            return slides.ResourceLoadingAction.Skip;
        }

        try {
            const imageData = fs.readFileSync(approvedImagePath);
            args.setData(imageData);
            return slides.ResourceLoadingAction.UserProvided;
        } catch (error) {
            console.error("The approved replacement image could not be read.");
            return slides.ResourceLoadingAction.Skip;
        }
    }
});

const loadOptions = new slides.LoadOptions();
loadOptions.setResourceLoadingCallback(imageLoadingHandler);

const presentation = new slides.Presentation("presentation-with-external-images.pptx", loadOptions);
try {
    console.log("Slide count: " + presentation.getSlides().size());
} finally {
    presentation.dispose();
}

임베드된 바이너리 객체 없이 프레젠테이션 로드

프레젠테이션에는 애플리케이션이 필요로 하지 않거나 유지하고 싶지 않은 임베드된 바이너리 데이터가 포함될 수 있습니다. 예시:

VBA 프로젝트, Presentation.getVbaProject를 통해 사용할 수 있음;
임베드된 OLE 데이터, OleEmbeddedDataInfo.getEmbeddedFileData를 통해 사용할 수 있음;
ActiveX 컨트롤 데이터, Control.getActiveXControlBinary를 통해 사용할 수 있음.

LoadOptions.setDeleteEmbeddedBinaryObjects 를 true 로 설정하면 로드 중에 이러한 바이너리 데이터를 제거합니다. 로드된 프레젠테이션을 저장하여 정리된 결과를 유지하십시오.

이 옵션은 원치 않는 임베드된 페이로드에 대한 노출을 줄이지만, 완전한 악성코드 탐지 또는 콘텐츠 정화 시스템은 아닙니다.

const slides = require("aspose.slides.via.java");

const loadOptions = new slides.LoadOptions();
loadOptions.setDeleteEmbeddedBinaryObjects(true);

const presentation = new slides.Presentation("presentation-with-embedded-data.pptx", loadOptions);
try {
    presentation.save("presentation-without-embedded-data.pptx", slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

FAQ

파일이 손상되어 열 수 없는 경우 어떻게 알 수 있나요?

Aspose.Slides는 로드 중에 구문 분석 또는 형식 예외를 발생시킵니다. 잘못된 비밀번호 오류와는 별도로 해당 실패를 처리하여 애플리케이션이 원인을 정확하게 보고할 수 있도록 합니다.

필요한 폰트가 누락된 경우 어떻게 되나요?

프레젠테이션은 여전히 로드될 수 있지만, 렌더링 및 내보내기 시 폰트가 대체될 수 있습니다. 폰트 대체를 구성하거나 사용자 정의 폰트를 제공하여 출력이 보다 예측 가능하도록 할 수 있습니다.

프레젠테이션을 로드하면 임베드된 미디어도 로드되나요?

임베드된 오디오와 비디오는 프레젠테이션 객체 모델을 통해 사용할 수 있게 됩니다. 외부 리소스는 구성된 리소스 로딩 동작에 따라 해결되며, 해당 위치에 접근할 수 없는 경우 사용할 수 없을 수 있습니다.

JavaScript에서 프레젠테이션 만들기 JavaScript에서 프레젠테이션 정보 검색 및 업데이트