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 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.
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 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 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.
Réponse vocale interactive
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.
Opérations auto-participantes
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
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",  
  "replacesContext": "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"},
}