Menentukan Format Presentasi Asli di Android

Ikhtisar

Setelah memuat presentasi, panggil metode Presentation.getSourceFormat untuk menentukan format aslinya. Metode ini juga tersedia melalui IPresentation.getSourceFormat. Gunakan metode ini ketika pemrosesan selanjutnya bergantung pada format di mana instance saat ini dimuat.

Format sumber berbeda dari SaveFormat yang dipilih untuk file output. Menyimpan ke format lain tidak mengubah format sumber dari instance yang ada.

Contoh-contoh menggunakan Java dan jalur file. Pada Android, ganti jalur contoh dengan jalur di penyimpanan yang dapat diakses aplikasi, seperti direktori file internal aplikasi Anda.

import com.aspose.slides.Presentation;
import com.aspose.slides.SourceFormat;

Presentation presentation = new Presentation("sample.pptx");
try {
    switch (presentation.getSourceFormat()) {
        case SourceFormat.Ppt:
        case SourceFormat.Pps:
        case SourceFormat.Pot:
            System.out.println("Use the legacy PowerPoint processing policy.");
            break;
        case SourceFormat.Pptx:
            System.out.println("Use the standard PPTX processing policy.");
            break;
        default:
            System.out.println("Use the general policy for source format " + presentation.getSourceFormat() + ".");
            break;
    }
} finally {
    presentation.dispose();
}

Baca Format Sumber dari File

Contoh ini memerlukan berkas sample.pptx yang sudah ada. Contoh memuat berkas tersebut dan memilih kebijakan pemrosesan aplikasi menggunakan Presentation.getSourceFormat , bukan berdasarkan nama berkas. Ubah jalur masukan untuk mencoba format lain. Contoh mencetak kebijakan yang dipilih; ganti pesan tersebut dengan logika aplikasi Anda.

import com.aspose.slides.Presentation;
import java.io.ByteArrayInputStream;
import java.io.IOException;
import java.io.ByteArrayOutputStream;
import java.io.FileInputStream;

try {
    byte[] bytes;
    try (FileInputStream input = new FileInputStream("sample.pps");
         ByteArrayOutputStream output = new ByteArrayOutputStream()) {
        byte[] buffer = new byte[8192];
        int bytesRead;
        while ((bytesRead = input.read(buffer)) != -1) {
            output.write(buffer, 0, bytesRead);
        }
        bytes = output.toByteArray();
    }
    try (ByteArrayInputStream stream = new ByteArrayInputStream(bytes)) {
        Presentation presentation = new Presentation(stream);
        try {
            System.out.println("Source format: " + presentation.getSourceFormat());
        } finally {
            presentation.dispose();
        }
    }
} catch (IOException exception) {
    System.err.println("Cannot read the presentation: " + exception.getMessage());
}

Mengenali Nilai yang Didukung

Kelas SourceFormat mendefinisikan konstanta integer yang membedakan format presentasi berikut. Ekstensi di bawah ini adalah ekstensi konvensional, bukan rekonstruksi nama file asli.

Nilai SourceFormat Ekstensi Format
Ppt .ppt presentasi PowerPoint 97–2003
Pptx .pptx presentasi Office Open XML
Pptm .pptm presentasi Office Open XML dengan makro
Pps .pps pertunjukan slide PowerPoint 97–2003
Ppsx .ppsx pertunjukan slide Office Open XML
Ppsm .ppsm pertunjukan slide Office Open XML dengan makro
Pot .pot templat PowerPoint 97–2003
Potx .potx templat Office Open XML
Potm .potm templat Office Open XML dengan makro
Odp .odp presentasi OpenDocument
Otp .otp templat presentasi OpenDocument
Fodp .fodp presentasi Flat XML ODF
Xml .xml presentasi PowerPoint XML

Baca Format Sumber dari Stream

Contoh ini memerlukan berkas sample.pps yang sudah ada. Membaca byte‑nya ke dalam memory stream mensimulasikan masukan yang diterima tanpa nama berkas, seperti nilai basis data atau array byte yang diunggah. Konstruktor Presentation menerima hanya stream tersebut.

import com.aspose.slides.Presentation;
import com.aspose.slides.SourceFormat;

Presentation presentation = new Presentation("sample.pptx");
try {
    String extension;
    switch (presentation.getSourceFormat()) {
        case SourceFormat.Ppt:
            extension = ".ppt";
            break;
        case SourceFormat.Pptx:
            extension = ".pptx";
            break;
        case SourceFormat.Pptm:
            extension = ".pptm";
            break;
        case SourceFormat.Pps:
            extension = ".pps";
            break;
        case SourceFormat.Ppsx:
            extension = ".ppsx";
            break;
        case SourceFormat.Ppsm:
            extension = ".ppsm";
            break;
        case SourceFormat.Pot:
            extension = ".pot";
            break;
        case SourceFormat.Potx:
            extension = ".potx";
            break;
        case SourceFormat.Potm:
            extension = ".potm";
            break;
        case SourceFormat.Odp:
            extension = ".odp";
            break;
        case SourceFormat.Otp:
            extension = ".otp";
            break;
        case SourceFormat.Fodp:
            extension = ".fodp";
            break;
        case SourceFormat.Xml:
            extension = ".xml";
            break;
        default:
            extension = null;
            break;
    }

    System.out.println(extension != null ? extension : "No extension mapping is available.");
} finally {
    presentation.dispose();
}

PPT, PPS, dan POT menggunakan format biner yang sama. Saat memuat melalui jalur file, ekstensi dapat membantu membedakan pertunjukan slide atau templat. Tanpa nama file, konten legacy PPS dan POT mungkin dilaporkan sebagai SourceFormat.Ppt; contoh PPS di atas mencetak nilai integer SourceFormat.Ppt.

Jika aplikasi Anda harus mempertahankan perbedaan tersebut, simpan nama file asli atau metadata subtipe secara terpisah. Ekstensi merupakan petunjuk yang berguna untuk subtipe legacy ini, tetapi tidak boleh menjadi satu‑satunya dasar untuk mengidentifikasi konten presentasi apa pun.

Bandingkan Deteksi Sebelum dan Sesudah Memuat

Gunakan PresentationFactory.getPresentationInfo dan IPresentationInfo.getLoadFormat ketika Anda perlu memeriksa file sebelum memuat model objek presentasi secara lengkap. Gunakan Presentation.getSourceFormat ketika instance sudah ada.

Contoh ini memerlukan sample.pptx dan mencetak nilai integer LoadFormat.Pptx dan SourceFormat.Pptx, masing‑masing. Dalam produksi, pilih API yang sesuai dengan tahap pemrosesan Anda; presentasi yang sudah dimuat tidak memerlukan inspeksi kedua hanya untuk memperoleh format sumbernya.

import com.aspose.slides.Presentation;
import com.aspose.slides.IPresentationInfo;
import com.aspose.slides.PresentationFactory;

String path = "sample.pptx";
IPresentationInfo information = PresentationFactory.getInstance().getPresentationInfo(path);
System.out.println("Before loading: " + information.getLoadFormat());

Presentation presentation = new Presentation(path);
try {
    System.out.println("After loading: " + presentation.getSourceFormat());
} finally {
    presentation.dispose();
}

Hasil menggunakan konstanta dari kelas yang berbeda: LoadFormat dan SourceFormat. Jangan membandingkan nilai numerik mereka atau mengasumsikan setiap format memiliki hasil deteksi yang identik. PowerPoint XML dapat dilaporkan sebagai LoadFormat.Unknown sebelum pemuatan dan SourceFormat.Xml setelah pemuatan.

Pisahkan Format Sumber dan Format Output

Contoh ini memerlukan sample.pptx dan menulis converted.odp. Contoh mencetak nilai integer SourceFormat.Pptx baik sebelum maupun setelah menyimpan instance asli. Hanya instance baru yang dimuat dari output ODP yang melaporkan Odp.

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

Presentation presentation = new Presentation("sample.pptx");
try {
    System.out.println("Before saving: " + presentation.getSourceFormat());

    presentation.save("converted.odp", SaveFormat.Odp);
    System.out.println("After saving: " + presentation.getSourceFormat());

    Presentation reopened = new Presentation("converted.odp");
    try {
        System.out.println("Reopened output: " + reopened.getSourceFormat());
    } finally {
        reopened.dispose();
    }
} finally {
    presentation.dispose();
}

Presentasi yang dibuat dari awal dengan new Presentation() melaporkan SourceFormat.Pptx. Tidak ada file masukan: ini adalah nilai default untuk instance yang baru dibuat, bukan bukti bahwa file PPTX telah dimuat. Lacak apakah aplikasi Anda membuat atau memuat instance secara terpisah jika perbedaan tersebut penting.

Petakan Format Sumber ke Ekstensi

Contoh berikut memerlukan sample.pptx. Contoh memetakan setiap nilai SourceFormat yang saat ini didukung ke ekstensi konvensional, tanpa menguraikan nama file masukan. Penanganan cadangan menghindari penetapan ekstensi secara diam‑diam pada nilai yang tidak dikenali.

import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;
import java.io.ByteArrayInputStream;
import java.io.IOException;
import java.io.ByteArrayOutputStream;
import java.io.FileInputStream;

Presentation presentation = new Presentation();
try {
    int[] formats = { SaveFormat.Pptx, SaveFormat.Odp, SaveFormat.Pps };
    String[] extensions = { "pptx", "odp", "pps" };

    for (int i = 0; i < formats.length; i++) {
        String path = "roundtrip." + extensions[i];
        presentation.save(path, formats[i]);

        Presentation fromFile = new Presentation(path);
        try {
            byte[] bytes;
            try (FileInputStream input = new FileInputStream(path);
                 ByteArrayOutputStream output = new ByteArrayOutputStream()) {
                byte[] buffer = new byte[8192];
                int bytesRead;
                while ((bytesRead = input.read(buffer)) != -1) {
                    output.write(buffer, 0, bytesRead);
                }
                bytes = output.toByteArray();
            }
            try (ByteArrayInputStream stream = new ByteArrayInputStream(bytes)) {
                Presentation fromStream = new Presentation(stream);
                try {
                    System.out.println(extensions[i] + ": file=" + fromFile.getSourceFormat() + ", stream=" + fromStream.getSourceFormat());
                } finally {
                    fromStream.dispose();
                }
            }
        } finally {
            fromFile.dispose();
        }
    }
} catch (IOException exception) {
    System.err.println("Cannot read a saved presentation: " + exception.getMessage());
} finally {
    presentation.dispose();
}

Pemetaannya tidak mengonversi file atau memulihkan subtipe legacy PPS/POT yang hilang selama pemuatan stream. Untuk penyimpanan sebenarnya, pilih SaveFormat secara eksplisit, atau gunakan konversi yang ditunjukkan dalam Simpan Presentasi dalam Format Aslinya.

Verifikasi Format dengan Menyimpan dan Membuka Kembali

Contoh mandiri ini membuat sebuah presentasi dan menulis tiga file di direktori kerja, menimpa file dengan nama yang sama. Contoh membuka kembali setiap output baik melalui jalur maupun melalui memory stream. Untuk PPTX dan ODP, kedua cara melaporkan format yang disimpan. Untuk PPS, memuat melalui jalur melaporkan Pps, sementara memuat byte yang sama tanpa nama file melaporkan Ppt.

Format yang Disimpan SourceFormat dari jalur file SourceFormat dari stream tanpa nama
PPT Ppt Ppt
PPTX, PPTM Pptx, Pptm masing‑masing Sama dengan jalur file
PPS Pps Ppt
PPSX, PPSM Ppsx, Ppsm masing‑masing Sama dengan jalur file
POT Pot Ppt
POTX, POTM Potx, Potm masing‑masing Sama dengan jalur file
ODP, OTP Odp, Otp masing‑masing Sama dengan jalur file
FODP Fodp Fodp
PowerPoint XML Xml Xml

Konten PPS/POT diidentifikasi sebagai Ppt untuk stream tanpa nama. Tabel menggambarkan identifikasi format, bukan preservasi setiap fitur presentasi selama konversi.

FAQ

Apakah menyimpan ke ODP mengubah format sumber presentasi yang dimuat dari PPTX?

Tidak. Instance yang ada masih melaporkan Pptx. Instance yang dimuat dari file ODP yang disimpan melaporkan Odp.

Apakah sebuah stream selalu dapat membedakan presentasi legacy, pertunjukan slide, dan templat?

Tidak. PPT, PPS, dan POT berbagi format biner. Simpan nama file atau metadata subtipe secara terpisah bila perbedaan tersebut diperlukan.

API mana yang harus saya gunakan jika presentasi sudah dimuat?

Gunakan Presentation.getSourceFormat. Gunakan PresentationFactory.getPresentationInfo untuk inspeksi sebelum pemuatan.