你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
隐藏式字幕
隐藏式字幕在视频语音通话应用中发挥关键作用，它提供了许多优势，增强了这些平台的辅助功能、可用性和整体用户体验。
本文介绍如何启用使用 UI 库的隐藏式字幕方案。 可通过两种方案启用隐藏式字幕：Azure 通信服务视频和语音通话及互操作通话。
基于 Azure 通信服务的字幕
仅支持涉及 Azure 通信服务用户的通话。 目前，Azure 通信服务字幕不支持语言翻译。
Teams 互操作隐藏式字幕
在与一个或多个 Teams 用户进行通话期间受支持。
翻译支持
与 Azure 通信服务隐藏式字幕不同，Teams 互操作隐藏式字幕支持翻译。 用户可以通过字幕设置选择将隐藏式字幕翻译为其他语言。
如何使用字幕
字幕无缝集成在 CallingUILibrary 中。
激活字幕：
- 在连接通话期间，导航到控制栏并单击“更多”按钮。
- 在菜单弹出项中，切换以启用字幕。
调整口语：
- 如果在会议中使用其他语言，则用户可以通过 UI 更改口语。 此更改适用于通话中的所有用户。
设置字幕语言（适用于 Teams 互操作隐藏式字幕）：
- 默认情况下，实时字幕以会议或活动口语显示。 借助实时翻译的字幕，用户可以看到已翻译为其最熟悉的语言的字幕。
- 如果需要翻译为其他语言，请在字幕启动后通过单击“字幕语言”按钮来更改字幕语言。
注意
会议中的实时翻译字幕仅随 Teams 高级版提供，这是一种附加产品许可证，用于提供可提高 Teams 会议的个性化水平、智能程度及安全性的其他功能。 要访问 Teams 高级版，请联系 IT 管理员。要了解更多详细信息，请访问此处。
支持的语言
Azure 通信服务支持各种口语字幕。 下表包含了可与 setSpokenLanguage 方法一起使用以设置所需字幕语言的受支持语言代码列表。
| 语言 | ACS 口语代码 | Teams 口语代码 | Teams 字幕代码 |
|---|---|---|---|
| 阿拉伯语 | ar-ae、ar-sa | ar-ae、ar-sa | ar |
| 丹麦语 | da-dk | da-dk | da |
| 德语 | de-de | de-de | de |
| 英语 | en-au、en-ca、en-gb、en-in、en-nz、en-us | en-au、en-ca、en-gb、en-in、en-nz、en-us | en |
| 西班牙语 | es-es、es-mx | es-es、es-mx | es |
| 芬兰语 | fi-fi | fi-fi | fi |
| 法语 | fr-ca、fr-fr | fr-ca、fr-fr | fr、fr-ca |
| Hindi | hi-in | hi-in | hi |
| 意大利语 | it-it | it-it | it |
| 日语 | ja-jp | ja-jp | ja |
| 韩语 | ko-kr | ko-kr | ko |
| 挪威语 | nb-no | nb-no | nb |
| 荷兰语 | nl-be、nl-nl | nl-be、nl-nl | nl |
| 波兰语 | pl-pl | pl-pl | pl |
| 葡萄牙语 | pt-br | pt-br、pt-pt | pt, pt-pt |
| 俄语 | ru-ru | ru-ru | ru |
| 瑞典语 | sv-se | sv-se | sv |
| 中文 | zh-cn、zh-hk | zh-cn、zh-hk | zh-Hans、zh-Hant |
| 捷克语 | — | cs-cz | cs |
| 斯洛伐克语 | — | sk-sk | sk |
| 土耳其语 | — | tr-tr | tr |
| 越南语 | — | vi-vn | vi |
| 泰语 | — | th-th | th |
| 希伯来语 | — | he-il | he |
| 威尔士语 | — | cy-gb | cy |
| 乌克兰语 | — | uk-ua | uk |
| 希腊语 | — | el-gr | el |
| 匈牙利语 | — | hu-hu | hu |
| 罗马尼亚语 | — | ro-ro | ro |
确保所选的口语与通话中使用的语言匹配，以准确生成字幕。
先决条件
- 具有活动订阅的 Azure 帐户。 免费创建帐户。
- 已部署的通信服务资源。 创建通信服务资源。
- 用于启用通话客户端的用户访问令牌。 获取用户访问令牌。
- 可选：完成快速入门以开始使用 UI 库复合项。
设置功能
启用隐藏式字幕
默认情况下，方法 setCaptionsOn 将配置为启动字幕。
启用隐藏式字幕
默认情况下，方法 captionsOn 将配置为启动字幕。
let captionsOptions = CaptionsOptions(
captionsOn: true,
spokenLanguage: "en-US"
)
let localOptions = LocalOptions(
participantViewData: participantViewData,
setupScreenViewData: setupScreenViewData,
cameraOn: false,
microphoneOn: false,
skipSetupScreen: false,
audioVideoMode: .audioAndVideo,
captionsOptions: captionsOptions
)