call-Ressourcentyp

Artikel
10/30/2023

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Die Anrufressource wird erstellt, wenn ein eingehender Anruf für die Anwendung erfolgt, oder die Anwendung erstellt einen neuen ausgehenden Anruf über einen POST für app/calls.

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 diese nicht angegeben werden, wird automatisch ein neuer Gruppenaufruf 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.

Obwohl dieselbe Identität nicht mehrmals eingeladen werden kann, ist es möglich, dass eine Anwendung mehrmals an derselben Besprechung teilnimmt. 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.
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.
SendDtmfTones	commsOperation	Senden von DTMF-Tönen in einem Anruf.
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, 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.
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 Kontext, der einem eingehenden Anruf zugeordnet ist. Schreibgeschützt. Vom Server generiert.
mediaConfig	appHostedMediaConfig oder serviceHostedMediaConfig	Die Medienkonfiguration. Erforderliche Informationen für das Erstellen von Peer-to-Peer-Anrufen oder zum Beitreten zu 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. Das Ergebnis kann z. B. den Beendigungsgrund 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-to-Peer-Anrufe. Mögliche Werte sind: `none`, `noMissedCall`, `disableForwardingExceptPhone`, `disableForwarding`, `preferSkypeForBusiness` und `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 Microsoft Entra ID.
terminationReason	Zeichenfolge	Schreibgeschützt.
toneInfo	toneInfo	Schreibgeschützt.

Beziehungen

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

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

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