Tüm Ürünler
Search
Belge Merkezi

ApsaraVideo Live:Pulled-stream relay

Son Güncelleme:Oct 02, 2026

Çekilen akış aktarımı, mevcut canlı yayın veya video on demand (VOD) kaynaklarını çekerek bunları yeni canlı akışlar olarak iletmenizi sağlar.

Genel Bakış

Çekilen akış aktarımı, üçüncü taraf canlı akışlardan veya kayıtlı videolardan içerik çeker ve geleneksel ingest adımları olmadan izleyicilere gerçek zamanlı olarak yayınlar.

İş Akışı:

image

Tipik Senaryo: Araç İzleme Erişimi

Araç üstü cihazlar genellikle JT/T 1078 veya Jiangsu Eyaleti standardı gibi özel protokollerde video akışları üretir. Bu tür bir akışı ApsaraVideo Live'a bağlamak için özel protokol akışını standart bir RTMP akışına dönüştüren bir protokol dönüşüm ağ geçidi kullanın. Ardından, bir çekilen akış aktarımı görevi oluşturun. Source Stream Type öğesini Live Stream olarak ayarlayın, kaynak akış protokolünü RTMP olarak seçin ve dönüştürülen RTMP kaynak akış URL'si ile hedef ingest URL'sini girin. Mobil istemciler daha sonra Alibaba Cloud Player SDK kullanarak akışı oynatabilir.

Kullanım Notları

  • Bu özellik ücretlidir. Faturalandırma 5 Aralık 2025 tarihinde saat 00:00'da başlar. Fiyatlandırma bilgileri için bakın: Pulled-stream relay fees.

  • Her görev tek bir akış iletir. Birden fazla akış iletmek için birden fazla görev oluşturun.

  • Akış çekme ve ingest sırasında çakışmaları önlemek için, belirli bir hedef ingest URL'sinin aynı anda yalnızca bir etkin görev tarafından kullanıldığından emin olun. auth_key değerleri farklı olsa bile StreamName dahil tüm bölümler aynı olduğunda iki hedef ingest URL'si aynı kabul edilir. Aynı hedef ingest URL'sini eşzamanlı olarak birden fazla görev kullanırsa, sonraki görev önceki akışın üzerine yazabilir veya onu değiştirebilir; bu durum canlı yayını kesintiye uğratabilir veya bozabilir.

  • Bu özellik ile kullanılan içeriğin geçerli tüm yasalara ve düzenlemelere uygun olduğundan emin olmak sizin sorumluluğunuzdadır. ApsaraVideo Live yalnızca akış iletim hizmetini sunar. Herhangi bir yasal tehdit tespit edilirse ApsaraVideo Live ilgili içerik için hizmeti durdurur ve yasal işlem başlatma hakkını saklı tutar.

  • Çin anakarası dışındaki bölgelerde akış çekmek veya iletmek için görev bölgesini Çin anakarası dışındaki bir bölge olarak ayarlayın.

  • Bu özellik olay geri aramalarını destekler. Ayrıntılar için bakın: Pulled-stream relay event callbacks.

  • Her hesap en fazla 100 eşzamanlı görev çalıştırabilir.

Ön Koşullar

  • ApsaraVideo Live etkinleştirilmiş olmalıdır.

  • Canlı veya VOD kaynağı hakkında gerekli bilgilere sahip olmalısınız.

    Kaynak türü

    Bilgi

    Canlı

    • Canlı akışın oynatma URL'si.

    • Desteklenen protokoller: RTMP, SRT ve HTTP-FLV.

    VOD

    Video

    • Video kaynağının URL yolu.

      Not

      Video URL yolu http:// veya https:// ile başlamalı ve .mp4 veya .flv ile bitmelidir.

    Not
    • Maksimum 30 VOD medya varlık kimliği veya video kaynağı URL yolu.

    • Desteklenen video kodekleri: H.264 ve H.265.

    • Desteklenen ses kodeği: AAC. Örnekleme hızı: 16 kHz ila 44,1 kHz.

    • VOD kaynakları MP4 veya FLV formatını kullanmalıdır.

  • Bir ingest URL'si ingest alan adınızdan oluşturulur. Daha fazla bilgi için bakın: Generate streaming URLs.

