Тип ресурса 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. |
Удаление/разрыв связи | Нет | Удаление или разрыв активного вызова. |
Сохранение активности | Нет | Проверка, что вызов остается активным. |
Обработка вызовов | ||
Ответ | Нет | Ответ на входящий вызов. |
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"},
}