Android でプレゼンテーションを開く

このページの概要

Android で PowerPoint および OpenDocument プレゼンテーションを開く方法、開く際のパスワードを指定する方法、リソース読み込みを制御する方法、そして Aspose.Slides for Android via Java を使用してメモリ使用量を削減する方法を学びます。

はじめに

Aspose.Slides for Android via Java は、ファイルやストリームから PowerPoint および OpenDocument プレゼンテーションを読み込むことができます。プレゼンテーションが読み込まれた後、その構造を検査したり、スライドを編集したり、リソースを管理したり、元の形式または他のサポートされている形式で保存したりできます。

読み込みの動作は、LoadOptions クラスを使用してカスタマイズできます。たとえば、開く際のパスワードを指定したり、大きなバイナリオブジェクトを Java ヒープメモリの外部に保持したり、外部リソースを制御したり、埋め込みバイナリデータを省略したりできます。

プレゼンテーションを開く

ファイルまたはストリームを読み込んだ後、元のプレゼンテーション形式を判別して、アプリケーションがどのように処理するかを選択できます。

既存のプレゼンテーションを開くには、そのファイルパスを Presentation コンストラクタに渡します。使用後はプレゼンテーションを破棄し、ファイルハンドルや一時データ、その他のリソースが速やかに解放されるようにしてください。

以下の Java の例は、プレゼンテーションを開いてスライド数を取得する方法を示しています：

import com.aspose.slides.Presentation;

Presentation presentation = new Presentation("sample.pptx");
try {
    System.out.println("Slide count: " + presentation.getSlides().size());
} finally {
    presentation.dispose();
}

パスワードで保護されたプレゼンテーションを開く

開く際のパスワードはプレゼンテーションの内容を暗号化します。完全なプレゼンテーションを読み込むには、正しいパスワードを LoadOptions.setPassword に渡し、そのオプションを Presentation コンストラクタに提供します。パスワードが無い、または誤っている場合、読み込みは失敗します。

import com.aspose.slides.LoadOptions;
import com.aspose.slides.Presentation;

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

Presentation presentation = new Presentation("encrypted-presentation.pptx", loadOptions);
try {
    System.out.println("Slide count: " + presentation.getSlides().size());
} finally {
    presentation.dispose();
}

パスワードの検出、検証、暗号化ワークフローについては、Password-Protect Presentations を参照してください。暗号化されたプレゼンテーションが意図的に公開ドキュメントプロパティとともに保存されている場合、そのプロパティはパスワードなしで読み取ることができます；詳細は Manage Presentation Properties をご覧ください。

大規模なプレゼンテーションを開く

LoadOptions.getBlobManagementOptions は、画像、音声、動画などのバイナリ大規模オブジェクト（BLOB）の Aspose.Slides による取り扱い方法を制御するオプションを返します。ソースファイルをロックしたままにしたり、一時ファイルを許可したり、メモリに保持する BLOB データの量を制限したりできます。

以下の Java コードは、大規模なプレゼンテーション（例: 2 GB）を読み込む方法を示しています：

import com.aspose.slides.LoadOptions;
import com.aspose.slides.Presentation;
import com.aspose.slides.PresentationLockingBehavior;
import com.aspose.slides.SaveFormat;

final String filePath = "large-presentation.pptx";

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

Presentation presentation = new Presentation(filePath, loadOptions);
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 は読み込み中に入力ストリームの内容をコピーすることがあります。大規模なプレゼンテーションの場合、ストリームよりもファイルパスを使用する方が一般的に効率的です。追加のストレージやメモリ管理オプションについては、Manage BLOBs を参照してください。

外部リソースの制御

LoadOptions.setResourceLoadingCallback は、IResourceLoadingCallback 実装を受け取ります。コールバックは、代替データを提供したり、リソースをリダイレクトしたり、デフォルトローダーを使用したり、リソースをスキップしたりできます。これは、プレゼンテーションに外部画像が含まれ、アプリケーション固有のセキュリティや保存ルールに従って解決する必要がある場合に便利です。

import com.aspose.slides.IResourceLoadingArgs;
import com.aspose.slides.IResourceLoadingCallback;
import com.aspose.slides.LoadOptions;
import com.aspose.slides.Presentation;
import com.aspose.slides.ResourceLoadingAction;
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.Locale;

class ImageLoadingHandler implements IResourceLoadingCallback {
    public int resourceLoading(IResourceLoadingArgs args) {
        boolean isJpeg = args.getOriginalUri().toLowerCase(Locale.ROOT).endsWith(".jpg");
        Path approvedImagePath = Paths.get("approved-image.jpg");
        if (!isJpeg || !Files.exists(approvedImagePath)) {
            return ResourceLoadingAction.Skip;
        }

        try {
            byte[] imageData = Files.readAllBytes(approvedImagePath);
            args.setData(imageData);
            return ResourceLoadingAction.UserProvided;
        } catch (IOException exception) {
            System.err.println("The approved replacement image could not be read.");
            return ResourceLoadingAction.Skip;
        }
    }
}

LoadOptions loadOptions = new LoadOptions();
loadOptions.setResourceLoadingCallback(new ImageLoadingHandler());

Presentation presentation = new Presentation("presentation-with-external-images.pptx", loadOptions);
try {
    System.out.println("Slide count: " + presentation.getSlides().size());
} finally {
    presentation.dispose();
}

埋め込みバイナリオブジェクトなしでプレゼンテーションを読み込む

プレゼンテーションには、アプリケーションが不要または保持したくない埋め込みバイナリデータが含まれることがあります。例としては以下があります：

VBA プロジェクト、IPresentation.getVbaProject を介して取得可能；
埋め込み OLE データ、IOleEmbeddedDataInfo.getEmbeddedFileData を介して取得可能；
ActiveX コントロールデータ、IControl.getActiveXControlBinary を介して取得可能。

LoadOptions.setDeleteEmbeddedBinaryObjects を true に設定すると、読み込み時にこのバイナリデータが削除されます。サニタイズされた結果を保持するには、読み込んだプレゼンテーションを保存してください。

このオプションは不要な埋め込みペイロードへの exposure を減らしますが、完全なマルウェア検出やコンテンツサニタイズシステムではありません。

import com.aspose.slides.LoadOptions;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;

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

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

FAQ

ファイルが破損していて開けないことはどうやって判別できますか？

Aspose.Slides は読み込み中にパースエラーまたはフォーマット例外をスローします。この失敗をパスワードが正しくないエラーとは別に処理し、アプリケーションが原因を正確に報告できるようにしてください。

必要なフォントが見つからない場合はどうなりますか？

プレゼンテーションは依然として読み込めますが、レンダリングやエクスポート時にフォントが代替されることがあります。出力をより予測可能にするために、フォント置換を構成したり、カスタムフォントを提供したりできます。

プレゼンテーションの読み込み時に埋め込みメディアも読み込まれますか？

埋め込みの音声や動画は、プレゼンテーションオブジェクトモデルを通じて利用可能になります。外部リソースは設定されたリソース読み込み動作に従って解決され、場所にアクセスできない場合は利用できないことがあります。

Android でプレゼンテーションを作成 Android でプレゼンテーション情報を取得および更新する