Yordam

Görev Oluşturma

  1. ApsaraVideo Live konsolu üzerinden oturum açın.

  2. Sol gezinme bölmesinde Feature Management > Pulled-stream Relay öğelerini seçin.

  3. Bir canlı merkez bölgesi seçin.

  4. Create Task öğesini tıklayın.

  5. Görev parametrelerini yapılandırın.

    Aşağıdaki tabloda görev parametreleri açıklanmaktadır.

    Parametre

    Açıklama

    Region

    Akış çekme görevinin bölgesi. Kaynak verilerin bölgesine veya akış ingest bölgesine göre bir bölge seçin.

    Not

    Desteklenen bölgeler: China (Shanghai), China (Beijing), China (Shenzhen), Singapore ve Indonesia (Jakarta).

    Task Name

    Görev için özel bir ad.

    Task Time

    Görevin başlangıç ve bitiş zamanları. Varsayılan olarak başlangıç zamanı geçerli zamandan beş dakika sonra, bitiş zamanı ise başlangıç zamanından 24 saat sonradır. Zaman seçici 5 minutes, 30 minutes ve 1 hour kısayolları sunar. Bir kısayol, başlangıç zamanını geçerli zamana göre ayarlar ve geçerli bir bitiş zamanını korur.

    Not

    Görev belirtilen başlangıç zamanında otomatik olarak başlar. Durursa veya başlayamazsa konsolda Enable veya Restart seçeneğini tıklayın.

    Callback Information

    Zorunludur. Çekilen akış aktarımı görev olayları için geri arama URL'si.

    Source Type

    Kaynak akış türü. Parametre ayrıntıları için bakın bu liste öğesi.

    • Live Stream: RTMP, SRT ve HTTP-FLV kaynak akış protokollerini destekler.

    • VOD Asset: MP4 video formatını destekler. Aynı video kimliğine sahip birden fazla video varsa en yüksek kod çözme çözümüne sahip video seçilir. Kodu çözülmüş videolar aynı çözünürlüğe sahipse videolardan biri rastgele seçilir. Kodu çözülmüş video yoksa orijinal video seçilir.

    • Video Path

    Playback Times

    Oynatma listesindeki videoların döngü sayısı. Sonsuz döngü seçin veya bir sayı belirtin.

    Not

    Bu parametre yalnızca VOD Asset veya Video Path kaynakları için kullanılabilir ve Playback Times öğesini kontrol eder.

    Destination Ingest URL

    Akışın iletileceği hedef ingest URL'si. Canlı akış kaynağı için rtmp:// ve rtmps:// desteklenir. Video on demand veya video yolu kaynağı için yalnızca rtmp:// desteklenir.

    Not

    ApsaraVideo Live ingest URL'si örneği:

    rtmp://ingestdomain.com//?auth_key=922353-0-0-f68cba72490a3328a1167c9**

    Callback configuration içindeki parametreler:

    • Video switch notification: Bu anahtar yalnızca VOD Asset veya Video Path kaynağı için görüntülenir ve varsayılan olarak devre dışıdır. Etkinleştirildiğinde, kaynak dosyalar arasında geçiş yaptığında bir geri arama iş sunucunuzu bilgilendirir.

    • Callback authentication: Bu anahtar varsayılan olarak devre dışıdır. Etkinleştirildiğinde geri arama istekleri ALI-LIVE-TIMESTAMP ve ALI-LIVE-SIGNATURE başlıklarını içerir.

      ALI-LIVE-SIGNATURE hesaplama yöntemi

      ALI-LIVE-SIGNATURE=LOWERCASE_HEX(MD5(SIGNCONTENT))
      SIGNCONTENT=PullFlowPushTaskID|ALI-LIVE-TIMESTAMP Value|Authentication KEY

      Alan Açıklaması:

      • PullFlowPushTaskID: Oluşturma tamamlandıktan sonra konsoldan alınabilir.

      • ALI-LIVE-TIMESTAMP: Geri arama isteğinin kaynaklandığı UNIX zaman damgası (saniye cinsinden).

      • Authentication KEY: Kullanıcı tarafından geri arama adresi için yapılandırılan kimlik doğrulama anahtarı.

    • Authentication key: Bu alan yalnızca Callback authentication etkinleştirildiğinde görüntülenir. 16 ila 64 görünen ASCII karakteri (0x21 ila 0x7e) girin.

    Kaynak akış türüne göre parametreler:

    1. Source Stream Type Live Stream olarak ayarlanırsa kaynak RTMP, SRT ve HTTP-FLV'yi destekler.

    2. Source Stream Type VOD Asset olarak ayarlanırsa video listesine medya varlık kimliğini girin. En fazla 30 video ekleyebilirsiniz ve sistem bunları sırayla oynatır. Playback Times için Loop veya Specified seçeneğini belirleyin.

    3. Source Stream Type Video Path olarak ayarlanırsa video URL'sini girin.

      Not

      Video URL yolu http:// veya https:// ile başlamalı ve .mp4 veya .flv ile bitmelidir.

  6. Görevi oluşturmak için Submit öğesini tıklayın.

