Delen via

Quickstart: Videobeperkingen instellen in uw aanroepende app

  • Artikel

Belangrijk

De functionaliteit die in dit artikel wordt beschreven, is momenteel beschikbaar als openbare preview. Deze preview-versie wordt geleverd zonder een service level agreement en we raden deze niet aan voor productieworkloads. Misschien worden bepaalde functies niet ondersteund of zijn de mogelijkheden ervan beperkt. Zie Aanvullende gebruiksvoorwaarden voor Microsoft Azure-previews voor meer informatie.

Overzicht

Met de API voor videobeperkingen kunnen ontwikkelaars de videokwaliteit vanuit hun videogesprekken beheren. In deze snelstartgids laten we zien hoe u de API gebruikt om de beperkingen in te stellen.

Vereisten

Raadpleeg de quickstart voor spraakoproepen om een voorbeeld-app in te stellen met spraakoproepen.

Klassen

Name Beschrijving
VideoConstraints Wordt gebruikt voor zowel binnenkomende videobeperkingen als uitgaande videobeperkingen.
OutgoingVideoConstraints Wordt gebruikt om beperkingen (MaxWidth | MaxHeight | MaxFrameRate) op te geven voor uitgaande videostreams.
IncomingVideoConstraints Wordt gebruikt om beperkingen (MaxWidth | MaxHeight) op te geven voor binnenkomende videostreams.

Videobeperkingen gebruiken

In de volgende secties wordt uitgelegd hoe de videobeperkingen kunnen worden ingesteld voor binnenkomende en/of uitgaande videostreams op verschillende momenten van een gesprek.

Videobeperkingen instellen voordat u een gesprek start

Voor binnenkomende videostreams moet er een IncomingVideoConstraints worden toegevoegd aan de IncomingVideoOptions.

    var IncomingVideoOptions = new IncomingVideoOptions()
    {
        Constraints = new IncomingVideoConstraints() 
        { 
            MaxWidth = /*value*/, 
            MaxHeight = /*value*/ 
        },
        // other options
        // ...
    }

Voor uitgaande videostreams moet er een OutgoingVideoConstraints worden toegevoegd aan de OutgoingVideoOptions.

    var OutgoingVideoOptions = new OutgoingVideoOptions()
    {
        Constraints = new OutgoingVideoConstraints() 
        { 
            MaxWidth = /*value*/, 
            MaxHeight = /*value*/, 
            MaxFrameRate = /*value*/ 
        },
        // other options
        // ...
    }

Omdat de opties worden gebruikt om een oproep te starten/eraan deel te nemen, kunnen de beperkingen automatisch worden toegepast op de streams. Voorbeeld:

    var joinCallOptions = new JoinCallOptions()
    {
        IncomingVideoOptions = new IncomingVideoOptions()
        {
            Constraints = new IncomingVideoConstraints() 
            { 
                MaxWidth = /*value*/, 
                MaxHeight = /*value*/ 
            },
            // other options
            // ...
        },

        OutgoingVideoOptions = new OutgoingVideoOptions()
        {
            Constraints = new OutgoingVideoConstraints() 
            { 
                MaxWidth = /*value*/, 
                MaxHeight = /*value*/, 
                MaxFrameRate = /*value*/ 
            },
            // other options
            // ...
        }
    };
    await callAgent.JoinAsync(locator, joinCallOptions);

Videobeperkingen instellen tijdens een gesprek

In plaats van de videobeperkingen in te stellen voordat u een oproep start, kunt u ook de videobeperkingen dynamisch aanpassen tijdens een gesprek. U moet uw Call typeklasse aanroepen SetVideoConstraints en de beperkingen opgeven.


    OutgoingVideoConstraints outgoingVideoConstraints = new OutgoingVideoConstraints()
    {
        outgoingVideoConstraints.MaxWidth = /*value*/ ;
        outgoingVideoConstraints.MaxHeight = /*value*/ ;
        outgoingVideoConstraints.MaxFrameRate = /*value*/ ;
    };
    
    IncomingVideoConstraints incomingVideoConstraints = new IncomingVideoConstraints()
    {
        incomingVideoConstraints.MaxWidth = /*value*/ ;
        incomingVideoConstraints.MaxHeight = /*value*/ ;
    };
  
    VideoConstraints constraints = new VideoConstraints();
    constraints.OutgoingVideoConstraints = outgoingVideoConstraints;
    constraints.IncomingVideoConstraints = incomingVideoConstraints;
    
    call.SetVideoConstraints(constraints);

