Intégration des développeurs à la redirection multimédia pour les applications d’appel WebRTC dans une session à distance

La redirection multimédia redirige la lecture et les appels vidéo dans une session à distance à partir d’Azure Virtual Desktop, d’un Windows 365 PC Cloud ou de Microsoft Dev Box vers votre appareil local pour accélérer le traitement et le rendu.

La redirection des appels optimise les appels audio pour les applications d’appel WebRTC, ce qui réduit la latence et améliore la qualité des appels. La connexion se produit entre l’appareil local et le serveur d’applications de téléphonie, où les appels WebRTC sont déchargés d’une session à distance vers un appareil local. Une fois la connexion établie, la qualité de l’appel devient dépendante de la page web ou des fournisseurs d’applications, comme c’est le cas pour un appel non redirigé.

La redirection d’appel peut fonctionner avec la plupart des applications d’appel webRTC sans modification. Toutefois, il peut y avoir des scénarios non pris en charge ou vous souhaiterez peut-être fournir une expérience différente dans une session à distance.

Cet article fournit des informations sur les interfaces API prises en charge et les méthodes instance, et présente les extraits de code JavaScript que vous pouvez utiliser avec la mediaDevices propriété de l’interface Navigator.

L’interface du navigateur fait partie de l’API Media Capture and Streams pour intégrer votre site web à la redirection des appels. Avec l’API WebRTC, ces API prennent en charge la diffusion en continu de données audio et vidéo avec des applications d’appel WebRTC. La redirection multimédia remplace l’implémentation de l’objet mediaDevices dans les API pour détecter la redirection des appels, gérer les événements de déconnexion et de reconnexion, et collecter des informations de diagnostic.

Conseil

Lorsque vous souhaitez tester votre intégration à la redirection multimédia, vous pouvez activer la redirection d’appel pour qu’elle soit disponible pour tous les sites web. Pour plus d’informations, consultez Activer la redirection des appels pour tous les sites à des fins de test.

Interfaces API et méthodes instance prises en charge

La redirection d’appel est conçue pour remplacer en toute transparence l’utilisation de WebRTC standard par une implémentation qui redirige les appels d’une session à distance vers l’appareil local.

Voici une liste des interfaces et méthodes instance prises en charge utilisées par la redirection d’appels à partir de l’API Media Capture and Streams et de l’API WebRTC :

• AnalyserNode
• AudioContext
• HTMLAudioElement
• MediaDevices
  • enumerateDevices
  • getUserMedia
• MediaStream
• MediaStreamAudioDestinationNode
• MediaStreamAudioSourceNode
• MediaStreamTrack
• RTCDataChannel
• RTCPeerConnection
• RTCRtpReceiver
• RTCRtpSender
• RTCRtpTransceiver

Limitations connues

La redirection d’appel présente les limitations d’API suivantes :

• Actuellement, seul un nombre limité de WebAudio nœuds est pris en charge.

• setSinkId sur un HTMLAudioElement fonctionne pour les pistes WebRTC srcObject , mais toute lecture locale, telle qu’une sonnerie, est toujours lue sur la sortie audio par défaut de la session à distance.

• Comme certaines API retournent de manière synchrone dans des conditions normales, mais doivent être des proxys lorsqu’elles sont utilisées avec la redirection d’appel, il est possible que l’état d’un objet ne soit pas disponible immédiatement.

Détecter la redirection des appels

Pour détecter si la redirection d’appel est active, vous pouvez case activée la isCallRedirectionEnabled propriété de l’objet MediaDevices . Si cette propriété a la valeur true, la redirection d’appel est active. Si cette propriété est undefined ou false, la redirection d’appel n’est pas active.

window.navigator.mediaDevices['isCallRedirectionEnabled'] = true;

Détecter la déconnexion d’une session à distance

Lorsqu’un utilisateur se déconnecte et se reconnecte à une session à distance lors de l’utilisation de la redirection d’appels sur une page web, le instance WebRTC local qui prend en charge les objets n’est plus disponible. En règle générale, si un utilisateur actualise la page, il est en mesure d’effectuer à nouveau des appels.

