call-Ressourcentyp

Namespace: microsoft.graph

Die call-Ressource wird erstellt, wenn es einen eingehenden Anruf für die Anwendung gibt oder die Anwendung einen neuen ausgehenden Anruf über POST in communications/calls erstellt.

Anrufe können als Peer-to-Peer-Anruf oder als Gruppenanruf eingerichtet werden. Geben Sie zum Erstellen oder Beitreten eines Gruppenanrufs chatInfo und meetingInfo an. Wenn Sie diese Informationen nicht angeben, wird automatisch ein Gruppenanruf erstellt. Zeichnen Sie diese Werte für einen eingehenden Anruf in einem hoch verfügbaren Speicher auf, damit die Anwendung dem Anruf erneut beitreten kann, falls sie abstürzt.

Dieselbe Identität kann zwar nicht mehrere Male verwendet werden, eine Anwendung kann aber derselben Besprechung mehrere Male beitreten. Jedes Mal, wenn die Anwendung einem Anruf beitreten möchte, muss eine eigene Identität bereitgestellt werden, damit die Clients sie als unterschiedliche Teilnehmer anzeigen können.

Hinweis: In einer mit Microsoft Teams geplanten Besprechung können Sie die Teilnahme-URL erhalten. Extrahieren Sie die Daten aus der URL wie dargestellt, um chatInfo und meetingInfo aufzufüllen.

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

Wird zu:

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

Methoden

Methode	Rückgabetyp	Beschreibung
Get	call	Lesen der Eigenschaften des call-Objekts.
Löschen	Keine	Löschen oder Auflegen eines aktiven Anrufs.
KeepAlive	Keine	Sicherstellen, dass der Anruf aktiv bleibt.
Anrufverarbeitung
Answer	Keine	Beantworten eines eingehenden Anrufs.
Reject	Keine	Ablehnen eines eingehenden Anrufs.
Redirect	Keine	Umleiten eines eingehenden Anrufs.
Transfer	Keine	Anruf weiterleiten
Gruppenanrufe
List participants	participant-Auflistung	Abrufen einer Auflistung von Teilnehmerobjekten.
Einladen von Teilnehmern	commsOperation	Einladen von Teilnehmern zum aktiven Anruf.
Teilnehmer stummschalten	muteParticipantOperation	Stummschalten eines Teilnehmers im Gruppenanruf.
Interactive-Voice-Response
PlayPrompt	playPromptOperation	Wiedergabeaufforderung in dem Anruf.
RecordResponse	recordOperation	Zeichnet eine kurze Audioantwort vom Anrufer auf.
CancelMediaProcessing	commsOperation	Abbrechen der Medienverarbeitung.
SubscribeToTone	commsOperation	Abonnieren von DTMF-Tönen.
Self Participant Operations
Mute	muteParticipantOperation	Sich selbst stummschalten in dem Anruf.
Unmute	unmuteParticipantOperation	Stummschaltung für sich selbst in dem Anruf aufheben.
ChangeScreenSharingRole	Keine	Starten und Beenden der Bildschirmübertragung in dem Anruf.
Aufzeichnungsvorgänge
UpdateRecordingStatus	updateRecordingStatusOperation	Aktualisiert den Aufzeichnungsstatus.
Protokollierungsvorgänge
Protokollieren von Gerätequalitätsdaten	teleconferenceDeviceQuality	Zeichnet Qualitätsdaten von Videokonferenzgeräten auf.

Eigenschaften

Eigenschaft	Typ	Beschreibung
callbackUri	Zeichenfolge	Die Rückruf-URL, zu der Rückrufe zugestellt werden. Muss https sein.
callChainId	Zeichenfolge	Ein eindeutiger Bezeichner für alle Teilnehmer in einer Konferenz oder ein eindeutiger Bezeichner für zwei Teilnehmer in einem P2P-Anruf. Dieser muss aus Microsoft.Graph.Call.CallChainId kopiert werden.
callRoutes	callRoute-Auflistung	Die Routinginformationen, wie der Anruf umgeleitet wurde. Schreibgeschützt.
chatInfo	chatInfo	Die Chatinformationen. Erforderliche Informationen für die Teilnahme an einer Besprechung.
direction	callDirection	Die Richtung des Anrufs. Die möglichen Werte sind: incoming oder outgoing. Schreibgeschützt.
id	Zeichenfolge	Die Anruf-ID. Schreibgeschützt.
mediaConfig	appHostedMediaConfig oder serviceHostedMediaConfig	Die Medienkonfiguration. Erforderlich.
mediaState	callMediaState	Schreibgeschützt. Der Aufruf des Medienstatus.
meetingInfo	organizerMeetingInfo oder tokenMeetingInfo	Die erforderlichen Besprechungsinformationen, um an einer Besprechung teilzunehmen.
Transkription	callTranscriptionInfo	Die Transkriptionsinformationen für den Anruf. Schreibgeschützt.
myParticipantId	Zeichenfolge	Schreibgeschützt.
requestedModalities	„modality“-Auflistung	Die Liste der angeforderten Modalitäten. Mögliche Werte: unknown, audio, video, videoBasedScreenSharing, data.
resultInfo	resultInfo	Die Ergebnisinformationen. Kann beispielsweise einen Grund für die Beendigung enthalten. Schreibgeschützt.
source	participantInfo	Ursprung des Anrufs.
state	callState	Der Anrufstatus. Mögliche Werte: incoming, establishing, ringing, established, hold, transferring, transferAccepted, redirecting, terminating, terminated. Schreibgeschützt.
subject	Zeichenfolge	Der Betreff der Unterhaltung.
targets	Sammlung invitationParticipantInfo	Die Ziele des Anrufs. Erforderliche Informationen für das Erstellen von Peer-to-Peer-Anrufen.
toneInfo	toneInfo	Schreibgeschützt.
incomingContext	incomingContext	Kontext, der einem eingehenden Anruf zugeordnet ist.

Beziehungen

Beziehung	Typ	Beschreibung
operations	commsOperation-Auflistung	Schreibgeschützt. Nullwerte zulassend.
participants	participant-Auflistung	Schreibgeschützt. Nullwerte zulassend.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "callbackUri": "String",
  "callChainId": "String",
  "chatInfo": {"@odata.type": "#microsoft.graph.chatInfo"},
  "direction": "incoming | outgoing",
  "id": "String (identifier)",
  "mediaConfig": {"@odata.type": "#microsoft.graph.mediaConfig"},
  "mediaState": {"@odata.type": "#microsoft.graph.callMediaState"},
  "meetingInfo": {"@odata.type": "#microsoft.graph.meetingInfo"},  
  "transcription": {"@odata.type": "#microsoft.graph.callTranscriptionInfo"},
  "myParticipantId": "String",
  "replacesContext": "String",
  "requestedModalities": ["unknown | audio | video | videoBasedScreenSharing | data"],
  "resultInfo": {"@odata.type": "#microsoft.graph.resultInfo"},
  "source": {"@odata.type": "#microsoft.graph.participantInfo"},
  "state": "incoming | establishing | ringing | established | hold | transferring | transferAccepted | redirecting | terminating | terminated",
  "subject": "String",
  "targets": [{"@odata.type": "#microsoft.graph.invitationParticipantInfo"}],
  "toneInfo": {"@odata.type": "#microsoft.graph.toneInfo"}
}