JavaScript を使用してプレゼンテーションのオーディオを管理

このページの概要

Aspose.Slides for Node.js でオーディオフレームを作成・制御します—埋め込み、トリミング、ループ、再生設定を PPT、PPTX、ODP プレゼンテーションで行う例です。

オーディオフレームの作成

Aspose.Slides for Node.js via Java を使用すると、スライドにオーディオファイルを追加できます。オーディオファイルはオーディオフレームとしてスライドに埋め込まれます。

Presentation クラスのインスタンスを作成します。
インデックスでスライドの参照を取得します。
スライドに埋め込むオーディオファイルストリームをロードします。
埋め込まれたオーディオフレーム（オーディオファイルを含む）をスライドに追加します。
AudioFrame オブジェクトで公開されている PlayMode と Volume を設定します。
変更されたプレゼンテーションを保存します。

この JavaScript コードは、スライドに埋め込みオーディオフレームを追加する方法を示しています:

// プレゼンテーション ファイルを表す Presentation クラスのインスタンスを作成
const pres = new aspose.slides.Presentation();
try {
    // 最初のスライドを取得
    const sld = pres.getSlides().get_Item(0);
    // wav サウンド ファイルをストリームにロード
    const fstr = java.newInstanceSync("java.io.FileInputStream", java.newInstanceSync("java.io.File", "audio.wav"));
    // オーディオ フレームを追加
    const audioFrame = sld.getShapes().addAudioFrameEmbedded(50, 150, 100, 100, fstr);
    fstr.close();
    // オーディオの再生モードと音量を設定
    audioFrame.setPlayMode(aspose.slides.AudioPlayModePreset.Auto);
    audioFrame.setVolume(aspose.slides.AudioVolumeMode.Loud);
    // PowerPoint ファイルをディスクに書き込む
    pres.save("AudioFrameEmbed_out.pptx", aspose.slides.SaveFormat.Pptx);
} catch (e) {console.log(e);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

オーディオフレームサムネイルの変更

プレゼンテーションにオーディオファイルを追加すると、標準のデフォルト画像が付いたフレームとして表示されます（以下の画像を参照）。オーディオフレームのプレビュー画像（好みの画像）に変更できます。

この JavaScript コードは、オーディオフレームのサムネイルまたはプレビュー画像を変更する方法を示しています:

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);
    // 指定された位置とサイズでスライドにオーディオ フレームを追加します。
    const audioStream = java.newInstanceSync("java.io.FileInputStream", "sample2.mp3");
    const audioFrame = slide.getShapes().addAudioFrameEmbedded(150, 100, 50, 50, audioStream);
    audioStream.close();
    // プレゼンテーションのリソースに画像を追加します。
    let picture;
    const image = aspose.slides.Images.fromFile("eagle.jpeg");
    try {
        picture = presentation.getImages().addImage(image);
    } finally {
        if (image != null) {
            image.dispose();
        }
    }
    // オーディオ フレームの画像を設定します。
    audioFrame.getPictureFormat().getPicture().setImage(picture);// <-----
    // 変更されたプレゼンテーションをディスクに保存します
    presentation.save("example_out.pptx", aspose.slides.SaveFormat.Pptx);
} catch (e) {console.log(e);
} finally {
    if (presentation != null) {
        presentation.dispose();
    }
}

オーディオ再生オプションの変更

Aspose.Slides for Node.js via Java を使用すると、オーディオの再生やプロパティを制御するオプションを変更できます。たとえば、音量を調整したり、ループ再生に設定したり、オーディオアイコンを非表示にしたりできます。

Microsoft PowerPoint の オーディオオプション パネル:

example1_image

PowerPoint の オーディオオプション は Aspose.Slides の AudioFrame プロパティに対応しています:

Start ドロップダウンリストは AudioFrame.setPlayMode メソッドと一致します
Volume は AudioFrame.setVolume メソッドと一致します
Play Across Slides は AudioFrame.setPlayAcrossSlides メソッドと一致します
Loop until Stopped は AudioFrame.setPlayLoopMode メソッドと一致します
Hide During Show は AudioFrame.setHideAtShowing メソッドと一致します
Rewind after Playing は AudioFrame.setRewindAudio メソッドと一致します

