call-Ressourcentyp

  • Artikel

Namespace: microsoft.graph

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 communications/calls.

Anrufe können als Peer-to-Peer-Anruf oder als Gruppenanruf eingerichtet werden. Um einen Gruppenanruf zu erstellen oder einem Gruppenanruf beizutreten, geben Sie und an chatInfomeetingInfo. Wenn diese Werte nicht angegeben werden, wird automatisch ein neuer Gruppenaufruf erstellt. Zeichnen Sie diese Werte für einen eingehenden Anruf in einem hochverfügbaren Speicher auf, damit Ihre Anwendung dem Anruf erneut beitreten kann, wenn Ihre Anwendung 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 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.
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.
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.
Selbstteilnehmervorgänge
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, an die Rückrufe übermittelt werden. Muss eine HTTPS-URL 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 Bezeichner muss aus Microsoft.Graph.Call.CallChainIdkopiert werden.
callOptions outgoingCallOptions Enthält die optionalen Features für den Anruf.
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 String Der eindeutige Bezeichner für den Aufruf. Schreibgeschützt.
incomingContext incomingContext Kontext, der einem eingehenden Anruf zugeordnet ist.
mediaConfig appHostedMediaConfig oder serviceHostedMediaConfig Die Medienkonfiguration. Erforderlich.
mediaState callMediaState Schreibgeschützt. Der Aufruf des Medienstatus.
meetingInfo organizerMeetingInfo, tokenMeetingInfo oder joinMeetingIdMeetingInfo Die Besprechungsinformationen. Erforderliche Informationen für Besprechungs-Szenarien.
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.
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.
Transkription callTranscriptionInfo Die Transkriptionsinformationen für den Anruf. Schreibgeschützt.

Beziehungen

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

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

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