Android でのプレゼンテーションのスライド遷移の管理

概要

スライド遷移は、スライドショー中にスライドがどのように表示されるかを制御します。Aspose.Slides for Android via Java を使用すると、各スライドの遷移効果を選択し、マウスクリックまたはタイマーによる進行を設定し、効果固有のオプションを調整できます。本記事では、Java のサンプルを使用して遷移の適用、正確な遷移時間の設定、スライドタイミングの管理、2 つのスライド間の Morph 遷移の作成方法を示します。また、設定を PPTX ファイルに保存する方法も示しています。

スライド遷移の追加

遷移を適用するには、Presentation クラスでプレゼンテーションを読み込み、getSlideShowTransition を介してスライドの遷移設定にアクセスします。TransitionType 列挙体の値を使用して setType を呼び出し、最後にプレゼンテーションを保存します。

次の例では、最初のスライドに Circle 遷移、2 番目のスライドに Comb 遷移を適用します。スライドが最低 2 枚ある input.pptx ファイルを使用してください。

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    if (presentation.getSlides().size() >= 2) {
        presentation.getSlides().get_Item(0).getSlideShowTransition().setType(TransitionType.Circle);
        presentation.getSlides().get_Item(1).getSlideShowTransition().setType(TransitionType.Comb);

        presentation.save("slide-transitions.pptx", SaveFormat.Pptx);
    } else {
        System.out.println("The input presentation must contain at least two slides.");
    }
} finally {
    presentation.dispose();
}

高度なスライド遷移の追加

スライドが画面に表示される時間や、マウスクリックでスライドショーを進めるかどうかを設定できます。以下のメソッドでこの動作を制御します。

  • setAdvanceOnClick は、マウスをクリックしてスライドショーを進めることを可能にします。
  • setAdvanceAfter は、自動的にスライドショーを進めることを有効にします。
  • setAdvanceAfterTime は、自動的に進むまでの遅延をミリ秒単位で指定します。

クリックとタイマーの両方を有効にすると、クリックでもタイマーでもスライドを進められます。タイマーのみを使用したい場合は、setAdvanceOnClickfalse を渡してください。遅延はスライドショーが進むタイミングを制御しますが、視覚的な遷移効果の長さは設定しません。

この例では、最初の 3 スライドに異なる効果を割り当て、3 秒、5 秒、7 秒後に自動進行するように設定します。マウスクリックでもこれらのスライドは進められます。スライドが最低 3 枚ある input.pptx ファイルを使用してください。

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    if (presentation.getSlides().size() >= 3) {
        ISlideShowTransition firstTransition = presentation.getSlides().get_Item(0).getSlideShowTransition();
        firstTransition.setType(TransitionType.Circle);
        firstTransition.setAdvanceOnClick(true);
        firstTransition.setAdvanceAfter(true);
        firstTransition.setAdvanceAfterTime(3000);

        ISlideShowTransition secondTransition = presentation.getSlides().get_Item(1).getSlideShowTransition();
        secondTransition.setType(TransitionType.Comb);
        secondTransition.setAdvanceOnClick(true);
        secondTransition.setAdvanceAfter(true);
        secondTransition.setAdvanceAfterTime(5000);

        ISlideShowTransition thirdTransition = presentation.getSlides().get_Item(2).getSlideShowTransition();
        thirdTransition.setType(TransitionType.Zoom);
        thirdTransition.setAdvanceOnClick(true);
        thirdTransition.setAdvanceAfter(true);
        thirdTransition.setAdvanceAfterTime(7000);

        presentation.save("advanced-transitions.pptx", SaveFormat.Pptx);
    } else {
        System.out.println("The input presentation must contain at least three slides.");
    }
} finally {
    presentation.dispose();
}

タイマー進行が有効かどうかを確認するには、getAdvanceAfter を呼び出します。遅延だけが保存されていても、タイマーがアクティブであることを意味しません。

次の例では、上記で保存したファイルを開き、各スライドのタイマー設定を報告し、遅延が 2 秒を超えるスライドの自動進行を無効にします。そのスライドはクリックで進められるようにし、更新された設定を保存します。

import com.aspose.slides.*;

