Filtreler

Makale
06/30/2023

Uyarı

Azure Media Services 30 Haziran 2024'de kullanımdan kaldırılacak. Daha fazla bilgi için bkz. AMS Kullanımdan Kaldırma Kılavuzu.

İçeriğinizi müşterilere teslim ederken (Canlı Akış etkinlikleri veya İsteğe Bağlı Video) istemcinizin varsayılan varlığın bildirim dosyasında açıklanandan daha fazla esnekliğe ihtiyacı olabilir. Azure Media Services, önceden tanımlanmış filtreleri temel alan Dinamik Bildirimler sunar.

Filtreler, müşterilerinizin şunları yapmasını sağlayan sunucu tarafı kurallarıdır:

Videonun yalnızca bir bölümünü oynatın (videonun tamamını oynatmak yerine). Örnek:
- Canlı etkinliğin alt klibini ("alt klip filtreleme") göstermek için bildirimi azaltın veya
- Videonun başlangıcını kırpma ("videoyu kırpma").
Yalnızca içeriği yürütmek için kullanılan cihaz tarafından desteklenen belirtilen çevirileri ve/veya belirtilen dil parçalarını ("işleme filtreleme") teslim edin.
Yürütücüdeki DVR penceresinin sınırlı bir uzunluğunu sağlamak için Sunu Penceresi'ni (DVR) ayarlayın ("sunu penceresini ayarlama").

Media Services, içeriğiniz için Hesap filtreleri ve Varlık filtreleri oluşturmanıza olanak tanır. Ayrıca, önceden oluşturduğunuz filtreleri bir Akış Bulucu ile ilişkilendirebilirsiniz.

Filtre türleri

İki tür filtre vardır:

Hesap Filtreleri (genel) - Azure Media Services hesabındaki herhangi bir varlığa uygulanabilir ve hesabın kullanım ömrü vardır.
Varlık Filtreleri (yerel) - Yalnızca, oluşturma işleminde filtrenin ilişkilendirildiği, varlığın kullanım ömrüne sahip bir varlığa uygulanabilir.

Hesap Filtreleri ve Varlık Filtreleri türleri, filtreyi tanımlamak/tanımlamak için tam olarak aynı özelliklere sahiptir. Varlık Filtresi'ni oluştururken, filtreyi ilişkilendirmek istediğiniz varlık adını belirtmeniz gerekir.

Senaryonuza bağlı olarak, hangi filtre türünün daha uygun olduğuna karar verirsiniz (Varlık Filtresi veya Hesap Filtresi). Hesap Filtreleri, Varlık Filtrelerinin belirli bir varlığı kırpmak için kullanılabildiği cihaz profilleri (işleme filtrelemesi) için uygundur.

Filtreleri açıklamak için aşağıdaki özellikleri kullanırsınız.

Ad	Açıklama
firstQuality	Filtrenin ilk kalite bit hızı.
presentationTimeRange	Canlı etkinlik bildiriminin sunum zaman aralığı. Bu özellik bildirim başlangıç/bitiş noktalarını, sunu penceresi uzunluğunu ve canlı başlangıç konumunu filtrelemek için kullanılır. Daha fazla bilgi için bkz . PresentationTimeRange.
Parça	Seçim koşullarını izler. Daha fazla bilgi için bkz . parçalar

presentationTimeRange

Bu özelliği Varlık Filtreleri ile kullanın. Özelliğin Hesap Filtreleri ile ayarlanması önerilmez.

