如何使用实时听录
警告
Azure 媒体服务将于 2024 年 6 月 30 日停用。 有关详细信息，请参阅 AMS 停用指南。
听录传递和播放
使用 MPEG-DASH 或 HLS/CMAF 发布实时传送流时， IMSC1.1 兼容的 TTML 格式听录文本与视频和音频一起创建。 该内容会打包为 MPEG-4 Part 30 (ISO/IEC 14496-30) 片段。 若使用 HLS/TS，文本将按照区块 VTT 传输。
注意
启用实时听录需要额外付费。 请查看媒体服务定价页的“实时视频”部分中的定价信息。
重要
应该对实时事件使用 2 秒的 GOP 大小。 对于包含实时听录内容的直通实时事件，必须使用 4 秒或更低的 GOP 大小，以获取正确的听录数据。 如果你选择使用更高的 GOP 大小，听录数据可能有缺陷，例如缺少内容。
实时听录自动生成 VTT 文件
为实时事件启用实时听录时，将会生成一个 WebVTT 文件，该文件位于存档资产的根目录中。 由于此文件的生成会延迟到所有语音广播完毕后，因此不应在广播结束后的几分钟内删除实时输出。 然后，可以下载并编辑 VTT 文件，或将其用于字幕的其他语言翻译。 该类文件命名为 auto-generated-best_XXX.vtt。
警告
最终自动生成的实时听录 VTT 文件会延迟处理。 除非等待几分钟再删除实时输出，否则文件中的内容将被截断。 此外，实时听录不可用于一个实时事件的多个输入流。
有关如何将轨道 API 与生成的 WebVTT 文件配合使用的详细信息，请参阅轨道一文。
创建具有实时听录功能的实时事件
可使用 Azure 门户、REST API 或任何 SDK 创建具有实时听录功能的实时事件。
语言代码必须与视频中的口语匹配。 请参阅本文末尾的语言代码表。
在实时事件开始后开始或停止
可以在直播活动处于运行、等待或停止状态时开始和停止，或更改直播听录语言。
重要
将任意数据写入输出资产之前必须开启或关闭实时听录 - 这通常是在创建实时输出时，或者传入的输入流到达直播活动时进行。
如需启用实时听录或更新听录语言，请修补实时事件，在“语言”属性中添加具有正确语言代码的“听录”属性。 请参阅上表，了解支持的语言代码。
若要禁用实时听录，请删除实时事件对象中的“transcriptions”属性。
实时听录区域和语言
此处列出的区域提供了实时听录功能。
这是可听录语言的列表，请在 API 中使用语言代码。
| 语言 | 区域设置 (BCP-47) |
|---|---|
| 南非荷兰语（南非） | af-ZA |
| 阿姆哈拉语（埃塞俄比亚） | am-ET |
| 阿拉伯语（阿尔及利亚） | ar-DZ |
| 阿拉伯语(巴林)，现代标准 | ar-BH |
| 阿拉伯语（埃及） | ar-EG |
| 阿拉伯语（伊拉克） | ar-IQ |
| 阿拉伯语（以色列） | ar-IL |
| 阿拉伯语（约旦） | ar-JO |
| 阿拉伯语（科威特） | ar-KW |
| 阿拉伯语（黎巴嫩） | ar-LB |
| 阿拉伯语（利比亚） | ar-LY |
| 阿拉伯语（摩洛哥） | ar-MA |
| 阿拉伯语（阿曼） | ar-OM |
| 阿拉伯语（巴勒斯坦民族权利机构） | ar-PS |
| 阿拉伯语（卡塔尔） | ar-QA |
| 阿拉伯语(沙特阿拉伯) | ar-SA |
| 阿拉伯语（叙利亚） | ar-SY |
| 阿拉伯语（突尼斯） | ar-TN |
| 阿拉伯语（阿拉伯联合酋长国） | ar-AE |
| 阿拉伯语（也门） | ar-YE |
| 孟加拉语（印度） | bn-IN |
| 保加利亚语(保加利亚) | bg-BG |
| 缅甸语(缅甸) | my-MM |
| 加泰罗尼亚语(西班牙) | ca-ES |
| 中文(粤语，繁体) | zh-HK |
| 中文（普通话，简体） | zh-CN |
| 中文(台湾普通话) | zh-TW |
| 克罗地亚语（克罗地亚） | hr-HR |
| 捷克语（捷克） | cs-CZ |
| 丹麦语（丹麦） | da-DK |
| 荷兰语（比利时） | nl-BE |
| 荷兰语（荷兰） | nl-NL |
| 英语（澳大利亚） | en-AU |
| 英语（加拿大） | en-CA |
| 英语（加纳） | en-GH |
| 英语（中国香港） | en-HK |
| 英语（印度） | en-IN |
| 英语（爱尔兰） | en-IE |
| 英语（肯尼亚） | en-KE |
| 英语（新西兰） | en-NZ |
| 英语（尼日利亚） | en-NG |
| 英语（菲律宾） | en-PH |
| 英语（新加坡） | en-SG |
| 英语（南非） | en-ZA |
| 英语（坦桑尼亚） | en-TZ |
| 英语（英国） | en-GB |
| 英语（美国） | en-US |
| 爱沙尼亚语(爱沙尼亚) | et-EE |
| 菲律宾语（菲律宾） | fil-PH |
| 芬兰语（芬兰） | fi-FI |
| 法语（比利时） | fr-BE |
| 法语（加拿大） | fr-CA |
| 法语（法国） | fr-FR |
| 法语（瑞士） | fr-CH |
| 德语（奥地利） | de-AT |
| 德语（德国） | de-DE |
| 德语（瑞士） | de-CH |
| 希腊语(希腊) | el-GR |
| 古吉拉特语(印度) | gu-IN |
| 希伯来语（以色列） | he-IL |
| 印地语（印度） | hi-IN |
| 匈牙利语(匈牙利) | hu-HU |
| 冰岛语(冰岛) | is-IS |
| 印度尼西亚语(印度尼西亚) | id-ID |
| 爱尔兰语（爱尔兰） | ga-IE |
| 意大利语（意大利） | it-IT |
| 日语（日本） | ja-JP |
| 爪哇语（印度尼西亚） | jv-ID |
| 卡纳达语（印度） | kn-IN |
| 高棉语(柬埔寨) | km-KH |
| 韩语(韩国) | ko-KR |
| 老挝语(老挝) | lo-LA |
| 拉脱维亚语(拉脱维亚) | lv-LV |
| 立陶宛语(立陶宛) | lt-LT |
| 马其顿语（北马其顿） | mk-MK |
| 马来语（马来西亚） | ms-MY |
| 马耳他语（马耳他） | mt-MT |
| 马拉地语(印度) | mr-IN |
| 挪威语（博克马尔语，挪威） | nb-NO |
| 波斯语（伊朗） | fa-IR |
| 波兰语（波兰） | pl-PL |
| 葡萄牙语（巴西） | pt-BR |
| 葡萄牙语(葡萄牙) | pt-PT |
| 罗马尼亚语(罗马尼亚) | ro-RO |
| 俄语（俄罗斯） | ru-RU |
| 塞尔维亚语（塞尔维亚） | sr-RS |
| 僧伽罗语(斯里兰卡) | si-LK |
| 斯洛伐克语（斯洛伐克） | sk-SK |
| 斯洛文尼亚语(斯洛文尼亚) | sl-SI |
| 西班牙语（阿根廷） | es-AR |
| 西班牙语（玻利维亚） | es-BO |
| 西班牙语（智利） | es-CL |
| 西班牙语（哥伦比亚） | es-CO |
| 西班牙语（哥斯达黎加） | es-CR |
| 西班牙语（古巴） | es-CU |
| 西班牙语（多米尼加共和国） | es-DO |
| 西班牙语（厄瓜多尔） | es-EC |
| 西班牙语（萨尔瓦多） | es-SV |
| 西班牙语（赤道几内亚） | es-GQ |
| 西班牙语（危地马拉） | es-GT |
| 西班牙语（洪都拉斯） | es-HN |
| 西班牙语(墨西哥) | es-MX |
| 西班牙（尼加拉瓜） | es-NI |
| 西班牙语（巴拿马） | es-PA |
| 西班牙语（巴拉圭） | es-PY |
| 西班牙语（秘鲁） | es-PE |
| 西班牙语（波多黎各） | es-PR |
| 西班牙语(西班牙) | es-ES |
| 西班牙语（乌拉圭） | es-UY |
| 西班牙语（美国） | es-US |
| 西班牙语（委内瑞拉） | es-VE |
| 斯瓦希里语（肯尼亚） | sw-KE |
| 斯瓦希里语（坦桑尼亚） | sw-TZ |
| 瑞典语（瑞典） | sv-SE |
| 泰米尔语（印度） | ta-IN |
| 泰卢固语（印度） | te-IN |
| 泰语（泰国） | th-TH |
| 土耳其语（土耳其） | tr-TR |
| 乌克兰语(乌克兰) | uk-UA |
| 乌兹别克语（乌兹别克斯坦） | uz-UZ |
| 越南语(越南) | vi-VN |
| 祖鲁语（南非） | zu-ZA |