create_live_pull_stream_task
Create a scheduled task to pull live or video-on-demand streams and push them to a specified Tencent Cloud Live destination with configurable parameters and optional features like backup sources, transcoding, and recording.
Instructions
创建直播拉流任务
Args:
region: 地域
source_type: 拉流源的类型
source_urls: 拉流源 url 列表
domain_name: 推流域名
app_name: 推流路径
stream_name: 推流名称
start_time: 开始时间
end_time: 结束时间
operator: 任务操作人备注
push_args: 推流参数(optional)
callback_events: 需要回调的事件(optional)
vod_loop_times: 点播拉流转推循环次数(optional)
vod_refresh_type: 点播更新SourceUrls后的播放方式(optional)
callback_url: 自定义回调地址(optional)
extra_cmd: 其他参数(optional)
specify_task_id: 自定义任务 ID(optional)
comment: 任务描述(optional)
to_url: 完整目标 URL 地址(optional)
file_index: 指定播放文件索引(optional)
offset_time: 指定播放文件偏移(optional)
backup_source_type: 备源的类型(optional)
backup_source_url: 备源 URL(optional)
vod_local_mode: 点播源是否启用本地推流模式(optional)
record_template_id: 录制模板 ID(optional)
backup_to_url: 新的目标地址,用于任务同时推两路场景(optional)
transcode_template_name: 直播转码模板(optional)
Returns:
TaskId: 任务ID
请求ID
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| region | No | 地域 | ap-guangzhou |
| source_type | No | 拉流源的类型:PullLivePushLive -直播,PullVodPushLive -点播,PullPicPushLive -图片。示例值:PullLivePushLive | |
| source_urls | No | 拉流源 url 列表,SourceType 为直播(PullLivePushLive)只可以填1个,SourceType 为点播(PullVodPushLive)可以填多个,上限30个。当前支持的文件格式:flv,mp4,hls。当前支持的拉流协议:http,https,rtmp,rtmps,rtsp,srt。 | |
| domain_name | No | 推流域名。将拉取过来的流推到该域名 | |
| app_name | No | 推流路径。将拉取过来的流推到该路径。 | |
| stream_name | No | 推流名称。将拉取过来的流推到该流名称。 | |
| start_time | No | 开始时间。使用 UTC 格式时间,例如:2019-01-08T10:00:00Z | |
| end_time | No | 结束时间 | |
| operator | No | 任务操作人备注 | |
| push_args | No | 推流参数。推流时携带自定义参数。 | |
| callback_events | No | 选择需要回调的事件(不填则回调全部) | |
| vod_loop_times | No | 点播拉流转推循环次数,默认:-1 | |
| vod_refresh_type | No | 点播更新SourceUrls后的播放方式:ImmediateNewSource:立即播放新的拉流源内容;ContinueBreakPoint:播放完当前正在播放的点播 url 后再使用新的拉流源播放。(旧拉流源未播放的点播 url 不会再播放) | |
| callback_url | No | 自定义回调地址。拉流转推任务相关事件会回调到该地址。 | |
| extra_cmd | No | 其他参数 | |
| specify_task_id | No | 自定义任务 ID | |
| comment | No | 任务描述,限制 512 字节 | |
| to_url | No | 完整目标 URL 地址 | |
| file_index | No | 指定播放文件索引 | |
| offset_time | No | 指定播放文件偏移 | |
| backup_source_type | No | 备源的类型:PullLivePushLive -直播,PullVodPushLive -点播 | |
| backup_source_url | No | 备源 URL | |
| vod_local_mode | No | 点播源是否启用本地推流模式,默认0,不启用 | |
| record_template_id | No | 录制模板 ID | |
| backup_to_url | No | 新的目标地址,用于任务同时推两路场景 | |
| transcode_template_name | No | 直播转码模板,使用云直播的转码功能进行转码后再转推出去。转码模板需在云直播控制台创建 |