通过

call 资源类型

  • 项目

命名空间：microsoft.graph

当应用程序有传入呼叫或应用程序通过 POST 上的 communications/calls创建新的传出呼叫时，将创建调用资源。

呼叫可设置为对等呼叫或群组通话。 若要创建或加入组呼叫，请 chatInfo 提供 和 meetingInfo。 如果未提供这些值，则会自动创建一个新的组调用。 对于传入呼叫，请在高可用性存储中记录这些值，以便在应用程序崩溃时，应用程序可以重新加入调用。

虽然无法多次邀请同一标识，但应用程序可能会多次加入同一会议。 应用程序每次想要加入呼叫时，都必须提供单独的标识，以便客户端将其显示为不同的参与者。

请注意：可从通过 Microsoft Teams 计划的会议中获取加入 URL。 从所示 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 创建 呼叫 使机器人能够创建新的传出对等呼叫或群组呼叫，或加入现有会议。
Get call 读取 call 对象的属性。
删除/挂断 无 删除或挂断活动呼叫。
保持活动状态 无 确保通话不中断。
呼叫处理
Answer 无 应答传入呼叫。
Reject 无 拒绝传入呼叫。
重定向 无 重定向传入呼叫。
Transfer 无 转接呼叫
组呼叫
List participant 集合 获取参与者对象集合。
邀请参与者 commsOperation 邀请参与者加入活动呼叫。
参与者静音 muteParticipantOperation 群组通话中参与者静音。
创建 audioRoutingGroup 通过发布到 audioRoutingGroups 集合来创建新的 audioRoutingGroup 。
列出音频路由组 audioRoutingGroup 集合 获取 audioRoutingGroup 对象集合。
添加大型库视图 addLargeGalleryViewOperation 将大型库视图添加到调用。
Interactive-voice-response
播放提示 playPromptOperation 在呼叫中播放提示。
记录响应 recordOperation 录制来自呼叫方的简短音频回复。
取消媒体处理 commsOperation 取消媒体处理。
订阅声音 commsOperation 订阅 DTMF 音。
发送 DTMF 音调 commsOperation 在呼叫中发送 DTMF 音调。
自参与操作
将应用程序静音 muteParticipantOperation 在呼叫中将自己设为静音。
取消应用程序静音 unmuteParticipantOperation 在呼叫中将自己取消静音。
更改屏幕共享角色 无 在呼叫中开始和停止共享屏幕。
记录操作
更新录制状态 updateRecordingStatusOperation 更新记录状态。
日志记录操作
记录电话会议设备质量数据 teleconferenceDeviceQuality 记录视频电话会议设备质量数据。

属性

属性 类型 说明
callbackUri String 要传递回调的回调 URL。 必须是 HTTPS URL。
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"},
}