在 Aspose.Slides for Node.js via Java 中的多執行緒

簡介

雖然在多執行緒環境下可以平行處理簡報（除了解析/載入/克隆之外）且大多數情況都能順利執行，但仍有小機會在多執行緒使用此函式庫時得到不正確的結果。

我們強烈建議您 不要 在多執行緒環境中使用單一的 Presentation 實例，因為這可能導致難以偵測的不可預期錯誤或失敗。

在多執行緒中載入、儲存和/或克隆 Presentation 類別的實例 不是 安全的，此類操作 不受支援。如果您必須執行此類任務，必須透過多個單執行緒的行程平行處理，且每個行程都應使用其自己的簡報實例。

並行將簡報投影片轉換為影像

假設我們想要將 PowerPoint 簡報的所有投影片平行轉換為 PNG 影像。由於在多執行緒中使用單一的 Presentation 實例不安全，我們將投影片拆分為多個簡報，並在各自的執行緒中平行轉換為影像。以下程式碼示例說明了如何做到這一點。

const inputFilePath = "sample.pptx";
const outputFilePathTemplate = "slide_%d.png";
const imageScale = 2;

(async () => {
    const presentation = new aspose.slides.Presentation(inputFilePath);
    const slideCount = presentation.getSlides().size();
    const slideSize = presentation.getSlideSize().getSize();
    const slideWidth = slideSize.getWidth();
    const slideHeight = slideSize.getHeight();

    const conversionTasks = Array.from({ length: slideCount }, async (_, slideIndex) => {
        // 將投影片 i 提取為單獨的簡報。
        const slidePresentation = new aspose.slides.Presentation();
        slidePresentation.getSlideSize().setSize(slideWidth, slideHeight, aspose.slides.SlideSizeScaleType.DoNotScale);
        slidePresentation.getSlides().removeAt(0);
        slidePresentation.getSlides().addClone(presentation.getSlides().get_Item(slideIndex));

        try {
            const slide = slidePresentation.getSlides().get_Item(0);
            const image = slide.getImage(imageScale, imageScale);
            const imageFilePath = outputFilePathTemplate.replace("%d", slideIndex + 1);

            image.save(imageFilePath, aspose.slides.ImageFormat.Png);
            console.log(`Saved slide ${slideIndex + 1} to ${imageFilePath}`);
        } catch (error) {
            console.error(`Error processing slide ${slideIndex + 1}: ${error.message}`);
        } finally {
            slidePresentation.dispose();
        }
    });

    // 等待所有任務完成。
    await Promise.all(conversionTasks);

    presentation.dispose();
})();

常見問題

我需要在每個執行緒中呼叫授權設定嗎？

不需要。只需在執行緒啟動之前於每個程序/應用程式域執行一次即可。如果 license setup 可能同時被呼叫（例如在延遲初始化期間），請同步該呼叫，因為授權設定方法本身並非執行緒安全。

我可以在執行緒之間傳遞 Presentation 或 Slide 物件嗎？

不建議在執行緒之間傳遞「即時」的簡報物件：請為每個執行緒使用獨立的實例，或事先為每個執行緒建立獨立的簡報/投影片容器。此做法呼應一般建議，即不要在執行緒之間共享單一簡報實例。

只要每個執行緒具有自己的 Presentation 實例，將匯出平行化為不同格式（PDF、HTML、影像）是否安全？

是的。只要使用獨立的實例並指定不同的輸出路徑，此類工作通常能正確平行化；請避免共享簡報物件或共享 I/O 串流。

在多執行緒環境下，我應該如何處理全域字型設定（資料夾、替代）？

請在啟動執行緒前先初始化所有全域字型設定，且在平行工作期間不要更改它們。如此可避免存取共享字型資源時的競爭條件。