Varsayılan yayınların ve akışların kullanımdan kaldırılmasıyla ilgili taşıma rehberi

Genel bakış

Bu kılavuz, canlı yayın yapmak için YouTube kanallarının varsayılan liveStream ve liveBroadcast kaynaklarını kullanan API istemci uygulamalarının geliştiricileri için hazırlanmıştır. Uygulamanızın varsayılan yayınların ve varsayılan akışların kullanımdan kaldırılmasını zarif bir şekilde ele almanızı sağlamaya yardımcı olur ve uygulamanız için aşağıdaki ifadelerden herhangi birinin geçerli olması durumunda sizin için geçerlidir:

  • liveBroadcast kaynağının isDefaultBroadcast özelliğinin değerini kontrol eder.
  • liveStream kaynağının isDefaultStream özelliğinin değerini kontrol eder.

  • liveBroadcasts.list yöntemini çağırır ve broadcastType parametre değerini persistent olarak ayarlar. Kullanımdan kaldırma tarihi itibarıyla:

    • broadcastType parametre değeri persistent ise liveBroadcasts.list yöntemi sonuç döndürmez.
    • broadcastType parametre değeri all ise liveBroadcasts.list yöntemi bu süreden önce mevcut olan kalıcı yayınları döndürmez.

Başvurunuz bu durumdan etkileniyorsa lütfen Başvurunuzu güncelleme bölümüne bakın. Bu bölümde, hesabınızın kullanımdan kaldırılmasından sonra yapılması gereken prosedür değişiklikleri belirtilmiştir. Bu bölümde, bir API'nin istemcisinin varsayılan yayın ve akış kullanması halinde genellikle izlemediği Yayının ömrü kılavuzundaki belirli adımlar açıklanmaktadır.

What is happening?

2015 yılından beri YouTube, otomatik olarak bir kanal oluşturup canlı yayın için etkinleştirildiğinde varsayılan bir yayın oluşturdu. Varsayılan akış süresiz olarak mevcuttu ve silinemedi. Benzer şekilde, varsayılan yayın kalıcı olarak kabul edildi. Bu şablon her zaman mevcuttu, kendisiyle ilişkilendirilmiş başlangıç veya bitiş zamanı yoktu ve belirli bir etkinliğe bağlı değildi.

YouTube, yukarıda belirtilen kullanımdan kaldırma tarihinden itibaren varsayılan akış ve yayın oluşturmayacak. Bu değişiklik, canlı içerik yayınlamak için bu kaynaklara güvenen istemci uygulamalarını etkiler. Ayrıca, kullanıcı arayüzünün bu varsayılan kaynaklar ile kanal sahiplerinin oluşturduğu diğer yayınlar ve akışlar arasında ayrım yapmak için özelleştirildiği uygulamaları da etkiler.

API istemcilerinin varsayılan kaynaklara güvenmek yerine liveBroadcast ve liveStream kaynaklarını oluşturup yönetmesi ve bu kaynakları birbirine bağlaması gerekir.

Başvurunuz güncelleniyor

Yayın, terminolojiyi hızlıca incelemek için YouTube'da canlı olarak izlenebilen bir etkinliği temsil eder. Yayın ise gerçek video içeriğini YouTube'a gönderme mekanizmasıdır. Bir yayının tam olarak tek bir yayına bağlı olması gerekir.

Varsayılan yayınlardan taşıma

Kullanımdan kaldırılmadan önce API istemcileri, kanalın varsayılan yayınını kullanmayı veya etkinliğe özel bir yayın oluşturmayı tercih edebilirdi. Varsayılan yayın, birden fazla etkinlik için yeniden kullanılabilecek kalıcı bir kaynak olurken etkinliğe özel bir yayın kaynağı da tam olarak bir YouTube videosuna karşılık gelen tek kullanımlık bir kaynaktı.

İstemci uygulamanız liveBroadcasts.list yöntemini çağırırsa ve aşağıdakilerden birini yaparsa varsayılan yayını kullanır:

  • broadcastType parametre değerini persistent olarak ayarlar. Bu istek yalnızca varsayılan yayını alır.
  • broadcastType parametre değerini all olarak ayarlar ve ardından isDefaultBroadcast özelliğinin değerinin true olduğu API yanıtında liveBroadcast kaynağını tanımlar.

Kullanımdan kaldırma işleminden sonra YouTube yalnızca etkinliğe özel yayınları destekleyecektir. Diğer bir deyişle, istemci uygulamaların varsayılan yayına güvenmek yerine her ayrı yayın etkinliği için liveBroadcast kaynakları oluşturması gerekir.

liveBroadcast kaynağı oluşturmak için liveBroadcasts.insert yöntemini çağırın. Bu süreç "Yayının ömrü" kılavuzunun 1.1 adımında açıklanmıştır.

Henüz yapmadıysanız kullanıcı arayüzünün, yaklaşan etkinliğe özel yayınları ayırt edip seçmesi için kullanıcılara mekanizmalar sağlaması gerekir.

