Szűrők

  • Cikk

Media Services embléma v3

Figyelmeztetés

Az Azure Media Services 2024. június 30-án megszűnik. További információkért lásd az AMS kivezetési útmutatót.

Amikor tartalmat szolgáltat az ügyfeleknek (élő streamelési események vagy igény szerinti videó), előfordulhat, hogy az ügyfélnek nagyobb rugalmasságra van szüksége, mint az alapértelmezett eszköz jegyzékfájljában leírtak. Az Azure Media Services előre definiált szűrők alapján kínál dinamikus jegyzékfájlokat .

A szűrők olyan kiszolgálóoldali szabályok, amelyek lehetővé teszik az ügyfelek számára a következőket:

  • Csak a videó egy szakaszának lejátszása (a teljes videó lejátszása helyett). Például:
    • Csökkentse a jegyzékfájlt egy élő esemény alklipjének megjelenítéséhez ("alklipszűrés"), vagy
    • Videó elejének levágása ("videó vágása").
  • Csak azokat a megadott kiadásokat és/vagy megadott nyelvi sávokat adja meg, amelyeket a tartalom lejátszásához használt eszköz támogat ("megjelenítési szűrés").
  • Állítsa be a bemutatóablakot (DVR), hogy a lejátszóban korlátozott hosszúságú legyen a DVR ablak ("bemutatóablak beállítása").

A Media Services lehetővé teszi , hogy fiókszűrőket és eszközszűrőket hozzon létre a tartalomhoz. Emellett társíthatja az előre létrehozott szűrőket egy streamelési lokátorhoz.

Szűrőtípusok

Kétféle szűrő létezik:

  • Fiókszűrők (globális) – az Azure Media Services-fiók bármely eszközére alkalmazható, és a fiók élettartama is érvényes.
  • Eszközszűrők (helyi) – csak olyan eszközre alkalmazhatók, amelyhez a szűrőt a létrehozáskor társították, az eszköz élettartamával rendelkezik.

A fiókszűrők és az eszközszűrők típusai pontosan ugyanazokkal a tulajdonságokkal rendelkeznek a szűrő definiálására/leírására. Az Eszközszűrő létrehozásakor meg kell adnia azt az eszköznevet, amelyhez a szűrőt társítani szeretné.

A forgatókönyvtől függően ön dönti el, hogy melyik szűrőtípus megfelelőbb (eszközszűrő vagy fiókszűrő). A fiókszűrők olyan eszközprofilokhoz (megjelenítési szűréshez) használhatók, ahol az eszközszűrők egy adott objektum vágására használhatók.

A szűrők leírását az alábbi tulajdonságok használatával végezheti el.

Név Leírás
firstQuality A szűrő első minőségi bitráta.
presentationTimeRange Egy élő eseményjegyzék bemutató időtartománya. Ez a tulajdonság a jegyzék kezdő/záró pontjainak, a bemutatóablak hosszának és az élő indítási pozíciónak a szűrésére szolgál.
További információ: PresentationTimeRange.
Számok A nyomon követi a kiválasztási feltételeket. További információkért lásd: számok

presentationTimeRange

Használja ezt a tulajdonságot eszközszűrőkkel. Nem ajánlott a tulajdonságot fiókszűrőkkel beállítani.

