Vue d’ensemble de Rooms
Azure Communication Services fournit un concept de salle pour les développeurs qui créent des conversations structurées, comme des rendez-vous ou des événements virtuels. Les salles autorisent actuellement les appels vocaux et vidéo.
Voici les principaux scénarios où Rooms est utile :
- Les salles permettent une expérience de communication planifiée. Les plates-formes de service aident Rooms à fournir des expériences de réunion tout en étant toujours génériques pour un large éventail d’applications. Les services peuvent planifier et gérer des salles pour les patients recherchant des conseils médicaux, des planificateurs financiers travaillant avec des clients et des juristes fournissant des services juridiques.
- Les salles permettent une expérience sur invitation uniquement. Les salles permettent à vos services de contrôler quels utilisateurs peuvent rejoindre la salle pour un rendez-vous virtuel avec des médecins ou des conseillers financiers. Cela permet uniquement à un sous-ensemble d’utilisateurs disposant d’identités Communication Services affectées de rejoindre un appel de conférence.
- Les salles permettent des communications structurées via des rôles et des autorisations. Les salles permettent aux développeurs d’attribuer des rôles prédéfinis aux utilisateurs pour exercer un degré de contrôle et de structure plus élevé dans la communication. Assurez-vous que seuls les présentateurs peuvent parler et partager du contenu dans une grande réunion ou dans une conférence virtuelle.
- Ajoutez des participants PSTN. (Actuellement en préversion publique) Invitez les participants au réseau téléphonique commuté public (PSTN) à un appel à l’aide d’un numéro acheté via votre abonnement ou via le routage direct Azure vers votre contrôleur de frontière de session (SBC).
Quand utiliser Rooms
Utilisez des salles lorsque vous avez besoin de l’une des fonctionnalités suivantes :
- Contrôler les utilisateurs qui peuvent participer à des appels de salle.
- Besoin de fonctionnalités de planification/coordonnées qui sont activées et expirent à une heure et une date spécifiées.
- Besoin d’une communication structurée par le biais de rôles et d’autorisations pour les utilisateurs.
| Fonctionnalité | Appel individuel | Appel individuel avec ID éphémère |
Appel Rooms |
|---|---|---|---|
| Participants interactifs | 350 | 350 | 350 |
| ID éphémère à distribuer aux participants | ❌ | ✔️ (ID de groupe) |
✔️ (ID de salle) |
| Participation uniquement sur invitation | ❌ | ❌ | ✔️ |
| Possibilité d’appeler un utilisateur PSTN | ✔️ | ✔️ | ✔️ préversion publique |
| Sous-titres d’appel | ✔️ préversion privée |
✔️ préversion privée |
✔️ préversion privée |
| Enregistrement d’appels | ✔️ | ✔️ | ✔️ préversion publique |
| Tous les utilisateurs de la ressource de service de communication pour rejoindre un appel | ❌ | ✔️ | ✔️ |
| Définir la période de validité d’un appel | ❌ | ❌ | ✔️ Maximum six mois |
| Définir des rôles d’utilisateur et des autorisations pour un appel | ❌ | ❌ | ✔️ |
| API pour créer, supprimer, mettre à jour ou supprimer l’appel | ❌ | ❌ | ✔️ API Rooms |
Gestion des salles et participation aux appels de salle
L’API et le SDK Rooms permettent d’accomplir des actions telles que la création d’une salle, l’ajout de participants et la configuration de la planification, etc. Le SDK d’appel est utilisé pour lancer l’appel dans une salle du côté client. La plupart des actions disponibles dans les appels de groupe et individuels dans les SDK Calling sont également disponibles dans les appels Rooms. La liste complète des fonctionnalités offertes dans le SDK d’appel est disponible dans la Vue d’ensemble du kit SDK Appel.
| Fonctionnalité | SDK Calling | API/SDK Rooms |
|---|---|---|
| Rejoindre un appel Rooms avec la voix et la vidéo | ✔️ | ❌ |
| Répertorier les participants qui ont rejoint l’appel Rooms | ✔️ | ❌ |
| Autoriser/interdire l’appel d’un utilisateur PSTN au niveau de Virtual Rooms | Kit de développement logiciel (SDK) Virtual Rooms | |
| Créer une salle | ❌ | ✔️ |
| Répertorier les participants qui sont invités à la salle | ❌ | ✔️ |
| Démarrer, suspendre, arrêter l’enregistrement des appels | ✔️ | ❌ |
| Ajouter ou supprimer un participant VoIP | ❌ | ✔️ |
| Attribuer des rôles aux participants de la salle | ❌ | ✔️ |
L’image ci-dessous illustre le concept de gestion et de participation dans les salles.
API/SDK Virtual Rooms
Les salles sont créées et gérées par le biais d’API ou de SDK de salle. Utilisez les API/SDK Rooms dans votre application serveur pour les opérations room :
- Créer
- Modifier
- Supprimer
- Définir et mettre à jour la liste des participants
- Définir et modifier la validité de la salle
- Attribuez des rôles et des autorisations aux utilisateurs. Consultez les détails ci-dessous.
| Kit de développement logiciel (SDK) Virtual Rooms | Version | State |
|---|---|---|
| SDKs Virtual Rooms | 2023-06-14 | Généralement disponible, prise en charge complète |
| SDKs Virtual Rooms | 2023-10-30 | Préversion publique, prise en charge complète |
| SDKs Virtual Rooms | 2023-03-31 | Mise hors service prévue le 30 mai 2024 |
| SDKs Virtual Rooms | 01-02-2022 | Mise hors service prévue le 30 mai 2024 |
| SDKs Virtual Rooms | 2021-04-07 | Mise hors service prévue le 30 mai 2024 |
SDK d’appel
Utilisez les SDK d’appel pour rejoindre l’appel de salle. Vous pouvez rejoindre des appels de salle à l’aide des SDK d’appel web, iOS ou Android. Vous trouverez ici des exemples de démarrage rapide pour rejoindre des appels de salle.
Rooms est aussi accessible à partir de la bibliothèque d’interface utilisateur d’Azure Communication Services. La bibliothèque d’interface utilisateur permet aux développeurs d’ajouter un client d’appel activé pour Rooms dans leur application avec seulement quelques lignes de code.
Rôles et autorisations de participants prédéfinis
Les participants de salle peuvent être affectés à l’un des rôles suivants : Présentateur, Participant et Consommateur. Par défaut, un utilisateur est affecté à un rôle Participant si aucun autre rôle n’est affecté.
Les tableaux ci-dessous indiquent les fonctionnalités détaillées mappées aux rôles. À un niveau élevé, le rôle Présentateur dispose d’un contrôle total, les fonctionnalités des Participants sont limitées à l’audio et à la vidéo, tandis qu’un Consommateur ne peut recevoir que du contenu audio, vidéo et de partage d’écran.
| Fonctionnalité | Rôle : Présentateur | Rôle : Participant | Rôle : Consommateur |
|---|---|---|---|
| Contrôles durant l’appel | |||
| - Activer/désactiver la vidéo | ✔️ | ✔️ | ❌ |
| - Désactiver/réactiver le micro | ✔️ | ✔️ | ❌ |
| - Mettre en sourdine un utilisateur à distance | ✔️ | ❌ | ❌ |
| - Basculer entre les caméras | ✔️ | ✔️ | ❌ |
| - Intervenant actif | ✔️ | ✔️ | ✔️ |
| - Choisir un intervenant pour les appels | ✔️ | ✔️ | ✔️ |
| - Choisir le micro pour les appels | ✔️ | ✔️ | ❌ |
| - Afficher l’état des participants (inactif, connexion en cours, connecté, en attente, déconnexion en cours, déconnecté, etc.) | ✔️ | ✔️ | ✔️ |
| - Afficher l’état de l’appel (Médias préliminaires, Entrant, Connexion, Sonnerie, Connecté, Attente, Déconnexion, Déconnecté | ✔️ | ✔️ | ✔️ |
| - Montrer si le micro d’un participant est désactivé | ✔️ | ✔️ | ✔️ |
| - Afficher la raison pour laquelle un participant a quitté un appel | ✔️ | ✔️ | ✔️ |
| Partage d’écran | |||
| - Partage d’écran | ✔️ * | ❌ | ❌ |
| - Partager une application | ✔️ * | ❌ | ❌ |
| - Partage d’onglet de navigateur | ✔️ * | ❌ | ❌ |
| - Les participants peuvent afficher l’écran partagé | ✔️ | ✔️ | ✔️ |
| Gestion des listes | |||
| - Supprimer un participant | ✔️ | ❌ | ❌ |
| Gestion des appareils | |||
| - Demander l’autorisation d’utiliser l’audio et/ou la vidéo | ✔️ | ✔️ | ❌ |
| - Obtenir la liste des caméras | ✔️ | ✔️ | ❌ |
| - Définir la caméra | ✔️ | ✔️ | ❌ |
| - Obtenir la caméra sélectionnée | ✔️ | ✔️ | ❌ |
| - Obtenir la liste des micros | ✔️ * | ✔️ * | ❌ |
| - Définir le micro | ✔️ * | ✔️ * | ❌ |
| - Obtenir le micro sélectionné | ✔️ * | ✔️ * | ❌ |
| - Obtenir la liste des haut-parleurs | ✔️ * | ✔️ * | ✔️ * |
| - Définir le haut-parleur | ✔️ * | ✔️ * | ✔️ * |
| - Obtenir le haut-parleur sélectionné | ✔️ | ✔️ | ✔️ |
| Rendu vidéo | |||
| - Afficher une vidéo unique à de nombreux emplacements (caméra locale ou flux distant) | ✔️ | ✔️ | ✔️ (Uniquement à distance) |
| - Définir/mettre à jour le mode de mise à l’échelle vidéo | ✔️ | ✔️ | ✔️ (Uniquement à distance) |
| - Afficher un flux vidéo distant | ✔️ | ✔️ | ✔️ |
| Ajoutez des participants PSTN ** | |||
| - Contacter des participants par appel téléphonique | ✔️** | ❌ | ❌ |
* Disponible uniquement sur le SDK d’appel web. Non disponible sur les kits SDK d’appel iOS et Android
** Actuellement disponible en préversion publique.
Gestion des événements
Les événements d’appel vocal et vidéo publiés via Event Grid sont annotés avec des informations d’appel de salle.
- CallStarted est publié lorsqu’un appel de salle démarre.
- CallEnded est publié lorsqu’un appel de salle se termine.
- CallParticipantAdded est publié lorsqu’un nouveau participant rejoint un appel de salle.
- CallParticipantRemoved est publié lorsqu’un participant quitte un appel de salle.
Fonctionnalités déconseillées
Les préversions publiques antérieures de l’API Rooms prenait en charge deux configurations pour le contrôle de liste de salles, comme suit :
- Une salle « Invitation uniquement » qui permet uniquement aux utilisateurs invités de rejoindre l’appel Rooms.
- Une « Salle ouverte » qui est moins sécurisée. Dans la configuration de salle ouverte, tous les utilisateurs d’Azure Communication Services ont été autorisés à participer à un appel sans être explicitement invités par le biais de la liste de salles.
Le concept « Salle ouverte » est désormais déconseillé. À l’avenir, les salles « Invitation uniquement » seront le seul type de salle pris en charge.
Limites connues
- Pour le moment, les fonctionnalités d’automatisation des appels Azure Communication Services ne prennent pas en charge l’appel de salles.
Étapes suivantes :
- Utilisez le démarrage rapide pour créer, gérer et joindre une salle.
- Découvrez comment rejoindre un appel de salle.
- Examinez la configuration réseau requise pour le média et la signalisation.
- Analysez vos données de salle en consultant : Journaux des salles.
- Découvrez comment utiliser l’espace de travail Log Analytics en consultant : Tutoriel Log Analytics.
- Créez vos propres requêtes dans Log Analytics en consultant : Requêtes de démarrage.