# Android에서 프레젠테이션에 도형 애니메이션 적용

> Aspose.Slides for Android via Java를 사용하여 PowerPoint 프레젠테이션에서 도형 애니메이션을 만들고 맞춤화하는 방법을 알아보세요. 돋보이세요!

Source: https://docs.aspose.com/slides/ko/androidjava/shape-animation/
Updated: 2026-06-14

## **소개**

애니메이션은 텍스트, 이미지, 도형 또는 [charts](https://docs.aspose.com/slides/ko/androidjava/animated-charts/)에 적용할 수 있는 시각 효과이며, 프레젠테이션이나 그 구성 요소에 생동감을 부여합니다.

## **프레젠테이션에서 애니메이션을 사용하는 이유**

애니메이션을 사용하면  

* 정보 흐름을 제어한다  
* 중요한 포인트를 강조한다  
* 청중의 관심이나 참여를 높인다  
* 콘텐츠를 더 쉽게 읽고 이해하거나 처리한다  
* 독자나 시청자의 주의를 프레젠테이션의 중요한 부분으로 끈다  

PowerPoint은 **입장**, **퇴장**, **강조**, **움직임 경로** 카테고리 전반에 걸쳐 애니메이션 및 애니메이션 효과를 위한 다양한 옵션과 도구를 제공합니다. 

## **Aspose.Slides의 애니메이션**

* Aspose.Slides는 `Aspose.Slides.Animation` 네임스페이스 아래에서 애니메이션 작업에 필요한 클래스와 유형을 제공합니다,  
* Aspose.Slides는 [EffectType](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/effecttype) 열거형에 정의된 **150개 이상의 애니메이션 효과**를 제공합니다. 이러한 효과는 기본적으로 PowerPoint에서 사용되는 효과와 동일하거나 동등합니다.

## **텍스트 상자에 애니메이션 적용**

Aspose.Slides for Android via Java를 사용하면 도형 내 텍스트에 애니메이션을 적용할 수 있습니다.

1. [Presentation](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/Presentation) 클래스의 인스턴스를 생성합니다.  
2. 인덱스를 통해 슬라이드 참조를 얻습니다.  
3. `rectangle` [IAutoShape](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/iautoshape)를 추가합니다.  
4. [IAutoShape.TextFrame](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/IAutoShape#addTextFrame-java.lang.String-)에 텍스트를 추가합니다.  
5. 주 효과 시퀀스를 가져옵니다.  
6. [IAutoShape](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/iautoshape)에 애니메이션 효과를 추가합니다.  
7. `TextAnimation.BuildType` 속성을 `BuildType` 열거형의 값으로 설정합니다.  
8. 프레젠테이션을 PPTX 파일로 디스크에 저장합니다.  

다음 Java 코드는 `Fade` 효과를 AutoShape에 적용하고 텍스트 애니메이션을 *By 1st Level Paragraphs* 값으로 설정하는 방법을 보여 줍니다:

```java
// 프레젠테이션 파일을 나타내는 프레젠테이션 클래스를 인스턴스화합니다.
Presentation pres = new Presentation();
try {
    ISlide sld = pres.getSlides().get_Item(0);

    // 텍스트가 있는 새 AutoShape를 추가합니다
    IAutoShape autoShape = sld.getShapes().addAutoShape(ShapeType.Rectangle, 20, 20, 150, 100);

    ITextFrame textFrame = autoShape.getTextFrame();
    textFrame.setText("First paragraph \nSecond paragraph \n Third paragraph");

    // 슬라이드의 주 시퀀스를 가져옵니다.
    ISequence sequence = sld.getTimeline().getMainSequence();

    // 도형에 Fade 애니메이션 효과를 추가합니다
    IEffect effect = sequence.addEffect(autoShape, EffectType.Fade, EffectSubtype.None, EffectTriggerType.OnClick);

    // 도형 텍스트를 1단계 단락별로 애니메이션합니다
    effect.getTextAnimation().setBuildType(BuildType.ByLevelParagraphs1);

    // PPTX 파일을 디스크에 저장합니다
    pres.save(path + "AnimText_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}
```

{{%  alert color="primary"  %}} 

텍스트에 애니메이션을 적용하는 것 외에도, 단일 [Paragraph](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/iparagraph)에 애니메이션을 적용할 수도 있습니다. 자세한 내용은 [**Animated Text**](/slides/ko/androidjava/animated-text/)를 참조하십시오.

{{% /alert %}} 

## **PictureFrame에 애니메이션 적용**

1. [Presentation](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/Presentation) 클래스의 인스턴스를 생성합니다.  
2. 인덱스를 통해 슬라이드 참조를 얻습니다.  
3. 슬라이드에 [PictureFrame](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/pictureframe)을 추가하거나 가져옵니다.  
4. 주 효과 시퀀스를 가져옵니다.  
5. [PictureFrame](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/pictureframe)에 애니메이션 효과를 추가합니다.  
6. 프레젠테이션을 PPTX 파일로 디스크에 저장합니다.  

다음 Java 코드는 picture frame에 `Fly` 효과를 적용하는 방법을 보여 줍니다:

```java
// 프레젠테이션 파일을 나타내는 프레젠테이션 클래스를 인스턴스화합니다.
Presentation pres = new Presentation();
try {
    // 프레젠테이션 이미지 컬렉션에 추가될 이미지를 로드합니다
    IPPImage picture;
    IImage image = Images.fromFile("aspose-logo.jpg");
    try {
        picture = pres.getImages().addImage(image);
    } finally {
        if (image != null) image.dispose();
    }

    // 슬라이드에 picture frame을 추가합니다
    IPictureFrame picFrame = pres.getSlides().get_Item(0).getShapes().addPictureFrame(ShapeType.Rectangle, 50, 50, 100, 100, picture);

    // 슬라이드의 주 시퀀스를 가져옵니다.
    ISequence sequence = pres.getSlides().get_Item(0).getTimeline().getMainSequence();

    // picture frame에 Fly from Left 애니메이션 효과를 추가합니다
    IEffect effect = sequence.addEffect(picFrame, EffectType.Fly, EffectSubtype.Left, EffectTriggerType.OnClick);

    // PPTX 파일을 디스크에 저장합니다
    pres.save(path + "AnimImage_out.pptx", SaveFormat.Pptx);
} catch(IOException e) {
} finally {
    if (pres != null) pres.dispose();
}
```

## **도형에 애니메이션 적용**

1. [Presentation](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/Presentation) 클래스의 인스턴스를 생성합니다.  
2. 인덱스를 통해 슬라이드 참조를 얻습니다.  
3. `rectangle` [IAutoShape](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/iautoshape)를 추가합니다.  
4. `Bevel` [IAutoShape](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/iautoshape)를 추가합니다(이 개체를 클릭하면 애니메이션이 재생됩니다).  
5. 베벨 도형에 대한 효과 시퀀스를 생성합니다.  
6. 맞춤형 `UserPath`를 생성합니다.  
7. `UserPath`로 이동하기 위한 명령을 추가합니다.  
8. 프레젠테이션을 PPTX 파일로 디스크에 저장합니다.  

다음 Java 코드는 도형에 `PathFootball`(경로 축구) 효과를 적용하는 방법을 보여 줍니다:

```java
// PPTX 파일을 나타내는 Presentation 클래스를 인스턴스화합니다.
Presentation pres = new Presentation();
try {
    ISlide sld = pres.getSlides().get_Item(0);

    // 기존 도형에 대해 처음부터 PathFootball 효과를 생성합니다.
    IAutoShape ashp = sld.getShapes().addAutoShape(ShapeType.Rectangle, 150, 150, 250, 25);
    ashp.addTextFrame("Animated TextBox");

    // PathFootBall 애니메이션 효과를 추가합니다
    pres.getSlides().get_Item(0).getTimeline().getMainSequence().addEffect(ashp, EffectType.PathFootball,
            EffectSubtype.None, EffectTriggerType.AfterPrevious);

    // 일종의 "버튼"을 생성합니다.
    IShape shapeTrigger = pres.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Bevel, 10, 10, 20, 20);

    // 이 버튼에 대한 효과 시퀀스를 생성합니다.
    ISequence seqInter = pres.getSlides().get_Item(0).getTimeline().getInteractiveSequences().add(shapeTrigger);

     // 사용자 지정 경로를 생성합니다. 객체는 버튼 클릭 후에만 이동됩니다.
    IEffect fxUserPath = seqInter.addEffect(ashp, EffectType.PathUser, EffectSubtype.None, EffectTriggerType.OnClick);

     // 생성된 경로가 비어 있으므로 이동 명령을 추가합니다.
    IMotionEffect motionBhv = ((IMotionEffect)fxUserPath.getBehaviors().get_Item(0));

    Point2D.Float[] pts = new Point2D.Float[1];
    pts[0] = new Point2D.Float(0.076f, 0.59f);
    motionBhv.getPath().add(MotionCommandPathType.LineTo, pts, MotionPathPointsType.Auto, true);
    pts[0] = new Point2D.Float(-0.076f, -0.59f);
    motionBhv.getPath().add(MotionCommandPathType.LineTo, pts, MotionPathPointsType.Auto, false);
    motionBhv.getPath().add(MotionCommandPathType.End, null, MotionPathPointsType.Auto, false);

     // PPTX 파일을 디스크에 씁니다
    pres.save("AnimExample_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}
```

## **도형에 적용된 애니메이션 효과 가져오기**

다음 예제는 [ISequence](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/isequence/) 인터페이스의 `getEffectsByShape` 메서드를 사용하여 도형에 적용된 모든 애니메이션 효과를 가져오는 방법을 보여 줍니다.

**예제 1: 일반 슬라이드에서 도형에 적용된 애니메이션 효과 가져오기**

이전에 PowerPoint 프레젠테이션에서 도형에 애니메이션 효과를 추가하는 방법을 배웠습니다. 다음 샘플 코드는 `AnimExample_out.pptx` 프레젠테이션의 첫 번째 일반 슬라이드에 있는 첫 번째 도형에 적용된 효과를 가져오는 방법을 보여 줍니다.

```java
Presentation presentation = new Presentation("AnimExample_out.pptx");
try {
    ISlide firstSlide = presentation.getSlides().get_Item(0);

    // 슬라이드의 주요 애니메이션 시퀀스를 가져옵니다.
    ISequence sequence = firstSlide.getTimeline().getMainSequence();

    // 첫 번째 슬라이드에서 첫 번째 도형을 가져옵니다.
    IShape shape = firstSlide.getShapes().get_Item(0);

    // 도형에 적용된 애니메이션 효과를 가져옵니다.
    IEffect[] shapeEffects = sequence.getEffectsByShape(shape);

    if (shapeEffects.length > 0)
        System.out.println("The shape " + shape.getName() + " has " + shapeEffects.length + " animation effects.");
} finally {
    if (presentation != null) presentation.dispose();
}
```

**예제 2: 자리표시자에서 상속된 효과를 포함한 모든 애니메이션 효과 가져오기**

일반 슬라이드의 도형에 레이아웃 슬라이드 및/또는 마스터 슬라이드에 있는 자리표시자가 있고, 이러한 자리표시자에 애니메이션 효과가 추가된 경우, 해당 도형의 모든 효과는 슬라이드 쇼 동안 재생되며 자리표시자에서 상속된 효과도 포함됩니다.

PowerPoint 프레젠테이션 파일 `sample.pptx`에 하나의 슬라이드가 있으며, 여기에는 텍스트가 “Made with Aspose.Slides”인 푸터 도형만 포함되어 있고, **Random Bars** 효과가 해당 도형에 적용되었습니다.

![슬라이드 도형 애니메이션 효과](slide-shape-animation.png)

또한 **layout** 슬라이드의 푸터 자리표시자에 **Split** 효과가 적용되었다고 가정해 보겠습니다.

![레이아웃 도형 애니메이션 효과](layout-shape-animation.png)

마지막으로 **master** 슬라이드의 푸터 자리표시자에 **Fly In** 효과가 적용되었습니다.

![마스터 도형 애니메이션 효과](master-shape-animation.png)

다음 샘플 코드는 [IShape](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/ishape/) 인터페이스의 `getBasePlaceholder` 메서드를 사용하여 도형 자리표시자에 접근하고 레이아웃 및 마스터 슬라이드에 위치한 자리표시자에서 상속된 효과를 포함한 푸터 도형에 적용된 애니메이션 효과를 가져오는 방법을 보여 줍니다.

```java
Presentation presentation = new Presentation("sample.pptx");

ISlide slide = presentation.getSlides().get_Item(0);

// 일반 슬라이드에서 도형에 대한 애니메이션 효과를 가져옵니다.
IShape shape = slide.getShapes().get_Item(0);
IEffect[] shapeEffects = slide.getTimeline().getMainSequence().getEffectsByShape(shape);

// 레이아웃 슬라이드에서 자리표시자에 대한 애니메이션 효과를 가져옵니다.
IShape layoutShape = shape.getBasePlaceholder();
IEffect[] layoutShapeEffects = slide.getLayoutSlide().getTimeline().getMainSequence().getEffectsByShape(layoutShape);

// 마스터 슬라이드에서 자리표시자에 대한 애니메이션 효과를 가져옵니다.
IShape masterShape = layoutShape.getBasePlaceholder();
IEffect[] masterShapeEffects = slide.getLayoutSlide().getMasterSlide().getTimeline().getMainSequence().getEffectsByShape(masterShape);

System.out.println("Main sequence of shape effects:");
printEffects(masterShapeEffects);
printEffects(layoutShapeEffects);
printEffects(shapeEffects);

presentation.dispose();
```
```java
static void printEffects(IEffect[] effects)
{
    for (IEffect effect : effects)
    {
        String typeName = EffectType.getName(EffectType.class, effect.getType());
        String subtypeName = EffectSubtype.getName(EffectSubtype.class, effect.getSubtype());

        System.out.println(typeName + " " + subtypeName);
    }
}
```

Output:
```text
Main sequence of shape effects:
Fly Bottom
Split VerticalIn
RandomBars Horizontal
```

## **애니메이션 효과 타이밍 속성 변경**

Aspose.Slides for Android via Java를 사용하면 애니메이션 효과의 타이밍 속성을 변경할 수 있습니다.

다음은 Microsoft PowerPoint의 Animation Timing 창입니다:

![예시 이미지1](shape-animation.png)

PowerPoint Timing과 [Effect.Timing](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/IEffect#getTiming--) 속성 간의 대응 관계는 다음과 같습니다:

- PowerPoint Timing **Start** 드롭다운 목록은 [Effect.Timing.TriggerType](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/ITiming#getTriggerType--) 속성과 일치합니다.  
- PowerPoint Timing **Duration** 은 [Effect.Timing.Duration](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/ITiming#getDuration--) 속성과 일치합니다. 애니메이션 지속 시간(초)은 애니메이션이 한 사이클을 완료하는 데 걸리는 총 시간입니다.  
- PowerPoint Timing **Delay** 은 [Effect.Timing.TriggerDelayTime](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/ITiming#getTriggerDelayTime--) 속성과 일치합니다.  

Effect Timing 속성을 변경하는 방법은 다음과 같습니다:

1. [도형에 애니메이션 적용](#apply-animation-to-shape) 절을 따라 효과를 적용하거나 가져옵니다.  
2. 필요한 [Effect.Timing](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/IEffect#getTiming--) 속성에 새로운 값을 설정합니다.  
3. 수정된 PPTX 파일을 저장합니다.  

다음 Java 코드는 해당 작업을 구현한 예시입니다:

```java
// 프레젠테이션 파일을 나타내는 프레젠테이션 클래스를 인스턴스화합니다.
Presentation pres = new Presentation("AnimExample_out.pptx");
try {
    // 슬라이드의 주 시퀀스를 가져옵니다.
    ISequence sequence = pres.getSlides().get_Item(0).getTimeline().getMainSequence();

    // 주 시퀀스의 첫 번째 효과를 가져옵니다.
    IEffect effect = sequence.get_Item(0);

    // 효과 TriggerType을 클릭시 시작하도록 변경합니다
    effect.getTiming().setTriggerType(EffectTriggerType.OnClick);

    // 효과 지속 시간을 변경합니다
    effect.getTiming().setDuration(3f);

    // 효과 TriggerDelayTime을 변경합니다
    effect.getTiming().setTriggerDelayTime(0.5f);

    // PPTX 파일을 디스크에 저장합니다
    pres.save("AnimExample_changed.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}
```

## **애니메이션 효과 사운드**

Aspose.Slides는 애니메이션 효과에 사운드를 사용하기 위한 다음 속성을 제공합니다:  

- [setSound(IAudio value)](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/effect/#setSound-com.aspose.slides.IAudio-) – 사운드 설정  
- [setStopPreviousSound(boolean value)](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/effect/#setStopPreviousSound-boolean-) – 이전 사운드 정지 설정  

### **애니메이션 효과 사운드 추가**

다음 Java 코드는 애니메이션 효과에 사운드를 추가하고 다음 효과가 시작될 때 사운드를 정지시키는 방법을 보여 줍니다:

```java
Presentation pres = new Presentation("AnimExample_out.pptx");
try {
    // 프레젠테이션 오디오 컬렉션에 오디오를 추가합니다
    IAudio effectSound = pres.getAudios().addAudio(Files.readAllBytes(Paths.get("sampleaudio.wav")));

    ISlide firstSlide = pres.getSlides().get_Item(0);

    // 슬라이드의 주 시퀀스를 가져옵니다.
    ISequence sequence = firstSlide.getTimeline().getMainSequence();

    // 주 시퀀스의 첫 번째 효과를 가져옵니다
    IEffect firstEffect = sequence.get_Item(0);

    // 효과에 "소리 없음"이 있는지 확인합니다
    if (!firstEffect.getStopPreviousSound() && firstEffect.getSound() == null)
    {
        // 첫 번째 효과에 사운드를 추가합니다
        firstEffect.setSound(effectSound);
    }

    // 슬라이드의 첫 번째 인터랙티브 시퀀스를 가져옵니다.
    ISequence interactiveSequence = firstSlide.getTimeline().getInteractiveSequences().get_Item(0);

    // 효과 "이전 사운드 정지" 플래그를 설정합니다
    interactiveSequence.get_Item(0).setStopPreviousSound(true);

    // PPTX 파일을 디스크에 저장합니다
    pres.save("AnimExample_Sound_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}
```

### **애니메이션 효과 사운드 추출**

1. [Presentation](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/presentation/) 클래스의 인스턴스를 생성합니다.  
2. 인덱스를 통해 슬라이드의 참조를 얻습니다.  
3. 주 효과 시퀀스를 가져옵니다.  
4. 각 애니메이션 효과에 임베드된 [setSound(IAudio value)](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/effect/#setSound-com.aspose.slides.IAudio-) 를 추출합니다.  

다음 Java 코드는 애니메이션 효과에 임베드된 사운드를 추출하는 방법을 보여 줍니다:

```java
// 프레젠테이션 파일을 나타내는 프레젠테이션 클래스를 인스턴스화합니다.
Presentation presentation = new Presentation("EffectSound.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    // 슬라이드의 주 시퀀스를 가져옵니다.
    ISequence sequence = slide.getTimeline().getMainSequence();

    for (IEffect effect : sequence)
    {
        if (effect.getSound() == null)
            continue;

        // 효과 사운드를 바이트 배열로 추출합니다
        byte[] audio = effect.getSound().getBinaryData();
    }
} finally {
    if (presentation != null) presentation.dispose();
}
```

## **애니메이션 후**

Aspose.Slides for Android via Java를 사용하면 애니메이션 효과의 After animation 속성을 변경할 수 있습니다.

다음은 Microsoft PowerPoint의 Animation Effect 창 및 확장 메뉴입니다:

![예시 이미지1](shape-after-animation.png)

PowerPoint Effect **After animation** 드롭다운 목록은 다음 속성과 일치합니다:  

- [setAfterAnimationType(int value)](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/ieffect/#setAfterAnimationType-int-) 속성은 After animation 유형을 지정합니다.  
  * PowerPoint **More Colors** 는 [AfterAnimationType.Color](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/afteranimationtype/#Color) 유형과 일치합니다.  
  * PowerPoint **Don't Dim** 항목은 [AfterAnimationType.DoNotDim](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/afteranimationtype/#DoNotDim) 유형(기본값)과 일치합니다.  
  * PowerPoint **Hide After Animation** 항목은 [AfterAnimationType.HideAfterAnimation](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/afteranimationtype/#HideAfterAnimation) 유형과 일치합니다.  
  * PowerPoint **Hide on Next Mouse Click** 항목은 [AfterAnimationType.HideOnNextMouseClick](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/afteranimationtype/#HideOnNextMouseClick) 유형과 일치합니다.  
- [setAfterAnimationColor(IColorFormat value)](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/ieffect/#setAfterAnimationColor-com.aspose.slides.IColorFormat-) 속성은 After animation 색상 형식을 정의합니다. 이 속성은 [AfterAnimationType.Color](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/afteranimationtype/#Color) 유형과 함께 동작합니다. 유형을 다른 것으로 변경하면 After animation 색상이 초기화됩니다.  

다음 Java 코드는 After animation 효과를 변경하는 방법을 보여 줍니다:

```java
// 프레젠테이션 파일을 나타내는 프레젠테이션 클래스를 인스턴스화합니다
Presentation pres = new Presentation("AnimImage_out.pptx");
try {
    ISlide firstSlide = pres.getSlides().get_Item(0);

    // 주 시퀀스의 첫 번째 효과를 가져옵니다
    IEffect firstEffect = firstSlide.getTimeline().getMainSequence().get_Item(0);

    // after animation 유형을 Color 로 변경합니다
    firstEffect.setAfterAnimationType(AfterAnimationType.Color);

    // after animation 어두워지는 색상을 설정합니다
    firstEffect.getAfterAnimationColor().setColor(Color.BLUE);

    // PPTX 파일을 디스크에 저장합니다
    pres.save("AnimImage_AfterAnimation.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}
```

## **텍스트 애니메이션**

Aspose.Slides는 애니메이션 효과의 *Animate text* 블록을 다루기 위한 다음 속성을 제공합니다:  

- [setAnimateTextType(int value)](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/ieffect/#setAnimateTextType-int-) – 효과의 텍스트 애니메이션 유형을 지정합니다. 텍스트는 다음과 같이 애니메이션될 수 있습니다:  
  - All at once ([AnimateTextType.AllAtOnce](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/animatetexttype/#AllAtOnce) 유형)  
  - By word ([AnimateTextType.ByWord](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/animatetexttype/#ByWord) 유형)  
  - By letter ([AnimateTextType.ByLetter](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/animatetexttype/#ByLetter) 유형)  
- [setDelayBetweenTextParts(float value)](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/ieffect/#setDelayBetweenTextParts-float-) – 애니메이션된 텍스트 부분(단어나 문자) 사이의 지연을 설정합니다. 양수 값은 효과 지속 시간의 백분율을 나타내고, 음수 값은 지연 시간을 초 단위로 지정합니다.  

Effect Animate text 속성을 변경하는 방법은 다음과 같습니다:

1. [도형에 애니메이션 적용](#apply-animation-to-shape) 절을 따라 효과를 적용하거나 가져옵니다.  
2. `setBuildType(int value)` 속성을 [BuildType.AsOneObject](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/buildtype/#AsOneObject) 값으로 설정하여 *By Paragraphs* 모드를 비활성화합니다.  
3. 새 값을 [setAnimateTextType(int value)](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/ieffect/#setAnimateTextType-int-) 및 [setDelayBetweenTextParts(float value)](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/ieffect/#setDelayBetweenTextParts-float-) 속성에 지정합니다.  
4. 수정된 PPTX 파일을 저장합니다.  

다음 Java 코드는 해당 작업을 구현한 예시입니다:

```java
// 프레젠테이션 파일을 나타내는 프레젠테이션 클래스를 인스턴스화합니다.
Presentation pres = new Presentation("AnimTextBox_out.pptx");
try {
    ISlide firstSlide = pres.getSlides().get_Item(0);

    // 주 시퀀스의 첫 번째 효과를 가져옵니다
    IEffect firstEffect = firstSlide.getTimeline().getMainSequence().get_Item(0);

    // 효과 텍스트 애니메이션 유형을 "As One Object" 로 변경합니다
    firstEffect.getTextAnimation().setBuildType(BuildType.AsOneObject);

    // 효과 Animate text 유형을 "By word" 로 변경합니다
    firstEffect.setAnimateTextType(AnimateTextType.ByWord);

    // 단어 사이 지연을 효과 지속 시간의 20%로 설정합니다
    firstEffect.setDelayBetweenTextParts(20f);

    // PPTX 파일을 디스크에 저장합니다
    pres.save("AnimTextBox_AnimateText.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}
```

## **FAQ**

**프레젠테이션을 웹에 게시할 때 애니메이션이 유지되도록 하려면 어떻게 해야 하나요?**

[Export to HTML5](/slides/ko/androidjava/export-to-html5/)를 사용하고 [shape](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/html5options/#setAnimateShapes-boolean-) 및 [transition](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/html5options/#setAnimateTransitions-boolean-) 애니메이션을 담당하는 옵션을 활성화합니다. 일반 HTML은 슬라이드 애니메이션을 재생하지 않지만 HTML5는 재생합니다.

**도형의 z-order(레이어 순서)를 변경하면 애니메이션에 어떤 영향을 미치나요?**

애니메이션과 그리기 순서는 독립적입니다. 효과는 나타나거나 사라지는 타이밍과 유형을 제어하고, [z-order](https://reference.aspose.com/slides/ko/androidjava/com.aspose.slides/shape/#getZOrderPosition--)는 무엇이 무엇을 가리는지를 결정합니다. 최종적인 시각적 결과는 두 요소의 조합에 의해 정의됩니다. (이는 일반적인 PowerPoint 동작이며, Aspose.Slides의 효과와 도형 모델도 동일한 논리를 따릅니다.)

**특정 효과를 비디오로 변환할 때 제한 사항이 있나요?**

일반적으로 [애니메이션은 지원됩니다](/slides/ko/androidjava/convert-powerpoint-to-video/), 하지만 드물게 특정 효과가 다르게 렌더링될 수 있습니다. 사용 중인 효과와 라이브러리 버전으로 테스트하는 것이 좋습니다.