2026/02/05 13:09:09

录制字幕

实时转录翻译支持录制字幕文本，生成 .vtt 文件并保存到配置的云存储中。录制的字幕可与音视频录制文件同步播放，也可用于生成会议纪要与主题摘要、情感分析和内容审核。录制字幕不收取额外费用。

本文介绍如何录制字幕，并将字幕与云端录制生成的音视频文件同步。

注意

云端录制与转写任务运行在不同服务器上，要同步时间戳，必须在云端录制中开启 NTP 时间戳。

前提条件

开始前，清确保你的开发环境满足以下条件：

参考开通服务在声网控制台开通实时语音转写服务，并复制保存 App ID、临时 Token、客户 ID 和客户密钥，以供后续使用。
可以访问互联网的计算机。如果你的网络环境部署了防火墙，参考应对防火墙限制以正常使用声网服务。
集成并使用声网实时互动 RTC SDK 搭建一个极简的实时音视频互动 App。
参考实现 HTTP 基本认证获取 Authorization 值。

使用原生平台 v4.2.6.3 或 Web v4.20.1 及以上版本的 Video SDK，并支持 datastreamEncryptionEnabled。

在云端录制的 start 请求体中将 enableNTPtimestamp 参数设置为 true，以便与转写时间戳对齐。

云端录制 start 请求体示例

JSON
"recordingConfig": {
    "maxIdleTime": 30,
    "streamTypes": 2,
    "channelType": 1,
    "extensionParams": {
        "enableNTPtimestamp": true
    },
    "transcodingConfig": {
        "width": 1280,
        "height": 720,
        "fps": 15,
        "bitrate": 2400,
        "mixedVideoLayout": 3,
        "layoutConfig": [
            {
                "alpha": 1,
                "height": 1,
                "render_mode": 1,
                "uid": "22228",
                "width": 1,
                "x_axis": 0,
                "y_axis": 0
            }
        ]
    }
},

实现方法

按照以下步骤录制字幕，并与对应录制文件同步以便顺畅回放。

录制字幕

按照快速开始中的 API 调用流程，并在 start 请求中加入字幕录制参数，如下所示：

Shell
curl --location --request POST 'https://api.sd-rtn.com/api/speech-to-text/v1/projects/{appId}/join' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic <credentials>' \
--data '{
    "name": "unique-agent-id",
    "languages": [
        "en-US"
    ],
    "maxIdleTime": 50,
    "rtcConfig": {
        "channelName": "<YourChannelName>",
        "subBotUid": "<YourSubscribeUid>",
        "subBotToken": "<YourSubscribeToken>",
        "pubBotUid": "<YourPublishUid>",
        "pubBotToken": "<PublishToken-IfRequired>"
    },
    "captionConfig": {
        "storage": {
            "accessKey": "<YourOssAccessKey>",       
            "secretKey": "<YourOssSecretKey>",       
            "bucket": "<YourOssBucketName>",         
            "vendor": <YourOssVendorCode>,               
            "region": <YourOssRegionCode>,               
            "fileNamePrefix": ["folder","sub-folder"]  
        }
    }
}'

同步文件

实时转录翻译生成的 m3u8+vtt 与云端录制生成的 m3u8+ts 是两套独立文件，时间戳不同：云端录制时间戳从 0 开始，实时转录翻译使用系统时间戳。如果任一过程异常启动，可能导致播放时音视频与字幕不同步。

声网提供了后处理脚本用于同步 m3u8+ts 与 m3u8+vtt 文件。运行步骤如下：

对转写文件运行脚本：

Python
python3 insert_subtitle.py --av audio_dir/audio_ts.m3u8 --subtitle subtitle_dir/subtitle.m3u8 --output output_dir/ --overwrite

如果 ffmpeg/ffprob 不在 PATH 中，可通过 -ffmpeg_path 指定路径。

播放同步后的文件：
1. 运行下列命令启动 HTTP 服务器：
  Python
  python3 -m http.server --bind 127.0.0.1 -d output_dir
2. 在浏览器访问：
  Bash
  http://127.0.0.1:8000/player_demo.html

支持的云存储厂商

vendor：Number，第三方云存储厂商，支持以下取值：

1： Amazon S3
5： Microsoft Azure
6： Google Cloud

region：Number，第三方云存储的地域信息，仅支持以下列表：

阿里云 (vendor = 2):
- 0: CN_Hangzhou
- 1: CN_Shanghai
- 2: CN_Qingdao
- 3: CN_Beijing
- 4: CN_Zhangjiakou
- 5: CN_Huhehaote
- 6: CN_Shenzhen
- 7: CN_Hongkong
- 8: US_West_1
- 9: US_East_1
- 10: AP_Southeast_1
- 11: AP_Southeast_2
- 12: AP_Southeast_3
- 13: AP_Southeast_5
- 14: AP_Northeast_1
- 15: AP_South_1
- 16: EU_Central_1
- 17: EU_West_1
- 18: EU_East_1
- 19: AP_Southeast_6
- 20: CN_Heyuan
- 21: CN_Guangzhou
- 22: CN_Chengdu
- 23: CN_Nanjing
- 24: CN_Fuzhou
- 25: CN_Wulanchabu
- 26: CN_Northeast_2
- 27: CN_Southeast_7
详见阿里云官方文档.
腾讯云 (vendor = 3):
- 0: AP_Beijing_1
- 1: AP_Beijing
- 2: AP_Shanghai
- 3: AP_Guangzhou
- 4: AP_Chengdu
- 5: AP_Chongqing
- 6: AP_Shenzhen_FSI
- 7: AP_Shanghai_FSI
- 8: AP_Beijing_FSI
- 9: AP_Hongkong
- 10: AP_Singapore
- 11: AP_Mumbai
- 12: AP_Seoul
- 13: AP_Bangkok
- 14: AP_Tokyo
- 15: NA_Siliconvalley
- 16: NA_Ashburn
- 17: NA_Toronto
- 18: EU_Frankfurt
- 19: EU_Moscow
金山云 (vendor = 4):
- 0: CN_Hangzhou
- 1: CN_Shanghai
- 2: CN_Qingdao
- 3: CN_Beijing
- 4: CN_Guangzhou
- 5: CN_Hongkong
- 6: JR_Beijing
- 7: JR_Shanghai
- 8: NA_Russia_1
- 9: NA_Singapore_1

华为云 (vendor = 7):
- 0: CN_North_1
- 1: CN_North_4
- 2: CN_East_2
- 3: CN_East_3
- 4: CN_South_1
- 5: CN_Southwest_2
- 6: AP_Southeast_1
- 7: AP_Southeast_2
- 8: AP_Southeast_3
- 9: AF_South_1
- 10: SA_Argentina_1
- 11: SA_Peru_1
- 12: NA_Mexico_1
- 13: SA_Brazil_1
- 14: LA_South_2
- 15: SA_Chile_1

前提条件​

实现方法​

录制字幕​

同步文件​

支持的云存储厂商​

前提条件

实现方法

录制字幕

同步文件

支持的云存储厂商