Ad	Açıklama
startTimestamp	İsteğe Bağlı Video (VoD) veya Canlı Akış için geçerlidir. Bu, akışın mutlak bir başlangıç noktasını temsil eden uzun bir değerdir. Değer en yakın sonraki GOP başlangıcına yuvarlanır. Birim zaman ölçeği olduğundan 150000000 startTimestamp değeri 15 saniye sürecek. Çalma listesinde (bildirim) yer alacak parçaları kırpmak için startTimestamp ve endTimestamp kullanın. Örneğin, varsayılan zaman ölçeğini kullanarak startTimestamp=40000000 ve endTimestamp=100000000, VoD sunumunun 4 saniye ile 10 saniye arasındaki parçalarını içeren bir çalma listesi oluşturur. Bir parça sınırın içinde yer alırsa, parçanın tamamı bildirime eklenir.
endTimestamp	İsteğe Bağlı Video (VoD) için geçerlidir. Canlı Akış sunusu için, sunu sona erdiğinde ve akış VoD olduğunda sessizce yoksayılır ve uygulanır. Bu, sununun mutlak bir bitiş noktasını temsil eden, sonraki en yakın GOP başlangıcına yuvarlanmış uzun bir değerdir. Birim zaman ölçeği olduğundan 1800000000 endTimestamp değeri 3 dakika sürer. Çalma listesinde (bildirim) yer alacak parçaları kırpmak için startTimestamp ve endTimestamp kullanın. Örneğin, varsayılan zaman ölçeğini kullanarak startTimestamp=40000000 ve endTimestamp=100000000, VoD sunumunun 4 saniye ile 10 saniye arasındaki parçalarını içeren bir çalma listesi oluşturur. Bir parça sınırın içinde yer alırsa, parçanın tamamı bildirime eklenir.
Zaman ölçeği	Bir saniyedeki artış sayısı olarak belirtilen Sunu Zaman Aralığındaki tüm zaman damgaları ve süreler için geçerlidir. Varsayılan değer 10000000-bir saniyede on milyon artıştır ve her artış 100 nanosaniye uzunluğunda olur. Ancak, değer videonun kaynağına bağlı olarak veya bulutta kodlamalı bir canlı etkinlik kullanıyorsanız (varsayılan olarak 90Khz veya video için 90000 olarak ayarlanır) farklılık gösterebilir. Örneğin, startTimestamp değerini 30 saniye olarak ayarlamak istiyorsanız, varsayılan zaman ölçeğini kullanırken 300000000 değerini kullanırsınız. Video parçasının zaman ölçeğinin ayarladığınız ölçekte olduğunu onaylamak için varlığınızın bildirimini kontrol edin. Kodlamalı canlı olayları kullanırken, zaman ölçeği video parçaları için 90Khz (90000) ve ses parçaları için 48khz (48000) olabilir.
liveBackoffDuration	Yalnızca Canlı Akış için geçerlidir. Bu değer, bir istemcinin arayabileceği en son canlı konumu tanımlar. Bu özelliği kullanarak canlı kayıttan yürütme konumunu geciktirebilir ve oyuncular için sunucu tarafı arabelleği oluşturabilirsiniz. Bu özelliğin birimi zaman ölçeğidir (aşağıya bakın). Maksimum canlı geri dönüş süresi 300 saniyedir (3000000000). Örneğin, 2000000000 değeri, kullanılabilir en son içeriğin gerçek canlı kenardan 20 saniye geciktiği anlamına gelir.
presentationWindowDuration	Yalnızca Canlı Akış için geçerlidir. Çalma listesine eklenecek parçalardan oluşan kayan bir pencere uygulamak için presentationWindowDuration kullanın. Bu özelliğin birimi zaman ölçeğidir (aşağıya bakın). Örneğin, presentationWindowDuration=1200000000 değerini iki dakikalık bir kayan pencere uygulayacak şekilde ayarlayın. Canlı kenardan 2 dakika sonra medya çalma listesine dahil edilecek. Bir parça sınırın içinde yer alırsa parçanın tamamı çalma listesine eklenir. En düşük sunu penceresi süresi 60 saniyedir.
forceEndTimestamp	Yalnızca Canlı Akış için geçerlidir. endTimestamp özelliğinin mevcut olup olmadığını gösterir. True ise endTimestamp belirtilmelidir veya hatalı bir istek kodu döndürülür. İzin verilen değerler: false, true.

Parça

Akışınızın parçalarının (Canlı Akış veya İsteğe Bağlı Video) dinamik olarak oluşturulan bildirime dahil edilmesi gereken filtre izleme özelliği koşullarının (FilterTrackPropertyConditions) listesini belirtirsiniz. Filtreler mantıksal AND ve OR işlemi kullanılarak birleştirilir.

Filtre izleme özelliği koşulları izleme türlerini, değerleri (aşağıdaki tabloda açıklanmıştır) ve işlemleri (Eşit, NotEqual) açıklar.

Ad	Açıklama
Bitrate	Filtreleme için parçanın bit hızını kullanın. En iyi değer, saniyedeki bit sayısı cinsinden bit hızı aralığıdır. Örneğin, "0-2427000". Not: 250000 (saniye başına bit sayısı) gibi belirli bir bit hızı değeri kullanabilirsiniz ancak tam bit hızı bir Varlıktan diğerine dalgalı olabileceğinden bu yaklaşım önerilmez.
Fourcc	Filtreleme için parçanın FourCC değerini kullanın. değer, RFC 6381'de belirtildiği gibi codec biçiminin ilk öğesidir. Şu anda aşağıdaki codec bileşenleri desteklenmektedir: Video için: "avc1", "hev1", "hvc1" Ses için: "mp4a", "ec-3" Bir Varlıktaki parçaların FourCC değerlerini belirlemek için bildirim dosyasını alın ve inceleyin.
Dil	Filtreleme için parçanın dilini kullanın. değeri, RFC 5646'da belirtildiği gibi eklemek istediğiniz dilin etiketidir. Örneğin, "en".
Ad	Filtreleme için parçanın adını kullanın.
Tür	Filtreleme için parça türünü kullanın. Şu değerlere izin verilir: "video", "ses" veya "metin".

