مدیریت فریم‌های ویدئویی در ارائه‌ها با استفاده از JavaScript

این صفحه درباره چیست

یادگیری افزودن و استخراج فریم‌های ویدئویی به‌صورت برنامه‌نویسی در اسلایدهای PowerPoint و OpenDocument با استفاده از Aspose.Slides برای Node.js به‌وسیله Java. راهنمای سریع نحوه کار.

مقدمه

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

PowerPoint به شما امکان می‌دهد ویدئوها را به یک اسلاید در یک ارائه به دو روش اضافه کنید:

یک ویدئوی محلی اضافه یا جاسازی کنید (ذخیره‌شده بر روی دستگاه شما)
یک ویدئوی آنلاین اضافه کنید (از منبع وب مانند YouTube).

برای اینکه بتوانید ویدئوها (اشیای ویدئویی) را به یک ارائه اضافه کنید، Aspose.Slides کلاس‌های Video، VideoFrame و سایر انواع مرتبط را ارائه می‌دهد.

ایجاد فریم ویدئوی جاسازی‌شده

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

یک نمونه از کلاس Presentation ایجاد کنید.
با استفاده از اندیس آن، مرجع یک اسلاید را دریافت کنید.
یک شیء Video اضافه کنید و مسیر فایل ویدئو را برای جاسازی ویدئو در ارائه پاس دهید.
یک شیء VideoFrame اضافه کنید تا فریمی برای ویدئو ایجاد شود.
ارائه‌ی اصلاح‌شده را ذخیره کنید.

این کد JavaScript نشان می‌دهد چگونه یک ویدئوی ذخیره‌شده به‌صورت محلی را به یک ارائه اضافه کنید:

