Mengambil dan Memperbarui Informasi Presentasi di Android

Tentang apa halaman ini

Jelajahi slide, struktur, dan metadata dalam presentasi PowerPoint dan OpenDocument menggunakan Java untuk wawasan yang lebih cepat dan audit konten yang lebih cerdas.

Gambaran Umum

Aspose.Slides dapat mengidentifikasi format presentasi dan membaca metadata dokumennya tanpa membuat model objek presentasi yang lengkap. Ini berguna ketika Anda perlu mengklasifikasikan file, membuat inventaris, atau memeriksa properti sebelum memutuskan apakah akan memuat dan memproses konten presentasi.

Artikel ini menunjukkan inspeksi ringan melalui PresentationFactory dan IPresentationInfo, serta pembaruan terarah melalui IDocumentProperties.

Periksa Format Presentasi

Jika Anda sudah memiliki presentasi yang dimuat, lihat Determine the Original Presentation Format untuk deteksi setelah pemuatan dan keterbatasan aliran PPT, PPS, dan POT warisan.

Gunakan PresentationFactory.getPresentationInfo untuk memeriksa file tanpa membuat instance Presentation . Metode IPresentationInfo.getLoadFormat melaporkan format yang terdeteksi, seperti PPTX, PPT, atau ODP.

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

String[] fileNames = { "pres.pptx", "pres.ppt", "pres.odp" };

for (String fileName : fileNames) {
    IPresentationInfo presentationInfo = PresentationFactory.getInstance().getPresentationInfo(fileName);
    int loadFormat = presentationInfo.getLoadFormat();
    String formatName = "Other (" + loadFormat + ")";

    if (loadFormat == LoadFormat.Pptx) {
        formatName = "PPTX";
    } else if (loadFormat == LoadFormat.Ppt) {
        formatName = "PPT";
    } else if (loadFormat == LoadFormat.Odp) {
        formatName = "ODP";
    }

    System.out.println(fileName + ": " + formatName);
}

Buat Inventaris Presentasi Ringan

Saat Anda memproses banyak file presentasi, Anda mungkin memerlukan inventaris ringkas untuk validasi, pengindeksan, atau sistem manajemen dokumen. Dalam skenario ini, gunakan PresentationFactory.getPresentationInfo untuk memperoleh objek IPresentationInfo , lalu panggil IPresentationInfo.readDocumentProperties untuk membaca metadata dokumen. Pendekatan ini tidak membuat instance Presentation atau mengharuskan Anda menelusuri model objek presentasi yang lengkap.

Properti ekstended yang diungkapkan oleh IDocumentProperties menyediakan nilai inventaris berikut:

Metode	Nilai inventaris
getSlides	Jumlah total slide.
getHiddenSlides	Jumlah slide tersembunyi.
getNotes	Jumlah slide yang berisi catatan.
getParagraphs	Jumlah total paragraf, bila tersedia.
getWords	Jumlah total kata.
getMultimediaClips	Jumlah total klip audio dan video.

Contoh berikut membaca nilai-nilai ini tanpa membuat objek Presentation dan mencetak inventaris ringkas. Ini juga menggabungkan getHeadingPairs dengan getTitlesOfParts untuk menampilkan grup konten seperti font, tema, dan judul slide.

import com.aspose.slides.IDocumentProperties;
import com.aspose.slides.IHeadingPair;
import com.aspose.slides.IPresentationInfo;
import com.aspose.slides.LoadFormat;
import com.aspose.slides.PresentationFactory;
import java.nio.file.Paths;

String filePath = "sample.pptx";
IPresentationInfo presentationInfo = PresentationFactory.getInstance().getPresentationInfo(filePath);
IDocumentProperties documentProperties = presentationInfo.readDocumentProperties();

int loadFormat = presentationInfo.getLoadFormat();
String formatName = "Other (" + loadFormat + ")";

if (loadFormat == LoadFormat.Pptx) {
    formatName = "PPTX";
} else if (loadFormat == LoadFormat.Ppt) {
    formatName = "PPT";
} else if (loadFormat == LoadFormat.Odp) {
    formatName = "ODP";
}