Als u de eerder ingestelde videobeperkingen opnieuw wilt instellen/verwijderen, moet u het bovenstaande patroon volgen en opgeven 0 als een beperkingswaarde. Het opgeven van null waarden voor of IncomingVideoConstraints OutgoingVideoConstraints het opnieuw instellen/verwijderen van de beperkingen en de beperkingen met een null waarde worden genegeerd.

Beperkingen

Notitie

Zorg ervoor dat u op de hoogte bent van deze beperkingen bij het gebruik van de VIDEObeperkingen-API. Sommige beperkingen worden in toekomstige releases verwijderd.

Er zijn enkele bekende beperkingen voor de huidige API voor videobeperkingen.

  • De beperking is een maximale beperking, wat betekent dat de mogelijke beperkingswaarde de opgegeven waarde of kleiner kan zijn. Er is geen garantie dat de werkelijke waarde hetzelfde blijft als door de gebruiker opgegeven.

  • Wanneer de gebruiker een beperkingswaarde instelt die te klein is, gebruikt de SDK de kleinste beschikbare waarde die wordt ondersteund.

  • Voor het instellen OutgoingVideoConstraints tijdens een gesprek haalt de huidige lopende videostream niet automatisch de opgegeven beperkingen op. Als u de beperkingen van kracht wilt maken, moet u de uitgaande video stoppen en opnieuw starten.

  • IncomingVideoConstraints momenteel is een beperking van de gebruiker in plaats van een vaste beperking, wat betekent dat, afhankelijk van uw netwerk en hardware, de werkelijke waarde die wordt ontvangen, de beperkingsset nog steeds overschrijdt.

Mediastatistieken

Als u de videokwaliteit wilt evalueren en vergelijken nadat u de videobeperkingen hebt toegepast, hebt u toegang tot de MediaStats-API om videoresolutie en bitrate-informatie van de stream op te halen. De mediastatistieken bevatten ook andere gedetailleerde statistieken die betrekking hebben op de streams, zoals jitter, pakketverlies, retourtijd, enzovoort.

Belangrijk

De functionaliteit die in dit artikel wordt beschreven, is momenteel beschikbaar als openbare preview. Deze preview-versie wordt geleverd zonder een service level agreement en we raden deze niet aan voor productieworkloads. Misschien worden bepaalde functies niet ondersteund of zijn de mogelijkheden ervan beperkt. Zie Aanvullende gebruiksvoorwaarden voor Microsoft Azure-previews voor meer informatie.

Overzicht

Met de API voor videobeperkingen kunnen ontwikkelaars de videokwaliteit vanuit hun videogesprekken beheren. In deze snelstartgids laten we zien hoe u de API gebruikt om de beperkingen in te stellen.

Vereisten

Raadpleeg de quickstart voor spraakoproepen om een voorbeeld-app in te stellen met spraakoproepen.

Klassen

Name Beschrijving
VideoConstraints Wordt gebruikt voor zowel binnenkomende videobeperkingen als uitgaande videobeperkingen.
OutgoingVideoConstraints Wordt gebruikt om beperkingen (maxWidth | maxHeight | maxFrameRate) op te geven voor uitgaande videostreams.
IncomingVideoConstraints Wordt gebruikt om beperkingen (maxWidth | maxHeight) op te geven voor binnenkomende videostreams.

Videobeperkingen gebruiken

In de volgende secties wordt uitgelegd hoe de videobeperkingen kunnen worden ingesteld voor binnenkomende en/of uitgaande videostreams op verschillende momenten van een gesprek.

Videobeperkingen instellen voordat u een gesprek start

Voor binnenkomende videostreams moet er een IncomingVideoConstraints worden toegevoegd aan de IncomingVideoOptions.

    IncomingVideoConstraints incomingVideoConstraints = new IncomingVideoConstraints();
    incomingVideoConstraints.setMaxWidth(/*value*/);
    incomingVideoConstraints.setMaxHeight(/*value*/);

    // ...

    IncomingVideoOptions incomingVideoOptions = new IncomingVideoOptions();
    incomingVideoOptions.setConstraints(incomingVideoConstraints);

Voor uitgaande videostreams moet er een OutgoingVideoConstraints worden toegevoegd aan de OutgoingVideoOptions.

    OutgoingVideoConstraints outgoingVideoConstraints = new OutgoingVideoConstraints() 
    outgoingVideoConstraints.setMaxWidth(/*value*/); 
    outgoingVideoConstraints.setMaxHeight(/*value*/); 
    outgoingVideoConstraints.setMaxFrameRate(/*value*/); 
   
    // ...
    
    OutgoingVideoOptions outgoingVideoOptions = new OutgoingVideoOptions();
    outgoingVideoOptions.setConstraints(outgoingVideoConstraints);