PowerPoint の編集オプションは Aspose.Slides の AudioFrame プロパティに対応しています:

Fade In は AudioFrame.setFadeInDuration メソッドと一致します
Fade Out は AudioFrame.setFadeOutDuration メソッドと一致します
Trim Audio Start Time は AudioFrame.setTrimFromStart メソッドと一致します
Trim Audio End Time の値は、オーディオの全体長から AudioFrame.setTrimFromEnd メソッドの値を差し引いたものに相当します

PowerPoint のオーディオコントロールパネル上の ボリュームコントロール は AudioFrame.setVolumeValue メソッドに対応しており、パーセンテージで音量を変更できます。

オーディオ再生オプションを変更する手順は次のとおりです:

Create または Audio Frame を取得します。
調整したい Audio Frame プロパティに新しい値を設定します。
変更された PowerPoint ファイルを保存します。

この JavaScript コードは、オーディオのオプションを調整する操作を示しています:

const pres = new aspose.slides.Presentation("AudioFrameEmbed_out.pptx");
try {
    // AudioFrame シェイプを取得
    const audioFrame = pres.getSlides().get_Item(0).getShapes().get_Item(0);
    // 再生モードをクリック時に設定
    audioFrame.setPlayMode(aspose.slides.AudioPlayModePreset.OnClick);
    // 音量を Low に設定
    audioFrame.setVolume(aspose.slides.AudioVolumeMode.Low);
    // オーディオをスライド全体で再生するよう設定
    audioFrame.setPlayAcrossSlides(true);
    // オーディオのループを無効化
    audioFrame.setPlayLoopMode(false);
    // スライドショー中に AudioFrame を非表示にする
    audioFrame.setHideAtShowing(true);
    // 再生後にオーディオを先頭に巻き戻す
    audioFrame.setRewindAudio(true);
    // PowerPoint ファイルをディスクに保存
    pres.save("AudioFrameEmbed_changed.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

この JavaScript の例は、埋め込みオーディオを持つ新しいオーディオフレームを追加し、トリミングとフェード時間を設定する方法を示しています:

const pres = new aspose.slides.Presentation();
try {
    const slide = pres.getSlides().get_Item(0);
    
    const audioData = java.newArray("byte", Array.from(fs.readFileSync("sampleaudio.mp3")));
    const audio = pres.getAudios().addAudio(audioData);
    const audioFrame = slide.getShapes().addAudioFrameEmbedded(50, 50, 100, 100, audio);

    // トリミング開始オフセットを 1.5 秒に設定
    audioFrame.setTrimFromStart(1500);
    // トリミング終了オフセットを 2 秒に設定
    audioFrame.setTrimFromEnd(2000);

    // フェードイン時間を 200 ミリ秒に設定
    audioFrame.setFadeInDuration(200);
    // フェードアウト時間を 500 ミリ秒に設定
    audioFrame.setFadeOutDuration(500);

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

以下のコードサンプルは、埋め込みオーディオを持つオーディオフレームを取得し、音量を 85% に設定する方法を示しています:

const pres = new aspose.slides.Presentation("AudioFrameEmbed_out.pptx");
try {
    const slide = pres.getSlides().get_Item(0);

    // オーディオ フレーム シェイプを取得
    const audioFrame = slide.getShapes().get_Item(0);

    // オーディオの音量を 85% に設定
    audioFrame.setVolumeValue(85.0);

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

オーディオキャプションの管理

Aspose.Slides を使用すると、getCaptionTracks メソッドを通じてオーディオフレームにクローズドキャプションを追加できます。このメソッドは CaptionsCollection を返し、WebVTT キャプショントラックの追加、既存トラックの反復、必要に応じた削除が可能です。

オーディオキャプションの追加

getCaptionTracks メソッドを使用して、1 つまたは複数のキャプショントラックをオーディオフレームに添付します。以下の例では、スライドにオーディオファイルを追加し、.vtt ファイルから新しいキャプショントラックを読み込みます。

let presentation = new aspose.slides.Presentation();
try {
    let audioStream = java.newInstanceSync("java.io.FileInputStream", "audio.mp3");
    let audio = presentation.getAudios().addAudio(audioStream);
    audioStream.close();

    let slide = presentation.getSlides().get_Item(0);
    let audioFrame = slide.getShapes().addAudioFrameEmbedded(10, 10, 50, 50, audio);

    // WebVTT ファイルから新しいキャプション トラックを追加。
    audioFrame.getCaptionTracks().add("New track", "track.vtt");

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

オーディオキャプションの抽出

オーディオフレームに関連付けられたキャプショントラックを反復処理し、.vtt ファイルとして保存できます。各キャプショントラックはバイナリデータと一意の識別子を公開しており、キャプションのエクスポート時に使用できます。

let presentation = new aspose.slides.Presentation("audio_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.AudioFrame")) {
            let audioFrame = shape;
            let trackCount = audioFrame.getCaptionTracks().getCount();
            for (let trackIndex = 0; trackIndex < trackCount; trackIndex++) {
                let captionTrack = audioFrame.getCaptionTracks().get_Item(trackIndex);
                // キャプション トラックを .vtt ファイルとして保存します。
                let filePath = captionTrack.getCaptionId() + ".vtt";
                let captionData = Buffer.from(captionTrack.getBinaryData());
                fs.writeFileSync(filePath, captionData);
            }
        }
    }
} finally {
    presentation.dispose();
}

オーディオキャプションの削除

オーディオフレームからキャプションを削除するには、CaptionsCollection が提供する clear、remove、または removeAt メソッドを使用します。以下の例は、オーディオフレームからすべてのキャプショントラックを削除します。

let presentation = new aspose.slides.Presentation("audio_with_captions.pptx");
try {
    let slide = presentation.getSlides().get_Item(0);
    let audioFrame = slide.getShapes().get_Item(0); // 型: aspose.slides.AudioFrame

    // オーディオ フレームからすべてのキャプション トラックを削除します。
    audioFrame.getCaptionTracks().clear();

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

オーディオの抽出

Aspose.Slides for Node.js via Java を使用すると、スライドショーの遷移で使用されるサウンドを抽出できます。たとえば、特定のスライドで使用されているサウンドを抽出できます。

Presentation クラスのインスタンスを作成し、オーディオを含むプレゼンテーションをロードします。
インデックスで対象スライドの参照を取得します。
スライドの slideshow transitions にアクセスします。
サウンドをバイトデータとして抽出します。

この JavaScript コードは、スライドで使用されているオーディオを抽出する方法を示しています:

// プレゼンテーション ファイルを表す Presentation クラスのインスタンスを作成
const pres = new aspose.slides.Presentation("AudioSlide.pptx");
try {
    // 目的のスライドにアクセス
    const slide = pres.getSlides().get_Item(0);
    // スライドのスライドショー遷移エフェクトを取得
    const transition = slide.getSlideShowTransition();
    // サウンドをバイト配列として抽出
    const audio = transition.getSound().getBinaryData();
    console.log("Length: " + audio.length);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

FAQ

同じオーディオアセットを複数のスライドで再利用して、ファイルサイズを増やさずにすみますか？

はい。プレゼンテーションの共有 audio collection にオーディオを 1 回追加し、その既存アセットを参照する追加のオーディオフレームを作成します。これによりメディアデータの重複が防がれ、プレゼンテーションサイズを抑制できます。

既存のオーディオフレームのサウンドをシェイプを作り直さずに置き換えることはできますか？

はい。リンクされたサウンドの場合は、link path を新しいファイルに更新します。埋め込みサウンドの場合は、プレゼンテーションの audio collection から別の埋め込みオーディオオブジェクトに差し替えます。フレームの書式設定やほとんどの再生設定はそのまま保持されます。

トリミングはプレゼンテーションに保存されている基礎オーディオデータを変更しますか？

いいえ。トリミングは再生範囲のみを調整します。元のオーディオバイトは変更されず、埋め込みオーディオまたはプレゼンテーションのオーディオコレクションを通じて引き続きアクセス可能です。

プレゼンテーションビューア

JavaScript を使用してプレゼンテーションのオーディオを管理

このページの概要

オーディオ フレームの作成

オーディオ フレーム サムネイルの変更

オーディオ 再生オプションの変更

オーディオ キャプションの管理

オーディオ の抽出

FAQ

オーディオフレームの作成

オーディオフレームサムネイルの変更

オーディオ再生オプションの変更

オーディオキャプションの管理

オーディオの抽出