概述

此集成使您的视频设备能够加入 Microsoft Teams 会议。 该集成适用于 Webex 设备和其他支持 SIP 的视频设备,无论设备注册到 Webex 还是注册到内部基础设施。

以下是集成如何改善设备用户在加入组织中托管的 Microsoft Teams 会议时的体验:

  • Webex 会议体验 - 具有灵活布局选项的多屏幕会议

  • 同时显示 Microsoft 和视频集成参加者的参加者列表

  • 设备与 Microsoft Teams 之间的双向内容共享

  • 设备上的录制文件指示灯

视频设备加入体验,来自会议邀请

Microsoft Teams 会议的标准电子邮件邀请中包含会议加入详细信息,其中包含可单击的链接,用于从 Microsoft Teams 客户端加入会议。 该部分还可能包含音频拨入信息,即作为纯音频参加者加入的音频会议标识和电话号码。 当您启用视频集成时,邀请加入详细信息部分将展开,以包含视频会议设备加入详细信息的区块。

图 1: Microsoft Teams 会议邀请中的视频加入详细信息

需要加入会议时,视频设备用户可呼叫使用视频会议设备加入标题下列出的 SIP 视频地址。 设备将呼叫 Webex 互动式语音应答 (IVR) 系统,要求呼叫者提供 VTC 会议标识(视频电话会议标识)。 请注意,VTC 会议标识专门用于视频设备,与音频会议标识(如果会议中包含)不同。

SIP IVR 视频地址特定于您的组织,由您组织的 Webex SIP 子域在格式 <subdomain>@m.webex.com.

在 SIP IVR 视频地址和 VTC 会议标识下方,邀请会链接到另一个备用拨号说明网页,其中显示了如何通过直接拨号的方式加入会议。

备用视频设备加入方法 - 直接拨号

视频呼叫者可以使用下列格式的 SIP 地址绕过 IVR,直接加入会议: <VTC Conference ID>.<subdomain>@m.webex.com. 该方法在邀请链接到的备用 VTC 拨号说明网页的顶部列出。 网页还会重复会议邀请中的 IVR 提示加入详细信息。

图 2: 备用 VTC 拨号说明(超链接的特定于会议的网页)

备用视频设备加入方法 - 加入按钮

如果您同时启用了 Webex 混合日历服务,当安排程序邀请设备参加 Microsoft Teams 会议时,设备可以收到一键通 (OBTP) 功能。 使用该设备的与会者只需在需要将设备连接到会议时按下加入按钮即可。 会议条目显示 Microsoft Teams 徽标,用于指示与会者加入的会议类型。

视频与 Microsoft Teams 集成的要求

要求

笔记

活跃的 Webex 组织

如果您还没有活动 Webex 组织,我们将在您购买视频集成时为您预配置一个组织。

带有组织中用户的 Microsoft Teams 帐户的 Microsoft 365 租户

设置过程需要一个能够以全局管理员身份登录的帐户,使租户能够授予应用程序权限,以及一个 Microsoft Teams 管理员帐户,使租户可以执行 PowerShell 命令。

Webex 视频集成许可证,为您计划用于此集成的每个视频设备提供一个许可证。

此服务的订阅必须预配置给 Control Hub 中的 Webex 组织,并如本文中所述进行设置。


 

早期现场试用期间不需要许可证。 要在试用结束后继续使用集成,请在服务正式发布后 45 天内购买许可证,或者开始由合作伙伴主导的试用。 否则,集成将停止工作。

向 Webex 组织注册的 Webex 设备,或其他可以进行互联网呼叫的 SIP 视频设备。

Webex 混合日历服务(可选,但强烈推荐使用)

这是将一键操作 (OBTP) 提供给视频设备时所必需的。

为了获得使用混合日历的最佳体验,所有会议组织者和共享协作室邮箱都应启用混合日历。

混合日历服务有额外要求。 要获取详细说明,请参阅 https://www.cisco.com/go/hybrid-services-calendar

视频集成流量的端口和协议

发送信号

视频设备连接到 Webex 数据中心以发送信令。

表 1. 使用 Webex 数据中心进行信号传输

视频设备

协议

端口号码

条评论

已向您的组织注册的 Webex 设备

TCP

443

有关要求,请参阅Webex 服务的网络要求

其他 SIP 视频设备

TCP

5060/5061

有关要求,请参阅如何在我的网络上允许Webex Meetings流量?

媒体

视频集成呼叫的媒体路径与其他Webex Meetings呼叫流程不同,因为专用媒体群集处理此呼叫类型。 这些专用媒体集群不属于为 Webex Meetings 发布的地址范围,部署必须确保流量能够访问这些额外的 IP 网络。

专用媒体集群不属于 Webex 注册设备执行的可访问性测试。 如果无法打开对任何媒体集群 IP 范围的访问,可能会导致呼叫失败。 根据呼叫者的来源,该集成将尝试为每个呼叫使用最佳媒体集群。 但是,您必须允许访问所有媒体集群,因为使用的媒体集群会根据运行时条件而变化。

表 2. 带有专用媒体集群的媒体

视频设备

协议

端口号码

媒体群集区域和 IP 范围

已向您的组织注册的 Webex 设备

TCP

443

5004

我们仅使用这些 TCP 端口作为首选 (UDP) 媒体端口的备用选项

  • 澳大利亚东部:

    20.53.87.0/24

  • 东南亚:

    40.119.234.0/24

  • 美国东部 2:

    52.232.210.0/24

    20.57.87.0/24

    4.152.214.0/24

  • 美国西部 2:

    20.120.238.0/23

  • 英国南部:

    20.68.154.0/24

    20.108.99.0/24

    4.158.208.0/24

  • 西欧:

    20.50.235.0/24

    20.76.127.0/24

    4.175.120.0/24

UDP

5004

9000

其他 SIP 视频设备

UDP

36000-59999

读取Webex 服务的网络要求对于其他 Webex 服务,以及它们使用的协议和端口。

从 Control Hub 创建视频集成

按照以下步骤向 Webex 云注册 Microsoft Teams,向 Microsoft 授予服务权限,并允许 Cisco 视频设备加入 Microsoft Teams 会议。 https://admin.webex.com 中的设置向导可引导您完成该过程。

在设置期间,Microsoft 用户至少需要进行两次单独的身份验证。 我们建议由已向其帐户授予对 Control Hub 的完全权限管理员访问权的 Microsoft 管理员执行这些步骤。

准备工作

  • 确保您已满足 中的所有要求视频与 Microsoft Teams 集成的要求

  • 如果您尚未设置 Webex 组织,请进行设置。

  • 如果您尚未执行此操作,请在组织中添加 Webex SIP 地址的子域

  • 要设置视频集成,您需要具备以下管理员访问权限:

    • 组织中的 Microsoft 租户全局管理员权限

    • 租户中的 Microsoft Teams 管理权限

    • 您自己的 Webex 组织的完全管理员特权和可访问 Control Hub 的 Web 浏览器。 (请参阅Webex 服务的系统要求为了浏览器的兼容性。)


       

      任何其他组织中可能有权访问 Control Hub 的用户(例如合作伙伴管理员)都不符合资格。 在要配置的 Webex 组织中使用完全管理员帐户。

  • 您还需要运行 Microsoft PowerShell 命令的访问权才能完成这些设置步骤。

    • 已安装 MicrosoftTeams PowerShell 模块。 (建议使用 2.0 版或更高版本。) 请参阅“安装 Microsoft Teams PowerShell ” 获取更多信息,请访问 Microsoft 文档网站。

    • 在撰写本文时,Microsoft 建议在使用 MicrosoftTeams 模块时选择 PowerShell 版本 5.1,因此我们建议在 Windows 计算机上使用 PowerShell。 请参阅 Microsoft 文档网站中的 PowerShell 5.1 系统要求了解更多信息。

1

登录到 https://admin.webex.com

2

检查您是否为 Webex SIP 地址设置子域: 转至组织设置> Cisco Webex Calling的 SIP 地址。 如果未设置子域,请参阅更改您的 Webex SIP 地址

3

转至 服务 > 混合。 在 Microsoft Teams 的视频集成卡上,单击设置

如果卡没有显示设置选项,请确保许可证处于活动状态。

4

在“视频集成设置”屏幕上,单击授权

您将被重定向至 Microsoft 同意提示。
5

为具有 Microsoft 租户全局管理员权限的用户选择帐户,然后输入凭证。

6

在权限屏幕上,查看请求的权限。 然后单击接受以向您的 Microsoft 租户授予对 Webex 视频集成应用程序的访问权。

当您完成授权步骤后,浏览器应将您重定向到 Control Hub 视频集成设置屏幕。 否则,请重新尝试上述步骤。

7

在计算机上打开 PowerShell 窗口并安装 Microsoft Teams PowerShell 模块(如果尚未安装):

  1. 在 PowerShell 命令提示符下,输入以下命令:

    Install-Module MicrosoftTeams -AllowClobber
  2. 如果系统提示您信任 PSGallery 存储库,则选择 Y 确认信任,然后继续下载和安装。

8

导入 MicrosoftTeams 模块并连接到您的 Teams 租户:

  1. 使用现有窗口或在计算机上打开新的 PowerShell 5.1 窗口。

  2. 在 PowerShell 提示符下,输入以下命令:

    Import-Module MicrosoftTeams 
  3. 在 PowerShell 提示符下,输入以下命令:

    Connect-MicrosoftTeams
    会出现一个 Microsoft 登录页面。
  4. 输入具有 Microsoft Teams 租户的管理权限的用户凭证。

    如果成功,您将获得有关您已成功登录哪个帐户和租户的反馈。 如果收到错误,请重复上述命令,并参阅有关 PowerShell 的 Microsoft 文档以获取更多协助。


     

    在继续其余步骤之前,您必须先成功登录 Teams 租户。

9

从 Control Hub 的视频集成设置屏幕,单击剪贴板按钮 New-CsVideoInteropServiceProvider 命令从 首先文本框,然后将其粘贴到 PowerShell 会话中。 然后运行命令。


 

该命令特定于您的租户。 除非您已导入 MicrosoftTeams PowerShell 模块并如前一步所述成功登录租户,否则该命令将不起作用。

将命令复制到 PowerShell 时请特别小心,以便在处理文本时不会对复制的文本进行任何修改。 通过电子邮件、消息客户端或其他处理方式发送命令可能导致添加格式、替换字符或添加额外字符,从而破坏配置。 PowerShell 不一定会拒绝格式错误的文本。 我们建议您尽量将命令从 Control Hub 直接复制并粘贴到 PowerShell 中,或者使用纯文本编辑器验证文本,然后再粘贴到 PowerShell。

此命令定义 Cisco 类型的新 CVI 提供商,并设置由 Webex 分配的 tenantKey、Webex 提供的备用说明 URL 和其他集成设置。
10

选择为用户启用集成的方式。

要获取帮助,请参阅“授予-CsTeamsVideoInteropServicePolicy ”(在 Microsoft 文档网站上)。

  1. 要启用以下集成: 全部组织中的用户,则将 Grant-CsTeamsVideoInteropServicePolicy 命令从 第二文本框。

    要启用所有用户:
    Grant-CsTeamsVideoInteropServicePolicy -PolicyName CiscoServiceProviderEnabled -Global
  2. 要为单个用户启用集成,复制 Grant-CsTeamsVideoInteropServicePolicy 文本框。 替换 -Global 替换为 -Identity ,并在其后面添加用户的电子邮件地址。

    要启用用户 jamie.smith@company.com:
    Grant-CsTeamsVideoInteropServicePolicy -PolicyName CiscoServiceProviderEnabled -Identity jamie.smith@company.com
  3. 将命令粘贴到 PowerShell 会话中并运行该命令。

11

完成 PowerShell 命令后,在 Control Hub 的“视频集成设置”屏幕上单击确定可完成设置。

对 Microsoft 租户的 PowerShell 更改可能需要一些时间才能传播到 Microsoft 365 环境中。 Microsoft 警告称完成该操作可能需要最长 6 小时,但通常不到 20 分钟。 您可以通过让用户在 Microsoft Outlook 或 Microsoft Teams 客户端中创建测试会议来测试用户的更改是否已生效。 如果更改已成功传播,您应在创建的会议邀请中看到视频集成加入详细信息(如概述中所示)。 如果加入详细信息不存在,请等待更长时间,然后再次重复测试。

下一步

如果您在离开设置向导后需要访问 PowerShell 命令文本,在 Control Hub 的左侧面板中,单击混合(在服务类别下)。 在带有 Microsoft Teams 徽标的视频互操作性卡上,单击编辑设置

要充分利用混合日历服务的日历和 OBTP 加入功能,请确保您的 Webex 设备是注册到 Webex 云或使用链接到云端适用于设备的 Edge

如果要将 OBTP 用于设备,请设置混合日历服务。 要获取在 Webex 视频设备上设置混合日历服务的 OBTP 帮助,请参阅借助 OBTP,让视频设备更轻松地加入会议

加入按钮和混合日历注意事项

如中所述备用视频设备加入方法 - 加入按钮,如果启用了混合日历服务,则可以使用一键通 (OBTP) 进一步改善组织的呼叫体验。

使用 OBTP,组织中的 Webex 设备会自动显示加入按钮,在 Microsoft Teams 会议开始前不久,当他们加入会议时:

  • 如果与设备关联的用户接受会议邀请,个人模式设备会显示该按钮。 (必须在 Control Hub 中为用户启用日历服务。)

  • 如果与该设备关联的会议室邮箱电子邮件地址接受会议邀请,共享模式设备会显示该按钮。 (必须在 Control Hub 中为设备的工作空间启用日历服务。)

OBTP 的 Exchange 邮箱要求

混合日历服务只有在会议安排程序或至少一位受邀者启用了该服务时,才能处理会议邀请(以添加 OBTP 所需的详细信息)。 如果您的组织没有很多启用了日历服务的用户,可能通常设备邀请会触发处理,而不是安排程序或用户来触发。 如果发生这种情况,Exchange 配置必须保留邀请中服务需要的所有详细信息。


 

现在,您可以为没有 Webex 许可证的用户启用混合日历服务。

缺省情况下,Exchange Online 设置会从发送到会议室邮箱的邀请中删除会议详细信息。 将以下 PowerShell 命令应用于您启用了混合日历服务的所有共享模式设备的会议室邮箱:

Set-CalendarProcessing -identity "room" -DeleteComments $false
Set-CalendarProcessing -identity "room" -DeleteSubject $false
Set-CalendarProcessing -identity "room" -AddOrganizerToSubject $false

如果您希望能够将 Microsoft 组织外部安排的邀请转发到设备,请添加以下命令:

Set-CalendarProcessing -identity "room" -ProcessExternalMeetingMessages $True

OBTP 支持的设备类型

使用视频集成和混合日历服务支持将 OBTP 用于 Microsoft Teams 会议的设备类型包括:

  • Webex Board、会议室和桌面设备

  • Webex Room Kit 和协作室电话

  • Cisco MX、SX 和 DX 系列

设备必须是注册到 Webex 云或使用链接到云端适用于设备的 Edge


 

如果您的设备从 Cisco TMS 或 Cisco TMSXE 获得加入按钮,它们将无法获得用于 Microsoft Teams 会议的加入按钮。

作为替代方案,您可以通过将 Microsoft Teams 会议的 SIP IVR 视频地址添加为快速拨号或宏来简化受影响设备的加入。

功能和限制

本部分说明 Microsoft Teams 视频集成的限制和功能行为。

多个组织和租户

  • 我们目前支持 Webex 组织和 Microsoft 365 租户之间的一对一关系:

    • 单个 Webex 组织只能与一个 Microsoft 365 租户进行互操作。

    • 您的 Microsoft 租户可支持多个不同的视频集成;例如,租户可以同时与 Cisco 和 Poly 进行互操作。 但是,该租户针对每种类型只能有一个集成;因此,一个集成来自 Cisco,另一个集成来自 Poly。

      如果您有多个 Webex 组织,请选择一个组织以使用 Webex 视频集成与您的 Microsoft 租户互操作。