Omdat de opties worden gebruikt om een oproep te starten/eraan deel te nemen, kunnen de beperkingen automatisch worden toegepast op de streams. Voorbeeld:

    JoinCallOptions joinCallOptions = new JoinCallOptions();
    joinCallOptions.setIncomingVideoOptions(incomingVideoOptions);
    joinCallOptions.setOutgoingVideoOptions(outgoingVideoOptions);
    callAgent.Join(context, locator, joinCallOptions);

Videobeperkingen instellen tijdens een gesprek

In plaats van de videobeperkingen in te stellen voordat u een oproep start, kunt u ook de videobeperkingen dynamisch aanpassen tijdens een gesprek. U moet uw Call typeklasse aanroepen setVideoConstraints en de beperkingen opgeven.


    OutgoingVideoConstraints outgoingVideoConstraints = new OutgoingVideoConstraints();
    outgoingVideoConstraints.setMaxWidth(/*value*/); 
    outgoingVideoConstraints.setMaxHeight(/*value*/); 
    outgoingVideoConstraints.setMaxFrameRate(/*value*/); 
    
    IncomingVideoConstraints incomingVideoConstraints = new IncomingVideoConstraints();
    incomingVideoConstraints.setMaxWidth(/*value*/);
    incomingVideoConstraints.setMaxHeight(/*value*/);
  
    VideoConstraints constraints = new VideoConstraints();
    constraints.setOutgoingVideoConstraints(outgoingVideoConstraints);
    constraints.setIncomingVideoConstraints(incomingVideoConstraints);
    
    call.setVideoConstraints(constraints);

Als u de eerder ingestelde videobeperkingen opnieuw wilt instellen/verwijderen, moet u het bovenstaande patroon volgen en opgeven 0 als een beperkingswaarde. Het opgeven van null waarden voor of IncomingVideoConstraints OutgoingVideoConstraints het opnieuw instellen/verwijderen van de beperkingen en de beperkingen met een null waarde worden genegeerd.

Beperkingen

Notitie

Zorg ervoor dat u op de hoogte bent van deze beperkingen bij het gebruik van de VIDEObeperkingen-API. Sommige beperkingen worden in toekomstige releases verwijderd.

Er zijn enkele bekende beperkingen voor de huidige API voor videobeperkingen.

  • De beperking is een maximale beperking, wat betekent dat de mogelijke beperkingswaarde de opgegeven waarde of kleiner kan zijn. Er is geen garantie dat de werkelijke waarde hetzelfde blijft als door de gebruiker opgegeven.

  • Wanneer de gebruiker een beperkingswaarde instelt die te klein is, gebruikt de SDK de kleinste beschikbare waarde die wordt ondersteund.

  • Voor het instellen OutgoingVideoConstraints tijdens een gesprek haalt de huidige lopende videostream niet automatisch de opgegeven beperkingen op. Als u de beperkingen van kracht wilt maken, moet u de uitgaande video stoppen en opnieuw starten.

  • IncomingVideoConstraints momenteel is een beperking van de gebruiker in plaats van een vaste beperking, wat betekent dat, afhankelijk van uw netwerk en hardware, de werkelijke waarde die wordt ontvangen, de beperkingsset nog steeds overschrijdt.

Mediastatistieken

Als u de videokwaliteit wilt evalueren en vergelijken nadat u de videobeperkingen hebt toegepast, hebt u toegang tot de MediaStats-API om videoresolutie en bitrate-informatie van de stream op te halen. De mediastatistieken bevatten ook andere gedetailleerde statistieken die betrekking hebben op de streams, zoals jitter, pakketverlies, retourtijd, enzovoort.

Belangrijk

De functionaliteit die in dit artikel wordt beschreven, is momenteel beschikbaar als openbare preview. Deze preview-versie wordt geleverd zonder een service level agreement en we raden deze niet aan voor productieworkloads. Misschien worden bepaalde functies niet ondersteund of zijn de mogelijkheden ervan beperkt. Zie Aanvullende gebruiksvoorwaarden voor Microsoft Azure-previews voor meer informatie.

Overzicht

