.NET'te Sunumlarda Ses Çerçevelerini Yönetme

Genel Bakış

Bu makale, Aspose.Slides’da ses çerçeveleriyle nasıl çalışılacağını açıklar. Slaytlara gömülü ses ekleme, ses çerçevesi küçük resmini özelleştirme, ses seviyesini, döngüyü, gizlemeyi, kırpmayı ve solma sürelerini içeren oynatma seçeneklerini yapılandırma ve slayt gösterisi geçişlerinde kullanılan sesi çıkartma konularını gösterir.

Ses Çerçeveleri Oluşturma

Aspose.Slides for .NET, slaytlara ses dosyaları eklemenize olanak tanır. Ses dosyaları, slaytlara ses çerçeveleri olarak gömülür.

  1. Bir Presentation sınıfının bir örneğini oluşturun.
  2. İndeks aracılığıyla bir slaydın referansını alın.
  3. Slayta gömmek istediğiniz ses dosyası akışını yükleyin.
  4. Gömülü ses çerçevesini (ses dosyasını içeren) slayta ekleyin.
  5. PlayMode ve Volume değerini IAudioFrame nesnesi aracılığıyla ayarlayın.
  6. Değiştirilmiş sunumu kaydedin.

Bu C# kodu, bir slayta gömülü ses çerçevesi eklemenin nasıl yapılacağını gösterir:

// Bir sunum dosyasını temsil eden sunum sınıfını örnekler
using (Presentation pres = new Presentation())
{
    // İlk slaydı alır
    ISlide sld = pres.Slides[0];
    
    // wav ses dosyasını akışa yükler
    FileStream fstr = new FileStream("sampleaudio.wav", FileMode.Open, FileAccess.Read);

    // Ses Çerçevesini ekler
    IAudioFrame audioFrame = sld.Shapes.AddAudioFrameEmbedded(50, 150, 100, 100, fstr);

    // Sesin Oynatma Modunu ve Ses Seviyesini ayarlar
    audioFrame.PlayMode = AudioPlayModePreset.Auto;
    audioFrame.Volume = AudioVolumeMode.Loud;

    // PowerPoint dosyasını diske yazar
    pres.Save("AudioFrameEmbed_out.pptx", SaveFormat.Pptx);
}

Ses Çerçevesi Küçük Resmini Değiştirme

Bir sunuma ses dosyası eklediğinizde, ses standart varsayılan bir görüntüyle çerçeve olarak görünür (aşağıdaki bölümdeki resmi bakınız). Ses çerçevesinin küçük resmini değiştirebilir (tercih ettiğiniz görüntüyü ayarlayabilirsiniz).

Bu C# kodu, bir ses çerçevesinin küçük resmini veya ön izleme görüntüsünü değiştirmenin nasıl yapılacağını gösterir:

using (var presentation = new Presentation())
{
    var slide = presentation.Slides[0];

    // Slayta belirtilen konum ve boyutta bir ses çerçevesi ekler.
    var audioStream = new FileStream("sample2.mp3", FileMode.Open, FileAccess.Read);
    var audioFrame = slide.Shapes.AddAudioFrameEmbedded(150, 100, 50, 50, audioStream);
    audioStream.Dispose();

    // Sunum kaynaklarına bir resim ekler.
    var imageStream = File.OpenRead("eagle.jpeg");
    var audioImage = presentation.Images.AddImage(imageStream);
    imageStream.Dispose();

    // Ses çerçevesi için resmi ayarlar.
    audioFrame.PictureFormat.Picture.Image = audioImage; // <-----
    
	//Değiştirilmiş sunumu diske kaydeder
    presentation.Save("example_out.pptx", SaveFormat.Pptx);
}

Ses Oynatma Seçeneklerini Değiştirme

Aspose.Slides for .NET, bir sesin oynatımını veya özelliklerini kontrol eden seçenekleri değiştirmenize olanak tanır. Örneğin, ses seviyesini ayarlayabilir, sesi döngü halinde oynatacak şekilde ayarlayabilir veya ses simgesini gizleyebilirsiniz.

Microsoft PowerPoint’teki Ses Seçenekleri bölmesi:

example1_image

PowerPoint Ses Seçenekleri, Aspose.Slides AudioFrame özelliklerine karşılık gelir:

PowerPoint Düzenleme seçenekleri, Aspose.Slides AudioFrame özelliklerine karşılık gelir:

PowerPoint ses kontrol panelindeki Volume controll, AudioFrame.VolumeValue özelliğine karşılık gelir. Ses seviyesini yüzde olarak değiştirmenizi sağlar.

Ses Oynatma seçeneklerini nasıl değiştireceğiniz aşağıdadır:

  1. Create veya Audio Frame’i alın.
  2. Ayarlamak istediğiniz Audio Frame özellikleri için yeni değerler ayarlayın.
  3. Değiştirilmiş PowerPoint dosyasını kaydedin.

Bu C# kodu, bir sesin seçeneklerinin ayarlandığı bir işlemi gösterir:

using (Presentation pres = new Presentation("AudioFrameEmbed_out.pptx"))
{
    // AudioFrame şekilini alır
    AudioFrame audioFrame = (AudioFrame)pres.Slides[0].Shapes[0];

    // Oynatma modunu tıklayınca oynatılacak şekilde ayarlar
    audioFrame.PlayMode = AudioPlayModePreset.OnClick;

    // Ses seviyesini Düşük olarak ayarlar
    audioFrame.Volume = AudioVolumeMode.Low;

    // Sesin slaytlar arasında çalmasını ayarlar
    audioFrame.PlayAcrossSlides = true;

    // Ses için döngüyü devre dışı bırakır
    audioFrame.PlayLoopMode = false;

    // Slayt gösterisi sırasında AudioFrame'i gizler
    audioFrame.HideAtShowing = true;

    // Oynattıktan sonra sesi başa sarar
    audioFrame.RewindAudio = true;

    // PowerPoint dosyasını diske kaydeder
    pres.Save("AudioFrameEmbed_changed.pptx", SaveFormat.Pptx);
}

Bu C# örneği, gömülü sesli yeni bir ses çerçevesi ekleme, kırpma ve solma sürelerini ayarlama yolunu gösterir:

using (Presentation pres = new Presentation())
{
    ISlide slide = pres.Slides[0];

    byte[] audioData = File.ReadAllBytes("sampleaudio.mp3");
    IAudio audio = pres.Audios.AddAudio(audioData);
    IAudioFrame audioFrame = slide.Shapes.AddAudioFrameEmbedded(50, 50, 100, 100, audio);

    // Kırpma başlangıç ofsetini 1.5 saniyeye ayarlar
    audioFrame.TrimFromStart = 1500f;
    // Kırpma bitiş ofsetini 2 saniyeye ayarlar
    audioFrame.TrimFromEnd = 2000f;

    // Fade-in süresini 200 ms'ye ayarlar
    audioFrame.FadeInDuration = 200f;
    // Fade-out süresini 500 ms'ye ayarlar
    audioFrame.FadeOutDuration = 500f;

    pres.Save("AudioFrameTrimFade_out.pptx", SaveFormat.Pptx);
}

Aşağıdaki kod örneği, gömülü sesli bir ses çerçevesini alıp ses seviyesini %85’e ayarlamanın nasıl yapılacağını gösterir:

using (Presentation pres = new Presentation("AudioFrameEmbed_out.pptx"))
{
    // Bir ses çerçevesi şekli alır
    IAudioFrame audioFrame = (IAudioFrame)pres.Slides[0].Shapes[0];

    // Ses seviyesini %85'e ayarlar
    audioFrame.VolumeValue = 85f;
    
    pres.Save("AudioFrameValue_out.pptx", SaveFormat.Pptx);
}

Ses Altyazılarını Yönetme

Aspose.Slides, bir ses çerçevesine kapalı altyazılar eklemenize CaptionTracks özelliği aracılığıyla izin verir. Bu özellik, WebVTT altyazı izlerini eklemenize, mevcut izler arasında dolaşmanıza ve gerektiğinde kaldırmanıza olanak tanıyan bir ICaptionsCollection döndürür.

Ses Altyazılarını Ekle

CaptionTracks özelliğini kullanarak bir ses çerçevesine bir veya daha fazla altyazı izi ekleyin. Aşağıdaki örnekte bir ses dosyası slayta eklenir ve ardından yeni bir altyazı izi .vtt dosyasından yüklenir.

