Тип ресурса 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.
Удаление Нет Удаление или разрыв активного вызова.
KeepAlive Нет Проверка, что вызов остается активным.
Обработка вызовов
Ответ Нет Ответ на входящий вызов.
Reject Нет Отклонение входящего вызова.
Redirect Нет Перенаправление входящего вызова.
Перевод Нет Переключение звонка
Групповые вызовы
Перечисление участников Коллекция participant Получение коллекции объектов.
Приглашение участников commsOperation Приглашение участников в активный вызов.
Отключение звука участника muteParticipantOperation Отключение звука участника в групповом вызове.
Создание объекта audioRoutingGroup audioRoutingGroup Создание нового объекта audioRoutingGroup путем публикации в коллекции audioRoutingGroups.
Перечисление AudioRoutingGroups Коллекция audioRoutingGroup Получение коллекции объектов audioRoutingGroup.
Добавление представления "Большая галерея" addLargeGalleryViewOperation Добавление представления "Большая галерея" в вызов.
Интерактивный голосовой ответ
PlayPrompt playPromptOperation Воспроизведение запроса в вызове.
RecordResponse recordOperation Запись короткого голосового ответа звонящего.
CancelMediaProcessing commsOperation Отмена обработки мультимедиа.
SubscribeToTone commsOperation Подписка на тоны DTMF.
SendDtmfTones commsOperation Отправка тонов DTMF в вызове.
Операции с самостоятельным участником
Отключение звука muteParticipantOperation Отключение своего звука в вызове.
Включение звука unmuteParticipantOperation Включение своего звука в звонке.
ChangeScreenSharingRole Нет Начало и прекращение демонстрации экрана в звонке.
Запись операций
UpdateRecordingStatus 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",  
  "replacesContext": "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"},
}