命名空间：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"}
注意
以下已知问题与此资源相关联：
方法
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| 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"}
}