Type de ressource Call
Espace de noms: microsoft.graph
La ressource d’appel est créée lorsqu’il y a un appel entrant pour l’application ou que l’application crée un nouvel appel sortant via un POST sur communications/calls.
Les appels peuvent être configurés en tant qu'appel de réseau pair à pair ou en tant qu'appel de groupe. Pour créer ou rejoindre un appel de groupe, indiquez et chatInfomeetingInfo. Si ces valeurs ne sont pas fournies, un nouvel appel de groupe est créé automatiquement. Pour un appel entrant, enregistrez ces valeurs dans un magasin hautement disponible afin que votre application puisse rejoindre l’appel en cas de blocage de votre application.
Bien que la même identité ne puisse pas être invitée plusieurs fois, il est possible pour une application de rejoindre la même réunion plusieurs fois. Chaque fois que l’application souhaite participer à un appel, une identité distincte est nécessaire pour que chaque client l’affiche en tant qu’autre participant.
Remarque : vous pouvez obtenir l’URL de participation d’un appel de réunion planifiée avec Microsoft Teams. Extraire les données de l’URL comme indiqué pour compléter
chatInfoetmeetingInfo.
https://teams.microsoft.com/l/meetup-join/19%3ameeting_NTg0NmQ3NTctZDVkZC00YzRhLThmNmEtOGQ3M2E0ODdmZDZk%40thread.v2/0?context=%7b%22Tid%22%3a%2272f988bf-86f1-41af-91ab-2d7cd011db47%22%2c%22Oid%22%3a%224b444206-207c-42f8-92a6-e332b41c88a2%22%7d
Devient :
https://teams.microsoft.com/l/meetup-join/19:meeting_NTg0NmQ3NTctZDVkZC00YzRhLThmNmEtOGQ3M2E0ODdmZDZk@thread.v2/0?context={"Tid":"72f988bf-86f1-41af-91ab-2d7cd011db47","Oid":"4b444206-207c-42f8-92a6-e332b41c88a2"}
Remarque
Les problèmes connus suivants sont associés à cette ressource :
Méthodes
| Méthode | Type renvoyé | Description |
|---|---|---|
| Créer | Appel | Créer un appel permet à votre bot de créer un nouvel appel d’égal à égal ou de groupe sortant, ou de rejoindre une réunion existante. |
| Obtenir | call | Lire les propriétés de l’objet call. |
| Supprimer/raccrocher | Aucun | Supprimer ou raccrocher un appel en cours. |
| Garder en vie | Aucun | Veillez à ce que l’appel reste actif. |
| Gestion des appels | ||
| Answer | Aucun | Répondre à un appel entrant. |
| Reject | Aucun | Rejeter un appel entrant. |
| Redirect | Aucun | Rediriger un appel entrant. |
| Transfer | Aucun | Transférer un appel |
| Appels de groupe | ||
| List | Liste de participants | Récupérer une collection d’objets participant. |
| Inviter les participants | commsOperation | Inviter des participants à l’appel en cours. |
| Désactiver le son des Participants | muteParticipantOperation | Désactiver le son d’un participant lors de l’appel de groupe. |
| Create | audioRoutingGroup | Créer un nouveau groupe audioRoutingGroup en postant dans la collection audioRoutingGroups. |
| Répertorier les groupes de routage audio | CollectionaudioRoutingGroup | Récupérer une collection d’objet audioRoutingGroup. |
| Ajouter une vue de galerie volumineuse | addLargeGalleryViewOperation | Ajoutez la vue de la grande galerie à un appel. |
| Réponse vocale interactive | ||
| Lire une invitation | playPromptOperation | Lire l’invite dans l’appel. |
| Enregistrer la réponse | recordOperation | Enregistre une courte réponse audio de l’appelant. |
| Annuler le traitement multimédia | commsOperation | Annuler le traitement du média. |
| S’abonner à la tonalité | commsOperation | Abonnement aux tonalités DTMF. |
| Envoyer la tonalité DTMF | commsOperation | Envoyer des tonalités DTMF dans un appel. |
| Opérations auto-participantes | ||
| Désactiver le son de l’application | muteParticipantOperation | Désactivez le son pour soi-même dans l’appel. |
| Activer l’application | unmuteParticipantOperation | Réactivez le son pour soi-même dans l’appel. |
| Changer de rôle partage écran | Aucun | Démarrer et arrêter le partage d’écran dans l’appel. |
| Opérations d’enregistrement | ||
| Mettre à jour les status d’enregistrement | updateRecordingStatusOperation | Met à jour le statut de l’enregistrement. |
| Opérations de journalisation | ||
| Journaliser les données de qualité des appareils de téléconférence | teleconferenceDeviceQuality | Enregistrez les données de qualité d’un appareil de téléconférence vidéo. |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| callbackUri | Chaîne | URL de rappel sur laquelle les rappels sont remis. Doit être une URL HTTPS. |
| callChainId | Chaîne | Identificateur unique de tous les appels de participants dans une conférence ou un identificateur unique pour deux appels de participants dans un appel P2P. Cet identificateur doit être copié à partir de Microsoft.Graph.Call.CallChainId. |
| callOptions | outgoingCallOptions | Contient les fonctionnalités facultatives de l’appel. |
| callRoutes | callRoute collection de sites | Les informations de routage sur la manière dont l’appel a été reciblé. Lecture seule. |
| chatInfo | chatInfo | Informations de chat. Informations requises pour participer à une réunion. |
| direction | callDirection | Direction de l’appel. Les valeurs possibles sont incoming ou outgoing. En lecture seule. |
| id | Chaîne | Identificateur unique de l’appel. En lecture seule. |
| incomingContext | incomingContext | Contexte d’appel associé à un appel entrant. |
| mediaConfig | appHostedMediaConfig ou serviceHostedMediaConfig | Configuration du média. Obligatoire. |
| mediaState | callMediaState | En lecture seule. État du support d’appel. |
| meetingInfo | organizerMeetingInfo, tokenMeetingInfo, ou joinMeetingIdMeetingInfo | Informations de réunion. Informations requises pour les scénarios de réunion. |
| myParticipantId | Chaîne | En lecture seule. |
| requestedModalities | collection de modalités | Liste des modalités demandées. Les valeurs possibles sont les suivantes : unknown, audio, video, videoBasedScreenSharing, data. |
| resultInfo | resultInfo | Informations résultat. Par exemple, le résultat peut contenir la raison de l’arrêt. Lecture seule. |
| source | participantInfo | L’émetteur de l’appel. |
| état | callState | État de l'appel. Les valeurs possibles sont les suivantes : incoming, establishing, ringing, established, hold, transferring, transferAccepted, redirecting, terminating et terminated. En lecture seule. |
| subject | Chaîne | Objet de la conversation. |
| cibles | Collection invitationParticipantInfo | Cibles de l’appel. Informations requises pour la création d’appels d’égal à égal. |
| toneInfo | toneInfo | En lecture seule. |
| transcription | callTranscriptionInfo | Informations de la transcription pour l’appel. En lecture seule. |
Relations
| Relation | Type | Description |
|---|---|---|
| contentSharingSessions | collection contentSharingSession | En lecture seule. Peut avoir la valeur Null. |
| operations | Collecte commsOperation | En lecture seule. Pouvant accepter la valeur Null. |
| participants | Liste de participants | En lecture seule. Pouvant accepter la valeur Null. |
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"callbackUri": "String",
"callChainId": "String",
"callOptions": {"@odata.type": "#microsoft.graph.outgoingCallOptions"},
"chatInfo": {"@odata.type": "#microsoft.graph.chatInfo"},
"contentSharingSessions": [{ "@odata.type": "microsoft.graph.contentSharingSession" }],
"direction": "String",
"id": "String (identifier)",
"mediaConfig": {"@odata.type": "#microsoft.graph.mediaConfig"},
"mediaState": {"@odata.type": "#microsoft.graph.callMediaState"},
"meetingInfo": {"@odata.type": "#microsoft.graph.meetingInfo"},
"myParticipantId": "String",
"requestedModalities": ["String"],
"resultInfo": {"@odata.type": "#microsoft.graph.resultInfo"},
"source": {"@odata.type": "#microsoft.graph.participantInfo"},
"state": "String",
"subject": "String",
"targets": [{"@odata.type": "#microsoft.graph.invitationParticipantInfo"}],
"toneInfo": {"@odata.type": "#microsoft.graph.toneInfo"},
"transcription": {"@odata.type": "#microsoft.graph.callTranscriptionInfo"},
}