call-Ressourcentyp
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
chatInfoundmeetingInfoaufzufü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"}
Hinweis
Die folgenden bekannten Probleme sind mit dieser Ressource verbunden:
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| Create | call | Mit "Anruf erstellen" kann Ihr Bot einen neuen ausgehenden Peer-to-Peer- oder Gruppenanruf erstellen oder an einer vorhandenen Besprechung teilnehmen. |
| Get | call | Lesen der Eigenschaften des call-Objekts. |
| Löschen/Auflegen | Keine | Löschen oder Auflegen eines aktiven Anrufs. |
| Am Leben bleiben | 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 | 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 | Erstellen Sie eine neue audioRoutingGroup, indem Sie sie an die audioRoutingGroups-Sammlung senden. |
| Auflisten von Audioroutinggruppen | 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 | ||
| Aufforderung wiedergeben | playPromptOperation | Wiedergabeaufforderung in dem Anruf. |
| Datensatzantwort | recordOperation | Zeichnet eine kurze Audioantwort vom Anrufer auf. |
| Medienverarbeitung abbrechen | commsOperation | Abbrechen der Medienverarbeitung. |
| Ton abonnieren | commsOperation | Abonnieren von DTMF-Tönen. |
| DTMF-Ton senden | commsOperation | Senden von DTMF-Tönen in einem Anruf. |
| Selbstteilnehmervorgänge | ||
| Anwendung stummschalten | muteParticipantOperation | Sich selbst stummschalten in dem Anruf. |
| Stummschaltung der Anwendung aufheben | unmuteParticipantOperation | Stummschaltung für sich selbst in dem Anruf aufheben. |
| Rolle „Bildschirmfreigabe“ ändern | Keine | Starten und Beenden der Bildschirmübertragung in dem Anruf. |
| Aufzeichnungsvorgänge | ||
| Aufzeichnungsstatus aktualisieren | updateRecordingStatusOperation | Aktualisiert den Aufzeichnungsstatus. |
| Protokollierungsvorgänge | ||
| Protokollieren von Daten zur Qualität des Telekonferenzgeräts | 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 veranschaulicht 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",
"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"},
}