call 资源类型
命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
当应用程序有传入呼叫或应用程序通过 POST 上的 app/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 | 邀请参与者加入活动呼叫。 |
| 所有参与者静音 | commsOperation | 将呼叫中的所有参与者设为静音。 |
| 参与者静音 | muteParticipantOperation | 群组通话中参与者静音。 |
| 创建 | audioRoutingGroup | 通过发布到 audioRoutingGroups 集合来创建新的 audioRoutingGroup 。 |
| 列出音频路由组 | audioRoutingGroup 集合 | 获取 audioRoutingGroup 对象集合。 |
| 添加大型库视图 | addLargeGalleryViewOperation | 将大型库视图添加到调用。 |
| Interactive-Voice-Response | ||
| 播放提示 | playPromptOperation | 在呼叫中播放提示。 |
| 记录响应 | recordOperation | 录制来自呼叫方的简短音频回复。 |
| 取消媒体处理 | commsOperation | 取消媒体处理。 |
| 订阅声音 | commsOperation | 订阅 DTMF 音。 |
| 发送 DTMF 音调 | commsOperation | 在呼叫中发送 DTMF 音调。 |
| Self Participant Operations | ||
| 将应用程序静音 | muteParticipantOperation | 在呼叫中将自己设为静音。 |
| 取消应用程序静音 | unmuteParticipantOperation | 在呼叫中将自己取消静音。 |
| 更改屏幕共享角色 | 无 | 在呼叫中开始和停止共享屏幕。 |
| 记录操作 | ||
| 更新录制状态 | 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 | 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"}
}