拉流转推事件回调_视频直播(LIVE)-阿里云帮助中心

本文介绍拉流转推事件回调触发条件和回调内容示例。

拉流转推回调事件

拉流转推回调事件包括拉流转推任务运行状态变化回调和拉流转推任务已退出回调

其中拉流转推任务状态包括：

状态	说明

状态	说明
未启动（Idle）	调用API请求创建生成拉流转推的任务初始状态。
正常运行（Running）	到了设定开始时间自动启动或任务被停止重新启动后的状态。
异常运行（Recovering）	任务运行过程中发生异常重试过程中的状态。
已停止（Offline）	任务异常重试超时自动停止或调用API请求停止后的状态。
已退出（Exit）	超过设定结束时间自动删除或调用API请求删除后的状态。

拉流转推任务运行状态变化回调

说明

当拉流转推任务运行过程中状态发生变化时触发，包括：正常运行、异常运行和已停止。

触发条件

到达预设开始时间任务自动启动或调用API重启任务，任务状态变为Running
运行过程发生异常，任务状态变为Recovering
用户调用API停止任务或异常重试超时，任务状态变为Offline

拉流转推任务已退出回调

说明

当拉流转推任务退出时触发，表示任务过期被清理。

触发条件

任务执行超过预设结束时间，任务状态变为Exit
用户调用API删除任务，任务状态变为Exit

拉流转推回调事件内容说明

回调内容为JSON格式，通过HTTP POST请求包含在请求体（Request Body）中发送到CallbackUrl回调地址中，解析请求体获取回调内容。

拉流转推任务运行状态变化回调参数和示例

表 1. 拉流转推任务运行状态变化回调内容说明

参数	描述
Event	事件名称，固定值：`LivePullToPushRunning`
EventTime	事件发生时间，Unix 秒时间戳。
TaskId	任务ID
TaskInfo	任务信息
TaskStatus	任务当前状态，取值： 1：正常运行（Running） 2：异常运行（Recovering） 3：已停止（Offline）
TaskInvalidReason	任务运行异常或停止运行的原因，取值： `PullStreamFailed`：拉流失败 `PushStreamFailed`：转推失败 `TriggerByUser`：用户调用API `UnknownError`：未知原因 `RetryTimesOffline`：定时异常回调说明仅停止运行（Offline）情况下返回此参数。

拉流转推任务运行状态变化回调参数示例

{
"Event": "LivePullToPushRuning",
"EventTime": "1725501246",
"TaskId": "08a1b00c-9c2f-4dfa-9f5d-878f2505****",
"TaskInfo": {
    "TaskId": "08a1b00c-9c2f-4dfa-9f5d-878f250****",
    "StartTime": "2024-09-05T01:54:00Z",
    "EndTime": "2024-09-05T01:58:00Z",
    "SourceUrls": [
      "\"http://fyl-*******-*****.oss-cn-beijing.aliyuncs.com/record/caster/741584e2557248e98ef332d41e4afc3d/2024-08-30-18:19:40_2024-08-30-18:21:09.mp4\""
    ],
    "DstUrl": "rtmp://pushtest.******.aliyunlive.com/pulltest38/pulltest-w38",
    "CallbackURL": "https://1833220977******.cn-shanghai.lc.aliyuncs.com/workflows/lc-uf6sd1382ikolc/triggers/manual/methods/invoke?ApiVersion=2018-12-12&Signature=TZT7CGDgc299cC2dtL73Yeq4xY8",
    "Offset": 0,
    "SourceType": "url"
  },
"TaskStatus": "1"
}

拉流转推任务已退出回调参数和示例

表 2. 拉流转推任务已退出回调内容说明

参数	描述
Event	事件名称，固定值：`LivePullToPushExit`
EventTime	事件发生时间，Unix 秒时间戳。
TaskId	任务ID。
TaskInfo	任务信息。
TaskStatus	任务当前状态，取值： -1：已退出
TaskExitTime	任务退出时间，Unix 秒级时间戳。
TaskExitReason	任务退出原因，取值： `TriggerByUser`：用户调用API `OverEndTime`：超过预设结束时间

拉流转推任务已退出回调参数示例

{
  "Event": "LivePullToPushExit",
  "EventTime": "1725501483",
  "TaskId": "08a1b00c-9c2f-4dfa-9f5d-878f2505****",
  "TaskInfo":  {
    "TaskId": "08a1b00c-9c2f-4dfa-9f5d-878f2505****",
    "StartTime": "2024-09-05T01:54:00Z",
    "EndTime": "2024-09-05T01:58:00Z",
    "SourceUrls": [
      "\"http://fyl-******-****.oss-cn-beijing.aliyuncs.com/record/caster/741584e2557248e98ef332d41e4afc3d/2024-08-30-18:19:40_2024-08-30-18:21:09.mp4\""
    ],
    "DstUrl": "rtmp://pushtest.*****.aliyunlive.com/pulltest38/pulltest-w38",
    "CallbackURL": "https://1833220977******.cn-shanghai.lc.aliyuncs.com/workflows/lc-uf6sd1382ikolc/triggers/manual/methods/invoke?ApiVersion=2018-12-12&Signature=TZT7CGDgc299cC2dtL73Yeq4xY8",
    "Offset": 0,
    "SourceType": "url"
  },
  "TaskStatus": "-1",
  "TaskExitTime": "1725501483",
  "TaskExitReason": "OverEndTime",
}