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