借助 Microsoft Graph 中的更改通知,能够订阅 Microsoft Teams 联机会议的通话开始/结束以及通话名单更新。 更改通知允许你维护订阅,从而提供低延迟模式。 你还可以在通知中获取资源数据,因此避免调用 API 来获取有效负载。
跨频道订阅消息
若要获取应用程序中会议呼叫事件的更改通知,请订阅 /communications/onlineMeetings/?$filter=JoinWebUrl eq '{JoinWebUrl}'。 此资源支持在通知中包括资源数据。
权限
| 权限类型 | 权限(从最低特权到最高特权) | 支持的版本 |
|---|---|---|
| 委派(工作或学校帐户) | 不支持。 | 不支持。 |
| 委派(个人 Microsoft 帐户) | 不支持。 | 不支持。 |
| 应用程序 | OnlineMeetings.Read.All、OnlineMeetings.ReadWrite.All | beta 版 |
示例
POST https://graph.microsoft.com/beta/subscriptions
Content-Type: application/json
{
"changeType": "updated",
"notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
"resource": "/communications/onlineMeetings/?$filter=JoinWebUrl eq '{JoinWebUrl}'",
"includeResourceData": true,
"encryptionCertificate": "{base64encodedCertificate}",
"encryptionCertificateId": "{customId}",
"expirationDateTime": "2021-02-01T11:00:00.0000000Z",
"clientState": "{secretClientState}"
}
JoinWebUrl
加入会议的 URL 包含在 onlineMeeting 资源的 joinWebUrl 属性中,或会议的 Teams 客户端中。
具有加密资源数据的通知
{
"value": [{
"subscriptionId": "{Subscription id}",
"clientState": "{secret client state}",
"changeType": "updated",
"tenantId": "{Organization/Tenant id}",
"resource": "communications/onlineMeetings?$filter=joinWebUrl+eq+'{joinWebUrl}'",
"subscriptionExpirationDateTime": "2022-02-28T00:00:00.0000000Z",
"resourceData": {
"@odata.id": "communications/onlineMeetings?$filter=joinWebUrl+eq+'{joinWebUrl}'",
"@odata.type": "#microsoft.graph.onlineMeeting",
"id": "communications/onlineMeetings?$filter=joinWebUrl+eq+'{joinWebUrl}'"
},
"organizationId": "{Organization/Tenant id}",
"encryptedContent": {
"data": "{Encrypted content}",
"dataSignature": "{Encrypted data signature}",
"dataKey": "{Encrypted data key for encrypting content}",
"encryptionCertificateId": "{User specified id of encryption certificate}",
"encryptionCertificateThumbprint": "{Encrpytion certification thumbprint}"
}
}],
"validationTokens": ["{Validation Tokens}"]
}
有关如何验证令牌和解密负载的详细信息,请参阅设置包含资源数据的更改通知。
事件通知类型
以下是受支持的会议事件:
- CallStarted - 在启动会议呼叫时发生。
- CallEnded - 在会议呼叫结束时发生。
- CallRosterUpdate - 在参与者加入或退出呼叫时发生。
解密的有效负载示例
CallStarted/CallEnded
{
"@odata.type":"#Microsoft.Graph.onlineMeeting",
"@odata.id":"communications/onlineMeetings?$filter=joinWebUrl+eq+'{joinWebUrl}'",
"id":"communications/onlineMeetings?$filter=joinWebUrl+eq+'{joinWebUrl}'",
"eventType":"{Microsoft.Communication.CallStarted or Microsoft.Communication.CallEnded}",
"eventDateTime":"2022-02-28T00:00:00.0000000Z",
"state":"active"
}
CallRosterUpdate
{
"@odata.type":"#Microsoft.Graph.onlineMeeting",
"@odata.id":"communications/onlineMeetings?$filter=joinWebUrl+eq+'{joinWebUrl}'",
"id":"communications/onlineMeetings?$filter=joinWebUrl+eq+'{joinWebUrl}'",
"eventType":"Microsoft.Communication.CallRosterUpdate",
"eventDateTime":"2022-02-28T00:00:00.0000000Z",
"state":"active",
"activeParticipants@delta": ["{meetingParticipantInfo list of users that joined}"],
"activeParticipants@remove": ["{meetingParticipantInfo list of users that left}"]
}
CallRosterUpdate 事件包括两个附加属性,activeParticipants@delta 用于说明添加到会议的参与者,以及 activeParticipants@remove,用于说明离开联机会议的参与者。 有关参与者的详细信息,请参阅 meetingParticipantInfo 资源类型。
可以通过不包括属性 includeResourceData,或在订阅请求正文中将此值设置为 false 来选择忽略加密。 这样做会向 resourceData 添加将属于加密有效负载的属性。
另请参阅
历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 benlee-msft)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
