Тип ресурса call
Пространство имен: microsoft.graph
Ресурс вызова создается, когда есть входящий вызов для приложения или приложение создает новый исходящий вызов через POST в communications/calls.
Вызовы можно настраивать как одноранговые или групповые вызовы. Чтобы создать групповой вызов или присоединиться к нему, укажите chatInfo и meetingInfo. Если эти значения не заданы, автоматически создается новый групповой вызов. При входящем вызове запишите эти значения в хранилище с высоким уровнем доступности, чтобы приложение ранее ранее запустите вызов в случае сбоя приложения.
Хотя одно и то же удостоверение не может быть приглашено несколько раз, приложение может присоединиться к одному и тому же собранию несколько раз. При каждой попытке приложения присоединиться к вызову должно предоставляться отдельное удостоверение, чтобы клиенты отображали их как отдельных участников.
Примечание. URL-адрес для присоединения можно получить из собрания, запланированного с помощью Microsoft Teams. Извлеките данные из URL-адреса, как показано, чтобы заполнить свойства
chatInfoиmeetingInfo.
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
преобразуется в:
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"}
Примечание.
С этим ресурсом связаны следующие известные проблемы:
Методы
| Метод | Возвращаемый тип | Описание |
|---|---|---|
| Создание | call | Создать вызов позволяет боту создать новый исходящий одноранговый или групповой вызов или присоединиться к существующему собранию. |
| получение; | call | Чтение свойств объекта call. |
| Удаление/разрыв связи | Нет | Удаление или разрыв активного вызова. |
| Сохранение активности | Нет | Проверка, что вызов остается активным. |
| Обработка вызовов | ||
| Ответ | Нет | Ответ на входящий вызов. |
| Reject | Нет | Отклонение входящего вызова. |
| Redirect | Нет | Перенаправление входящего вызова. |
| Перевод | Нет | Переключение звонка |
| Групповые вызовы | ||
| List | Коллекция participant | Получение коллекции объектов. |
| Приглашение участников | commsOperation | Приглашение участников в активный вызов. |
| Отключение звука участника | muteParticipantOperation | Отключение звука участника в групповом вызове. |
| Создание | audioRoutingGroup | Создание нового объекта audioRoutingGroup путем публикации в коллекции audioRoutingGroups. |
| Список групп маршрутизации звука | Коллекция audioRoutingGroup | Получение коллекции объектов audioRoutingGroup. |
| Добавление представления "Большая галерея" | addLargeGalleryViewOperation | Добавление представления "Большая галерея" в вызов. |
| Интерактивный голосовой ответ | ||
| Воспроизведение запроса | playPromptOperation | Воспроизведение запроса в вызове. |
| Запись ответа | recordOperation | Запись короткого голосового ответа звонящего. |
| Отмена обработки мультимедиа | commsOperation | Отмена обработки мультимедиа. |
| Подписка на гудок | commsOperation | Подписка на тоны DTMF. |
| Отправка сигнала DTMF | commsOperation | Отправка тонов DTMF в вызове. |
| Операции с самостоятельным участником | ||
| Отключение звука приложения | muteParticipantOperation | Отключение своего звука в вызове. |
| Отключение приложения | unmuteParticipantOperation | Включение своего звука в звонке. |
| Изменение роль совместного использования экрана | Нет | Начало и прекращение демонстрации экрана в звонке. |
| Запись операций | ||
| Обновление состояния записи | updateRecordingStatusOperation | Обновление состояния записи. |
| Операции ведения журнала | ||
| Запись данных о качестве устройств телеконференции | teleconferenceDeviceQuality | Запись в журнал данных о качестве устройств для видеоконференций. |
Свойства
| Свойство | Тип | Описание |
|---|---|---|
| callbackUri | String | URL-адрес обратного вызова, по которому выполняются обратные вызовы. Должен быть URL-адресом HTTPS. |
| callChainId | String | Уникальный идентификатор всех звонков участника конференции или уникальный идентификатор двух звонков участника в звонке P2P. Этот идентификатор должен быть скопирован из Microsoft.Graph.Call.CallChainId. |
| callOptions | outgoingCallOptions | Содержит необязательные функции для вызова. |
| callRoutes | Коллекция callRoute | Сведения маршрутизации о том, как был перенаправлен вызов. Только для чтения. |
| chatInfo | chatInfo | Сведения о чате. Сведения, необходимые для присоединения к собранию. |
| direction | callDirection | Направление вызова. Возможные значения: incoming или outgoing. Только для чтения. |
| id | String | Уникальный идентификатор для вызова. Только для чтения. |
| incomingContext | incomingContext | Контекст звонка, связанный с входящим звонком. |
| mediaConfig | appHostedMediaConfig или serviceHostedMediaConfig | Настройка мультимедиа. Обязательно. |
| mediaState | callMediaState | Только для чтения. Состояние мультимедиа компонентов вызова. |
| meetingInfo | organizerMeetingInfo, tokenMeetingInfo или joinMeetingIdMeetingInfo | Сведения о собрании. Обязательные сведения для сценариев собраний. |
| myParticipantId | String | Только для чтения. |
| requestedModalities | Коллекция modality | Список запрошенных модальностей. Возможные значения: unknown, audio, video, videoBasedScreenSharing, data. |
| resultInfo | resultInfo | Сведения о результате. Например, результат может содержать причину завершения. Только для чтения. |
| source | participantInfo | Создатель вызова. |
| state | callState | Состояние вызова. Возможные значения: incoming, establishing, ringing, established, hold, transferring, transferAccepted, redirecting, terminating, terminated. Только для чтения. |
| subject | String | Тема беседы. |
| targets | Коллекция invitationParticipantInfo | Целевые объекты вызова. Обязательные сведения для создания одноранговых вызовов. |
| toneInfo | toneInfo | Только для чтения. |
| transcription | callTranscriptionInfo | Сведения расшифровки для звонка. Только для чтения. |
Связи
| Связь | Тип | Описание |
|---|---|---|
| contentSharingSessions | Коллекция contentSharingSession | Только для чтения. Допускается значение null. |
| operations | Коллекция commsOperation | Только для чтения. Допускается значение null. |
| participants | Коллекция participant | Только для чтения. Допускается значение null. |
Представление JSON
В следующем представлении JSON показан тип ресурса.
{
"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"},
}