Özel Web Alıcısı

Jump start: Temel Özel Web Alıcısı oluşturma kodu basittir. Web Alıcısı uygulamanızı kaydetmek için sonraki adımı atlayın, ardından temel bir Web Alıcısı uygulaması oluşturun.

Web Buyer SDK'sı, sorunsuz ve kolay bir oynatma deneyimi sunmak için yerleşik bir medya oynatıcı kullanır. Google Asistan için kullanıma hazır destek sunmanın yanı sıra tüm gönderenlerde ve dokunmatik özellikli cihazlarda otomatik olarak desteklenen Cast'e özgü özellikler sağlar. Kullanıma sunulan yeni özellikler, ek gönderen değişiklikleri olmaksızın desteklenmeye devam edecektir.

Özel Web Alıcısı, içeriğinizi Cast uyumlu cihazlarda görüntülemek için barındırılması gereken, özel olarak oluşturulmuş bir HTML5 uygulamasıdır. İşletmenizin ihtiyaçlarına bağlı olarak bir Özel Web Alıcısı oluşturmanız gerekebilir. Kullanılacak alıcı türünü belirleme konusunda yardım almak için Web Alıcısı seçme kılavuzuna göz atın.

Google Web Alıcısı SDK'sı

Web Alıcısı uygulamanız, Web Alıcısı API'sine aşağıdaki referansla erişir:

<script src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js"></script>

URL protokolleri için en iyi uygulama: Yukarıdaki URL'nin "&" veya "https:" protokolünü belirtmediğine dikkat edin. cast_receiver_framework.js kaynağının kaynağında bu protokollerin atlanması, bu kaynağın Web Alıcısı uygulamasını barındıran sunucuyla aynı protokol kullanılarak getirilmesini sağlar. Bu, geliştirme için HTTP ile üretim için HTTPS arasında geçiş yapmanın şeffaf olduğu ve kod değişikliği gerektirmediği anlamına gelir. (Yayınlanan Web Alıcısı uygulamaları TLS özellikli sunucularda barındırılmalıdır.)

SDK önizlemesi

Üretim harici uygulamaları test etmek için Cast Web Alıcısı SDK'sının yayın öncesi sürümünü de kullanabilirsiniz. SDK önizleme URL'si hakkında daha fazla bilgiye Google Cast Web Alıcısı SDK Önizleme URL'sinden ulaşabilirsiniz.

Uygulama yaşam döngüsü

Web Alıcısı uygulama yaşam döngüsü, Web Alıcısı'nın Yayın cihazına yüklendiği andan itibaren uygulamanın bozulduğu ve Yayın cihazının varsayılan durumuna geri döndüğü noktaya kadar uzanır.

Bir Web Alıcısı uygulamasının yaşam döngüsü boyunca, Web Alıcısı ile bağlı gönderen uygulamaları arasında mesaj alışverişi yapılır. Gönderen uygulama, Google Cast cihazına ilk olarak belirli bir uygulama kimliğini kullanarak oturum oluşturulmasını isteyen bir mesaj gönderir. Google Cast cihazı Web Alıcısı uygulamasını yüklemeye çalışacağından Web Alıcısının yaşam döngüsünü başlatır. Ağ sorunu olmadığı sürece Web Alıcısı uygulaması, uygulama kimliğiyle ilişkilendirilen çözümlenmiş URL kullanılarak ağdan indirilir. Web Alıcısı, yüklendikten sonra kurulum işlemlerini gerçekleştirir ve bağlı tüm gönderen uygulamalarından gelen mesajların işlenmeye hazır olduğunu gösterir.

Bir Web Alıcısı uygulaması, aşağıdaki koşullarda yırtabilir (mevcut yaşam döngüsünü sonlandırabilir ve uygulamayı kapatabilir):

  • Web Alıcısı uygulaması, uygulama oturumunu sonlandırmak için bağlı son gönderenden açık bir mesaj alır.
  • Web Alıcısı uygulaması, bağlı bir gönderen olmadan belirli bir süre boyunca boşta kalır ve uygulama oturumunu sonlandırmaya karar verir.
  • Farklı bir yayın oturumu başlatıldı.
  • Web Alıcısı, normal yaşam döngüsünde önemli bir hatayla karşılaşır.

Web Buyer SDK'sı, tüm yaygın durumları Kullanıcı Deneyimi kurallarımıza uygun şekilde işler.

Kurslar