Név Leírás
startTimestamp Az igény szerinti videóra (VoD) vagy az élő streamelésre vonatkozik.
Ez egy hosszú érték, amely a stream abszolút kezdőpontját jelöli. Az érték a legközelebbi következő GOP-kezdésre kerekül. Az egység az időskálázás, ezért 1500000000-ből álló startTimestamp érték 15 másodpercre lenne.
A startTimestamp és az endTimestamp használatával vágja le a lejátszási listában (jegyzékfájlban) lévő töredékeket.
Például a startTimestamp=40000000 és az endTimestamp=100000000 az alapértelmezett időskálával létrehoz egy lejátszási listát, amely a VoD-bemutató 4 másodperc és 10 másodperc közötti töredékeit tartalmazza. Ha egy töredék átlépi a határt, a teljes töredék bekerül a jegyzékbe.
endTimestamp Az igény szerinti videóra (VoD) vonatkozik.
Az élő streameléses bemutató esetében a rendszer csendesen figyelmen kívül hagyja és alkalmazza, amikor a bemutató befejeződik, és a stream VoD-vá válik.
Ez egy hosszú érték, amely a bemutató abszolút végpontját jelöli, és a legközelebbi GOP-kezdésre kerekített. Az egység az időskálázás, ezért 18000000000-ből álló endTimestamp 3 percig tart.
A startTimestamp és az endTimestamp használatával vágja le a lejátszási listában (jegyzékfájlban) lévő töredékeket.
Például a startTimestamp=40000000 és az endTimestamp=100000000 az alapértelmezett időskálával létrehoz egy lejátszási listát, amely a VoD-bemutató 4 másodperc és 10 másodperc közötti töredékeit tartalmazza. Ha egy töredék átlépi a határt, a teljes töredék bekerül a jegyzékbe.
Időskála A bemutató időtartományában lévő összes időbélyegre és időtartamra vonatkozik, amely a másodpercenkénti növekmények számaként van megadva.
Az alapértelmezett érték 100000000 – tízmillió növekmény egy másodperc alatt, ahol minden növekmény 100 nanoszekundum hosszú lenne. Az érték azonban eltérhet a videó forrásától függően, vagy ha élő eseményt használ kódolással a felhőben (alapértelmezés szerint 90 Hz vagy 90000 a videó esetében).)
Ha például 30 másodperces startTimestamp értéket szeretne beállítani, akkor az alapértelmezett időskálázás használatakor 3000000000 értéket használna. Ellenőrizze az eszköz jegyzékfájlját, és győződjön meg arról, hogy a videósáv időskálája a beállított skálán van. Ha élő eseményeket használ kódolással, az időskálázás a videósávok esetében 90 Hz-ben (90000), a hangsávok esetében pedig 48 hz -ben (48000) lehet.
liveBackoffDuration Csak az élő streamelésre vonatkozik.
Ez az érték határozza meg az ügyfél által keresett legfrissebb élő pozíciót.
Ezzel a tulajdonságtal késleltetheti az élő lejátszási pozíciót, és kiszolgálóoldali puffert hozhat létre a játékosok számára.
A tulajdonság mértékegysége az időskálázás (lásd alább).
Az élő visszalépés maximális időtartama 300 másodperc (3000000000).
A 200000000000 érték például azt jelenti, hogy a legújabb elérhető tartalom 20 másodperccel késik a valós élő éltől.
presentationWindowDuration Csak az élő streamelésre vonatkozik.
A presentationWindowDuration használatával egy szilánkokat tartalmazó csúszóablakot alkalmazhat a lejátszási listákba való belefoglaláshoz.
A tulajdonság mértékegysége az időskálázás (lásd alább).
Állítsa be például a presentationWindowDuration=1200000000 beállítást egy kétperces csúszóablak alkalmazásához. Az élő él 2 percen belüli médiatartalmat a lejátszási lista tartalmazza. Ha egy töredék átlépi a határt, a teljes töredék bekerül a lejátszási listába. A bemutatóablak minimális időtartama 60 másodperc.
forceEndTimestamp Csak az élő streamelésre vonatkozik.
Azt jelzi, hogy az endTimestamp tulajdonságnak jelen kell-e lennie. Ha igaz, meg kell adni az endTimestamp értéket, vagy hibás kéréskódot kell visszaadni.
Megengedett értékek: hamis, igaz.

Számok

Megadhatja a szűrőkövetési tulajdonságfeltételek (FilterTrackPropertyConditions) listáját, amely alapján a stream zeneszámait (élő streamelés vagy igény szerinti videó) dinamikusan létre kell hozni. A szűrők egy logikai ÉS és OR művelettel vannak kombinálva.

A szűrőkövetési tulajdonságfeltételek a követés típusait, értékeit (az alábbi táblázatban leírtak szerint) és a műveleteket (Egyenlőség, NotEqual) írják le.

