在 Python via Java 中開啟簡報

本頁內容簡介

了解如何在 Python via Java 中開啟 PowerPoint 與 OpenDocument 簡報、提供開啟密碼、控制資源載入，並使用 Aspose.Slides for Python via Java 減少記憶體使用。

簡介

Aspose.Slides for Python via Java 可以從檔案和資料流載入 PowerPoint 與 OpenDocument 簡報。載入簡報後，您可以檢查其結構、編輯投影片、管理資源，並以原始或其他支援的格式儲存。

可以透過 LoadOptions 類別自訂載入行為。例如，您可以提供開啟密碼、將大型二進位物件保留在 Java 堆外、控制外部資源，或省略嵌入的二進位資料。

開啟簡報

在載入檔案或資料流之後，您可以判斷其原始簡報格式，以決定應用程式如何處理它。

若要開啟現有簡報，將其檔案路徑傳遞給 Presentation 建構函式。使用完畢後請釋放簡報，以便及時釋放檔案句柄、暫存資料與其他資源。

以下 Python 範例示範如何開啟簡報並取得投影片數量：

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation

presentation = Presentation("sample.pptx")
try:
    print("Slide count:", presentation.getSlides().size())
finally:
    presentation.dispose()

開啟受密碼保護的簡報

開啟密碼會加密簡報內容。若要載入完整簡報，請將正確的密碼傳遞給 LoadOptions.setPassword 並將選項提供給 Presentation 建構函式。若密碼缺失或不正確，載入會失敗。

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import LoadOptions, Presentation

load_options = LoadOptions()
load_options.setPassword("open_password")

presentation = Presentation("encrypted-presentation.pptx", load_options)
try:
    print("Slide count:", presentation.getSlides().size())
finally:
    presentation.dispose()

有關密碼偵測、驗證與加密工作流程，請參閱密碼保護簡報。若加密的簡報刻意以公開文件屬性儲存，這些屬性可在未提供密碼的情況下讀取；請參閱管理簡報屬性。

開啟大型簡報

LoadOptions.getBlobManagementOptions 會回傳控制 Aspose.Slides 如何處理圖像、音訊與影片等大型二進位物件的選項。您可以保持來源檔案被鎖定、允許建立暫存檔，並限制保留在記憶體中的 BLOB 資料量。

以下 Python 程式碼示範載入大型簡報（例如 2 GB）：

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import LoadOptions, Presentation, PresentationLockingBehavior, SaveFormat

file_path = "large-presentation.pptx"

load_options = LoadOptions()
load_options.getBlobManagementOptions().setPresentationLockingBehavior(PresentationLockingBehavior.KeepLocked)
load_options.getBlobManagementOptions().setTemporaryFilesAllowed(True)
load_options.getBlobManagementOptions().setMaxBlobsBytesInMemory(10 * 1024 * 1024)

presentation = Presentation(file_path, load_options)
try:
    presentation.getSlides().get_Item(0).setName("Large presentation")
    presentation.save("large-presentation-copy.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Note

使用 PresentationLockingBehavior.KeepLocked 時，來源檔案會一直被鎖定，直到釋放簡報實例為止。請勿在實例仍在使用時移動、覆寫或刪除來源檔案。

Aspose.Slides 可能在載入時複製輸入串流的內容。對於大型簡報而言，使用檔案路徑通常比使用串流更有效率。請參閱管理 BLOB以取得其他儲存與記憶體管理選項。

控制外部資源

LoadOptions.setResourceLoadingCallback 接受實作 Java 資源載入回呼介面的 JPype 代理。回呼可提供替代資料、重新導向資源、使用預設載入器，或略過該資源。當簡報包含必須依應用程式特定安全或儲存規則解析的外部影像時，此功能相當有用。

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from pathlib import Path
from asposeslides.api import LoadOptions, Presentation, ResourceLoadingAction

class ImageLoadingHandler:
    def resourceLoading(self, resource_loading_arguments):
        is_jpeg = str(resource_loading_arguments.getOriginalUri()).lower().endswith(".jpg")
        approved_image_path = Path("approved-image.jpg")
        if not is_jpeg or not approved_image_path.exists():
            return ResourceLoadingAction.Skip

        try:
            image_data = approved_image_path.read_bytes()
            java_image_data = jpype.JArray(jpype.JByte)(image_data)
            resource_loading_arguments.setData(java_image_data)
            return ResourceLoadingAction.UserProvided
        except OSError:
            print("The approved replacement image could not be read.")
            return ResourceLoadingAction.Skip

load_options = LoadOptions()
image_loading_handler = ImageLoadingHandler()
callback = jpype.JProxy("com.aspose.slides.IResourceLoadingCallback", inst=image_loading_handler)
load_options.setResourceLoadingCallback(callback)

presentation = Presentation("presentation-with-external-images.pptx", load_options)
try:
    print("Slide count:", presentation.getSlides().size())
finally:
    presentation.dispose()

載入不含嵌入式二進位物件的簡報

簡報可能包含應用程式不需要或不想保留的嵌入式二進位資料。常見範例包括：

VBA 專案，可透過 Presentation.getVbaProject 取得；
嵌入的 OLE 資料，可透過 OleEmbeddedDataInfo.getEmbeddedFileData 取得；
ActiveX 控制項資料，可透過 Control.getActiveXControlBinary 取得。

將 LoadOptions.setDeleteEmbeddedBinaryObjects 設為 True，即可在載入時移除這些二進位資料。將載入後的簡報儲存，即可保留已清理的結果。

此選項可減少不必要的嵌入式負載，但並非完整的惡意程式偵測或內容淨化系統。

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import LoadOptions, Presentation, SaveFormat

load_options = LoadOptions()
load_options.setDeleteEmbeddedBinaryObjects(True)

presentation = Presentation("presentation-with-embedded-data.pptx", load_options)
try:
    presentation.save("presentation-without-embedded-data.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

常見問題

如何判斷檔案已損毀且無法開啟？

Aspose.Slides 在載入時會拋出解析或格式例外。請將此失敗與密碼錯誤區分處理，以便應用程式正確回報原因。

如果缺少必要的字型會發生什麼情況？

簡報仍然可以載入，但呈現與匯出時可能會使用替代字型。您可以設定字型替代或提供自訂字型，以使輸出更可預測。

載入簡報時是否也會載入其嵌入的媒體？

嵌入的音訊與視訊會透過簡報物件模型提供。外部資源會依照已設定的資源載入行為解析，若無法存取其位置，則可能無法取得。

在 Python 透過 Java 中建立簡報在 Python via Java 中取得與更新簡報資訊