Hantera videoramar i presentationer med Java

Introduktion

En välplacerad video i en presentation kan göra ditt budskap mer övertygande och öka engagemangsnivåerna hos din publik.

PowerPoint låter dig lägga till videor på en bild i en presentation på två sätt:

  • Lägg till eller bädda in en lokal video (sparad på din dator)
  • Lägg till en online-video (från en webbkälla som YouTube).

För att låta dig lägga till videor (videoobjekt) i en presentation tillhandahåller Aspose.Slides gränssnitten IVideo , IVideoFrame och andra relevanta typer.

Skapa inbäddade videoramar

Om videofilen du vill lägga till på din bild är lagrad lokalt kan du skapa ett videoram för att bädda in videon i din presentation.

  1. Skapa en instans av klassen Presentation class.
  2. Hämta en bilds referens via dess index.
  3. Lägg till ett IVideo‑objekt och ange videofilens sökväg för att bädda in videon i presentationen.
  4. Lägg till ett IVideoFrame‑objekt för att skapa ett ramverk för videon.
  5. Spara den ändrade presentationen.

Denna Java‑kod visar hur du lägger till en lokalt lagrad video i en presentation:

// Skapar en instans av Presentation-klassen
Presentation pres = new Presentation("pres.pptx");
try {
    // Laddar videon
    FileInputStream fileStream = new FileInputStream("Wildlife.mp4");
    
    IVideo video = pres.getVideos().addVideo(fileStream, LoadingStreamBehavior.KeepLocked);

    // Hämtar den första bilden och lägger till ett videoram
    pres.getSlides().get_Item(0).getShapes().addVideoFrame(10, 10, 150, 250, video);

    // Sparar presentationen till disk
    pres.save("pres-with-video.pptx", SaveFormat.Pptx);
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

Alternativt kan du lägga till en video genom att skicka dess filsökväg direkt till metoden addVideoFrame(float x, float y, float width, float height, IVideo video) :

Presentation pres = new Presentation();
try {
	ISlide sld = pres.getSlides().get_Item(0);
	IVideoFrame vf = sld.getShapes().addVideoFrame(50, 150, 300, 150, "video1.avi");
} finally {
	if (pres != null) pres.dispose();
}

Skapa videoramar med video från webbkällor

Microsoft PowerPoint 2013 och senare stödjer YouTube‑videor i presentationer. Om videon du vill använda finns online (t.ex. på YouTube) kan du lägga till den i din presentation via dess webblänk.

  1. Skapa en instans av klassen Presentation class
  2. Hämta en bilds referens via dess index.
  3. Lägg till ett IVideo‑objekt och ange länken till videon.
  4. Ställ in en miniatyr för videoramen.
  5. Spara presentationen.

Denna Java‑kod visar hur du lägger till en video från webben på en bild i en PowerPoint‑presentation:

// Skapar ett Presentation-objekt som representerar en presentationsfil 
Presentation pres = new Presentation();
try {
    addVideoFromYouTube(pres, "Tj75Arhq5ho");
    pres.save("out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

private static void addVideoFromYouTube(Presentation pres, String videoID)
{
    // Lägger till ett videoram
    IVideoFrame videoFrame = pres.getSlides().get_Item(0).getShapes().addVideoFrame(
            10, 10, 427, 240, "https://www.youtube.com/embed/" + videoID);
    videoFrame.setPlayMode(VideoPlayModePreset.Auto);

    // Laddar miniatyr
    String thumbnailUri = "http://img.youtube.com/vi/" + videoID + "/hqdefault.jpg";
    URL url;

    try {
        url = new URL(thumbnailUri);
        videoFrame.getPictureFormat().getPicture().setImage(pres.getImages().addImage(url.openStream()));
    } catch (MalformedURLException e) {
        e.printStackTrace();
    } catch (IOException e) {
        e.printStackTrace();
    }
}

Beskär en videoram

Aspose.Slides låter dig styra vilken del av en video som spelas genom att ange värdena trim-from-start och trim-from-end via IVideoFrame.setTrimFromStart och IVideoFrame.setTrimFromEnd. Båda värdena anges i millisekunder och definierar hur mycket tid som hoppas över i början respektive slutet av videon. Dessa inställningar ändrar videouppspelningsinställningarna i presentationen; de klipper inte eller på annat sätt modifierar den inbäddade videons binära data.

Ställ in triminställningar

För att skapa ett videoram och ange dess triminställningar:

  1. Skapa en instans av klassen Presentation .
  2. Lägg till ett IVideo‑objekt i presentationen.
  3. Lägg till ett IVideoFrame‑objekt på en bild.
  4. Ange värdena trim-from-start och trim-from-end via IVideoFrame.setTrimFromStart och IVideoFrame.setTrimFromEnd.
  5. Spara den ändrade presentationen.

Följande kodexempel hoppar över de första 2,5 sekunderna och den sista sekunden av en inbäddad video under uppspelning:

Presentation presentation = new Presentation();
try {
    FileInputStream videoStream = new FileInputStream("video.mp4");
    try {
        IVideo video = presentation.getVideos().addVideo(
                videoStream, LoadingStreamBehavior.ReadStreamAndRelease);
        ISlide slide = presentation.getSlides().get_Item(0);
        IVideoFrame videoFrame = slide.getShapes().addVideoFrame(50, 50, 640, 360, video);

        videoFrame.setTrimFromStart(2500f);
        videoFrame.setTrimFromEnd(1000f);

        presentation.save("video_with_trim.pptx", SaveFormat.Pptx);
    } finally {
        videoStream.close();
    }
} finally {
    presentation.dispose();
}

Läs triminställningar

För att granska befintliga triminställningar, läs in en presentation, hitta ett IVideoFrame‑objekt bland formerna på den första bilden och läs värdena via IVideoFrame.getTrimFromStart och IVideoFrame.getTrimFromEnd.

Följande kodexempel hittar den första videoramen på den första bilden och rapporterar dess triminställningar i millisekunder:

Presentation presentation = new Presentation("video_with_trim.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    for (IShape shape : slide.getShapes()) {
        if (shape instanceof IVideoFrame) {
            IVideoFrame videoFrame = (IVideoFrame) shape;
            float trimFromStart = videoFrame.getTrimFromStart();
            float trimFromEnd = videoFrame.getTrimFromEnd();

            System.out.println("Trim from start: " + trimFromStart + " ms");
            System.out.println("Trim from end: " + trimFromEnd + " ms");
            break;
        }
    }
} finally {
    presentation.dispose();
}

Hantera videobeskrivningar

Aspose.Slides låter dig hantera stängda undertexter för videoramar i PowerPoint‑presentationer. Undertexter lagras i WebVTT‑format och exponeras via metoden IVideoFrame.getCaptionTracks .

Lägg till undertexter i ett videoram

För att lägga till undertexter i ett videoram:

  1. Skapa en instans av klassen Presentation .
  2. Lägg till en video i presentationen.
  3. Lägg till ett IVideoFrame‑objekt på en bild.
  4. Använd ICaptionsCollection som returneras av getCaptionTracks för att lägga till ett WebVTT‑undertextspår.
  5. Spara den ändrade presentationen.

Följande kod visar hur du lägger till undertexter i ett videoram:

Presentation presentation = new Presentation();
try {
    byte[] videoData = Files.readAllBytes(Paths.get("video.mp4"));
    IVideo video = presentation.getVideos().addVideo(videoData);

    ISlide slide = presentation.getSlides().get_Item(0);
    IVideoFrame videoFrame = slide.getShapes().addVideoFrame(0, 0, 100, 100, video);

    // Lägger till ett nytt undertextspår från en WebVTT-fil.
    videoFrame.getCaptionTracks().add("English", "track.vtt");

    presentation.save("video_with_captions.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Gränssnittet ICaptionsCollection erbjuder även en överlagring som låter dig lägga till undertexter från en ström.

Extrahera undertexter från ett videoram

För att extrahera undertexter från ett videoram:

  1. Läs in presentationen som innehåller videon.
  2. Hitta mål‑objektet IVideoFrame .
  3. Iterera genom undertextspåren i ICaptionsCollection .
  4. Spara varje undertextspår till en .vtt‑fil.

Följande kod visar hur du extraherar undertexter från ett videoram:

Presentation presentation = new Presentation("video_with_captions.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    for (IShape shape : slide.getShapes()) {
        if (shape instanceof IVideoFrame) {
            IVideoFrame videoFrame = (IVideoFrame)shape;
            for (ICaptions captionTrack : videoFrame.getCaptionTracks()) {
                // Sparar undertextspåret till en WebVTT-fil.
                String filePath = captionTrack.getCaptionId().toString() + ".vtt";
                Files.write(Paths.get(filePath), captionTrack.getBinaryData());
            }
        }
    }
} finally {
    presentation.dispose();
}

Varje ICaptions‑objekt exponerar undertextens identifierare, etikett, binärdata och undertexten som en UTF‑8‑sträng.

Ta bort undertexter från ett videoram

För att ta bort undertexter från ett videoram:

  1. Läs in presentationen som innehåller videon.
  2. Hämta mål‑objektet IVideoFrame .
  3. Ta bort undertextspåren från ICaptionsCollection .
  4. Spara den ändrade presentationen.

Följande kod visar hur du tar bort alla undertexter från ett videoram:

Presentation presentation = new Presentation("video_with_captions.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IVideoFrame videoFrame = (IVideoFrame)slide.getShapes().get_Item(0);

    // Tar bort alla undertexter från videoramen.
    videoFrame.getCaptionTracks().clear();

    presentation.save("video_without_captions.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Om du bara behöver ta bort ett enda undertextspår, använd metoderna remove eller removeAt i stället för clear .

Extrahera video från bilder

Förutom att lägga till videor på bilder låter Aspose.Slides dig extrahera videor som är inbäddade i presentationer.

  1. Skapa en instans av klassen Presentation för att läsa in presentationen som innehåller videon.
  2. Iterera genom alla ISlide‑objekt.
  3. Iterera genom alla IShape‑objekt för att hitta en VideoFrame .
  4. Spara videon till disk.

Denna Java‑kod visar hur du extraherar videon på en presentationsbild:

// Skapar ett Presentation-objekt som representerar en presentationsfil 
Presentation pres = new Presentation("VideoSample.pptx");
try {
    for (ISlide slide : pres.getSlides()) 
    {
        for (IShape shape : slide.getShapes()) 
        {
            if (shape instanceof VideoFrame) 
            {
                IVideoFrame vf = (IVideoFrame) shape;
                String type = vf.getEmbeddedVideo().getContentType();
                int ss = type.lastIndexOf('-');
                byte[] buffer = vf.getEmbeddedVideo().getBinaryData();

                //Hämtar filändelsen
                int charIndex = type.indexOf("/");
                type = type.substring(charIndex + 1);

                FileOutputStream fop = new FileOutputStream("testing2." + type);
                fop.write(buffer);
                fop.flush();
                fop.close();
            }
        }
    }
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

FAQ

Vilka videouppspelningsparametrar kan ändras för ett videoram?

Du kan styra uppspelningsläget (automatiskt eller vid klick) och loopning. Dessa alternativ är tillgängliga via egenskaperna på objektet VideoFrame .

Påverkar tillägg av en video PPTX‑filens storlek?

Ja. När du bäddar in en lokal video inkluderas den binära datan i dokumentet, vilket gör att presentationens storlek ökar proportionellt mot filens storlek. När du lägger till en online‑video bäddas bara en länk och en miniatyr in, så ökningen blir mindre.

Kan jag ersätta videon i ett befintligt videoram utan att ändra dess position och storlek?

Ja. Du kan byta ut videoinnehållet i ramen samtidigt som du behåller formens geometri; detta är ett vanligt scenario för att uppdatera media i en befintlig layout.

Kan innehållstypen (MIME) för en inbäddad video bestämmas?

Ja. En inbäddad video har en innehållstyp som du kan läsa och använda, till exempel när du sparar den till disk.

Hantera bildtransformeringseffekter i presentationer med Java