Met de API voor videobeperkingen kunnen ontwikkelaars de videokwaliteit vanuit hun videogesprekken beheren. In deze snelstartgids laten we zien hoe u de API gebruikt om de beperkingen in te stellen.

Vereisten

Raadpleeg de quickstart voor spraakoproepen om een voorbeeld-app in te stellen met spraakoproepen.

Klassen

Name Beschrijving
VideoConstraints Wordt gebruikt voor zowel binnenkomende videobeperkingen als uitgaande videobeperkingen.
OutgoingVideoConstraints Wordt gebruikt om beperkingen (maxWidth | maxHeight | maxFrameRate) op te geven voor uitgaande videostreams.
IncomingVideoConstraints Wordt gebruikt om beperkingen (maxWidth | maxHeight) op te geven voor binnenkomende videostreams.

Videobeperkingen gebruiken

In de volgende secties wordt uitgelegd hoe de videobeperkingen kunnen worden ingesteld voor binnenkomende en/of uitgaande videostreams op verschillende momenten van een gesprek.

Videobeperkingen instellen voordat u een gesprek start

Voor binnenkomende videostreams moet er een IncomingVideoConstraints worden toegevoegd aan de IncomingVideoOptions.

    let incomingVideoConstraints = IncomingVideoConstraints()
    incomingVideoConstraints.maxWidth = /*value*/ 
    incomingVideoConstraints.maxHeight = /*value*/ 
    
    // ...
    
    let incomingVideoOptions = IncomingVideoOptions()
    incomingVideoOptions.constraints = incomingVideoConstraints

Voor uitgaande videostreams moet er een OutgoingVideoConstraints worden toegevoegd aan de OutgoingVideoOptions.

    let outgoingVideoConstraints = OutgoingVideoConstraints()
    outgoingVideoConstraints.maxWidth = /*value*/ 
    outgoingVideoConstraints.maxHeight = /*value*/
    outgoingVideoConstraint.maxFrameRate = /*value*/ 
    
    // ...

    let outgoingVideoOptions = OutgoingVideoOptions()
    outgoingVideoOptions.constraints = outgoingVideoConstraints

Omdat de opties worden gebruikt om een oproep te starten/eraan deel te nemen, kunnen de beperkingen automatisch worden toegepast op de streams. Voorbeeld:

    let incomingVideoConstraints = IncomingVideoConstraints()
    incomingVideoConstraints.maxWidth = /*value*/ 
    incomingVideoConstraints.maxHeight = /*value*/ 
    let incomingVideoOptions = IncomingVideoOptions()
    incomingVideoOptions.constraints = incomingVideoConstraints
    
    let outgoingVideoConstraints = OutgoingVideoConstraints()
    outgoingVideoConstraints.maxWidth = /*value*/ 
    outgoingVideoConstraints.maxHeight = /*value*/
    outgoingVideoConstraint.maxFrameRate = /*value*/ 
    let outgoingVideoOptions = OutgoingVideoOptions()
    outgoingVideoOptions.constraints = outgoingVideoConstraints
    
    let joinCallOptions = new JoinCallOptions()
    joinCallOptions.incomingVideoOptions = incomingVideoOptions
    joinCallOptions.outgoingVideoOptions = outgoingVideoOptions

    callAgent.join(with: locator, joinCallOptions: joinCallOptions);

Videobeperkingen instellen tijdens een gesprek

In plaats van de videobeperkingen in te stellen voordat u een oproep start, kunt u ook de videobeperkingen dynamisch aanpassen tijdens een gesprek. U moet uw Call typeklasse aanroepen set(videoConstraints) en de beperkingen opgeven.


    let outgoingVideoConstraints = OutgoingVideoConstraints()
    outgoingVideoConstraints.maxWidth = /*value*/ 
    outgoingVideoConstraints.maxHeight = /*value*/
    outgoingVideoConstraint.maxFrameRate = /*value*/ 
    
    let incomingVideoConstraints = IncomingVideoConstraints()
    incomingVideoConstraints.maxWidth = /*value*/ 
    incomingVideoConstraints.maxHeight = /*value*/ 
  
    let videoConstraints = VideoConstraints()
    videoConstraints.outgoingVideoConstraints = outgoingVideoConstraints
    videoConstraints.incomingVideoConstraints = incomingVideoConstraints
    
    call?.set(videoConstraints: videoConstraints)

Als u de eerder ingestelde videobeperkingen opnieuw wilt instellen/verwijderen, moet u het bovenstaande patroon volgen en opgeven 0 als een beperkingswaarde. Het opgeven van null waarden voor of IncomingVideoConstraints OutgoingVideoConstraints het opnieuw instellen/verwijderen van de beperkingen en de beperkingen met een null waarde worden genegeerd.

