在簡報中使用 Node.js 管理影片框
簡介
影片可以說明概念並吸引觀眾。Aspose.Slides for Node.js via Java 讓您可以將影片框新增至投影片、調整播放設定、管理字幕,並提取內嵌影片資料。
PowerPoint 支援本機影片與線上影片的連結,例如 YouTube 影片。
為了表示影片資料和影片框,Aspose.Slides 提供 Video 類別、VideoFrame 類別,以及其他相關型別。
建立嵌入式影片框
如果您要新增至投影片的影片檔案儲存在本機,您可以建立影片框以將影片嵌入至簡報中。
此範例在現有簡報的第一張投影片上嵌入本機影片,並儲存結果。框的座標與尺寸以點為單位。由於 LoadingStreamBehavior.KeepLocked 會在簡報使用時保持鎖定,因此資料流會持續開啟,直到儲存完成。
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const presentation = new aspose.slides.Presentation("presentation.pptx");
try {
const videoStream = java.newInstanceSync("java.io.FileInputStream", "video.mp4");
try {
const slide = presentation.getSlides().get_Item(0);
const video = presentation.getVideos().addVideo(videoStream, aspose.slides.LoadingStreamBehavior.KeepLocked);
slide.getShapes().addVideoFrame(10, 10, 150, 250, video);
presentation.save("embedded_video.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
videoStream.close();
}
} finally {
presentation.dispose();
}
您也可以直接將本機影片路徑傳遞給 addVideoFrame。此範例在新簡報的第一張投影片上嵌入影片。影片必須保持可存取,直至簡報儲存完成。
const aspose = { slides: require("aspose.slides.via.java") };
const presentation = new aspose.slides.Presentation();
try {
const slide = presentation.getSlides().get_Item(0);
slide.getShapes().addVideoFrame(50, 150, 300, 150, "video.avi");
presentation.save("video_from_path.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
建立來自網路來源的影片框
Microsoft PowerPoint 支援在簡報中使用線上影片。您可以建立指向線上影片(例如 YouTube 影片)的影片框。
此範例在第一張投影片上加入 YouTube 影片連結與縮圖。將影片識別碼替換,即可使用其他影片。setPlayMode 方法請求自動播放。下載縮圖與播放影片皆需要網際網路連線。簡報檢視器亦必須支援線上影片播放。
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const presentation = new aspose.slides.Presentation();
try {
const slide = presentation.getSlides().get_Item(0);
const videoId = "aqz-KE-bpKQ";
const videoUrl = "https://www.youtube.com/embed/" + videoId;
const videoFrame = slide.getShapes().addVideoFrame(10, 10, 427, 240, videoUrl);
videoFrame.setPlayMode(aspose.slides.VideoPlayModePreset.Auto);
const thumbnailUrl = "https://img.youtube.com/vi/" + videoId + "/hqdefault.jpg";
const thumbnailLocation = java.newInstanceSync("java.net.URL", thumbnailUrl);
const thumbnailStream = thumbnailLocation.openStream();
try {
const thumbnail = presentation.getImages().addImage(thumbnailStream);
videoFrame.getPictureFormat().getPicture().setImage(thumbnail);
} finally {
thumbnailStream.close();
}
presentation.save("online_video.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
在全螢幕模式播放影片
在教學簡報中,您可以在全螢幕模式下播放軟體示範,讓觀眾看到細節。於播放期間呼叫 setFullScreenMode 並傳入 true 以啟用此行為。
此範例開啟簡報,於第一張投影片上尋找第一個 VideoFrame,並啟用全螢幕播放。輸入的簡報必須至少有一張投影片,且第一張投影片上已有影片框。
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const presentation = new aspose.slides.Presentation("training.pptx");
try {
const slide = presentation.getSlides().get_Item(0);
for (let shapeIndex = 0; shapeIndex < slide.getShapes().size(); shapeIndex++) {
const shape = slide.getShapes().get_Item(shapeIndex);
if (java.instanceOf(shape, "com.aspose.slides.VideoFrame")) {
const videoFrame = shape;
videoFrame.setFullScreenMode(true);
break;
}
}
presentation.save("full_screen_video.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
全螢幕播放控制影片的顯示方式。而 setPlayMode 決定是否自動或點擊後開始播放,setPlayLoopMode 則決定是否重複播放。若要選擇開始行為,請將播放模式設定為 VideoPlayModePreset.Auto 或 VideoPlayModePreset.OnClick。此範例保留了既有的開始與迴圈設定。
在播放後倒回影片
在教學簡報中,將示範影片倒回開頭可讓演講者再次播放。於播放結束後呼叫 setRewindVideo 並傳入 true,即可將影片返回起點。
此範例開啟簡報,於第一張投影片上尋找第一個 VideoFrame,並啟用倒回。它會停用迴圈以讓播放結束,並設定為點擊後開始播放。輸入的簡報必須至少有一張投影片,且第一張投影片上已有影片框。
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const presentation = new aspose.slides.Presentation("training.pptx");
try {
const slide = presentation.getSlides().get_Item(0);
for (let shapeIndex = 0; shapeIndex < slide.getShapes().size(); shapeIndex++) {
const shape = slide.getShapes().get_Item(shapeIndex);
if (java.instanceOf(shape, "com.aspose.slides.VideoFrame")) {
const videoFrame = shape;
videoFrame.setRewindVideo(true);
videoFrame.setPlayLoopMode(false);
videoFrame.setPlayMode(aspose.slides.VideoPlayModePreset.OnClick);
break;
}
}
presentation.save("rewind_video.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
倒回會將影片返回起點且不會再次啟動播放。相反地,傳入 true 給 setPlayLoopMode 會自動重複播放。當您希望影片播放結束並保持可重新播放時,請停用迴圈。 setPlayMode 獨立控制自動或點擊啟動;本範例使用 VideoPlayModePreset.OnClick,讓演講者自行決定何時開始播放。正如範例所示,先設定迴圈後再設定播放模式。倒回功能與 setFullScreenMode 無關。
修剪影片框
使用 VideoFrame.setTrimFromStart 與 VideoFrame.setTrimFromEnd 可在播放時略過影片開頭或結尾的一部分。兩個數值皆以毫秒為單位。修剪會變更播放設定,卻不會修改內嵌的影片資料。
設定修剪參數
此範例嵌入本機影片,於播放時跳過前 2.5 秒與最後 1 秒。請使用長度超過 3.5 秒的影片,以保留可播放的段落。
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const fs = require("fs");
const presentation = new aspose.slides.Presentation();
try {
const slide = presentation.getSlides().get_Item(0);
const videoBuffer = fs.readFileSync("video.mp4");
const videoData = java.newArray("byte", Array.from(videoBuffer));
const video = presentation.getVideos().addVideo(videoData);
const videoFrame = slide.getShapes().addVideoFrame(50, 50, 640, 360, video);
videoFrame.setTrimFromStart(2500);
videoFrame.setTrimFromEnd(1000);
presentation.save("video_with_trim.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
讀取修剪設定
此範例以毫秒為單位印出第一張投影片上第一個影片框的修剪數值。簡報必須至少包含一張投影片。若該投影片沒有影片框,則不會印出任何內容。前述範例會產生 2500 與 1000 兩個值。
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const presentation = new aspose.slides.Presentation("video_with_trim.pptx");
try {
const slide = presentation.getSlides().get_Item(0);
for (let shapeIndex = 0; shapeIndex < slide.getShapes().size(); shapeIndex++) {
const shape = slide.getShapes().get_Item(shapeIndex);
if (java.instanceOf(shape, "com.aspose.slides.VideoFrame")) {
const videoFrame = shape;
console.log("Trim from start: " + videoFrame.getTrimFromStart() + " ms");
console.log("Trim from end: " + videoFrame.getTrimFromEnd() + " ms");
break;
}
}
} finally {
presentation.dispose();
}
管理影片字幕
Aspose.Slides 允許您管理 PowerPoint 簡報中影片框的隱蔽字幕。字幕以 WebVTT 格式儲存,並可透過 VideoFrame.getCaptionTracks 方法取得。
為影片框新增字幕
此範例嵌入本機影片,並新增標示為 English 的 WebVTT 字幕軌。字幕的時間戳記應與影片相符。儲存的簡報同時包含影片與其字幕。
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const fs = require("fs");
const presentation = new aspose.slides.Presentation();
try {
const slide = presentation.getSlides().get_Item(0);
const videoBuffer = fs.readFileSync("video.mp4");
const videoData = java.newArray("byte", Array.from(videoBuffer));
const video = presentation.getVideos().addVideo(videoData);
const videoFrame = slide.getShapes().addVideoFrame(0, 0, 100, 100, video);
videoFrame.getCaptionTracks().add("English", "track.vtt");
presentation.save("video_with_captions.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
CaptionsCollection 類別也提供 addFromStream 方法,以從串流加入字幕。
從影片框提取字幕
此範例將第一張投影片上所有影片框的字幕軌儲存為個別的 WebVTT 檔案。以連續編號區分輸出檔案。主控台會報告已提取的軌道數量。簡報必須至少包含一張投影片。
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const fs = require("fs");
const presentation = new aspose.slides.Presentation("video_with_captions.pptx");
try {
const slide = presentation.getSlides().get_Item(0);
let trackCount = 0;
for (let shapeIndex = 0; shapeIndex < slide.getShapes().size(); shapeIndex++) {
const shape = slide.getShapes().get_Item(shapeIndex);
if (java.instanceOf(shape, "com.aspose.slides.VideoFrame")) {
const videoFrame = shape;
for (let trackIndex = 0; trackIndex < videoFrame.getCaptionTracks().getCount(); trackIndex++) {
const captionTrack = videoFrame.getCaptionTracks().get_Item(trackIndex);
trackCount++;
const outputPath = "captions_" + trackCount + ".vtt";
const outputData = Buffer.from(captionTrack.getBinaryData());
fs.writeFileSync(outputPath, outputData);
}
}
}
console.log("Caption tracks extracted: " + trackCount);
} finally {
presentation.dispose();
}
每個 Captions 物件會顯示字幕的識別碼、標籤、二進位資料,以及作為 UTF-8 字串的字幕文字。
從影片框移除字幕
此範例移除第一張投影片上第一個圖形位置之影片框的全部字幕,並儲存結果。它假設投影片與圖形皆存在,且該圖形為影片框。
const aspose = { slides: require("aspose.slides.via.java") };
const presentation = new aspose.slides.Presentation("video_with_captions.pptx");
try {
const slide = presentation.getSlides().get_Item(0);
const videoFrame = slide.getShapes().get_Item(0);
videoFrame.getCaptionTracks().clear();
presentation.save("video_without_captions.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
若只需要移除單一字幕軌,請使用 remove 或 removeAt 方法,而非 clear。
搜尋影片字幕
Captions.getDataAsString 方法會回傳整個 WebVTT 軌道,包括標頭、時間線與字幕文字。您可以在記憶體中搜尋字幕文字,以找出特定片語與其時間戳記。例如,投影片 2 上的英文軌道可能包含以下提示:
WEBVTT Café tour
00:00:01.000 --> 00:00:03.000 align:start
Meet me at the café
near the station.
此範例開啟 captioned_media.pptx,並使用 VideoFrame.getCaptionTracks 讀取每張投影片上所有頂層影片框的字幕軌。在純文字提示中,時間線包含 -->,空白行結束提示。對於包含「café」(不分大小寫) 的每個字幕,範例會印出投影片編號、軌道標籤、原始時間線及完整字幕。
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const presentation = new aspose.slides.Presentation("captioned_media.pptx");
try {
const slides = presentation.getSlides();
for (let slideIndex = 0; slideIndex < slides.size(); slideIndex++) {
const slide = slides.get_Item(slideIndex);
const shapes = slide.getShapes();
for (let shapeIndex = 0; shapeIndex < shapes.size(); shapeIndex++) {
const shape = shapes.get_Item(shapeIndex);
if (!java.instanceOf(shape, "com.aspose.slides.VideoFrame")) {
continue;
}
const tracks = shape.getCaptionTracks();
for (let trackIndex = 0; trackIndex < tracks.getCount(); trackIndex++) {
const track = tracks.get_Item(trackIndex);
const lines = track.getDataAsString().split(/\r\n|\n|\r/);
for (let i = 0; i < lines.length; i++) {
const timing = lines[i];
if (!timing.includes("-->")) {
continue;
}
const start = i + 1;
i = start;
while (i < lines.length && lines[i] !== "") {
i++;
}
const caption = lines.slice(start, i).join("\n");
if (caption.toLowerCase().includes("café")) {
console.log(`Slide ${slide.getSlideNumber()} | ${track.getLabel()} | ${timing}`);
console.log(caption);
}
}
}
}
}
} finally {
presentation.dispose();
}
搜尋「café」在範例軌道中找到一個符合。搜尋會略過軌道標頭,並在輸出中保留時間設定與換行。
Slide 2 | English | 00:00:01.000 --> 00:00:03.000 align:start
Meet me at the café
near the station.
從投影片提取影片
除了將影片加入投影片外,Aspose.Slides 也允許您提取簡報中內嵌的影片。
此範例將每張投影片內的內嵌影片提取為分別編號的二進位檔案。連結的影片會被略過,因為它們沒有內嵌資料。主控台會印出每個影片的 MIME 類型以及總計數。輸出使用通用的 .bin 副檔名;必要時可改為符合回報的媒體類型。
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const fs = require("fs");
const presentation = new aspose.slides.Presentation("presentation_with_videos.pptx");
try {
let videoCount = 0;
for (let slideIndex = 0; slideIndex < presentation.getSlides().size(); slideIndex++) {
const slide = presentation.getSlides().get_Item(slideIndex);
for (let shapeIndex = 0; shapeIndex < slide.getShapes().size(); shapeIndex++) {
const shape = slide.getShapes().get_Item(shapeIndex);
if (java.instanceOf(shape, "com.aspose.slides.VideoFrame")) {
const videoFrame = shape;
const video = videoFrame.getEmbeddedVideo();
if (video == null) {
console.log("Skipped a linked video: no embedded data is available.");
continue;
}
videoCount++;
const outputPath = "extracted_video_" + videoCount + ".bin";
const outputData = Buffer.from(video.getBinaryData());
fs.writeFileSync(outputPath, outputData);
console.log("Video " + videoCount + ": " + video.getContentType());
}
}
}
console.log("Embedded videos extracted: " + videoCount);
} finally {
presentation.dispose();
}
FAQ
可以為影片框變更哪些影片播放參數?
您可以控制播放模式(自動或點擊)、以及迴圈。這些選項可透過 VideoFrame 物件的方法取得。
加入影片會影響 PPTX 檔案大小嗎?
會。若您嵌入本機影片,二進位資料會寫入文件,使簡報大小按影片檔案大小成比例增加。若您連結線上影片並加入縮圖,簡報僅儲存連結與預覽圖像,而非影片資料,因此大小增幅通常較小。
我可以在不變更位置與尺寸的情況下,替換現有影片框中的影片嗎?
可以。您可以在保持形狀幾何不變的情況下,交換框內的影片內容;這是更新既有版面中媒體的常見情境。
能否取得內嵌影片的內容類型 (MIME)?
可以。內嵌影片具有內容類型,您可以讀取並使用,例如將其儲存至磁碟時。