产品推出信息

  • 我们仅支持 Microsoft 365 的全球实例。(其他实例(我们不支持的国家/地区包括 USGovDoD、USGovGCCHigh、中国和德国。)

  • 我们仅支持位于以下国家/地区的商业 Webex 组织:提供 Webex 付费订阅的国家和地区。 (我们不支持 FedRAMP 授权的 Webex 服务。)

视频设备互操作性

  • 集成仅支持传入 SIP 呼叫,不支持 H.323 或 IP 呼叫。 您可以使用 Cisco Expressway 部署将这些旧协议整合到 SIP 呼叫中。

  • 该集成不支持使用 Webex 应用程序呼入 Microsoft Teams 会议。 此外,集成不支持需要将 Webex 应用程序与设备配对或连接的功能。 这包括无线共享、通过 Webex 应用程序拨号以及通过 Webex 应用程序进行呼叫控制。

  • Webex 设备的交互式白板功能不适用于 Microsoft Teams 上的会议。 用户可在设备上共享白板,作为视频内容(BFCP 支持)。

  • 集成不支持纯音频参加者。 (纯音频参加者应使用 Microsoft Teams 的 PSTN 网关功能呼入。)

布局

  • 视频集成参加者可以通过从设备发送 DTMF 音 2 和 8 来循环切换不同的布局选项。

  • 参加者可以使用 Cisco Touch 界面更改支持 ActiveControl 的设备上的布局。 (这适用于云呼叫和 SIP。)

  • 参加者可以同时看到最多 9 个视频流。 可见流的数量还取决于所选的布局和设备类型。 当参加者没有向会议发送视频流时,布局会显示字母头像而不是视频。

  • 该集成支持单显示器 + 内容、双显示器 + 内容以及 TIP 三显示器 + 内容配置。 不支持特定于全景画的布局和摄像头行为,其运行类似于标准双显示器配置。 该服务不支持 iX 沉浸式体验,但这些设备可能作为 TIP 终端进行连接,没有沉浸式特定功能。 根据设备类型,支持的布局系列可能有所不同。

  • 在两个显示器上接收传入参加者视频的双屏设备将具有固定的“焦点+网格”两屏布局,用于在多个参加者的显示器处于活动状态时进行 VIMT 呼叫。 使用布局控件不会在两个显示器显示传入参加者视频时更改活动布局。 在内容共享处于活动状态时,没有专用演示显示器的双显示器配置将切换到单个参加者的显示器,并且在内容共享处于活动状态时,参加者显示器的布局控件将可操作。 使用专用演示显示器的三种显示器配置将参加者视频保持在两个显示器上,因此无论是否进行内容共享,显示器都保持为固定的“焦点+网格”布局。

日历和跨组织邀请

  • 组织外部的参加者可以通过下列方式从其视频设备加入您的 Microsoft Teams 会议:拨打 IVR 视频地址 ( <yoursubdomain>@m.webex.com) 并在提示处输入会议的 VTC 会议标识,或使用直接拨号备选项( <VTC Conference ID>.<yoursubdomain>@m.webex.com )。

  • 您的 Microsoft 租户的视频集成不支持拨入其他 Microsoft 客户主持的会议。 当拨入由其他 Microsoft 租户主持的 Teams 会议时,您必须使用为该租户启用的视频集成的视频地址。

  • Webex 混合日历服务不会为包含其他(非 Cisco)视频集成提供的加入详情的会议创建 OBTP 加入条目。 (例如,已启用混合日历的工作空间将不会显示用于 Pexip 邀请的一键操作 (OBTP) 加入按钮。)

  • 在处理 Microsoft Teams 会议的 OBTP 时,因缺失注释/正文详细信息或基于组织者的处理而产生的已知混合日历限制也适用。

会议功能

  • 视频集成参加者没有可用于开始或停止会议录制的控件。 Microsoft Teams 用户必须管理会议录制文件。

  • 内容共享使用 BFCP,并遵守该协议的限制,包括不能共享应用程序或允许远程控制。

  • 如果会议策略或会议组织者限制哪些人可以使用谁可以进行演示?会议选项,则视频集成参加者必须具有“主讲者”角色才能在会议中共享内容。 通过视频集成加入时,主叫方在缺省情况下为“与会者”。 作为受信任的呼叫者加入的呼叫者将自动分配主讲者角色,无论在谁可以进行演示? 。 会议组织者可以使用团队客户端中的参加者列表即时切换参加者的角色。

  • 如果会议策略或会议组织者限制哪些人可以使用谁可以进行演示?选项,则对于在会议中仅担任“与会者”角色的视频集成参加者将无法按预期方式共享内容。 来电者将能够在其设备上开始共享,但会议中的其他参加者将无法看到其内容。 共享也可能干扰从其他用户处接收内容。

  • 视频集成参加者无法使用 Microsoft Teams 聊天功能。

  • 视频集成参加者无法使用 Microsoft Teams 白板功能。

  • 当 Microsoft Teams 参加者共享时,视频集成参加者只能看到共享桌面窗口选项。 视频集成参加者无法查看从 Microsoft Teams 客户端共享的文件或者 PowerPoint白板选项。

  • Microsoft Teams 参加者可以将视频集成参加者静音,但出于隐私原因,无法将其取消静音。

  • 视频集成参加者可以在设备上(本地静音)或通过发送 DTMF *6 (服务器端静音)将自己静音和取消静音。 参加者在发送时将看到设备上的确认消息 *6.

    在参加者列表中,您只会看到视频集成参加者的静音指示灯亮起,前提是他们使用 *6 将自己静音或 Microsoft Teams 参加者将其静音时,您才能看到其静音指示器打开(本地静音不会更新名单。)

    如果静音指示器打开,参加者取消静音的方式可能会以不同的方式影响该指示器,具体取决于设备使用的呼叫类型:

    • 云呼叫 - 参加者可以在本地取消静音以清除参加者列表中的静音指示器。

    • SIP 或内建呼叫 - 只有使用 *6 取消静音才会清除名单中的静音指示器。 (在本地取消静音不会清除名单中的静音指示器。)

  • 通过视频集成连接的 Webex 设备会将 Webex IVR 和初始屏幕本地化为设备中设置的语言。 美国英语是所有其他场景的缺省值。 使用云呼叫或 SIP 呼叫的 Webex 设备支持本地化(需要 CE9.14.3 或更高版本)。

Microsoft Teams 等候区

  • 来自您自己的组织的可信设备可以自动绕过 Microsoft Teams 等候区,从而简化其加入会议的方式。 设备在以下任一情况下将被视为可信:

    • 它是使用云呼叫的 Webex 设备,并注册到部署视频集成的 Webex 组织。

    • 它是使用内建或 SIP 呼叫的设备,这种呼叫使用 SIP TLS,并且提供的证书包含部署视频集成的 Webex 组织的一个已验证 SIP 域


       

      如果在对 Webex 的 SIP 呼叫上启用 TLS 验证,则 TLS 验证应该检查主题名称 sip.webex.com (而非 m.webex.com)。

      有关Cisco Expressway的帮助,请参阅配置 Expressway 以进行 MTLS 验证

  • 如果会议组织者将谁可以绕过等候区?如果将会议选项设置为“组织者和我”或“我邀请的人员”,则尝试作为受信任呼叫者加入的呼叫者将被放置到团队会议的等候区中。 来电者将看到“正在等待其他人”的初始屏幕,而不是预期的等候区初始屏幕。

  • 如果您在 Microsoft Teams 租户设置中禁用匿名用户可以加入会议,则视频集成参加者无法通过等候区加入。 通常会绕过等候区的视频集成参加者仍能加入 Microsoft Teams 会议。

网络

  • 对视频集成的呼叫不会使用 Webex 视频网节点;流量直接从设备到云端。

  • Microsoft Teams 视频集成使用的专用媒体群集不属于 Webex 注册设备执行的可达性测试的一部分。 如果无法打开对任何媒体集群 IP 范围的访问,可能会导致呼叫失败。 根据呼叫者的来源,该集成将尝试为每个呼叫使用最佳媒体集群。 但是,您必须允许访问所有媒体集群,因为使用的媒体集群会根据运行时条件而变化。