Beperkingen

Notitie

Zorg ervoor dat u op de hoogte bent van deze beperkingen bij het gebruik van de VIDEObeperkingen-API. Sommige beperkingen worden in toekomstige releases verwijderd.

Er zijn enkele bekende beperkingen voor de huidige API voor videobeperkingen.

  • De beperking is een maximale beperking, wat betekent dat de mogelijke beperkingswaarde de opgegeven waarde of kleiner kan zijn. Er is geen garantie dat de werkelijke waarde hetzelfde blijft als door de gebruiker opgegeven.

  • Wanneer de gebruiker een beperkingswaarde instelt die te klein is, gebruikt de SDK de kleinste beschikbare waarde die wordt ondersteund.

  • Voor het instellen OutgoingVideoConstraints tijdens een gesprek haalt de huidige lopende videostream niet automatisch de opgegeven beperkingen op. Als u de beperkingen van kracht wilt maken, moet u de uitgaande video stoppen en opnieuw starten.

  • IncomingVideoConstraints momenteel is een beperking van de gebruiker in plaats van een vaste beperking, wat betekent dat, afhankelijk van uw netwerk en hardware, de werkelijke waarde die wordt ontvangen, de beperkingsset nog steeds overschrijdt.

Mediastatistieken

Als u de videokwaliteit wilt evalueren en vergelijken nadat u de videobeperkingen hebt toegepast, hebt u toegang tot de MediaStats-API om videoresolutie en bitrate-informatie van de stream op te halen. De mediastatistieken bevatten ook andere gedetailleerde statistieken die betrekking hebben op de streams, zoals jitter, pakketverlies, retourtijd, enzovoort.

U kunt videobeperkingen instellen in uw oproepen om de videokwaliteit te beheren op basis van resolutie of frameRate of bitrate in uw videogesprekken. In deze snelstartgids laten we zien hoe u videobeperkingen instelt aan het begin van een gesprek en hoe u onze setConstraints methode op het oproepobject gebruikt om videobeperkingen dynamisch in te stellen tijdens het gesprek.

Videobeperkingen verzenden

Azure Communication Services Web Calling SDK ondersteunt het instellen van de maximale videoresolutie, framerate of bitrate die een client verzendt. De beperkingen van de afzendervideo worden ondersteund in desktopbrowsers (Chrome, Edge, Firefox) en wanneer u de mobiele browser van iOS Safari of de mobiele Android Chrome-browser gebruikt.

Ondersteunde beperkingen
Binnenkomende video: resolutie
Uitgaande video: resolutie, framerate, bitrate

Videobeperkingen instellen aan het begin van een gesprek - uitgaande video (verzenden)

De instelling voor videobeperkingen wordt geïmplementeerd op de Call interface. Als u de videobeperkingen wilt gebruiken, kunt u de beperkingen van binnenuit CallOptions opgeven wanneer u een oproep doet, een oproep accepteert of deelneemt aan een gesprek. U moet opgeven localVideoStreams in videoOptions.
Houd er rekening mee dat beperkingen niet werken als u deelneemt aan een gesprek met alleen audio en de camera later inschakelt. In dit geval kunt u videobeperkingen dynamisch instellen met behulp van de setConstraints methode op de Call interface.

const callOptions = {
    videoOptions: {
        localVideoStreams: [...],
        constraints: {
            send: {
                bitrate: {
                    max: 575000
                },
                frameHeight: {
                    max: 240
                },
                frameRate: {
                    max: 20
                }
            }
        }
    },
    audioOptions: {
        muted: false
    }
};
// make a call
this.callAgent.startCall(identitiesToCall, callOptions);
// join a group call
this.callAgent.join({ groupId }, callOptions);
// accept an incoming call
this.incomingCall.accept(callOptions)

Typen videobeperkingen worden als volgt beschreven:

export declare interface VideoOptions {
    localVideoStreams?: LocalVideoStream[];
    //video constraint when call starts
    constraints?: VideoConstraints;
};

export declare type VideoConstraints = {
    send?: VideoSendConstraints;
};

export type VideoSendConstraints = {
    /**
     * Resolution constraint
     */
    frameHeight?: MediaConstraintRange;

    /**
     * FrameRate constraint
     */
    frameRate?: MediaConstraintRange;

    /**
     * Bitrate constriant
     */
    bitrate?: MediaConstraintRange;
};

