Abrir una presentación en JavaScript

Descripción general

Además de crear presentaciones de PowerPoint desde cero, Aspose.Slides también permite abrir presentaciones existentes. Después de cargar una presentación, puedes obtener información sobre ella, editar el contenido de las diapositivas, agregar nuevas diapositivas, eliminar las existentes y mucho más.

Abrir presentaciones

Para abrir una presentación existente, instancia la clase Presentation y pasa la ruta del archivo a su constructor.

El siguiente ejemplo de JavaScript muestra cómo abrir una presentación y obtener el recuento de diapositivas:

// Instancie la clase Presentation y pase una ruta de archivo a su constructor.
let presentation = new aspose.slides.Presentation("Sample.pptx");
try {
    // Imprima el número total de diapositivas en la presentación.
    console.log(presentation.getSlides().size());
} finally {
    presentation.dispose();
}

Abrir presentaciones protegidas con contraseña

Cuando necesites abrir una presentación protegida con contraseña, pasa la contraseña mediante el método setPassword de la clase LoadOptions para descifrarla y cargarla. El siguiente código JavaScript demuestra esta operación:

let loadOptions = new aspose.slides.LoadOptions();
loadOptions.setPassword("YOUR_PASSWORD");

let presentation = new aspose.slides.Presentation("Sample.pptx", loadOptions);
try {
    // Realice operaciones en la presentación descifrada.
} finally {
    presentation.dispose();
}

Abrir presentaciones de gran tamaño

Aspose.Slides proporciona opciones—en particular el método getBlobManagementOptions en la clase LoadOptions—para ayudar a cargar presentaciones de gran tamaño.

El siguiente código JavaScript muestra cómo cargar una presentación grande (por ejemplo, 2 GB):

const filePath = "LargePresentation.pptx";

let loadOptions = new aspose.slides.LoadOptions();
// Elija el comportamiento KeepLocked: el archivo de la presentación permanecerá bloqueado durante la vida de
// la instancia Presentation, pero no necesita cargarse en memoria ni copiarse a un archivo temporal.
loadOptions.getBlobManagementOptions().setPresentationLockingBehavior(aspose.slides.PresentationLockingBehavior.KeepLocked);
loadOptions.getBlobManagementOptions().setTemporaryFilesAllowed(true);
loadOptions.getBlobManagementOptions().setMaxBlobsBytesInMemory(10 * 1024 * 1024); // 10 MB

let presentation = new aspose.slides.Presentation(filePath, loadOptions);
try {
    // La presentación grande se ha cargado y puede usarse, mientras el consumo de memoria se mantiene bajo.
    
    // Realice cambios en la presentación.
    presentation.getSlides().get_Item(0).setName("Large presentation");

    // Guarde la presentación en otro archivo. El consumo de memoria se mantiene bajo durante esta operación.
    presentation.save("LargePresentation-copy.pptx", aspose.slides.SaveFormat.Pptx);

    // ¡No haga esto! Se lanzará una excepción de E/S porque el archivo está bloqueado hasta que se deseche el objeto Presentation.
    //fs.unlinkSync(filePath);
} finally {
    presentation.dispose();
}

// Está bien hacerlo aquí. El archivo fuente ya no está bloqueado por el objeto Presentation.
fs.unlinkSync(filePath);

Controlar recursos externos

Aspose.Slides proporciona la interfaz IResourceLoadingCallback que permite gestionar recursos externos. El siguiente código JavaScript muestra cómo usar la interfaz IResourceLoadingCallback:

const ImageLoadingHandler = java.newProxy("com.aspose.slides.IResourceLoadingCallback", {
  resourceLoading: function(args) {
        if (args.getOriginalUri().endsWith(".jpg")) {
            try {
                // Cargar una imagen de sustitución.
                const imageData = fs.readFileSync("aspose-logo.jpg");
                args.setData(imageData);
                return aspose.slides.ResourceLoadingAction.UserProvided;
            } catch {
                return aspose.slides.ResourceLoadingAction.Skip;
            }
        } else if (args.getOriginalUri().endsWith(".png")) {
            // Establecer una URL de sustitución.
            args.setUri("http://www.google.com/images/logos/ps_logo2.png");
            return aspose.slides.ResourceLoadingAction.Default;
        }
        // Omitir todas las demás imágenes.
        return aspose.slides.ResourceLoadingAction.Skip;
      }
});

let loadOptions = new aspose.slides.LoadOptions();
loadOptions.setResourceLoadingCallback(ImageLoadingHandler);

let presentation = new aspose.slides.Presentation("Sample.pptx", loadOptions);

Cargar presentaciones sin objetos binarios incrustados

Una presentación de PowerPoint puede contener los siguientes tipos de objetos binarios incrustados:

Mediante el método LoadOptions.setDeleteEmbeddedBinaryObjects, puedes cargar una presentación sin objetos binarios incrustados.

Este método es útil para eliminar contenido binario potencialmente malicioso. El siguiente código JavaScript muestra cómo cargar una presentación sin contenido binario incrustado:

let loadOptions = new aspose.slides.LoadOptions();
loadOptions.setDeleteEmbeddedBinaryObjects(true);

let presentation = new aspose.slides.Presentation("malware.ppt", loadOptions);
try {
    // Realice operaciones en la presentación.
} finally {
    presentation.dispose();
}

Preguntas frecuentes

¿Cómo puedo saber si un archivo está dañado y no se puede abrir?

Se producirá una excepción de validación de análisis/formato durante la carga. Estos errores a menudo mencionan una estructura ZIP no válida o registros de PowerPoint dañados.

¿Qué ocurre si faltan fuentes requeridas al abrir?

El archivo se abrirá, pero luego la renderización/exportación puede sustituir fuentes. Configura sustituciones de fuentes o agrega las fuentes requeridas al entorno de ejecución.

¿Qué pasa con los medios incrustados (vídeo/audio) al abrir?

Se convierten en recursos de la presentación. Si los medios se referencian mediante rutas externas, asegúrate de que esas rutas sean accesibles en tu entorno; de lo contrario, la renderización/exportación puede omitir los medios.

Visor de presentaciones