Çekme akışı röle geri aramaları - ApsaraVideo Live - Alibaba Cloud Dokümantasyon Merkezi

Çekme akışı röle geri aramaları, bir görevin durumu değiştiğinde veya sonlandığında uygulamanızı bilgilendirir. Bu konu, tetikleme koşullarını ve örnek geri arama yüklerini kapsar.

Geri arama olayları

Çekme akışı röle geri aramaları iki tür olayı kapsar: görev durumu değişiklikleri ve görev çıkışları.

Bir çekme akışı röle görevi aşağıdaki durumlardan birinde olabilir:

Durum	Açıklama
Idle	Bir API çağrısıyla oluşturulan görevin başlangıç durumu.
Running	Görevin planlanan zamanda başladığı veya bir API çağrısıyla yeniden başlatıldığı durum.
Recovering	Görevin yürütme hatası sonrasında yeniden deneme yaptığı durum.
Offline	Yeniden deneme girişimlerinin zaman aşımına uğraması veya bir API çağrısıyla görevin durdurulması sonrası oluşan durum.
Exit	Planlanan bitiş zamanına ulaşıldığında veya bir API çağrısıyla görev silindiğinde oluşan durum.

Görev durumu değişiklikleri için geri arama

Açıklama

Bir çekme akışı röle görevi Running, Recovering veya Offline durumuna geçtiğinde bir geri arama tetiklenir.

Tetikleme koşulları

Görev, planlanan başlangıç saatinde başladığında veya bir API çağrısıyla yeniden başlatıldığında Running durumuna geçer.
Görev yürütme sırasında bir hatayla karşılaştığında Recovering durumuna geçer.
Bir API çağrısıyla durdurulduğunda veya yeniden deneme girişimleri zaman aşımına uğradığında görev Offline durumuna geçer.

Görev çıkışı için geri arama

Açıklama

Bir çekme akışı röle görevi çıktığında bir geri arama tetiklenir. Çıkış, sistemin süresi dolan görevi kaldırdığı anlamına gelir.

Tetikleme koşulları

Sistem, planlanan bitiş zamanına ulaşıldığı için görevi sildiğinde görev Exit durumuna geçer.
Bir API çağrısıyla görev silindiğinde görev Exit durumuna geçer.

Geri arama yükü

Geri arama, geri arama URL'nize yapılan bir HTTP POST isteğinin istek gövdesinde bir JSON nesnesi olarak gönderilir. Geri arama içeriğini almak için istek gövdesini ayrıştırın.

Görev durumu değişikliği geri araması için parametreler ve örnek yük

Tablo 1. Görev durumu değişiklikleri için geri arama yükü

Parametre	Açıklama
Event	Olay adı. Sabit değer: `LivePullToPushRunning`.
EventTime	Olayın gerçekleştiği zaman, saniye cinsinden Unix zaman damgası olarak.
TaskId	Görev kimliği.
TaskInfo	Görev bilgileri.
TaskStatus	Görevin mevcut durumu. Geçerli değerler: 1: Running 2: Recovering 3: Offline
TaskInvalidReason	Görevin anormal çalışmasının veya durmasının nedeni. Geçerli değerler: `PullStreamFailed`: Akış çekilemedi. `PushStreamFailed`: Akış röle edilemedi. `TriggerByUser`: Bir API çağrısıyla durduruldu. `UnknownError`: Bilinmeyen bir hata oluştu. `RetryTimesOffline`: Yeniden deneme girişimleri zaman aşımına uğradı. Not Bu parametre yalnızca görev durumu `Offline` olduğunda döndürülür.

Örnek yük

{
"Event": "LivePullToPushRunning",
"EventTime": "1725501246",
"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"
}

Görev çıkışı geri araması için parametreler ve örnek yük

Tablo 2. Görev çıkışı için geri arama yükü

Parametre	Açıklama
Event	Olay adı. Sabit değer: `LivePullToPushExit`.
EventTime	Olayın gerçekleştiği zaman, saniye cinsinden Unix zaman damgası olarak.
TaskId	Görev kimliği.
TaskInfo	Görev bilgileri.
TaskStatus	Görevin mevcut durumu. Geçerli değer: -1: Exit
TaskExitTime	Görevin çıktığı zaman, saniye cinsinden Unix zaman damgası olarak.
TaskExitReason	Görevin çıkış nedeni. Geçerli değerler: `TriggerByUser`: Bir API çağrısıyla silindi. `OverEndTime`: Planlanan bitiş zamanına ulaşıldı.

Örnek yük

{
  "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",
}