Örnek

Aşağıdaki örnek bir Canlı Akış filtresi tanımlar:

{
  "properties": {
    "presentationTimeRange": {
      "startTimestamp": 0,
      "endTimestamp": 170000000,
      "presentationWindowDuration": 9223372036854776000,
      "liveBackoffDuration": 0,
      "timescale": 10000000,
      "forceEndTimestamp": false
    },
    "firstQuality": {
      "bitrate": 128000
    },
    "tracks": [
      {
        "trackSelections": [
          {
            "property": "Type",
            "operation": "Equal",
            "value": "Audio"
          },
          {
            "property": "Language",
            "operation": "NotEqual",
            "value": "en"
          },
          {
            "property": "FourCC",
            "operation": "NotEqual",
            "value": "EC-3"
          }
        ]
      },
      {
        "trackSelections": [
          {
            "property": "Type",
            "operation": "Equal",
            "value": "Video"
          },
          {
            "property": "Bitrate",
            "operation": "Equal",
            "value": "3000000-5000000"
          }
        ]
      }
    ]
  }
}

Akış Bulucu'nun oluşturulmasıyla ilgili HLS veya DASH bildirimlerinizi filtreleme

Media Services, akış bulucu varlığındaki filter özelliğinde bir filtre koleksiyonu geçirerek önceden filtrelenmiş bir Akış Bulucusu oluşturmanıza olanak tanır. Bu, akış bulucudaki tüm bildirimleri önceden filtrelemenizi sağlar. Özgün bildirim artık bu akış bulucu aracılığıyla kullanılamaz ve filtrelenmiş akış bulucudan DASH veya HLS URL'lerini isteyen istemciler için yalnızca filtrelenmiş yanıta erişilebilir. Bu, bir varlığın yalnızca bir bölümünü yayımlamak ve HLS veya DASH bildirim URL'sinin sorgu dizesini değiştirerek kullanıcıların varlık için tam özgün bildirime erişmesini engellemek istediğiniz durumlarda yararlıdır.

Akış Bulucunuzda varlık veya hesap filtrelerinin listesini belirtebilirsiniz. Dinamik Paketleyici, bu filtre listesini istemcinizin URL'de belirttiği filtrelerle birlikte uygular. Bu birleşim, Akış Bulucu'da belirttiğiniz URL + filtrelerdeki filtreleri temel alan bir Dinamik Bildirim oluşturur.

Filtreler güncelleştiriliyor

Filtreler ve akış bulucuları anında güncelleştirilebilir, ancak ön uç web sunucularında güncelleştirmelerin 10 saniyeye kadar sürebileceğini ve zaten üretimde yayımlanmış ve kullanılan Aynı Akış Bulucuyu güncelleştiriyorsanız içeriğin aşağı akış CDN önbelleğe alınmasıyla ilgili sorunlar olabileceğini unutmayın.

Özellikle CDN etkinleştirildiğinde, etkin olarak yayımlanmış bir Akış Bulucu ile ilişkili filtrelerin tanımının güncelleştirililmesi önerilmez. Akış sunucuları ve CDN'ler, önbelleğe alınmış eski verilerin döndürülmesine neden olabilecek iç önbelleklere sahip olabilir.

Filtre tanımının değiştirilmesi gerekiyorsa, yeni bir filtre oluşturup Bunu Akış Bulucu URL'sine eklemeyi veya güncelleştirilmiş filtreye doğrudan başvuran benzersiz yeni bir Akış Bulucusu yayımlamayı göz önünde bulundurun.

Yardım ve destek alma

Aşağıdaki yöntemlerden birini kullanarak Media Services ile iletişime geçebilir veya güncelleştirmelerimizi izleyebilirsiniz:

Q & A
Stack Overflow. soruları ile etiketleyin azure-media-services.
Destek istemek için @AzureSupport @MSFTAzureMedia veya kullanın.
Azure portal üzerinden bir destek bileti açın.