Aandachtspunten bij het gebruik van Azure AI Video Indexer op schaal

Wanneer u Azure AI Video Indexer gebruikt om video's te indexeren en uw archief met video's groeit, kunt u overwegen om te schalen.

In dit artikel vindt u antwoorden op vragen zoals:

• Moet ik rekening houden met technologische beperkingen?
• Is er een slimme en efficiënte manier om het te doen?
• Kan ik voorkomen dat ik overtollig geld in het proces uitgeeft?

Het artikel bevat zes aanbevolen procedures voor het gebruik van Azure AI Video Indexer op schaal.

Bij het uploaden van video's kunt u overwegen een URL te gebruiken via bytematrix

Azure AI Video Indexer biedt u de keuze om video's te uploaden vanaf een URL of rechtstreeks door het bestand als een bytematrix te verzenden. Deze laatste heeft enkele beperkingen.

Ten eerste gelden er beperkingen voor de bestandsgrootte. De grootte van het bytematrixbestand is beperkt tot 2 GB in vergelijking met de beperking van de uploadgrootte van 30 GB tijdens het gebruik van URL.

Overweeg ten tweede slechts enkele van de problemen die van invloed kunnen zijn op uw prestaties en daarom uw mogelijkheid om te schalen:

• Het verzenden van bestanden met meerdere delen betekent een hoge afhankelijkheid van uw netwerk,
• servicebetrouwbaarheid,
• Connectiviteit
• uploadsnelheid,
• verloren pakketten ergens in het wereldwijde web.

Wanneer u video's uploadt met behulp van URL, hoeft u alleen een pad naar de locatie van een mediabestand op te geven en zorgt Video Indexer voor de rest (zie het videoUrl veld in de uploadvideo-API ).

Tip

Gebruik de videoUrl optionele parameter van de uploadvideo-API. Daarnaast kunt u AzCopy gebruiken voor een snelle en betrouwbare manier om uw inhoud op te halen naar een opslagaccount van waaruit u deze kunt verzenden naar Azure AI Video Indexer met behulp van de SAS-URL. Azure AI Video Indexer raadt het gebruik van alleen-lezen SAS-URL's aan.

Beperking respecteren

Azure AI Video Indexer is gebouwd om indexering op schaal aan te pakken. Wanneer u er optimaal gebruik van wilt maken, moet u zich ook bewust zijn van de mogelijkheden van het systeem en uw integratie dienovereenkomstig ontwerpen. U wilt geen uploadaanvraag verzenden voor een batch video's om te ontdekken dat sommige films niet zijn geüpload en dat u een HTTP 429-antwoordcode (te veel aanvragen) ontvangt. Er is een API-aanvraaglimiet van 10 aanvragen per seconde en maximaal 120 aanvragen per minuut.

Azure AI Video Indexer voegt een retry-after header toe aan het HTTP-antwoord. De header geeft aan wanneer u het volgende opnieuw moet proberen. Zorg ervoor dat u dit respecteert voordat u uw volgende aanvraag probeert.

Callback-URL gebruiken

We raden u aan om in plaats van de status van uw aanvraag voortdurend te peilen vanaf het tweede dat u de uploadaanvraag hebt verzonden, een callback-URL toe te voegen en te wachten totdat Azure AI Video Indexer u bijwerkt. Zodra er een statuswijziging in uw uploadaanvraag is, ontvangt u een POST-melding naar de URL die u hebt opgegeven.

U kunt een callback-URL toevoegen als een van de parameters van de uploadvideo-API. Bekijk de codevoorbeelden in de GitHub-opslagplaats.

Voor callback-URL kunt u ook Azure Functions gebruiken, een serverloos gebeurtenisgestuurd platform dat kan worden geactiveerd door HTTP en een volgende stroom implementeren.

callBack-URL-definitie

Een callback-URL wordt gebruikt om de klant (via een POST-aanvraag) op de hoogte te stellen van de volgende gebeurtenissen:

• Statuswijziging indexering:

  • Eigenschappen:

    Name	Description
    id	De video-id
    staat	De videostatus

  • Voorbeeld: https://test.com/notifyme?projectName=MyProject& id=1234abcd&state=Verwerkt

• Personen geïdentificeerd in de video:

  • Eigenschappen

    Name	Description
    id	De video-id
    faceId	De gezichts-id die wordt weergegeven in de video-index
    knownPersonId	De persoons-id die uniek is in een gezichtsmodel
    personName	De naam van de persoon

  • Voorbeeld: https://test.com/notifyme?projectName=MyProject& id=1234abcd&faceid=12&knownPersonId=CCA84350-89B7-4262-861C-3CAC796542A5&personName=Inigo_Montoya

Gebruik de juiste indexeringsparameters voor u

Wanneer u beslissingen neemt met betrekking tot het gebruik van Azure AI Video Indexer op schaal, bekijkt u hoe u er optimaal gebruik van kunt maken met de juiste parameters voor uw behoeften. Denk na over uw use-case door verschillende parameters te definiëren die u geld kunt besparen en het indexeringsproces voor uw video's sneller kunt maken. Stel de voorinstelling bijvoorbeeld niet in op streaming als u niet van plan bent om de video te bekijken, indexeer geen video-inzichten als u alleen audio-inzichten nodig hebt.

Index in optimale resolutie, niet de hoogste resolutie

Misschien vraagt u, welke videokwaliteit hebt u nodig voor het indexeren van uw video's?

In veel gevallen hebben indexeringsprestaties bijna geen verschil tussen HD-video's (720P) en 4K-video's. Uiteindelijk krijgt u bijna dezelfde inzichten met hetzelfde vertrouwen. Hoe hoger de kwaliteit van de film die u uploadt, betekent hoe groter de bestandsgrootte en dit leidt tot hogere rekenkracht en tijd die nodig is om de video te uploaden.

Voor de gezichtsdetectiefunctie kan een hogere resolutie bijvoorbeeld helpen bij het scenario waarin er veel kleine maar contextuele belangrijke gezichten zijn. Dit wordt echter geleverd met een kwadratische toename van runtime en een verhoogd risico op fout-positieven.

Daarom raden we u aan om te controleren of u de juiste resultaten krijgt voor uw use-case en om deze eerst lokaal te testen. Upload dezelfde video in 720P en in 4K en vergelijk de inzichten die u krijgt.