System.out.println("File: " + Paths.get(filePath).getFileName());
System.out.println("Format: " + formatName);
System.out.println("Title: " + documentProperties.getTitle());
System.out.println("Author: " + documentProperties.getAuthor());
System.out.println("Statistics:");
System.out.println("  Slides: " + documentProperties.getSlides());
System.out.println("  Hidden slides: " + documentProperties.getHiddenSlides());
System.out.println("  Slides with notes: " + documentProperties.getNotes());
System.out.println("  Paragraphs: " + documentProperties.getParagraphs());
System.out.println("  Words: " + documentProperties.getWords());
System.out.println("  Multimedia clips: " + documentProperties.getMultimediaClips());

IHeadingPair[] headingPairs = documentProperties.getHeadingPairs();
String[] titlesOfParts = documentProperties.getTitlesOfParts();
headingPairs = headingPairs != null ? headingPairs : new IHeadingPair[0];
titlesOfParts = titlesOfParts != null ? titlesOfParts : new String[0];
int partIndex = 0;

if (headingPairs.length == 0 || titlesOfParts.length == 0) {
    System.out.println("Content groups: not available");
} else {
    System.out.println("Content groups:");

    for (IHeadingPair headingPair : headingPairs) {
        System.out.println("  " + headingPair.getName() + " (" + headingPair.getCount() + ")");

        for (int partOffset = 0; partOffset < headingPair.getCount() && partIndex < titlesOfParts.length; partOffset++) {
            System.out.println("    - " + titlesOfParts[partIndex]);
            partIndex++;
        }
    }

    if (partIndex < titlesOfParts.length) {
        System.out.println("  Other parts:");

        while (partIndex < titlesOfParts.length) {
            System.out.println("    - " + titlesOfParts[partIndex]);
            partIndex++;
        }
    }
}

Setiap IHeadingPair menyediakan nama grup dan jumlah item dalam grup tersebut. IDocumentProperties.getTitlesOfParts mengembalikan array datar yang terurut, sehingga konsumsi jumlah judul berurutan yang ditentukan oleh setiap heading pair.

Metadata yang Disimpan dan Batasan Format

Properti inventaris yang dikembalikan oleh IPresentationInfo.readDocumentProperties mencerminkan metadata yang tersedia dalam dokumen sumber. Aspose.Slides tidak memuat dan menelusuri model objek presentasi untuk menghitung ulang nilai-nilai ini pada pemanggilan tersebut. Properti yang hilang direpresentasikan dengan nilai default, dan nilai yang disimpan mungkin usang jika aplikasi yang terakhir menyimpan file tidak memperbarui properti dokumennya.

PPTX: Format ini menyediakan properti dokumen ekstended untuk hitungan slide, catatan, slide tersembunyi, paragraf, kata, dan multimedia, serta heading pair dan judul bagian. Ketersediaan tergantung pada properti mana yang ditulis oleh pembuat dokumen.
PPT: Format biner dapat menyimpan properti ringkasan dokumen yang sesuai. Jika sebuah properti tidak ada atau tidak diperbarui oleh pembuat dokumen, Aspose.Slides mengembalikan nilai yang disimpan atau nilai default alih-alih menghitungnya dari slide.
ODP: Metadata OpenDocument menyediakan statistik umum dokumen, seperti jumlah halaman, paragraf, dan kata, tetapi nilai-nilai ini tidak memetakan ke setiap properti ekstended khusus PowerPoint. Metadata slide tersembunyi, slide catatan, multimedia, heading-pair, dan judul bagian mungkin tidak tersedia, dan properti inventaris dapat mengembalikan nilai default. Jangan menganggap nilai nol atau array kosong sebagai bukti otoritatif bahwa konten yang bersangkutan tidak ada.

Gunakan pendekatan metadata ringan untuk inventaris dan pemeriksaan awal. Muat presentasi dan periksa model objeknya yang aktif ketika hasil harus mencerminkan perubahan dalam memori atau ketika Anda perlu memverifikasi konten presentasi yang sebenarnya.

Perbarui Properti Presentasi

