Type de ressource Call

Article
10/30/2023

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

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 app/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, fournissez le chatInfo et meetingInfo. Si elles ne sont pas fournies, un nouvel appel de groupe est créé automatiquement. Pour un appel entrant, enregistrez ces valeurs dans une mémoire facilement accessible, de sorte que votre application puisse reprendre l'appel en cas de panne 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, une identité distincte doit être fournie pour que les clients 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"}

Méthodes

Méthode	Type renvoyé	Description
Obtenir	call	Lire les propriétés de l’objet call.
Delete	Aucun	Supprimer ou raccrocher un appel en cours.
KeepAlive	Aucun	Veillez à ce que l’appel reste actif.
Call Handling
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 participants	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 pour tous les participants	commsOperation	Désactivez le son de tous les participants dans l’appel.
Désactiver le son des Participants	muteParticipantOperation	Désactiver le son d’un participant lors de l’appel de groupe.
Create audioRoutingGroup	audioRoutingGroup	Créer un nouveau groupe audioRoutingGroup en postant dans la collection audioRoutingGroups.
Liste audioRoutingGroups	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.
Interactive-Voice-Response
PlayPrompt	playPromptOperation	Lire l’invite dans l’appel.
RecordResponse	recordOperation	Enregistre une courte réponse audio de l’appelant.
CancelMediaProcessing	commsOperation	Annuler le traitement du média.
SubscribeToTone	commsOperation	Abonnement aux tonalités DTMF.
SendDtmfTones	commsOperation	Envoyer des tonalités DTMF dans un appel.
Self Participant Operations
Mute	muteParticipantOperation	Désactivez le son pour soi-même dans l’appel.
Unmute	unmuteParticipantOperation	Réactivez le son pour soi-même dans l’appel.
ChangeScreenSharingRole	Aucun	Démarrer et arrêter le partage d’écran dans l’appel.
Opérations d’enregistrement
UpdateRecordingStatus	updateRecordingStatusOperation	Met à jour le statut de l’enregistrement.
Opérations de journalisation
Enregistrer les données de qualité des appareils	teleconferenceDeviceQuality	Enregistrez les données de qualité d’un appareil de téléconférence vidéo.

Propriétés

Propriété	Type	Description
activeModalities	collection de modalités	Liste des modalités actives. Les valeurs possibles sont les suivantes : `unknown`, `audio`, `video`, `videoBasedScreenSharing`, `data`. En lecture seule.
answeredBy	participantInfo	Le participant qui répond à l’appel. En lecture seule.
callRoutes	callRoute collection de sites	Les informations de routage sur la manière dont l’appel a été reciblé. En lecture seule.
callbackUri	String	L’URL de rappel vers laquelle les rappels seront remis. Doit être `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. Il doit être copié depuis `Microsoft.Graph.Call.CallChainId`.
callOptions	outgoingCallOptions	Contient les fonctionnalités facultatives de l’appel.
chatInfo	chatInfo	Informations de chat. Informations requises pour les scénarios de réunion.
direction	callDirection	Direction de l’appel. Les valeurs possibles sont `incoming` ou `outgoing`. En lecture seule.
id	String	ID de l’appel. En lecture seule.
incomingContext	incomingContext	Le contexte associé à un appel entrant. Lecture seule. Généré par le server.
mediaConfig	appHostedMediaConfig ou serviceHostedMediaConfig	Configuration du média. Informations requises pour la création d’appels d’égal à égal ou pour la participation à des réunions.
mediaState	callMediaState	En lecture seule. État du support d’appel.
meetingCapability	meetingCapability	Contient les fonctionnalités d’une réunion. En lecture seule.
meetingInfo	organizerMeetingInfo, tokenMeetingInfo, ou joinMeetingIdMeetingInfo	Informations de réunion. Informations requises pour les scénarios de réunion.
transcription	callTranscriptionInfo	Informations de la transcription pour l’appel. En lecture seule.
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. En lecture seule.
ringingTimeoutInSeconds	Int32	Délai d’expiration en attente en secondes pour les appels d’égal à égal sortants. La valeur maximale pour cet attribut est de 115 secondes.
routingPolicies	collection routingPolicy	Cette propriété est applicable pour les appels d’égal à égal uniquement. Les valeurs possibles sont : `none`, `noMissedCall`, `disableForwardingExceptPhone`, `disableForwarding`, `preferSkypeForBusiness`, `unknownFutureValue`.
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.
tenantId	Chaîne	En lecture seule. `tenantId`dans Microsoft Entra ID.
terminationReason	Chaîne	En lecture seule.
toneInfo	toneInfo	En lecture seule.

Relations

Relation	Type	Description
audioRoutingGroups	CollectionaudioRoutingGroup	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.
contentSharingSessions	collection contentSharingSession	En lecture seule. Pouvant accepter la valeur Null.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "activeModalities": ["String"],
  "answeredBy": {"@odata.type": "#microsoft.graph.participantInfo"},
  "callRoutes": [{"@odata.type": "#microsoft.graph.callRoute"}],
  "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)",
  "incomingContext": {"@odata.type": "#microsoft.graph.incomingContext"},
  "mediaConfig": {"@odata.type": "#microsoft.graph.mediaConfig"},
  "mediaState": {"@odata.type": "#microsoft.graph.callMediaState"},
  "meetingCapability": {"@odata.type": "#microsoft.graph.meetingCapability"},
  "meetingInfo": {"@odata.type": "#microsoft.graph.meetingInfo"},
  "transcription": {"@odata.type": "#microsoft.graph.callTranscriptionInfo"},
  "myParticipantId": "String",
  "replacesContext": "String",
  "requestedModalities": ["String"],
  "resultInfo": {"@odata.type": "#microsoft.graph.resultInfo"},
  "ringingTimeoutInSeconds": 99,
  "routingPolicies": ["String"],
  "source": {"@odata.type": "#microsoft.graph.participantInfo"},
  "state": "String",
  "subject": "String",
  "targets": [{"@odata.type": "#microsoft.graph.invitationParticipantInfo"}],
  "tenantId": "String",
  "terminationReason": "String",
  "toneInfo": {"@odata.type": "#microsoft.graph.toneInfo"}
}