Not

Bir görev oluşturmak için CreateLivePullToPush API işlemini de kullanabilirsiniz.

Görev Sorgulama

  1. ApsaraVideo Live konsolu üzerinden oturum açın.

  2. Sol gezinme bölmesinde Feature Management > Pulled-stream Relay öğelerini seçin.

  3. Pulled-stream Relay görevini oluşturduğunuz bölgeyi seçin. Ardından Task ID, Task Name veya Destination Ingest URL kullanarak terim sorgusu yapabilirsiniz.

Not

DescribeLivePullToPush API işlemini de kullanabilirsiniz.

Görev Kopyalama

  1. Sol gezinme bölmesinde Feature Management > Pulled-stream Relay öğelerini seçerek Pulled-stream Relay sayfasına gidin.

  2. Görevin canlı merkez bölgesini seçin. Görev listesinde görevi bulun ve Actions sütunundaki Copy öğesini tıklayın.

  3. Görev oluşturma sayfasında önceden doldurulmuş yapılandırmayı inceleyin veya değiştirin ve bir görev oluşturmak için Submit öğesini tıklayın. Aşağıdaki kurallar uygulanır:

    • Orijinal görev Not Started durumundaysa orijinal yapılandırma ile başlangıç ve bitiş zamanları önceden doldurulur. Görev adı önceden doldurulmaz.

    • Orijinal görev Running, Recovering veya Stopped durumundaysa orijinal yapılandırma önceden doldurulur, başlangıç zamanı geçerli zamandan beş dakika sonrasına ayarlanır ve orijinal bitiş zamanı korunur. Görev adı önceden doldurulmaz.

    • Orijinal görev Ended durumundaysa Copy eylemi kullanılamaz.

    • Tüm kopyalama senaryolarında Task Name temizlenir. Boş bırakılırsa sistem taskname_Timestamp formatında bir ad oluşturur.

Görev Değiştirme

  1. ApsaraVideo Live konsolu üzerinden oturum açın.

  2. Sol gezinme bölmesinde Feature Management > Pulled-stream Relay öğelerini seçin.

  3. Pulled-stream Relay sayfasında değiştirmek istediğiniz görevi bulun ve Actions sütunundaki Edit öğesini tıklayın.

  4. Düzenleme sayfasında parametreleri gerektiği gibi değiştirin ve Submit öğesini tıklayın.

    1. Bir görev Not Started durumundaysa Task Time, Callback URL, Playback Times, Source Information içindeki düzenlenebilir kaynak ayarları, Callback authentication, Authentication key ve Video switch notification öğelerini değiştirebilirsiniz.

    2. Bir görev Stopped durumundaysa Callback URL, Playback Times, Source Information içindeki düzenlenebilir kaynak ayarları, Callback authentication, Authentication key ve Video switch notification öğelerini değiştirebilirsiniz.

    3. Tüm görev durumlarında Region, Destination URL, Source Type ve Source Protocol değiştirilemez. Diğer durumlarda görev yapılandırmaları değiştirilemez.