Varsayılan akışlardan taşıma

Akış, ses-video içeriğini YouTube'a iletmenizi sağlar ve içeriğinizi YouTube'a aktarma şeklinizle ilgili ayarları tanımlar. Anonslar farklı zamanlarda yapılıyorsa yayıncıların çoğu farklı yayın için aynı akışı yeniden kullanmaları yaygın görülen bir durumdur.

Uygulamanız varsayılan akışı kullanamasa da her yayın için yeniden kullanılabilen yeniden kullanılabilir bir yayın oluşturabilir. liveStream Kaynak oluşturmak için liveStreams.insert yöntemini çağırarak "Yayının ömrü" kılavuzunun 1.2 adımındaki talimatları çağırın. Yeni oluşturulan akışlar varsayılan olarak yeniden kullanılabilir. Ancak isterseniz tek kullanımlık yayınlar oluşturmak ve yayınlar ile akışlar arasında bire bir ilişki kurmak için contentDetails.isReusable özelliğini false olarak ayarlayabilirsiniz.

Aşağıdaki listede, akış başlığı ve akış açıklaması'nın yanı sıra yeni bir yayın oluştururken ayarlayabileceğiniz dört özellik bulunmaktadır. Liste, varsayılan akışların her bir mülk için kullandığı değerleri gösterir. Bu değerler, varsayılan akışları kullanmayı taşıyacaksanız bir istemci uygulamasında kullanmak isteyeceğiniz ayarlar olabilir.

Yayınları yayınlara bağlama

YouTube'da canlı yayının gerçekten başlaması için her liveBroadcast kaynağının tam olarak bir yayına bağlanması gerekir. (Yayının oluşturulduğu zamanda herhangi bir yayına bağlı değildir.)

Bağlama işlemi, varsayılan akışa varsayılan olarak bağlı olan varsayılan yayın için otomatik olarak işlenir. Ancak, kullanımdan kaldırma tarihinden sonra istemci uygulamalarının tüm yayınlar için bu süreci yönetmesi gerekecektir.

Bir yayını yayına bağlamak için "Yayının yaşam döngüsü" kılavuzunun 1.3. adımında açıklanan şekilde liveBroadcasts.bind yöntemini çağırın.

  • Yeniden kullanılabilir bir canlı yayın kullanıyorsanız bir kez canlı yayın yapıp her yayını bu yayına bağlayabilirsiniz.
  • Yeniden kullanılabilir bir yayın kullanmıyorsanız bir yayın ile canlı yayın oluşturmanız ve ardından bu ikisini birbirine bağlamanız gerekir.

Yayınınızı test etme

Varsayılan yayını kullanmadığınızda yayınınızı test etme seçeneğiniz vardır. Test yapmak için yayın videosunu YouTube izleyicilerine gösterilecek şekilde önizlemenizi sağlayan bir oynatıcı yerleştirirsiniz ancak yayın diğer izleyicilere gösterilmez.

API istemciniz daha önce varsayılan yayın ve akışı kullanıyorsa ve akış sürecinize bir test aşaması eklemek istiyorsanız "Yayının ömrü" kılavuzunun 3. aşamasına bakın.

Yayınınızı test etmek isterseniz bir yayın eklerken contentDetails.trackerStream.enableMonitorStream özelliğini true ve contentDetails.enableAutoStart özelliğini false olarak ayarlamanız gerekir. Bunlar, her iki mülk için de varsayılan değerlerdir.

Otomatik başlatma ve otomatik durdurma özelliklerini kullanma

Varsayılan akışta video akışı başlattığınızda varsayılan yayın otomatik olarak başlar. Benzer şekilde, video yayını durduktan sonra varsayılan yayın sona erdi. Daha sonra bu varsayılan kaynakları kullanan her akış oturumu, kanalınızda bir video haline geldi.

Otomatik başlatma ve otomatik durdurma özellikleri varsayılan yayınlar için varsayılan davranış olsa da bu özellikler isteğe bağlıdır ve diğer yayınlar için etkinleştirilmesi gerekir. Bu özellikleri kullanmak istiyorsanız bir yayın eklerken contentDetails.enableAutoStart ve contentDetails.enableAutoStop özellik değerlerini true olarak ayarlamanız gerekir. Bu özellikler birbirinden bağımsızdır, böylece birini değil diğerini kullanmayı seçebilirsiniz.

Yeni yayınlar için otomatik başlatma ve otomatik durdurma özelliklerini etkinleştirmezseniz API akışı istemciniz, video yayını başlatıp başlattığınızda yayının durumunu güncellemek için liveBroadcasts.transition yöntemini çağırmalıdır. Yayının başında ve sonunda bu geçişleri yönetmeyle ilgili talimatlar için "Yayının Yaşamı" kılavuzundaki 4.3. adıma ve 5.2. adıma bakın.