Genel Bakış
Cast Web Buyer SDK, içeriğin çeşitli web akış protokolleri bölümüne bakın. Referans olarak protokolü kullanılırsa SDK, içeriğin oynatılmasını sağlamak için bir oynatıcı yükler. durumunda, Medya Oynatıcı Kitaplığı (MPL) yüklenir. Projede DASH içeriği, Shaka Player yüklendi.
İleride Cast SDK'sı ve Shaka Player mühendislik ekipleri, Shaka'da HLS içerik oynatma desteğini artırmak için çalışmalar birleştiriliyor Oynatıcı. MPL artık kritik güncellemeleri almayacak. Hedef EBM'yi uygulamanızda HLS içeriği oynatırken Shaka Player'ı kullanın.
Shaka Player'ın avantajları
Oyuncuların değişiminde uygulamalar aşağıdaki avantajlardan faydalanır:
- Yükleme süresinde iyileştirmelerle kullanıcılar için daha etkili akış oturumları ve gecikmeleri hesaba katın.
- En son HLS özelliklerinin benimsenmesine devam edilmesi.
- Oynatıcı içeriği için temel neden analizinde daha fazla netlik Shaka Player'ın açık kaynak yapısından kaynaklanan uyumluluk sorunları.
- Açık kaynak oynatıcı kod tabanı, iş ortaklarının Shaka Player Projesi'ne katkıda bulunma.
- Özellik ve hata düzeltme süresinin önemli ölçüde kısaltılması Shaka Player'ın yayını ritm sık ve Web Receiver SDK'nın sürümlerinden bağımsızdır.
- Üçüncü taraf yayıncı tarafından sağlanan oynatma ortamı üzerinde daha fazla kontrol
shakaVersionAPI. - Mühendislik kaynaklarıyla Google'dan daha fazla oynatma desteği burada görüldüğü üzere Shaka Player'da HLS oynatmaya yol haritasını kullanın.
Zaman çizelgesi
Web Receiver SDK'sı, Shaka Player'ı varsayılan oynatıcı olarak kullanmaya başlayacak. kullanın. Bu süreç aşamalı olarak proje boyunca iş ortaklarına katılabilirsiniz.
| Faz | Başlangıç Tarihi | Genel Bakış |
|---|---|---|
| 1 | Ekim 2022 | Cast Web Alıcı SDK'sı, Shaka Player'da HLS içeriği oynatmak için etkinleştirilecek API'leri kullanıma sunar. |
| 2 | 2024'ün 2. Yarısı | Cast Web Alıcı SDK'sı, HLS içeriği oynatma için varsayılan oynatıcıyı Shaka Player olarak değiştirir. |
Web Retriever SDK'sı mühendislik ekipleri performansa dayalı bir yaklaşım uyguluyor ve yalnızca Shaka Player'ın performansı etkinken bir sonraki aşamaya geçer. MPL'nin temel performansıyla aynı düzeydedir. Bu değişiklikler cast-sdk-announcements google group (Google grubu) inceleyebilirsiniz.
Dahil ol
CAF 3.0.0105 sürümünden itibaren, bir uygulama düzeyi mevcuttur
HLS oynatma için Shaka Player'ı etkinleştirmek amacıyla yapılandırma ayarlayın. Bu sürüm
ayrıca, desteklenen bir dizi Shaka Player sürümü arasından seçim yapabileceğiniz bir API'yi kullanıma sunuyor.
yükleyin. Bu flag'ler,
CastReceiverOptions dersi
useShakaForHls ve
shakaVersion özellikleri ve
CastReceiverContext başlatıldı. HLS için Shaka'ya kaydolan herhangi bir uygulama
4.3.4 olan Shaka Player sürümünü
en son HLS iyileştirmeleri. Bunun için aşağıdaki kod snippet'ini izleyin:
const context = cast.framework.CastReceiverContext.getInstance();
let castReceiverOptions = new cast.framework.CastReceiverOptions();
castReceiverOptions.useShakaForHls = true;
context.start(castReceiverOptions);
İçeriği doğrulayın
İş ortakları, içerik oynatmalarını etkinleştirmeden önce Shaka Player'da doğrulamalıdır. Shaka Player'ı kullanmaya karar verdi. Bu özelliklerin her biri için aşağıda listelenen içerik varyasyonlarınız:
- Canlı yayın türleri: CANLI veya VOD
- Kapsayıcı biçimleri: TS, MP4 veya temel akışlar
- Süreksizlikler veya yerleştirilmiş reklamlar barındıran içerik
- Şu cihaz türlerinde oynatma: akıllı ekranlar, Chromecast donanım anahtarları, Android TV cihazları, Chromecast Entegre özellikli TV'ler, akıllı hoparlörler
Herhangi bir hata veya beklenmedik bir davranışla karşılaşırsanız hata bildiriminde bulunun. emin olmak için, değişiklikleri üretim ortamınıza uyarlayın.
Devre dışı bırak
Web Receiver SDK'sı, Shaka Player HLS için kapsam dışında kalma modeline geçiş yapacaktır.
zaman çizelgesine göre oynatma. Mülk
useShakaForHls, varsayılan değerini değiştirecek
false - true arasında. O anda, uygulamalar HLS için MPL kullanmayı tercih edebilir
oynatmak için bu özelliği manuel olarak false değerine ayarlayın.
CastReceiverContext başlatıldı, Web Receiver SDK'sı eski haline dönecek
MPL kullanın. Kapsam dışında kalmayı nasıl yapacağınızı öğrenmek için aşağıdaki örneğe bakın:
const context = cast.framework.CastReceiverContext.getInstance();
let castReceiverOptions = new cast.framework.CastReceiverOptions();
castReceiverOptions.useShakaForHls = false;
context.start(castReceiverOptions);
Sorun bildirme
İş ortaklarımızın HLS oynarken buldukları sorunları bildirmelerini öneririz içerik. Daha önce de belirtildiği gibi MPL, artık kritik güncellemeleri almayacak. Varsa ile ilgili daha fazla bilgi edinmek istiyorsanız Etkinleştir bölümüne giderek Shaka Player'a geçiş yapmanın . Sorun hâlâ devam ediyorsa veya sorun yaşıyorsanız aşağıdaki adımları uygulayın farklı bir sorun yaşıyorduk.
shakaVersiondeğerini bir farklı şube sürümlerini deneyin. Örneğin,4.3dalında deneyimleniyorsa, şurada en son sürüme ayarlamayı deneyin:4.2.xveya3.3.xsürümü. Shaka Oynatıcının sürümünü kontrol edin notlarınızı en alakalı güncellemelerle yayınlar. LütfenshakaVersionAPI'nin minimum ve maksimum değeri var referans belgelerde açıklandığı üzere desteklenen bir sürüm olmalıdır. Bir bir regresyon olduğunu, sorunu Shaka Player'da Sorun İzleyici.Oynatıcı yapılandırma parametrelerini değiştirmeyi deneyin. Shaka Player aracılığıyla yapılandırılabilir
PlayerConfigurationnesnesini tanımlayın. Web Alıcı SDK'sı, bir dizi varsayılan değeri tanımlar ve uygulamaların bu yapılandırmayı şuradan değiştirebilirsiniz:PlaybackConfigiçindeshakaConfigmülkü nesnesini tanımlayın. Bu, oynatıcı örneği şu durumdayken yükleme süresinde değerlendirilir: oluşturuldu. Şu kategorideki diğerlerine bakın:yapılandırma ve yapılandırma seçenekleri bulabilirsiniz. Varsayılan Web Receiver SDK tarafından ayarlanan değerler, önerilen değerlerdir.
Sorunun Shaka Player sorun izleyici veya Cast Sorun İzleyici Hata hakkında yorum yapın ve ilgili varsa ekleyin bilgi edinin.
İçeriğinizi Shaka Player demo sitesinde test edin. Şu durumda: Sorunun demo sitesinde yeniden bulunduğunu tespit ederseniz bir dosya yükleyin hata düzeltmesini isteyebilirsiniz.
Aşağıdaki durumlarda Yayınlama Sorun İzleyici'de hata bildiriminde bulunun yayın uç noktalarında Shaka Player'a özgü bir sorun varsa
SSS
Oyuncuların değiştirilmesi, pek çok sorunun aklını karıştırabilir. Aşağıda, sık sorulan sorular ve bu soruların yanıtları taşıma sürecinde size yol gösterecektir.
Shaka Player'a geçmeli miyim?
HLS içeriğini kullanan iş ortaklarımızın taşıma sürecini en kısa sürede değiştirmelisiniz. Sonuç olarak, uygulamanız daha sağlam bir akış sunacak. bir deneyim elde edersiniz. Daha fazla avantaj Shaka Player'da özetleniyor avantajları bölümünde bulabilirsiniz. İş ortaklarının doğrulanması gerekir ve uygulamaların sorunsuz bir şekilde çalışıp için geçerlidir. Bazı uygulamalar, Web Alıcı SDK'sı aşağıdaki durumlarda risk altında olabilir: İş ortakları doğrulama yapmazsa kapsam dışında kalma modeline geçiş yapar. Shaka Player'da düzgün oynatıldığından emin olun.
Oyuncuları değiştirirken beklenen çaba düzeyi nedir?
İş ortaklarının, uygulamalarını ve içeriklerini bir test ortamında test etmeleri gerekecektir. HLS ile karşılaştırıldığında kullanıcı deneyiminin benzer veya iyileştirilmiş olduğundan emin olun. Bunu yapmak için iş ortaklarının ve içeriklerinin oynatılıp yürütülemediğini ayrıntılı bir şekilde YouTube Create'i kullanın. Ayrıntılı bilgi için içerik doğrulama bölümüne bakın. odaklanmanız gereken önemli noktalardır. Doğrulamanın ardından iş ortaklarının şunları yapması gerekir: Başlamak için, üretim uygulaması ortamında dahil olma bayrağı eklemelidir. YouTube Create, Shaka Player'ın sağladığı avantajlardan yararlanabilir. Yüksek bir düzeyde kalite güvencesi gereklilikleridir. iş ortaklarının başarılı bir şekilde taşınmasını sağlar.
Uygulamam yakında içerik yayınlamak için HLS'yi kullanacak. Ne yapmalıyım?
Yeni entegrasyonlarda, Shaka Player'ın oynatma için etkinleştirilmesi gerekir. Sizin uygulamanın uzun vadede daha iyi destekleneceğini ve yeni HLS özelliklerinin ve performans iyileştirmelerinin avantajını elde ettik. Yeni entegrasyonda sorun yaşanıyorsa, en kısa sürede bir hata bildiriminde bulunun. ekibe sorunu çözmek için yeterli zamanı tanımalıdır. Uygulamanızda bu bilgileri hata raporuna eklemeli ve bu bilgileri ve buna göre önceliklendirebilirsiniz. Mühendislik ekibimiz size bir çözüm sunmak için çalışacak. ve kullanıcılarınıza yeterli desteği sunmak.
İçeriğim veya uygulamam Shaka Player ile çalışmıyor. Peki şimdi ne olacak?
Shaka Player Projesi veya Cast projesinde hata bildirmelisiniz. (Sorun bildirme bölümüne bakın). Cast SDK'sı mühendislik ekibi, takip eder ve mevcut sorunları çözmek için sizinle birlikte çalışır. Bu sorunlar ne kadar erken tespit edilirse o kadar fazla zamanları olur. bir çözüm sunmalısınız.
MPL artık kritik güncellemeler almıyor. Bu ne anlama geliyor?
Bugüne kadar MPL, yeni HLS özelliklerini benimsemiş ve kritik güncellemeler. Artık MPL bunları almayacağı için yeni HLS oynatıcıya yeni özellikler eklenmez. Benzer şekilde, HLS için bildirilen tüm sorunlar MPL'de oynatma, MPL'de sabitlenmez. Bu sorunlar Google Ads'deki oynatma için Shaka Player'a geçiliyor. Sorunlar devam ederse, Shaka'da karşılaşılan ilgili sorunlarla birlikte bug dosyası gönderilmelidir. Oynatıcı. İş ortakları MPL'yi kullanmayı bırakmalıdır.
İçeriğimde Smooth Streaming protokolü kullanılıyor. Bu durum uygulamamı nasıl etkiler?
MPL ikili programları, alıcınız tarafından barındırılmaya ve erişilebilir olmaya devam eder. bir uygulamadır. Ancak Smooth Streaming ile ilgili özellik istekleri ve düzeltmelerin Sorunsuz Akış spesifikasyonu şurada güncellenmedi: üzerinde çalışıyorum. DASH veya HLS kullanmak için içeriğinizi taşımanızı öneririz Aşağıdakiler için performans güncellemeleri ve destek almaya devam etmek için yayın protokolüdür: daha fazla bilgi edineceksiniz.
İçeriğimde HLS veya Smooth Stream protokolleri kullanılmıyor. Bu durum uygulamamı nasıl etkiler?
İçerik kitaplığınız bu akış protokollerinden hiçbirini kullanmıyorsa: taşıma işleminden etkilenmezsiniz. bir uygulamadır.