Presentation presentation = new Presentation("advanced-transitions.pptx");
try {
    for (ISlide slide : presentation.getSlides()) {
        ISlideShowTransition transition = slide.getSlideShowTransition();

        if (transition.getAdvanceAfter()) {
            System.out.println("Slide " + slide.getSlideNumber() + ": advance after " + transition.getAdvanceAfterTime() + " ms.");

            if (transition.getAdvanceAfterTime() > 2000) {
                transition.setAdvanceAfter(false);
                transition.setAdvanceOnClick(true);
            }
        }
    }

    presentation.save("adjusted-transitions.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

遷移タイミングの正確な制御

setDuration を使用して、遷移効果そのものの長さをミリ秒単位で正確に指定できます。スライドの getSlideShowTransition メソッドは、ISlideShowTransition を通じてこれらの設定を提供します。

メソッド 目的
setDuration 遷移効果自体の時間をミリ秒で設定します。
setAdvanceAfterTime スライドが自動的に進むまでの遅延をミリ秒で設定します。タイマーを有効にするには setAdvanceAftertrue を渡します。
setSpeed 正確な時間が指定されていない場合に使用する、TransitionSpeed の事前定義された速度カテゴリ(Slow、Medium、Fast)を選択します。

setDuration は遷移効果だけを制御し、スライドが画面に残る時間は決定しません。自動進行の遅延は別途設定してください。明示的な期間が設定されていない場合、Aspose.Slides は遷移タイプと getSpeed の値から効果時間を算出します。

すべてのスライドに同じ期間を適用する

一定のリズムを保つために、すべてのスライドに同じ効果と正確な期間を適用します。この例は input.pptx を読み込み、TransitionType から Fade を選択し、各遷移に 750 ミリ秒の期間を設定します。自動進行は 5,000 ミリ秒後に有効にし、マウスクリックによる進行は無効にしてから PPTX として保存します。

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    for (ISlide slide : presentation.getSlides()) {
        ISlideShowTransition transition = slide.getSlideShowTransition();
        transition.setType(TransitionType.Fade);
        transition.setDuration(750);

        // 効果の期間とは別に自動進行を設定します。
        transition.setAdvanceAfter(true);
        transition.setAdvanceAfterTime(5000);
        transition.setAdvanceOnClick(false);
    }

    presentation.save("precise-transitions.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

個別スライドに異なる期間を設定する

スライドごとに異なる効果期間を使用できます。たとえば、タイトルスライドには短い遷移、セクション紹介スライドには長い遷移を設定します。この例は最初のスライドに 500 ミリ秒、2 番目のスライドに 1,200 ミリ秒を設定します。スライドが最低 2 枚ある input.pptx ファイルを使用してください。

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    if (presentation.getSlides().size() >= 2) {
        ISlideShowTransition firstTransition = presentation.getSlides().get_Item(0).getSlideShowTransition();
        firstTransition.setType(TransitionType.Fade);
        firstTransition.setDuration(500);

        ISlideShowTransition secondTransition = presentation.getSlides().get_Item(1).getSlideShowTransition();
        secondTransition.setType(TransitionType.Push);
        secondTransition.setDuration(1200);

        presentation.save("individual-transition-durations.pptx", SaveFormat.Pptx);
    } else {
        System.out.println("The input presentation must contain at least two slides.");
    }
} finally {
    presentation.dispose();
}

アニメーション出力と遷移を調整する

animated GIFHTML5 presentation、または video を作成する場合は、エクスポート前に正確な遷移期間を設定して意図したリズムに合わせます。たとえばシーン間に 600 ミリ秒のフェードを使用し、各スライドの進行遅延を個別に調整してナレーションやコンテンツの時間を確保します。

GIF とビデオの場合、フレームレートと効果時間を合わせます。600 ミリ秒は 30fps で 18 フレームに相当します。HTML5 ではエクスポート設定でアニメーション遷移を有効にします。選択したエクスポート形式がサポートする効果とタイミングオプションを確認し、プレビューで同期を確認してください。

既存の遷移期間を取得する

遷移を変更する前に getDuration を呼び出して、明示的な値が保存されているか確認します。-1 は明示的な期間が設定されていないことを意味し、非負の値はミリ秒単位の保存された期間です。未設定の値は再生時間の計算結果ではありません。Aspose.Slides は遷移タイプと getSpeed の値から期間を算出します。遷移タイプを設定すると期間が初期化されることがあるため、元の設定を最初に確認してください。

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    for (ISlide slide : presentation.getSlides()) {
        ISlideShowTransition transition = slide.getSlideShowTransition();
        int duration = transition.getDuration();

        if (duration >= 0) {
            System.out.println("Slide " + slide.getSlideNumber() + ": stored transition duration is " + duration + " ms.");
        } else {
            System.out.println("Slide " + slide.getSlideNumber() + ": no explicit duration; timing depends on transition type " + transition.getType() + " and speed " + transition.getSpeed() + ".");
        }
    }
} finally {
    presentation.dispose();
}

Morph 遷移

Morph 遷移は、連続するスライド間でオブジェクトの変更をアニメーション化します。簡単な Morph 効果を作成するには、スライドをクローンし、クローン上のオブジェクトを移動またはサイズ変更し、2 番目のスライドに Morph 遷移を適用します。これにより、元の状態と変更後の状態の間で対応するオブジェクトがアニメーション化されます。

以下の例はテキスト矩形を持つスライドを作成し、スライドをクローンして矩形の位置とサイズを変更します。その後、2 番目のスライドの TransitionType 列挙体から Morph を選択します。Morph をサポートするプレゼンテーションビューアで保存したファイルを開くと、スライドショー中に効果が確認できます。

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide firstSlide = presentation.getSlides().get_Item(0);
    IAutoShape rectangle = firstSlide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 400, 100);
    rectangle.getTextFrame().setText("Morph transition");

    ISlide secondSlide = presentation.getSlides().addClone(firstSlide);
    IShape movedRectangle = secondSlide.getShapes().get_Item(0);
    movedRectangle.setX(movedRectangle.getX() + 100);
    movedRectangle.setY(movedRectangle.getY() + 50);
    movedRectangle.setWidth(movedRectangle.getWidth() - 200);
    movedRectangle.setHeight(movedRectangle.getHeight() - 10);

    secondSlide.getSlideShowTransition().setType(TransitionType.Morph);

    presentation.save("morph-transition.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Morph 遷移タイプ

TransitionMorphType 列挙体は、Morph がコンテンツをどのようにマッチさせてアニメーション化するかを制御します。

  • ByObject は、各シェイプを全体のオブジェクトとして扱います。
  • ByWord は、可能な場合、単語単位でテキストを一致させてアニメーション化します。
  • ByChar は、可能な場合、文字単位でテキストを一致させてアニメーション化します。

Morph を選択するには、まず setType で Morph を設定し、getValue で取得した IMorphTransition インターフェイスの setMorphType メソッドでマッチングモードを選択します。

この例は前節で作成したプレゼンテーションを開き、2 番目のスライドに単語ベースの Morph アニメーションを設定します。

import com.aspose.slides.*;

Presentation presentation = new Presentation("morph-transition.pptx");
try {
    if (presentation.getSlides().size() >= 2) {
        ISlideShowTransition transition = presentation.getSlides().get_Item(1).getSlideShowTransition();
        transition.setType(TransitionType.Morph);
        ITransitionValueBase transitionValue = transition.getValue();

        if (transitionValue instanceof IMorphTransition) {
            IMorphTransition morphTransition = (IMorphTransition) transitionValue;
            morphTransition.setMorphType(TransitionMorphType.ByWord);
            presentation.save("morph-by-word.pptx", SaveFormat.Pptx);
        } else {
            System.out.println("Morph transition options are unavailable.");
        }
    } else {
        System.out.println("The input presentation must contain at least two slides.");
    }
} finally {
    presentation.dispose();
}

遷移効果の設定

一部の遷移は方向や黒画面から開始するかどうかなど、追加オプションを提供します。利用可能なオプションは、setType で選択した遷移に依存します。まずタイプを設定し、次に getValue から適切なインターフェイスを取得してオプションを設定します。

以下の例は input.pptx の最初のスライドに Cut 遷移を適用し、IOptionalBlackTransition を介して setFromBlack を呼び出し、黒画面から開始するようにします。

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    ISlideShowTransition transition = presentation.getSlides().get_Item(0).getSlideShowTransition();
    transition.setType(TransitionType.Cut);
    ITransitionValueBase transitionValue = transition.getValue();

    if (transitionValue instanceof IOptionalBlackTransition) {
        IOptionalBlackTransition cutTransition = (IOptionalBlackTransition) transitionValue;
        cutTransition.setFromBlack(true);
        presentation.save("cut-from-black.pptx", SaveFormat.Pptx);
    } else {
        System.out.println("Cut transition options are unavailable.");
    }
} finally {
    presentation.dispose();
}

FAQ

スライド遷移の再生速度を制御できますか?

はい。ミリ秒単位で正確な効果時間が必要な場合は setDuration を優先してください。事前定義された速度カテゴリ(Slow、Medium、Fast)で十分な場合は、明示的な期間を設定せずに setSpeed を使用します。これらの設定は自動進行遅延とは独立して遷移効果を制御します。

遷移に音声を付けてループさせることはできますか?

はい。setSound で埋め込み音声を割り当て、TransitionSoundMode 列挙体から StartSound を setSoundMode に渡し、setSoundLooptrue に設定します。音声は次のサウンドイベントが発生するまでループします。

すべてのスライドに同じ遷移を適用する最速の方法は?

プレゼンテーションの getSlides コレクションをループし、各スライドの遷移に対して同じ値で setType を呼び出します。同じループ内でタイミングや効果オプションも設定すれば、スライド間で動作を統一できます。

スライドに現在設定されている遷移を確認するには?

スライドの getSlideShowTransition 結果に対して getType を呼び出します。返されるのは TransitionType 列挙体の値で、None は遷移効果が設定されていないことを示します。