باز کردن ارائه‌ها در اندروید

مقدمه

Aspose.Slides for Android via Java می‌تواند ارائه‌های PowerPoint و OpenDocument را از فایل‌ها و جریان‌ها بارگذاری کند. پس از بارگذاری یک ارائه، می‌توانید ساختار آن را بررسی کنید، اسلایدها را ویرایش کنید، منابع را مدیریت کنید و آن را در قالب اصلی یا قالب دیگر پشتیبانی‌شده ذخیره کنید.

رفتار بارگذاری می‌تواند از طریق کلاس LoadOptions سفارشی شود. به عنوان مثال، می‌توانید یک رمز عبور باز کردن فراهم کنید، اشیای باینری بزرگ را خارج از حافظه heap جاوا نگه دارید، منابع خارجی را کنترل کنید یا داده‌های باینری جاسازی‌شده را حذف کنید.

باز کردن ارائه‌ها

پس از بارگذاری یک فایل یا جریان، می‌توانید قالب اصلی ارائه را تعیین کنید تا نحوه پردازش آن توسط برنامه خود را انتخاب کنید.

برای باز کردن یک ارائه موجود، مسیر فایل آن را به سازندهٔ 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 گزینه‌هایی را برمی‌گرداند که نحوهٔ مدیریت اشیای باینری بزرگ مانند تصاویر، صدا و ویدیو را توسط Aspose.Slides کنترل می‌کند. می‌توانید فایل منبع را قفل نگه دارید، فایل‌های موقت را اجازه دهید و مقدار داده‌های BLOB نگهداری‌شده در حافظه را محدود کنید.

کد زیر به زبان Java نحوهٔ بارگذاری یک ارائه بزرگ (به عنوان مثال، ۲ گیگابایت) را نشان می‌دهد:

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();
}

کنترل منابع خارجی

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();
}

بارگذاری ارائه‌ها بدون اشیای باینری جاسازی‌شده

یک ارائه ممکن است شامل داده‌های باینری جاسازی‌شده باشد که برنامه به آن نیازی ندارد یا نمی‌خواهد آن را نگه دارد. مثال‌ها شامل:

مقدار LoadOptions.setDeleteEmbeddedBinaryObjects را به true تنظیم کنید تا این داده‌های باینری هنگام بارگذاری حذف شوند. برای حفظ نتیجهٔ پاک‌سازی‌شده، ارائه بارگذاری‌شده را ذخیره کنید.

این گزینه خطر حملات مخفی جاسازی‌شدهٔ ناخواسته را کاهش می‌دهد، اما یک سیستم کامل تشخیص بدافزار یا پاک‌سازی محتوا نیست.

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();
}

سوالات متداول

چگونه می‌توانم تشخیص دهم که یک فایل خراب است و نمی‌توان آن را باز کرد؟

Aspose.Slides هنگام بارگذاری، استثنای تجزیه یا فرمت را پرتاب می‌کند. این شکست را جدا از خطای رمز عبور نادرست مدیریت کنید تا برنامه بتواند دلیل را به‌دقت گزارش دهد.

اگر قلم‌های لازم موجود نباشند چه می‌شود؟

ارائه همچنان می‌تواند بارگذاری شود، اما رندر کردن و خروجی ممکن است قلم‌ها را جایگزین کند. می‌توانید پیکربندی جایگزینی قلم یا ارائه قلم‌های سفارشی را تنظیم کنید تا خروجی قابل پیش‌بینی‌تر باشد.

آیا بارگذاری یک ارائه باعث بارگذاری رسانه‌های جاسازی‌شدهٔ آن نیز می‌شود؟

صدا و ویدیوهای جاسازی‌شده از طریق مدل شیء ارائه در دسترس می‌شوند. منابع خارجی بر اساس رفتار پیکربندی‌شدهٔ بارگذاری منابع حل می‌شوند و ممکن است در دسترس نباشند اگر مکان‌های آن‌ها قابل دسترسی نباشد.

ایجاد ارائه‌ها در اندروید بازیابی و به‌روزرسانی اطلاعات ارائه در Android