为 Teams 应用启用应用图标标记

应用图标标记可帮助会议参与者识别会议期间的任何应用活动。 参与者会收到会议应用的活动通知。

当会议期间有新活动时，应用会调用 targetedMeetingNotification API，并在会议统一栏中的应用图标上显示红色锁屏提醒， (U 形栏) 。 当参与者选择应用图标时，应用将在会议侧面板中打开，锁屏提醒将消失。

例如，在会议中的实时协作期间，如果参与者在添加到会议的文件中添加注释，应用将从参与者的会议侧面板调用 targetedMeetingNotification API。 API 在应用图标上触发锁屏提醒，使其他参与者了解评论活动。

下图显示了会议 U 栏中的应用图标标记：

注意

• 应用图标禁用不适用于 政府社区云 (GCC) -High 和国防部 (DOD) 环境。
• 移动客户端不支持应用图标标记。
• 频道会议不支持应用图标标记。

若要启用应用图标标记，请执行以下步骤：

1. 为应用图标标记启用应用清单设置
2. 为应用启用应用图标标记

为应用图标标记启用应用清单设置

若要启用应用图标标记，必须：

• 确保已配置为meetingSidePanelcontext应用的属性。
• 在authorization应用清单的 字段下resourceSpecific配置 属性和 name 和 type 属性，如下所示：

"webApplicationInfo": {
    "id": "<<MICROSOFT-APP-ID>>",
    "resource": "https://RscBasedStoreApp"  },
  "authorization": {
    "permissions": {
      "resourceSpecific": [
        {
          "name": "OnlineMeetingNotification.Send.Chat",
          "type": "Application"        }
      ]
    }
  }

为应用启用应用图标标记

若要启用应用图标标记，请确保已启用 目标会议内通知。

目标会议通知和应用图标标记 API 已扩展，以支持应用图标上的应用图标标记功能，并传递目标收件人的用户 MRI ID。 参数 surfaces 现在支持 meetingTabIcon 应用使用的值。

如果向同一 tabEntityId会议添加了多个应用实例，则应用也可以传递 。 tabEntityId如果未传递 ，Teams 会在用户会议窗口的第一个应用图标上显示锁屏提醒。

示例

C#

示例代码参考

TeamsInfo.SendMeetingNotificationAsync(context, notificationPayload, meetingId);

JavaScript

示例代码参考

TeamsInfo.sendMeetingNotification(context, notificationPayload, meetingId);

JSON

{
    "type": "targetedMeetingNotification",
    "value": {
        "recipients": [
            "<participant1 MRI>",
            "<participant2 MRI>" 
        ],
        "surfaces": [
            {
                "surface": "meetingTabIcon",
                "tabEntityId": "<tab id from tab sdk>" // optional           
            }
        ]
    }
}

响应代码

下表列出了响应代码：

响应代码	说明
202	已成功发送通知。
207	通知仅发送给少数参与者。
400	会议通知请求有效负载验证失败。
401	机器人令牌无效。
403	不允许机器人发送通知。
404	找不到会议聊天，或者在名单中找不到任何参与者。

限制

• 应用图标在每次会议一分钟内仅显示一个用户的通知。

• 对于特定会议，最多显示前 50 名参与者的应用图标。

代码示例

示例名称	Description	Node.js	.NET
Teams 应用的应用图标标记	此示例演示如何为 Teams 应用启用应用图标标记。	View	View

另请参阅

• 会议的“生成”选项卡
• 为 Teams 会议生成会议内通知
• 定向会议通知和应用图标标记 API