export declare type MediaConstraintRange = {
    max?: number;
};

Bij het instellen van videobeperkingen kiest de SDK de dichtstbijzijnde waarde die binnen de beperking valt die is ingesteld om te voorkomen dat de waarden voor resolutie, frameRate en bitrate worden overschreden om de ingestelde maximumlimietwaarden niet te overschrijden. Als de waarde van de oplossingsbeperking te klein is, kiest de SDK ook de kleinste beschikbare resolutie. In dit geval kan de hoogte van de gekozen resolutie groter zijn dan de beperkingswaarde.

Notitie

Voor alle bitrate, frameHeight en frameRate, de beperkingswaarde is een max beperking, wat betekent dat de werkelijke waarde in de aanroep de opgegeven waarde of kleiner kan zijn. Er is geen gurante dat de verzonden videoresolutie op de opgegeven resolutie blijft staan.

De frameHeight in VideoSendConstraints heeft een andere betekenis wanneer een mobiel apparaat zich in de staande modus bevindt. In de staande modus geeft deze waarde de kortere kant van het apparaat aan. Als u bijvoorbeeld een waarde opgeeft frameHeight.max met 240 op een apparaat van 1080 (W) x 1920(H) in de staande modus, bevindt de hoogte van de beperking zich aan de zijde van 1080(W). Wanneer hetzelfde apparaat zich in de liggende modus bevindt (1920(W) x 1080(H)), bevindt de beperking zich aan de zijde van 1080(H).

Als u de MediaStats-API gebruikt om de verzonden videoresolutie bij te houden, kunt u erachter komen dat de verzonden resolutie tijdens de aanroep kan veranderen. Deze kan omhoog en omlaag gaan, maar moet gelijk zijn aan of kleiner zijn dan de opgegeven beperkingswaarde. Deze oplossingswijziging is een verwacht gedrag. De browser heeft ook een aantal degradatieregels om verzonden resolutie aan te passen op basis van cpu- of netwerkomstandigheden.

Videobeperkingen instellen tijdens het gesprek - uitgaande video (verzenden)

U kunt videobeperkingen instellen tijdens het gesprek met behulp van de setConstraints methode voor het Call object.

// For eg, when you've started a call,
const currentCall = this.callAgent.startCall(identitiesToCall, callOptions);

// To set constraints during the call,
await currentCall.setConstraints({
    video: {
        send: {
            frameHeight: {
                max: 360
            },
            frameRate: {
                max: 15
            }
        }
    }
});

// To set only a particular constraint (the others will stay as what they were set before, if they were set)
await currentCall.setConstraints({
    video: {
        send: {
            bitrate: {
                max: 400000
            }
        }
    }
});

// To unset any constraint,
await currentCall.setConstraints({
    video: {
        send: {
            frameHeight: {
                max: 0
            }
        }
    }
});

Notitie

Als u een beperkingswaarde instelt, worden 0 eventuele eerder ingestelde beperkingen uitgeschakeld. U kunt op deze manier beperkingen opnieuw instellen of verwijderen.


Videobeperkingen ontvangen

Als u de resolutie aan de ontvangerzijde wilt beheren met behulp van azure Communication Services Web Calling SDK, kunt u de grootte van de renderer van die video aanpassen. De aanroepende SDK past de ontvangen resolutie automatisch aan op basis van de dimensies van de renderer. De SDK vraagt geen binnenkomende videostroom (breedte en hoogte) aan die in het videovenster van de renderer past.

Media statics gebruiken om inzicht te hebben in de impact van videobeperkingen

Als u de videokwaliteit wilt evalueren en vergelijken nadat u de videobeperkingen hebt toegepast, hebt u toegang tot de MediaStats-API om videoresolutie en bitrate informatie over de verzendende stream op te halen. De mediastatistieken bevatten ook andere gedetailleerde statistieken die betrekking hebben op de streams, zoals jitter, pakketverlies, retourtijd, enzovoort.

const mediaStatsFeature = call.feature(Features.MediaStats);
const mediaStatsCollector = mediaStatsFeature.createCollector();

mediaStatsCollector.on('sampleReported', (sample: SDK.MediaStatsReportSample) => {
    // process the stats for the call.
    console.log(sample);
});

Volgende stappen

Raadpleeg voor meer informatie de volgende artikelen:

  • Meer informatie over conceptdocument videobeperkingen
  • Meer informatie over de mogelijkheden van calling-SDK