YouTube Live Streaming API - Yayınları ve Akışları Anlama
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bu kılavuzda, yayınlar ve akışlara kısa bir genel bakış sunulmaktadır. Ayrıca yayıncıların bu kaynakları oluşturmak ve yönetmek için YouTube Live Streaming API'yi nasıl kullandığını gösteren kullanım alanlarını da ele alır.
-
Yayın, YouTube'da gerçekleştiği sırada izlenebilen bir etkinliği temsil eder. Her yayın farklı bir YouTube videosudur. Bir yayın tam olarak bir akışa bağlı olabilir ve olması gerekir.
-
Akış, ses ve video içeriklerini YouTube'a iletmenizi sağlar ve içeriklerinizin YouTube'da nasıl canlı oynatılacağına ilişkin ayarları tanımlar. Aynı yayın en fazla üç canlı yayına bağlanabilir. Bu yayınlar farklı zamanlarda yapılıyorsa yayıncıların aynı akışı birçok farklı yayın için yeniden kullanması da yaygın karşılaşılan bir durumdur.
Kalan bölümlerde, API kullanıcılarının yayınları ve akışları genellikle nasıl kullandığını açıklayan üç kullanım alanı sunulmuştur.
Tek bir kodlayıcı yapılandırma
API kullanımının en yaygın olduğu senaryoda, YouTube kanalınızda planlanmış veya yinelenen bir canlı etkinlik dizisi vardır. Kanal sahibi olarak, tek bir kodlayıcınız vardır ve kodlayıcıyı yalnızca bir defa yapılandırmak istiyorsunuz. Bu nedenle aşağıdaki adımları uygularsınız:
- API'de bir
liveStream
kaynağı oluşturun.
- Kanal için kodlayıcıyı yapılandırmak için bu kaynaktan içerik yayınlama ayarlarını kullanın.
Birden fazla kanalınız varsa her kanal için farklı bir yayın oluşturmanız gerektiğini unutmayın.
- API'de
liveBroadcast
kaynakları oluşturun ve bu kaynakların tümünü liveStream
kaynağına bağlayın. Bu senaryoda, kanalınız için planladığınız her canlı etkinlikte aynı yayın ayarları kullanılır. Ancak, herhangi bir zamanda yalnızca bir etkinlik canlı olarak yayınlanır ve her yayının video içeriği benzersizdir.
- Bir etkinlik gerçekleştiğinde yayının durumunu
testing
veya live
olarak güncelleyin ve bu etkinliği YouTube'da yayınlamaya devam edin.
Yayın başına bir yayın oluşturma
Diğer bir yaygın yaklaşım ise her yayın için ayrı bir akış oluşturmaktır. Bu senaryoda, her liveBroadcast
kaynağı için ayrı bir liveStream
kaynağı oluşturur ve ardından akış kodlayıcınızı her yayın için uygun ayarları kullanacak şekilde yapılandırırsınız.
Kanalınızda yinelenen birden çok yayın olması durumunda, iki yayının aynı anda gerçekleştirilebileceği durumlarda bu yaklaşım mantıklı olabilir. Bu da her iki yayının aynı yayın ayarlarını kullanmasını olanaksız kılar. Hatta kanalınızda tekrarlanan her yayını bir program olarak değerlendirip her program için yalnızca bir liveStream
kaynağı oluşturabilirsiniz. Bu durumda, aynı programın her bölümü bir yayını temsil eder ve aynı programın tüm yayınları aynı akışa bağlanabilir.
Eş zamanlı yayınlar oluşturmak için tek bir akış kullanma
Bu senaryoda, bir canlı yayını birden fazla eşzamanlı yayına bölmek istersiniz. Bu nedenle, aynı anda live
durumunda olan iki (veya daha fazla) liveBroadcast
kaynağına bağlı bir liveStream
kaynağınız var.
Örneğin, kanalınızın 7/24 canlı yayın yayınladığını ancak bu yayın sırasında gerçekleşen bir röportaj için ayrı bir video da oluşturmak istediğinizi varsayalım. Bu örnekte röportaj içeriği, 7/24 yayınlanan yayın içeriğinin bir alt kümesidir.
Bu durumu ele almak için iki liveBroadcast
kaynağı oluşturur ve her iki yayını aynı akışa bağlarsınız. 7/24 yayın devam ediyor ve yayın kaynağının kaynağı, röportaj başlamadan çok önce live
durumunda. Röportaj başladığında, 7/24 yayının kaynağını değiştirmeden röportajla ilişkili kaynağın durumunu live
olarak güncellersiniz. Böylece, aynı içeriği aynı anda iki ayrı videoya gönderirsiniz.
Röportaj sona erdiğinde görüşme yayınının kaynağını tekrar güncelliyor ve bu kez durum complete
olarak ayarlanıyor. Ancak 7/24 yayın devam ettiğinden video akışını durdurmanız mümkün değildir.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2024-08-15 UTC.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2024-08-15 UTC."],[[["\u003cp\u003eA broadcast represents a live event on YouTube, functioning as a distinct video, and it must be linked to one stream.\u003c/p\u003e\n"],["\u003cp\u003eA stream is used to send audio-video content to YouTube, defining the settings for that stream, and one stream can be connected to up to three live broadcasts.\u003c/p\u003e\n"],["\u003cp\u003eBroadcasters often use the same stream for numerous broadcasts that occur at different times, reusing stream settings and reducing redundant setup.\u003c/p\u003e\n"],["\u003cp\u003eThe API can be used in multiple ways, whether it be one stream for multiple broadcasts, one stream per broadcast, or a single stream being split into multiple simultaneous broadcasts.\u003c/p\u003e\n"],["\u003cp\u003eChannels can use the API to schedule recurring live events with a single encoder, configuring it just once for multiple broadcasts.\u003c/p\u003e\n"]]],["Broadcasts represent distinct YouTube live events, each bound to one stream. Streams transmit audio-video content to YouTube and define streaming settings. Broadcasters often reuse streams for multiple broadcasts at different times. Common use cases include: configuring one stream for multiple scheduled broadcasts, creating a unique stream per broadcast, or using a single stream for simultaneous broadcasts. For the last case, one stream can be used to have up to 3 simultaneous live broadcasts. API users create and bind these resources.\n"],null,["# YouTube Live Streaming API - Understanding Broadcasts and Streams\n\nThis guide provides a brief overview of **broadcasts** and **streams**. It also discusses use cases that show how broadcasters use the YouTube Live Streaming API to create and manage those resources.\n\n- A **broadcast** represents an event that can be watched on YouTube as it happens. Each broadcast is a distinct YouTube video. A broadcast can be and needs to be bound to exactly one stream.\n\n- A **stream** enables you to transmit audio-video content to YouTube, and it defines the settings for how you stream your content to YouTube. The same stream can be bound to up to three live broadcasts. It is also common for broadcasters to reuse the same stream for many different broadcasts if those broadcasts occur at different times.\n\nThe remaining sections present three use cases that explain how API users typically use broadcasts and streams.\n\nConfigure a single encoder\n--------------------------\n\nIn the most common API use case, your YouTube channel has a series of scheduled or recurring live events. As the channel owner, you have a single encoder and only want to configure the encoder one time. So, you perform the following steps:\n\n1. Create one [liveStream](/youtube/v3/live/docs/liveStreams) resource in the API.\n2. Use the content delivery settings from that resource to configure the encoder for the channel.\n3. Note that, if you have multiple channels, you must create a different stream for each channel.\n4. Create [liveBroadcast](/youtube/v3/live/docs/liveBroadcasts) resources in the API and [bind](/youtube/v3/live/docs/liveBroadcasts/bind) all of those resources to the [liveStream](/youtube/v3/live/docs/liveStreams) resource. In this scenario, every live event that you schedule for your channel uses the same streaming settings. However, only one event is live at any given time, and the video content for each broadcast is unique.\n5. Any time an event occurs, update the broadcast's status to either `testing` or `live` and proceed to broadcast that event on YouTube.\n\nCreate one stream per broadcast\n-------------------------------\n\nAnother common approach is to create a separate stream for each broadcast. In this scenario, you would create a distinct [liveStream](/youtube/v3/live/docs/liveStreams) resource for each [liveBroadcast](/youtube/v3/live/docs/liveBroadcasts) resource and then configure your streaming encoder to use the appropriate settings for each broadcast.\n\nThis approach might make sense if your channel has multiple recurring broadcasts such that two broadcasts might occur simultaneously, making it infeasible for both broadcasts to use the same streaming settings. In fact, your channel might treat each recurring broadcast as a show and just create one [liveStream](/youtube/v3/live/docs/liveStreams) resource per show. Then, each episode of the same show would represent a broadcast, and all broadcasts of the same show could be bound to the same stream.\n\nUse one stream to create simultaneous broadcasts\n------------------------------------------------\n\nIn this scenario, you want to split a live stream into multiple, simultaneous broadcasts. As such, you have one [liveStream](/youtube/v3/live/docs/liveStreams) resource that is bound to two (or more) [liveBroadcast](/youtube/v3/live/docs/liveBroadcasts) resources that have a `live` status at the same time.\n\nFor example, suppose your channel broadcasts a 24/7 live feed, but you also want to create a separate video for an interview that occurs during that broadcast. In this case, the interview content is a subset of the 24/7 broadcast's content.\n\nTo handle this case, you create two `liveBroadcast` resources and bind both broadcasts to the same stream. The 24/7 broadcast is ongoing and its resource has a `live` status long before the interview begins. When the interview begins, you update the status of the resource associated with the interview to `live` without changing the 24/7 broadcast's resource. Thus, you are streaming the same content to two separate videos at the same time.\n\nWhen the interview ends, you update the interview broadcast's resource again, this time setting its status to `complete`. However, you don't stop streaming video since the 24/7 broadcast continues."]]