Név Leírás
Bitráta Szűréshez használja a sáv bitrátát.

A legjobb érték a bitsebességek tartománya, másodpercenkénti bitekben. Például: "0-2427000".

Megjegyzés: bár használhat egy adott bitrátaértéket, például 250000 (másodpercenkénti bit), ez a megközelítés nem ajánlott, mivel a pontos bitsebességek ingadozhatnak az egyik eszközről a másikra.
Fourcc A szűréshez használja a sáv FourCC értékét.

Az érték a kodekek formátumának első eleme, az RFC 6381-ben megadottak szerint. Jelenleg a következő kodekek támogatottak:
Videó esetén: "avc1", "hev1", "hvc1"
Hang esetén: "mp4a", "ec-3"

Az eszközben lévő sávok FourCC-értékeinek meghatározásához kérje le és vizsgálja meg a jegyzékfájlt.
Nyelv A szűréshez használja a sáv nyelvét.

Az érték a felvenni kívánt nyelv címkéje, az RFC 5646-ban megadottak szerint. Például: "en".
Név A szűréshez használja a sáv nevét.
Típus A szűréshez használja a pálya típusát.

A következő értékek engedélyezettek: "video", "audio" vagy "text".

Példa

Az alábbi példa egy élő streamelési szűrőt definiál:

{
  "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"
          }
        ]
      }
    ]
  }
}

A HLS- vagy DASH-jegyzékek szűrése a streamelési lokátor létrehozásakor

A Media Services lehetővé teszi, hogy létrehozhasson egy streamelési lokátort, amely előre szűrt, ha a streamelési lokátor entitás szűrőtulajdonságában lévő szűrők gyűjteményét adja át. Ez lehetővé teszi, hogy előre szűrje az összes jegyzékfájlt a streamelési lokátorban. Az eredeti jegyzékfájl már nem érhető el ezen a streamelési lokátoron keresztül, és csak a szűrt válasz lesz elérhető a DASH vagy HLS URL-címeit kérő ügyfelek számára a szűrt streamelési lokátorból. Ez olyan helyzetekben hasznos, amikor csak egy objektum egy részét szeretné közzétenni, és megakadályozza, hogy a felhasználók hozzáférjenek az objektum teljes eredeti jegyzékfájljaihoz a HLS vagy a DASH jegyzék URL-címének lekérdezési sztringjének módosításával.

A streamelési lokátorban megadhatja az eszköz- vagy fiókszűrők listáját. A Dinamikus csomagkezelő az ügyfél által az URL-ben megadott szűrőkkel együtt alkalmazza ezt a szűrőlistát. Ez a kombináció létrehoz egy dinamikus jegyzékfájlt, amely a Streamelési lokátorban megadott URL- és szűrők szűrőin alapul.

Szűrők frissítése

A szűrők és a streamelési lokátorok menet közben frissíthetők, de ne feledje, hogy akár 10 másodpercet is igénybe vehet, amíg az előtér-webkiszolgálókon frissülnek a frissítések, és problémák merülhetnek fel a tartalom CDN-gyorsítótárazásával kapcsolatban, ha ugyanazt a streamelési lokátort frissíti, amelyet már közzétettek és használtak az éles környezetben.

Nem ajánlott frissíteni az aktívan közzétett streamelési lokátorhoz társított szűrők definícióját, különösen akkor, ha a CDN engedélyezve van. A streamelő kiszolgálók és CDN-k belső gyorsítótárakat tartalmazhatnak, amelyek elavult gyorsítótárazott adatok visszaadásához vezethetnek.

Ha módosítani kell a szűrődefiníciót, hozzon létre egy új szűrőt, és adja hozzá a Streamelési lokátor URL-címéhez, vagy tegyen közzé egy egyedileg új Stream lokátort , amely közvetlenül hivatkozik a frissített szűrőre.

Súgó és támogatás

Kérdéseket tehet fel a Media Serviceshez, vagy kövesse a frissítéseket az alábbi módszerek egyikével: