# JavaScript를 사용한 프레젠테이션 오디오 관리 > Aspose.Slides for Node.js에서 오디오 프레임을 생성하고 제어합니다—삽입, 트리밍, 루프 및 PPT, PPTX, ODP 프레젠테이션 전역에서 재생을 구성하는 예제. Source: https://docs.aspose.com/slides/ko/nodejs-java/audio-frame/ Updated: 2026-06-14 ## **개요** 이 문서에서는 Aspose.Slides에서 오디오 프레임을 사용하는 방법을 설명합니다. 슬라이드에 삽입된 오디오를 추가하고, 오디오 프레임 썸네일을 사용자 지정하며, 볼륨, 루프, 숨기기, 트리밍 및 페이드 지속 시간과 같은 재생 옵션을 구성하고, 슬라이드 쇼 전환에 사용되는 오디오를 추출하는 방법을 보여줍니다. ## **오디오 프레임 만들기** Node.js용 Aspose.Slides for Java를 사용하면 오디오 파일을 슬라이드에 추가할 수 있습니다. 오디오 파일은 오디오 프레임으로 슬라이드에 삽입됩니다. 1. [Presentation](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/Presentation) 클래스의 인스턴스를 생성합니다. 2. 슬라이드의 인덱스를 통해 슬라이드 참조를 가져옵니다. 3. 슬라이드에 삽입하려는 오디오 파일 스트림을 로드합니다. 4. 삽입된 오디오 프레임(오디오 파일 포함)을 슬라이드에 추가합니다. 5. Set [PlayMode](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/AudioPlayModePreset) 및 `Volume`을 [AudioFrame](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/AudioFrame) 객체에서 설정합니다. 6. 수정된 프레젠테이션을 저장합니다. 이 JavaScript 코드는 슬라이드에 삽입된 오디오 프레임을 추가하는 방법을 보여줍니다: ```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 코드는 오디오 프레임의 썸네일 또는 미리보기 이미지를 변경하는 방법을 보여줍니다: ```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(); } } ``` ## **오디오 재생 옵션 변경** Node.js용 Aspose.Slides for Java를 사용하면 오디오 재생이나 속성을 제어하는 옵션을 변경할 수 있습니다. 예를 들어, 오디오의 볼륨을 조정하거나, 오디오를 반복 재생하도록 설정하거나, 오디오 아이콘을 숨길 수도 있습니다. Microsoft PowerPoint의 **오디오 옵션** 창: ![example1_image](audio_frame_0.png) PowerPoint **오디오 옵션**은 Aspose.Slides [AudioFrame](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/audioframe/) 속성과 대응됩니다: - **Start** 드롭다운 목록은 [AudioFrame.setPlayMode](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/audioframe/#setPlayMode) 메서드와 일치합니다 - **Volume**은 [AudioFrame.setVolume](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/audioframe/#setVolume) 메서드와 일치합니다 - **Play Across Slides**는 [AudioFrame.setPlayAcrossSlides](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/audioframe/#setPlayAcrossSlides) 메서드와 일치합니다 - **Loop until Stopped**는 [AudioFrame.setPlayLoopMode](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/audioframe/#setPlayLoopMode) 메서드와 일치합니다 - **Hide During Show**는 [AudioFrame.setHideAtShowing](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/audioframe/#setHideAtShowing) 메서드와 일치합니다 - **Rewind after Playing**는 [AudioFrame.setRewindAudio](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/audioframe/#setRewindAudio) 메서드와 일치합니다 PowerPoint **편집** 옵션은 Aspose.Slides [AudioFrame](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/audioframe/) 속성과 대응됩니다: - **Fade In**은 [AudioFrame.setFadeInDuration](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/audioframe/#setFadeInDuration) 메서드와 일치합니다 - **Fade Out**은 [AudioFrame.setFadeOutDuration](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/audioframe/#setFadeOutDuration) 메서드와 일치합니다 - **Trim Audio Start Time**은 [AudioFrame.setTrimFromStart](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/audioframe/#setTrimFromStart) 메서드와 일치합니다 - **Trim Audio End Time** 값은 오디오 길이에서 [AudioFrame.setTrimFromEnd](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/audioframe/#setTrimFromEnd) 메서드 값을 뺀 것과 같습니다 PowerPoint 오디오 컨트롤 패널의 **Volume controll**은 [AudioFrame.setVolumeValue](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/audioframe/#setVolumeValue) 메서드와 대응됩니다. 이를 통해 오디오 볼륨을 백분율로 변경할 수 있습니다. 오디오 재생 옵션을 변경하는 방법은 다음과 같습니다: 1. [생성](#create-audio-frame) 또는 Audio Frame을 가져옵니다. 2. 조정하려는 Audio Frame 속성에 새로운 값을 설정합니다. 3. 수정된 PowerPoint 파일을 저장합니다. 이 JavaScript 코드는 오디오 옵션을 조정하는 작업을 보여줍니다: ```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 예제는 삽입된 오디오가 있는 새 오디오 프레임을 추가하고, 트리밍하고, 페이드 지속 시간을 설정하는 방법을 보여줍니다: ```js 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초로 설정합니다 // 트리밍 종료 오프셋을 2초로 설정합니다 // 페이드 인 지속 시간을 200밀리초로 설정합니다 // 페이드 아웃 지속 시간을 500밀리초로 설정합니다 pres.save("AudioFrameTrimFade_out.pptx", aspose.slides.SaveFormat.Pptx); } finally { pres.dispose(); } ``` 다음 코드 샘플은 삽입된 오디오가 있는 오디오 프레임을 검색하고 볼륨을 85%로 설정하는 방법을 보여줍니다: ```js 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](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/audioframe/#getCaptionTracks) 메서드를 통해 오디오 프레임에 폐쇄 캡션을 추가할 수 있습니다. 이 메서드는 [CaptionsCollection](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/captionscollection/)을 반환하며, 이를 사용해 WebVTT 캡션 트랙을 추가하고, 기존 트랙을 순회하며, 필요에 따라 제거할 수 있습니다. **오디오 캡션 추가** [getCaptionTracks](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/audioframe/#getCaptionTracks) 메서드를 사용하여 오디오 프레임에 하나 이상의 캡션 트랙을 연결합니다. 다음 예제에서는 오디오 파일을 슬라이드에 추가한 후 `.vtt` 파일에서 새 캡션 트랙을 로드합니다. ```js 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` 파일로 저장할 수 있습니다. 각 캡션 트랙은 바이너리 데이터와 고유 식별자를 제공하므로 캡션을 내보낼 때 사용할 수 있습니다. ```js 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](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/captionscollection/)에서 제공하는 [clear](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/captionscollection/#clear), [remove](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/captionscollection/#remove), 또는 [removeAt](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/captionscollection/#removeAt) 메서드를 사용합니다. 다음 예제는 오디오 프레임에서 모든 캡션 트랙을 제거합니다. ```js 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(); } ``` ## **오디오 추출** Node.js용 Aspose.Slides for Java를 사용하면 슬라이드 쇼 전환에 사용된 사운드를 추출할 수 있습니다. 예를 들어, 특정 슬라이드에 사용된 사운드를 추출할 수 있습니다. 1. [Presentation](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/Presentation) 클래스의 인스턴스를 생성하고 오디오가 포함된 프레젠테이션을 로드합니다. 2. 해당 슬라이드의 인덱스를 통해 슬라이드 참조를 가져옵니다. 3. 슬라이드의 [slideshow transitions](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/BaseSlide#getSlideShowTransition--)에 접근합니다. 4. 사운드를 바이트 데이터로 추출합니다. 이 JavaScript 코드는 슬라이드에서 사용된 오디오를 추출하는 방법을 보여줍니다: ```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](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/presentation/getaudios/)에 한 번 추가하고, 해당 자산을 참조하는 추가 오디오 프레임을 생성하면 됩니다. 이렇게 하면 미디어 데이터 중복을 방지하고 프레젠테이션 크기를 제어할 수 있습니다. **기존 오디오 프레임의 사운드를 형태를 재생성하지 않고 교체할 수 있나요?** 예. 연결된 사운드의 경우 [link path](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/audioframe/setlinkpathlong/)를 새 파일을 가리키도록 업데이트하면 됩니다. 삽입된 사운드의 경우 프레젠테이션의 [audio collection](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/presentation/getaudios/)에서 다른 [embedded audio](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/audioframe/setembeddedaudio/) 객체로 교체하면 됩니다. 프레임의 서식 및 대부분의 재생 설정은 유지됩니다. **트리밍이 프레젠테이션에 저장된 기본 오디오 데이터를 변경합니까?** 아니요. 트리밍은 재생 경계만 조정합니다. 원본 오디오 바이트는 그대로 유지되며, 삽입된 오디오나 프레젠테이션의 오디오 컬렉션을 통해 접근할 수 있습니다.