Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Пространство имен: microsoft.graph
Важно!
API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Ресурс вызова создается, когда есть входящий вызов для приложения или приложение создает новый исходящий вызов через POST в app/calls.
Вызовы можно настраивать как одноранговые или групповые вызовы. Чтобы создать или присоединиться к групповому вызову, укажите chatInfo и meetingInfo. Если они не предоставляются, автоматически создается новый групповой вызов. Для входящих вызовов записывайте эти значения в высокодоступном хранилище, чтобы приложение повторно присоединилось к вызову в случае своего сбоя.
Хотя одно и то же удостоверение не может быть приглашено несколько раз, приложение может присоединиться к одному и тому же собранию несколько раз. При каждой попытке приложения присоединиться должно предоставляться отдельное удостоверение, чтобы клиенты отображали их как отдельных участников.
Примечание. URL-адрес для присоединения можно получить из собрания, запланированного с помощью #REF!. Извлеките данные из 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"}
Примечание.
С этим ресурсом связаны следующие известные проблемы:
- Исключение обработки сообщений веб-перехватчика: System.Security.Cryptography.CryptographicException
- Отсутствует поддержка варианта использования нескольких конечных точек в режиме уведомлений разностного списка
- Несогласованный записанный номер участника отображается в клиенте teams при включенной группировке ботов
Методы
| Метод | Возвращаемый тип | Описание |
|---|---|---|
| Создание | 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 | Обновление состояния записи. |
| Запуск записи | startRecordingOperation | Начинает запись звонка. |
| Остановка записи | stopRecordingOperation | Останавливает запись вызова. |
| Начало транскрибирования | startTranscriptionOperation | Начинает транскрибирование вызова. |
| Остановить транскрибирование | stopTranscriptionOperation | Останавливает транскрибирование вызова. |
| Операции ведения журнала | ||
| Запись данных о качестве устройств телеконференции | 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"}
}