using (Presentation presentation = new Presentation())
{
    byte[] audioData = File.ReadAllBytes("audio.mp3");
    IAudio audio = presentation.Audios.AddAudio(audioData);

    ISlide slide = presentation.Slides[0];
    IAudioFrame audioFrame = slide.Shapes.AddAudioFrameEmbedded(10, 10, 50, 50, audio);

    // WebVTT dosyasından yeni bir altyazı izi ekle.
    audioFrame.CaptionTracks.Add("New track", "track.vtt");

    presentation.Save("audio_with_captions.pptx", SaveFormat.Pptx);
}

Ses Altyazılarını Çıkarma

Bir ses çerçevesiyle ilişkili altyazı izlerini dolaşabilir ve .vtt dosyaları olarak kaydedebilirsiniz. Her altyazı izi, ikili verisini ve benzersiz tanımlayıcısını sunar; bu, altyazılar dışa aktarılırken kullanılabilir.

using (Presentation presentation = new Presentation("audio_with_captions.pptx"))
{
    ISlide slide = presentation.Slides[0];
    foreach (IShape shape in slide.Shapes)
    {
        if (shape is IAudioFrame audioFrame)
        {
            foreach (ICaptions captionTrack in audioFrame.CaptionTracks)
            {
                // Altyazı izini .vtt dosyası olarak kaydet.
                File.WriteAllBytes($"{captionTrack.CaptionId}.vtt", captionTrack.BinaryData);
            }
        }
    }
}

Ses Altyazılarını Kaldırma

Bir ses çerçevesinden altyazıları kaldırmak için ICaptionsCollection tarafından sağlanan yöntemleri, örneğin Clear, Remove, veya RemoveAt kullanın. Aşağıdaki örnek, bir ses çerçevesinden tüm altyazı izlerini kaldırır.

using (Presentation presentation = new Presentation("audio_with_captions.pptx"))
{
    ISlide slide = presentation.Slides[0];
    IAudioFrame audioFrame = slide.Shapes[0] as IAudioFrame;

    // Ses çerçevesinden tüm altyazı izlerini kaldır.
    audioFrame.CaptionTracks.Clear();

    presentation.Save("audio_without_captions.pptx", SaveFormat.Pptx);
}

Ses Çıkarma

Aspose.Slides for .NET, slayt gösterisi geçişlerinde kullanılan sesi çıkarmanıza olanak tanır. Örneğin, belirli bir slaytta kullanılan sesi çıkarabilirsiniz.

  1. Ses içeren sunumu yüklemek için bir Presentation sınıfının örneğini oluşturun ve sunumu yükleyin.
  2. İlgili slaydın referansını indeks üzerinden alın.
  3. Slayt için slayt gösterisi geçişlerine erişin.
  4. Sesi bayt verisi olarak çıkarın.

Bu C# kodu, bir slaytta kullanılan sesin nasıl çıkarılacağını gösterir:

string presName = "AudioSlide.pptx";

// Bir sunum dosyasını temsil eden Presentation sınıfının bir örneğini oluşturur
Presentation pres = new Presentation(presName);

// Slaytı erişir
ISlide slide = pres.Slides[0];

// Slayt için slayt gösterisi geçiş efektlerini alır
ISlideShowTransition transition = slide.SlideShowTransition;

// Sesi bayt dizisine çıkarır
byte[] audio = transition.Sound.BinaryData;

System.Console.WriteLine("Length: " + audio.Length);

SSS

Aynı ses varlığını birden fazla slaytta dosya boyutunu artırmadan yeniden kullanabilir miyim?

Evet. Ses dosyasını yalnızca bir kez sunumun ortak audio collection öğesine ekleyin ve mevcut varlığı referans alan ek ses çerçeveleri oluşturun. Bu, ortam verilerinin çoğaltılmasını önler ve sunum boyutunun kontrol altında kalmasını sağlar.

Mevcut bir ses çerçevesindeki sesi şekli yeniden oluşturmadan değiştirebilir miyim?

Evet. Bağlantılı bir ses için, link path’i yeni dosyaya işaret edecek şekilde güncelleyin. Gömülü bir ses için, embedded audio nesnesini sunumun audio collection içindeki başka bir nesneyle değiştirin. Çerçevenin biçimlendirmesi ve çoğu oynatma ayarı aynı kalır.

Kırpma, sunumda saklanan temel ses verisini değiştirir mi?

Hayır. Kırpma yalnızca oynatma sınırlarını ayarlar. Orijinal ses baytları dokunulmadan kalır ve gömülü ses ya da sunumun audio collection’ı aracılığıyla erişilebilir.