Web Buyer SDK çerçevesinin 2 ana sınıfı vardır:

  • cast.framework.CastReceiverContext: Genel çerçeveyi yönetir ve gerekli kitaplıkları yükler. Bu nesneyle şunları yapabilirsiniz:

    • Uygulama yapılandırma seçeneklerini ayarlama
    • Sistem etkinliklerini işleme (gönderenle bağlantı kuruldu veya bağlantı kesildi)
    • Özel kanal oluşturma
    • Yayın iletişimini başlat
  • cast.framework.PlayerManager: Medya oynatmayı yönetir. Gönderenden gelen isteğe göre temel oynatıcıyı ve medya öğesini işler. Bu nesneyle şunları yapabilirsiniz:

    • Oynatma işlemlerini işleme
    • Gönderenden gelen oynatma isteklerini işleme
    • Oynatmayla ilgili etkinlikleri yönetme

Web Alıcısı uygulamanızı kaydedin

Bir Web Alıcısı uygulaması geliştirmeden önce, Web Alıcısı uygulamanızı Google Cast SDK'sı Geliştirici Konsolu'na kaydetmeniz gerekir. Daha fazla bilgi için Kayıt bölümünü inceleyin. Tüm Web Alıcısı uygulamaları, gönderen uygulamaların gönderen API'sı aracılığıyla Web Alıcısı'na gönderdikleri komut mesajlarını içeren bir uygulama kimliği sağlamasını gerektirir. Web Alıcısı uygulamanızı kaydettiğinizde, gönderenin API çağrılarına eklenecek uygulama kimliğini alırsınız.

Temel Web Alıcısı uygulaması oluşturma

Aşağıda, özelleştirme içermeyen temel bir Web Alıcısı uygulamasının ana yapısı verilmiştir:

  1. Medya oynatıcıyı temsil eden cast-media-player HTML öğesi.
  2. Web Alıcısı çerçevesini yükleyecek bir komut dosyası HTML öğesi.
  3. Herhangi bir seçenek olmadan Web Alıcısı uygulamasını başlatmak için start() numaralı telefonu arayın.

Herhangi bir özelleştirme yapmadan, yayın uygulaması çerçevesini kullanan web alıcıları için minimum kodu aşağıda bulabilirsiniz. Web Alıcısı uygulamanızı oluşturmak için bu komut dosyasını olduğu gibi kopyalayıp uygulamanıza yapıştırabilirsiniz.

<html>
<head>
  <script type="text/javascript"
      src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js">
  </script>
</head>
<body>
  <cast-media-player></cast-media-player>
  <script>
    cast.framework.CastReceiverContext.getInstance().start();
  </script>
</body>
</html>

Bu noktada kullanıcı, gönderen uygulamasını açabilir, Yayın cihazına bağlanabilir, ardından medyaya gidip Oynat düğmesine basabilir. Web Alıcısı, medyayı kullanıcının izleyebilmesi için bu medyayı televizyonda canlı oynatmaya çalışır.

Bu temel Web Alıcısı'nı, özelleştirilmiş bir alıcı uygulamasıyla karşılaştırın.

Medya ve oynatıcılar

Yayın çerçevesi, cast-media-player HTML öğesiyle temsil edilen yerleşik bir medya oynatıcı sağlar. Bu medya oynatıcı MPEG-DASH, HLS ve Smooth Streaming gibi akış protokolleri için oynatmayı destekler.

Desteklenen Medya bölümünde bir dizi desteklenen medya codec'i ve kapsayıcı gösterilir. Geliştiriciler, Yayınlama mesajlaşması aracılığıyla yükleme, oynatma, duraklatma ve arama gibi gönderen tarafından başlatılan işlemlerin listesini destekleyebilir. Burada, SDK SDK'sı medyayla etkileşimleri yönetir. Desteklenen işlemlerin bir listesi için uygulamanızın platformundaki gönderen API referansını inceleyin: Android Gönderen'de RemoteMediaClient, iOS Gönderen'de GCKMediaControlChannel ve Web Gönderen'de Media.

Kaynaklar Arası Kaynak Paylaşımı

Google Cast, merkezler arası kaynak paylaşımını (CORS) tam olarak destekler. Akış tabanlı protokoller (çoğu dosya tabanlı protokolün aksine) XMLHttpRequest kullanarak içeriğe eşzamansız şekilde erişebilir. CORS dünyasında, bu istekler kaynağın oluşturulduğu sunucudan gelen CORS başlığı tarafından uygunsuz erişime karşı korunur. Bu da içerik sunucunuzun nerede yer alabileceği hakkında bir fikri olduğu anlamına gelir. Modern tarayıcıların çoğu CORS'yi tamamen destekler. iOS ve Android cihazlar içeriğe daha düşük bir düzeyde erişir ve bu üstbilgileri incelemez. Bu, bir geliştirici canlı yayın içeriği kullanmak istediğinde ortaya çıkan ilk sorundur. Ayrıntılar için Kaynaklar Arası Kaynak Paylaşımı bölümüne bakın.