Not

UpdateLivePullToPush API işlemini de kullanabilirsiniz.

Görev Silme

Önemli

Çekilen akış aktarımı görevleri kurtarılamaz.

  1. ApsaraVideo Live konsolu üzerinden oturum açın.

  2. Sol gezinme bölmesinde Feature Management > Pulled-stream Relay öğelerini seçin.

  3. Pulled-stream Relay sayfasında silmek istediğiniz görevi bulun ve Actions sütunundaki Delete öğesini tıklayın.

  4. Görüntülenen iletişim kutusunda görevi silmek için Delete öğesini tıklayın.

Not

DeleteLivePullToPush API işlemini de kullanabilirsiniz.

Görev Başlatma

Not
  • Yalnızca Stopped durumundaki görevler etkinleştirilebilir.

  • Görev belirtilen başlangıç zamanında otomatik olarak başlar.

  1. ApsaraVideo Live konsolu üzerinden oturum açın.

  2. Sol gezinme bölmesinde Feature Management > Pulled-stream Relay öğelerini seçin.

  3. Pulled-stream Relay sayfasında başlatmak istediğiniz görevi bulun ve Actions sütunundaki Enable öğesini tıklayın.

  4. Görüntülenen iletişim kutusunda görevi başlatmak için Enable öğesini tıklayın.

Görevi Yeniden Başlatma

Not

Yalnızca Running durumundaki görevler yeniden başlatılabilir.

  1. ApsaraVideo Live konsolu üzerinden oturum açın.

  2. Sol gezinme bölmesinde Feature Management > Pulled-stream Relay öğelerini seçin.

  3. Pulled-stream Relay sayfasında yeniden başlatmak istediğiniz görevi bulun ve Actions sütunundaki Restart öğesini tıklayın.

  4. Görüntülenen iletişim kutusunda görevi yeniden başlatmak için Restart öğesini tıklayın.

Not

RestartLivePullToPush API işlemini de kullanabilirsiniz.

Görev Durdurma

Not

Stop durumuna sahip bir görevi Running edebilirsiniz.

  1. ApsaraVideo Live konsolu üzerinden oturum açın.

  2. Sol gezinme bölmesinde Feature Management > Pulled-stream Relay öğelerini seçin.

  3. Pulled-stream Relay sayfasında durdurmak istediğiniz görevi bulun ve Stop sütunundaki Actions öğesini tıklayın.

  4. Görüntülenen iletişim kutusunda görevi durdurmak için Stop öğesini tıklayın.

Not

StopLivePullToPush API işlemini de kullanabilirsiniz.

SSS

Bir görev oluşturduktan sonra nasıl akış URL'si oluşturulur?

Çekilen akış aktarımı görevi için akış URL'si, hedef ingest URL'sine karşılık gelen ilişkili akış alan adı, AppName ve StreamName temel alınarak oluşturulmalıdır. Bu URL'yi konsoldaki URL oluşturucu aracılığıyla veya özel birleştirme yöntemiyle oluşturabilirsiniz.

Üçüncü taraf kaynak akışı bağlantısı kesildiğinde çekilen akış aktarımı görevi otomatik olarak devam eder mi?

Üçüncü taraf kaynak akışının bağlantısı kesildiğinde görev durumu Recovering (abnormal) olarak değişir. Varsayılan olarak sistem her dakika bir kez olmak üzere toplamda üç kez akışı yeniden çekmeyi dener.

  • Kaynak akış 3 dakika içinde kurtarılır ve akış başarıyla çekilirse görev durumu otomatik olarak Running (Normal) olarak değişir.

  • Üç denemenin tümü başarısız olursa görev durumu Offline olarak değişir ve sistem akışı otomatik olarak çekmeyi artık denemez. Görevi yeniden başlatmak için konsoldaki Restart düğmesini tıklayın veya RestartLivePullToPush API'sini çağırın.