反馈 编辑

call 资源类型

  • 项目

命名空间：microsoft.graph

重要

Microsoft Graph版本下的 /beta API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

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

呼叫可设置为对等呼叫或群组通话。 要创建或加入群组通话，请提供 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"}

方法

方法 返回类型 说明
Get call 读取 call 对象的属性。
Delete 无 删除或挂断活动 呼叫。
KeepAlive 无 确保通话不中断。
呼叫处理
Answer 无 应答传入呼叫。
Reject 无 拒绝传入呼叫。
重定向 无 重定向传入呼叫。
Transfer 无 转接呼叫
群组呼叫
List participants participant 集合 获取参与者对象集合。
邀请参与者 commsOperation 邀请参与者加入活动呼叫。
所有参与者静音 commsOperation 将呼叫中的所有参与者设为静音。
参与者静音 muteParticipantOperation 群组通话中参与者静音。
配置 Audio Mixer commsOperation 在多方对话中配置音频。
Create audioRoutingGroup audioRoutingGroup 通过发布到 audioRoutingGroups 集合来创建新的 audioRoutingGroup 。
List audioRoutingGroups audioRoutingGroup 集合 获取 audioRoutingGroup 对象集合。
添加大型库视图 addLargeGalleryViewOperation 将大型库视图添加到调用。
Interactive-Voice-Response
PlayPrompt playPromptOperation 在呼叫中播放提示。
RecordResponse recordOperation 录制来自呼叫方的简短音频回复。
CancelMediaProcessing commsOperation 取消媒体处理。
SubscribeToTone commsOperation 订阅 DTMF 音。
Self Participant Operations
Mute muteParticipantOperation 在呼叫中将自己设为静音。
Unmute unmuteParticipantOperation 在呼叫中将自己取消静音。
ChangeScreenSharingRole 无 在呼叫中开始和停止共享屏幕。
记录操作
UpdateRecordingStatus updateRecordingStatusOperation 更新记录状态。
日志记录操作
记录设备质量数据 teleconferenceDeviceQuality 记录视频电话会议设备质量数据。

属性

属性 类型 说明
activeModalities modality 集合 活动模态的列表。 可取值为：unknown、audio、video、videoBasedScreenSharing、data。 只读。
answeredBy participantInfo 已应答呼叫的参与者。只读。
callRoutes callRoute 集合 有关如何重定向呼叫的路由信息。只读。
callbackUri 字符串 用于传递回拨的回拨 URL。必须为 https。
callChainId String 会议中所有参与者通话的唯一标识符，或 P2P 通话中两位参与者通话的唯一标识符。需要从 Microsoft.Graph.Call.CallChainId 复制它。
callOptions outgoingCallOptions 包含该通话的可选功能。
chatInfo chatInfo 聊天信息。 会议情境所需的信息。
direction callDirection 呼叫的方向。 可取值为 incoming 或 outgoing。 只读。
id 字符串 来电显示。只读。
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 字符串 只读。 tenantId 在 Azure Active Directory 中。
terminationReason String 只读。
toneInfo toneInfo 只读。

关系

关系 类型 说明
audioRoutingGroups audioRoutingGroup 集合 只读。可为空。
operations commsOperation 集合 只读。可为空。
participants participant 集合 只读。可为空。
contentSharingSessions contentSharingSession 集合 只读。可为空。

JSON 表示形式

下面是资源的 JSON 表示形式。

{
  "activeModalities": ["unknown | audio | video | videoBasedScreenSharing | data"],
  "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": "incoming | outgoing",
  "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",
  "replacesContext": "String",
  "requestedModalities": ["unknown | audio | video | videoBasedScreenSharing | data"],
  "resultInfo": {"@odata.type": "#microsoft.graph.resultInfo"},
  "ringingTimeoutInSeconds": 99,
  "routingPolicies": ["none | noMissedCall | disableForwardingExceptPhone | disableForwarding | preferSkypeForBusiness"],
  "source": {"@odata.type": "#microsoft.graph.participantInfo"},
  "state": "incoming | establishing | ringing | established | hold | transferring | transferAccepted | redirecting | terminating | terminated",
  "subject": "String",
  "targets": [{"@odata.type": "#microsoft.graph.invitationParticipantInfo"}],
  "tenantId": "String",
  "terminationReason": "String",
  "toneInfo": {"@odata.type": "#microsoft.graph.toneInfo"}
}