La page web peut détecter et gérer ces événements de déconnexion et de reconnexion en déclassant et en recréant tous les objets WebRTC, éléments audio ou vidéo, et MediaStream ou MediaStreamTrack interfaces. Cette approche élimine la nécessité d’actualiser la page web.

Pour être informé de ces événements, inscrivez l’événement rdpClientConnectionStateChanged sur l’objet MediaDevices , comme illustré dans l’exemple suivant. Cet événement contient le nouvel état, qui peut être ou connecteddisconnected.

navigator.mediaDevices.addEventListener('rdpClientConnectionStateChanged', () => 
    console.log("state change: " + event.detail.state);
);

Diagnostics de redirection des appels

L’exemple suivant répertorie les propriétés exposées sur l’objet MediaDevices . Ils fournissent des informations de diagnostic spécifiques sur les versions de redirection des appels utilisées et les identificateurs de session. Ces informations sont utiles lorsque vous signalez des problèmes à Microsoft et nous vous recommandons de les collecter dans le cadre de vos propres données de télémétrie ou diagnostics.

window.navigator.mediaDevices['mmrClientVersion'];
window.navigator.mediaDevices['mmrHostVersion'];
window.navigator.mediaDevices['mmrExtensionVersion'];

window.navigator.mediaDevices['activityId'];
window.navigator.mediaDevices['connectionId'];

Voici ce que représente chaque propriété :

• mmrClientVersion : version du fichier MsMmrDVCPlugin.dll sur l’ordinateur local, qui fait partie de Windows App et de l’application Bureau à distance.

• mmrHostVersion : version du fichier MsMMRHost.exe installée sur l’hôte de session, le PC cloud ou la dev box.

• mmrExtensionVersion : version de l’extension Microsoft Multimedia Redirection en cours d’exécution dans le navigateur.

• activityId : identificateur unique utilisé par Microsoft pour associer la télémétrie à une session spécifique et mappé à la redirection multimédia de page web actuelle.

• connectionId : identificateur unique utilisé par Microsoft pour associer la télémétrie à une session spécifique et lié à la connexion donnée entre l’appareil local et la session à distance.

Toutes ces informations sont disponibles pour l’utilisateur final dans les détails de l’extension de navigateur, mais cet exemple fournit un moyen programmatique de les collecter.

Journaux de redirection des appels

Par défaut, la redirection multimédia ne se connecte pas à la console. L’extension de navigateur a un bouton pour permettre aux utilisateurs de collecter les journaux. L’exemple suivant montre comment activer les journaux de console par programmation. Vous souhaiterez peut-être activer les journaux de console par programmation si vous travaillez sur l’intégration ou capturez un problème qui nécessite des journaux d’exécution plus longs que l’option de l’interface d’extension de navigateur.

window.navigator.mediaDevices['mmrConsoleLoggingEnabled'] = true;

Vous pouvez également collecter par programme les journaux de redirection multimédia pour faciliter les investigations. Tous les journaux de la page web sont également disponibles en vous inscrivant à l’événement mmrExtensionLog sur le document.

L’objet d’événement a deux propriétés sous le détail :

• Niveau : indique le type de trace de l’entrée et vous permet de filtrer des événements spécifiques. Level est l’une des valeurs suivantes :

  • info
  • verbeux
  • warning
  • error

• Message : message de trace textuel.

L’exemple suivant montre comment s’inscrire à l’événement mmrExtensionLog :

document.addEventListener('mmrExtensionLog', () =>
    console.log("MMR event, level:" + event.detail.level + " : " + event.detail.message);
);

Soumettre votre site web pour révision ou demander de l’aide

Si vous représentez un éditeur de logiciels indépendant et que vous souhaitez ajouter votre site web à la liste des sites web pour la redirection d’appel, ou si vous avez besoin d’aide pour intégrer votre site web à la redirection d’appels, remplissez et envoyez ce formulaire.

Contenu connexe

En savoir plus sur la redirection multimédia pour la lecture vidéo et les appels dans une session à distance.