Properti yang dikembalikan oleh IPresentationInfo.readDocumentProperties juga dapat diubah tanpa membuat instance Presentation . Terapkan perubahan dengan IPresentationInfo.updateDocumentProperties, lalu tulis presentasi yang terikat dengan IPresentationInfo.writeBindedPresentation.

Gambar berikut menunjukkan properti dokumen asli.

Properti dokumen asli dari presentasi PowerPoint

Contoh berikut mengubah judul dan waktu penyimpanan terakhir serta menulis hasilnya ke file baru:

import com.aspose.slides.IDocumentProperties;
import com.aspose.slides.IPresentationInfo;
import com.aspose.slides.PresentationFactory;
import java.io.FileOutputStream;
import java.io.OutputStream;
import java.util.Date;

String sourceFile = "sample.pptx";
String outputFile = "sample_with_updated_properties.pptx";
IPresentationInfo presentationInfo = PresentationFactory.getInstance().getPresentationInfo(sourceFile);
IDocumentProperties documentProperties = presentationInfo.readDocumentProperties();

documentProperties.setTitle("Quarterly sales report");
documentProperties.setLastSavedTime(new Date());

presentationInfo.updateDocumentProperties(documentProperties);
try (OutputStream outputStream = new FileOutputStream(outputFile)) {
    presentationInfo.writeBindedPresentation(outputStream);
}

Gambar berikut menunjukkan properti dokumen yang diperbarui.

Properti dokumen yang diubah dari presentasi PowerPoint

Tautan Berguna

Untuk pemeriksaan keamanan terkait dan pengaturan perlindungan, lihat artikel berikut:

FAQ

Bagaimana saya dapat memeriksa apakah font ter-embed dan mana saja yang ter-embed?

Muat presentasi dan gunakan Presentation.getFontsManager. Panggil IFontsManager.getEmbeddedFonts untuk mendapatkan font yang ter-embed dan IFontsManager.getFonts untuk mendapatkan font yang digunakan oleh presentasi. Bandingkan kedua hasil untuk menemukan font yang diperlukan untuk merender tetapi tidak ter-embed.

Bagaimana saya dapat dengan cepat mengetahui apakah file memiliki slide tersembunyi dan berapa banyak?

Ketika metadata dokumen yang disimpan sudah cukup, baca IDocumentProperties.getHiddenSlides melalui PresentationFactory.getPresentationInfo dan IPresentationInfo.readDocumentProperties. Ini cocok untuk inventaris ringan. Jika presentasi telah dimodifikasi dalam memori, metadata yang disimpan mungkin hilang atau usang, atau Anda perlu memverifikasi nilai secara langsung, iterasi melalui Presentation.getSlides dan periksa metode ISlide.getHidden setiap slide.

Apakah saya dapat mendeteksi apakah ukuran slide khusus dan orientasi digunakan, dan apakah mereka berbeda dari default?

Ya. Muat presentasi dan panggil Presentation.getSlideSize. Gunakan ISlideSize.getType, ISlideSize.getSize, dan ISlideSize.getOrientation untuk membandingkan pengaturan saat ini dengan preset dan dimensi yang diharapkan.

Apakah ada cara cepat untuk melihat apakah chart merujuk ke sumber data eksternal?

Ya. Temukan setiap Chart dan panggil IChartData.getDataSourceType. Untuk workbook eksternal, panggil IChartData.getExternalWorkbookPath. Jenis sumber data dan path mengidentifikasi referensi eksternal, tetapi memverifikasi apakah target tersedia memerlukan pemeriksaan sumber daya terpisah.

Bagaimana saya dapat menilai slide ‘berat’ yang mungkin memperlambat render atau ekspor PDF?

Tidak ada properti kompleksitas tunggal. Telusuri Presentation.getSlides dan koleksi IBaseSlide.getShapes setiap slide. Gunakan jumlah shape dan keberadaan gambar besar, efek, animasi, atau multimedia sebagai sinyal penyaringan, dan ukur render atau ekspor representatif sebelum menilai sebuah slide sebagai bottleneck kinerja yang terkonfirmasi.

Buka Presentasi di Android Menentukan Format Presentasi Asli di Android