Type de ressource Call

  • Article

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 chatInfo et meetingInfo.

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"},
}