call-Ressourcentyp

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

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 app/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 eine Verbindung herstellen will, 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.
Delete	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.
Alle Teilnehmer stummschalten	commsOperation	Stummschalten aller Teilnehmer in dem Anruf.
Teilnehmer stummschalten	muteParticipantOperation	Stummschalten eines Teilnehmers im Gruppenanruf.
Konfigurieren von Audio-Mixer	commsOperation	Konfigurieren von Audio in der Unterhaltung mit mehreren Teilnehmern.
Create audioRoutingGroup	audioRoutingGroup	Erstellen Sie eine neue audioRoutingGroup, indem Sie sie an die audioRoutingGroups-Sammlung senden.
List audioRoutingGroups	audioRoutingGroup-Auflistung	Rufen Sie eine audioRoutingGroup-Objektsammlung ab.
Fügen Sie eine große Galerieansicht hinzu	addLargeGalleryViewOperation	Fügen Sie einem Anruf die große Galerieansicht hinzu.
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
activeModalities	„modality“-Auflistung	Die Liste der aktiven Modalitäten. Mögliche Werte: unknown, audio, video, videoBasedScreenSharing, data. Schreibgeschützt.
answeredBy	participantInfo	Der Teilnehmer, der den Anruf angenommen hat. Schreibgeschützt.
callRoutes	callRoute-Auflistung	Die Routinginformationen, wie der Anruf umgeleitet wurde. Schreibgeschützt.
callbackUri	Zeichenfolge	Die Rückruf-URL, über die Rückrufe zugestellt werden. Muss https sein.
callChainId	Zeichenfolge	Ein eindeutiger Bezeichner für alle Teilnehmeranrufe in einer Konferenz oder ein eindeutiger Bezeichner für zwei Teilnehmeranrufe in einem P2P-Anruf. Dies muss aus Microsoft.Graph.Call.CallChainId kopiert werden.
callOptions	outgoingCallOptions	Enthält die optionalen Features für den Anruf.
chatInfo	chatInfo	Die Chatinformationen. Erforderliche Informationen für Besprechungs-Szenarien.
direction	callDirection	Die Richtung des Anrufs. Die möglichen Werte sind: incoming oder outgoing. Schreibgeschützt.
id	Zeichenfolge	Die Anruf-ID. Schreibgeschützt.
incomingContext	incomingContext	Der einem eingehenden Anruf zugeordnete Kontext. Schreibgeschützt. Vom Server generiert.
mediaConfig	appHostedMediaConfig oder serviceHostedMediaConfig	Die Medienkonfiguration. Erforderliche Informationen zum Erstellen von Peer-to-Peer-Anrufen oder zur Teilnahme an Besprechungen.
mediaState	callMediaState	Schreibgeschützt. Der Aufruf des Medienstatus.
meetingCapability	meetingCapability	Enthält die Funktionen einer Besprechung. Schreibgeschützt.
meetingInfo	organizerMeetingInfo, tokenMeetingInfo oder joinMeetingIdMeetingInfo	Die Besprechungsinformationen. Erforderliche Informationen für Besprechungs-Szenarien.
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.
ringingTimeoutInSeconds	Int32	Timeout in Sekunden für Rufzeichen für ausgehende Peer-to-Peer-Anrufe. Der maximale Wert für dieses Attribut ist 115 Sekunden.
routingPolicies	routingPolicy-Sammlung	Diese Eigenschaft gilt nur für Peer-zu-Peer-Anrufe. Mögliche Werte sind: none, noMissedCall, disableForwardingExceptPhone, disableForwarding, preferSkypeForBusiness, unknownFutureValue.
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.
tenantId	Zeichenfolge	Schreibgeschützt. tenantId in Azure Active Directory.
terminationReason	Zeichenfolge	Schreibgeschützt.
toneInfo	toneInfo	Schreibgeschützt.

Beziehungen

Beziehung	Typ	Beschreibung
audioRoutingGroups	audioRoutingGroup-Auflistung	Schreibgeschützt. Nullwerte zulassend.
operations	commsOperation-Auflistung	Schreibgeschützt. Nullwerte zulassend.
participants	participant-Auflistung	Schreibgeschützt. Nullwerte zulassend.
contentSharingSessions	contentSharingSession-Sammlung	Schreibgeschützt. Nullwerte zulassend.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "activeModalities": ["unknown | audio | video | videoBasedScreenSharing | data"],
  "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": "incoming | outgoing",
  "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": ["unknown | audio | video | videoBasedScreenSharing | data"],
  "resultInfo": {"@odata.type": "#microsoft.graph.resultInfo"},
  "ringingTimeoutInSeconds": 99,
  "routingPolicies": ["none | noMissedCall | disableForwardingExceptPhone | disableForwarding | preferSkypeForBusiness"],
  "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"}],
  "tenantId": "String",
  "terminationReason": "String",
  "toneInfo": {"@odata.type": "#microsoft.graph.toneInfo"}
}