概述

适用于 Microsoft Teams 的 Webex 视频集成支持从云端或本地部署中注册的支持 Cisco 和 SIP 的视频设备呼入 Microsoft Teams 会议。

此集成在受支持的设备加入在您的组织中主持的 Microsoft Teams 会议时,增强了这些设备上的体验:

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

  • 显示 Microsoft 和视频集成参加者的名单

  • 双向内容共享

  • 关于会议录制是否正在进行的指示器

会议邀请中的视频设备加入体验

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

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

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

SIP IVR 视频地址特定于您的组织,并使用您组织的 Cisco Webex SIP 子域构成,其格式为 <subdomain>@m.webex.com

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

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

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

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

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

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

适用于 Microsoft Teams 的视频集成要求

要求

说明

活动 Cisco Webex 组织

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

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

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

Cisco 视频集成许可证,每个要通过该集成使用的视频设备各一个。

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

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

Cisco Webex 混合日历服务(可选,但强烈建议使用)

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

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

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

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

信号传输

视频设备连接到 Cisco Webex 数据中心以进行信号传输。

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

视频设备

协议

端口号码

注释

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

TCP

443

要了解相关要求,请参阅 Webex 服务的网络要求

其他 SIP 视频设备

TCP

5060/5061

要获取相关要求,请参阅如何在我的网络上允许使用 Webex Meetings 流量?

媒体

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

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

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

视频设备

协议

端口号码

媒体集群区域和 IP 范围

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

TCP/UDP

5004

  • 澳大利亚东部:

    20.53.87.0/24

  • 东南亚:

    40.119.234.0/24

  • 美国东部:

    52.232.210.0/24

    20.57.87.0/24

  • 英国南部:

    20.68.154.0/24

    20.108.99.0/24

  • 西欧:

    20.50.235.0/24

    20.76.127.0/24

UDP

33434

其他 SIP 视频设备

UDP

36000-59999

在 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 浏览器。(请参阅 Cisco Webex 服务的系统要求以了解浏览器兼容性。)


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

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

    • 已安装 MicrosoftTeams PowerShell 模块。 (建议使用 2.0 版或更高版本。) 请参阅 Microsoft 文档网站中的“安装 Microsoft Teams PowerShell”了解更多信息。

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

1

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

2

要检查是否为 Webex SIP 地址设置子域,请在组织的客户视图中,转至设置,然后滚动至 Cisco Webex Calling 的 SIP 地址。 如果未设置子域,请参阅更改 Cisco 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

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

要获取帮助,请参阅 Microsoft 文档网站上的“Grant-CsTeamsVideoInteropServicePolicy”。

  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 云或使用适用于设备的 Webex Edge 链接到云。

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

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

正如备用视频设备加入方式 - 加入按钮中所述,如果您启用混合日历服务,可以使用 Cisco 的一键操作 (OBTP) 解决方案进一步增强组织的呼叫体验。

通过 Cisco 的 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 云或使用适用于设备的 Webex Edge 链接到云。


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

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

功能限制

本节列出了适用于 Microsoft Teams 的视频集成的限制和值得注意的行为。

多个组织和租户

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

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

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

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

可用性

视频设备互操作性

  • 集成仅支持传入 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 会议时,您必须使用为该租户启用的视频集成的视频地址。

  • Cisco 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 取消静音才会清除名单中的静音指示器。 (在本地取消静音不会清除名单中的静音指示器。)

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

Microsoft Teams 等候区

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

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

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


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

      要获取有关 Cisco Expressway 的帮助,请参阅 https://help.webex.com/en-us/notkgfab/Configure-Expressway-for-Mutual-TLS-Authentication

  • 如果会议组织者编辑等候区设置,以仅允许主持人进入,则将被视为可信(如上文所述)的呼叫者不受此设置的限制,仍会自动绕过等候区。

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

网络

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

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