// نمونه‌سازی کلاس Presentation
var pres = new aspose.slides.Presentation("pres.pptx");
try {
    // ویدئو را بارگذاری می‌کند
    var fileStream = java.newInstanceSync("java.io.FileInputStream", "Wildlife.mp4");
    var video = pres.getVideos().addVideo(fileStream, aspose.slides.LoadingStreamBehavior.KeepLocked);
    // اسلاید اول را دریافت می‌کند و یک فریم ویدئویی اضافه می‌کند
    pres.getSlides().get_Item(0).getShapes().addVideoFrame(10, 10, 150, 250, video);
    // ارائه را بر روی دیسک ذخیره می‌کند
    pres.save("pres-with-video.pptx", aspose.slides.SaveFormat.Pptx);
} catch (e) {console.log(e);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

به‌طور جایگزین، می‌توانید با پاس دادن مسیر فایل ویدئو مستقیماً به متد addVideoFrame(float x, float y, float width, float height, IVideo video) ویدئو را اضافه کنید:

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

ایجاد فریم ویدئویی با ویدئویی از منبع وب

Microsoft PowerPoint 2013 و جدیدتر از ویدئوهای YouTube در ارائه‌ها پشتیبانی می‌کند. اگر ویدئویی که می‌خواهید استفاده کنید به صورت آنلاین موجود باشد (مثلاً در YouTube)، می‌توانید آن را از طریق لینک وب به ارائه خود اضافه کنید.

یک نمونه از کلاس Presentation ایجاد کنید
با استفاده از اندیس آن، مرجع یک اسلاید را دریافت کنید.
یک شیء Video اضافه کنید و لینک به ویدئو را پاس دهید.
یک تصویر بند انگشتی برای فریم ویدئو تنظیم کنید.
ارائه را ذخیره کنید.

این کد JavaScript نشان می‌دهد چگونه یک ویدئوی آنلاین را به یک اسلاید در ارائه PowerPoint اضافه کنید:

// نمونه‌سازی یک شیء Presentation که نمایانگر یک فایل ارائه است
var pres = new aspose.slides.Presentation();
try {
    addVideoFromYouTube(pres, "Tj75Arhq5ho");
    pres.save("out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

async function addVideoFromYouTube(pres, videoID) {
    let slide = pres.getSlides().get_Item(0);
    let videoUrl = "https://www.youtube.com/embed/" + videoID;
    let videoFrame = slide.getShapes().addVideoFrame(10, 10, 427, 240, videoUrl);
    
    videoFrame.setPlayMode(aspose.slides.VideoPlayModePreset.Auto);

    let thumbnailUri = "http://img.youtube.com/vi/" + videoID + "/hqdefault.jpg";

    try {
        const imageStream = await getImageStream(thumbnailUri);
        let image = pres.getImages().addImage(imageStream);
        videoFrame.getPictureFormat().getPicture().setImage(image);
    } catch (error) {
        console.error("Error loading thumbnail:", error);
    }
}

async function getImageStream(url) {
    return new Promise((resolve, reject) => {
        http.get(url, (response) => {
            if (response.statusCode === 200) {
                resolve(response);
            } else {
                reject(new Error(`Failed to load image: ${response.statusCode}`));
            }
        }).on('error', (e) => {
            reject(e);
        });
    });
}

قاطع‌سازی فریم ویدئویی

Aspose.Slides به شما امکان می‌دهد بخش پخش ویدئو را با تنظیم مقادیر trim‑from‑start و trim‑from‑end از طریق VideoFrame.setTrimFromStart و VideoFrame.setTrimFromEnd کنترل کنید. هر دو مقدار بر حسب میلی‌ثانیه مشخص می‌شوند و تعیین می‌کنند چه مقدار زمان از ابتدای و انتهای ویدئو به ترتیب پرش شود. این تنظیمات فقط تنظیمات پخش ویدئو در ارائه را تغییر می‌دهند؛ داده‌های باینری ویدئوی جاسازی‌شده را قطع یا تغییر نمی‌دهند.

تنظیمات برش

برای ایجاد یک فریم ویدئوی و تنظیم مقادیر برش آن:

یک نمونه از کلاس Presentation ایجاد کنید.
یک شیء Video به ارائه اضافه کنید.
یک شیء VideoFrame به یک اسلاید اضافه کنید.
مقادیر trim‑from‑start و trim‑from‑end را از طریق VideoFrame.setTrimFromStart و VideoFrame.setTrimFromEnd تنظیم کنید.
ارائه‌ی اصلاح‌شده را ذخیره کنید.

کد زیر اولین ۲٫۵ ثانیه و یک ثانیه انتهای یک ویدئوی جاسازی‌شده را در زمان پخش نادیده می‌گیرد:

const presentation = new aspose.slides.Presentation();
try {
    const videoStream = java.newInstanceSync("java.io.FileInputStream", "video.mp4");
    try {
        const video = presentation.getVideos().addVideo(
            videoStream, aspose.slides.LoadingStreamBehavior.ReadStreamAndRelease);
        const slide = presentation.getSlides().get_Item(0);
        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 {
        videoStream.close();
    }
} finally {
    presentation.dispose();
}

خواندن تنظیمات برش

برای بررسی تنظیمات برش موجود، یک ارائه را بارگذاری کنید، یک شیء VideoFrame را در میان اشکال اسلاید اول پیدا کنید و مقادیر را از طریق VideoFrame.getTrimFromStart و VideoFrame.getTrimFromEnd بخوانید.

کد زیر اولین فریم ویدئویی در اسلاید اول را پیدا می‌کند و تنظیمات برش آن را بر حسب میلی‌ثانیه گزارش می‌دهد:

const presentation = new aspose.slides.Presentation("video_with_trim.pptx");
try {
    const slide = presentation.getSlides().get_Item(0);
    const shapeCount = slide.getShapes().size();
    for (let shapeIndex = 0; shapeIndex < shapeCount; shapeIndex++) {
        const shape = slide.getShapes().get_Item(shapeIndex);
        if (java.instanceOf(shape, "com.aspose.slides.VideoFrame")) {
            const videoFrame = shape;
            const trimFromStart = videoFrame.getTrimFromStart();
            const trimFromEnd = videoFrame.getTrimFromEnd();

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

مدیریت زیرنویس‌های ویدئو

Aspose.Slides به شما امکان می‌دهد زیرنویس‌های بسته (closed captions) برای فریم‌های ویدئویی در ارائه‌های PowerPoint را مدیریت کنید. زیرنویس‌ها در قالب WebVTT ذخیره می‌شوند و از طریق متد VideoFrame.getCaptionTracks در دسترس هستند.

افزودن زیرنویس به فریم ویدئو

برای افزودن زیرنویس به فریم ویدئو:

یک نمونه از کلاس Presentation ایجاد کنید.
یک ویدئو به ارائه اضافه کنید.
یک شیء VideoFrame به اسلاید اضافه کنید.
از مجموعه CaptionsCollection برای افزودن یک مسیر زیرنویس WebVTT استفاده کنید.
ارائه‌ی اصلاح‌شده را ذخیره کنید.

کد زیر نشان می‌دهد چگونه زیرنویس‌ها را به یک فریم ویدئویی اضافه کنید:

let presentation = new aspose.slides.Presentation();
try {
    let videoStream = java.newInstanceSync("java.io.FileInputStream", "video.mp4");
    let video = presentation.getVideos().addVideo(videoStream, aspose.slides.LoadingStreamBehavior.KeepLocked);

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

    // یک مسیر زیرنویس جدید از یک فایل WebVTT اضافه می‌کند.
    videoFrame.getCaptionTracks().add("English", "track.vtt");

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

کلاس CaptionsCollection همچنین متد addFromStream را ارائه می‌دهد که به شما اجازه می‌دهد زیرنویس‌ها را از یک جریان (stream) اضافه کنید.

استخراج زیرنویس‌ها از فریم ویدئو

برای استخراج زیرنویس‌ها از فریم ویدئو:

ارائه‌ای که شامل ویدئو است را بارگذاری کنید.
شیء VideoFrame هدف را پیدا کنید.
در مجموعه CaptionsCollection پیمایش کنید.
هر مسیر زیرنویس را در یک فایل .vtt ذخیره کنید.

کد زیر نشان می‌دهد چگونه زیرنویس‌ها را از یک فریم ویدئویی استخراج کنید:

let presentation = new aspose.slides.Presentation("video_with_captions.pptx");
try {
    let slide = presentation.getSlides().get_Item(0);
    let shapeCount = slide.getShapes().size();
    for (let shapeIndex = 0; shapeIndex < shapeCount; shapeIndex++) {
        let shape = slide.getShapes().get_Item(shapeIndex);
        if (java.instanceOf(shape, "com.aspose.slides.VideoFrame")) {
            let videoFrame = shape;
            let trackCount = videoFrame.getCaptionTracks().getCount();
            for (let trackIndex = 0; trackIndex < trackCount; trackIndex++) {
                let captionTrack = videoFrame.getCaptionTracks().get_Item(trackIndex);
                // یک مسیر زیرنویس را به یک فایل WebVTT ذخیره می‌کند.
                let filePath = captionTrack.getCaptionId() + ".vtt";
                let captionData = Buffer.from(captionTrack.getBinaryData());
                fs.writeFileSync(filePath, captionData);
            }
        }
    }
} finally {
    presentation.dispose();
}

هر شیء Captions شناسهٔ زیرنویس، برچسب، داده باینری و متن زیرنویس را به‌صورت رشتهٔ UTF‑8 ارائه می‌کند.

حذف زیرنویس‌ها از فریم ویدئو

برای حذف زیرنویس‌ها از فریم ویدئو:

ارائه‌ای که شامل ویدئو است را بارگذاری کنید.
شیء VideoFrame هدف را دریافت کنید.
مسیرهای زیرنویس را از مجموعه CaptionsCollection حذف کنید.
ارائه‌ی اصلاح‌شده را ذخیره کنید.

کد زیر نشان می‌دهد چگونه تمام زیرنویس‌ها را از یک فریم ویدئویی حذف کنید:

let presentation = new aspose.slides.Presentation("video_with_captions.pptx");
try {
    let slide = presentation.getSlides().get_Item(0);
    let videoFrame = slide.getShapes().get_Item(0); // نوع: com.aspose.slides.VideoFrame

    // تمام زیرنویس‌ها را از فریم ویدئو حذف می‌کند.
    videoFrame.getCaptionTracks().clear();

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

اگر نیاز به حذف تنها یک مسیر زیرنویس دارید، به‌جای متد clear از متدهای remove یا removeAt استفاده کنید.

استخراج ویدئو از اسلاید

علاوه بر افزودن ویدئوها به اسلایدها، Aspose.Slides به شما امکان می‌دهد ویدئوهای جاسازی‌شده در ارائه‌ها را استخراج کنید.

یک نمونه از کلاس Presentation ایجاد کنید تا ارائه‌ای که شامل ویدئو است بارگذاری شود.
در تمام اشیاء Slide پیمایش کنید.
در تمام اشیاء Shape پیمایش کنید تا یک VideoFrame پیدا شود.
ویدئو را روی دیسک ذخیره کنید.

این کد JavaScript نشان می‌دهد چگونه ویدئوی موجود در یک اسلاید ارائه را استخراج کنید:

// نمونه‌سازی یک شیء Presentation که نمایانگر یک فایل ارائه است
var pres = new aspose.slides.Presentation("VideoSample.pptx");
try {
    for (let i = 0; i < pres.getSlides().size(); i++) {
        let slide = pres.getSlides().get_Item(i);
        for (let j = 0; j < slide.getShapes().size(); j++) {
            let shape = slide.getShapes().get_Item(j);
            if (java.instanceOf(shape, "com.aspose.slides.VideoFrame")) {
                var vf = shape;
                console.log(shape);
                var type = vf.getEmbeddedVideo().getContentType();
                var ss = type.lastIndexOf('-');
                const buffer = Buffer.from(vf.getEmbeddedVideo().getBinaryData());
                console.log(buffer);
                // پسوند فایل را دریافت می‌کند
                var charIndex = type.indexOf("/");
                type = type.substring(charIndex + 1);
                fs.writeFileSync("testing2." + type, buffer);
            }
        }
    }
} catch (e) {console.log(e);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

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

کدام پارامترهای پخش ویدئو می‌توان برای VideoFrame تغییر داد؟

می‌توانید حالت پخش (playback mode) (به‌صورت خودکار یا با کلیک) و حلقه‌زدن (looping) را کنترل کنید. این گزینه‌ها از طریق ویژگی‌های شیء VideoFrame در دسترس هستند.

آیا افزودن یک ویدئو بر اندازه فایل PPTX تاثیر می‌گذارد؟

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

آیا می‌توان ویدئوی موجود در یک VideoFrame را بدون تغییر موقعیت و اندازه آن جایگزین کرد؟

بله. می‌توانید محتوای ویدئو (video content) را داخل فریم تعویض کنید در حالی که شکل (geometry) حفظ می‌شود؛ این سناریوی رایجی برای به‌روزرسانی رسانه در یک طرح موجود است.

آیا می‌توان نوع محتوا (MIME) یک ویدئوی جاسازی‌شده را تعیین کرد؟

بله. یک ویدئوی جاسازی‌شده دارای یک content type است که می‌توانید آن را بخوانید و استفاده کنید، برای مثال هنگام ذخیره‌سازی بر روی دیسک.

مدیریت اثرهای تبدیل تصویر در ارائه‌ها با JavaScript