Özel Web Alıcısı

Hızlı başlangıç: Temel bir Özel Web oluşturma kodu Alıcı basit. Şuraya atla: Web Alıcınızı kaydedin uygulamanızı tıklayın, ardından bir temel Web Alıcısı uygulaması.

Web Receiver SDK, sorunsuz ve kolay bir uygulama deneyimi sunmak için oynatma deneyimi. Ayrıca Google Asistan için kullanıma hazır destek sağlar. tüm gönderenler tarafından otomatik olarak desteklenen Cast'e özgü özellikler dokunmatik ekran özelliği olan cihazlar. Yeni özellikler kullanıma sunuldukça: ek gönderen değişiklikleri olmadan desteklenir.

Özel Web Alıcısı, şuralarda barındırılması gereken özel oluşturulmuş bir HTML5 uygulamasıdır: içeriğinizi Cast uyumlu cihazlarda görüntüleyin. Bir Özel Rapor oluşturmanız gerekebilir İşletmenizin ihtiyaçlarına bağlı olarak Web Alıcısı. Hangi alıcıya karar verme konusunda yardım almak için kullanım türünden emin olmak için bir Web Alıcı kılavuzu seçin.

Google Web Receiver SDK'sı

Web Receiver uygulamanız, Web Receiver API'ye aşağıdakilerle erişir referans:

<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 "http:" veya "https:" protokolü. Tedarik ederken bu protokollere cast_receiver_framework.js kaynak, bu kaynağın Web Alıcı uygulamasını barındıran sunucuyla aynı protokolü kullanır. Bunun anlamı, Geliştirme için HTTP ve üretim için HTTPS arasındaki geçiş şeffaftır ve kod değişikliği gerektirmez. (Yayınlanan Web Alıcı uygulamaları barındırılmalıdır .)

cast_receiver_framework.js kaynağı (Web Alıcı SDK'sı), hatta göz önünde bulundurun. Her zaman tarafından barındırılan Web Receiver SDK'yı kullan: gstatic.com referansını kullanarak. Google tarafından barındırılan Web Receiver SDK'sı platform donanım yazılımıyla eş değerde tutulur ve düzenli olarak güncellenir. hata düzeltmeleri yapıp yeni özellikler ekleyin. Geliştirme sırasında Test için özel bir ağda yerel olarak bulunan ancak web'i barındıran Web Alıcı uygulaması Yerel olarak alıcı SDK'sı, uygulamanızın bozulmasına neden olabilir.

SDK önizlemesi

Yayın Web Alıcı SDK'sının yayın öncesi sürümü şurada da kullanılabilir: ve üretim dışı uygulamaları test etmek amacıyla kullanılır. SDK önizleme URL'si hakkında daha fazla bilgi Google Cast Web Buyer SDK Önizleme URL'si adresinde bulunabilir.

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üklenir ve uygulama kaldırılır ve yayın cihazı varsayılan durumuna geri döner.

Bir Web Alıcısı uygulamasının yaşam döngüsü boyunca, mesajlar ile Web Alıcısı ve bağlı tüm gönderen uygulamaları. Gönderen uygulama, Google Cast cihazına oturum oluşturulmasını isteyen bir ilk mesaj gönder belirli bir uygulama kimliği kullanarak yapabilirsiniz. Bu, Web Alıcısı'nın yaşam döngüsünü başlatır ve Google Cast cihazı, Web Alıcı uygulamasını yüklemeyi dener. Orada olduğu varsayıldığında Ağ sorunu yoksa Web Receiver uygulaması ağdan indirilecek bunu kullanabilirsiniz. Yüklendikten sonra, Web Receiver uygulama, kurulum işlemlerini gerçekleştirir ve işlenmeye hazır olduğunu belirtir iletilerinin sayısı.

Bir Web Alıcı uygulaması bozulabilir (mevcut yaşam döngüsünü sona erdirebilir ve aşağıdaki koşullar kapsamındadır:

• Web Alıcı uygulaması, son bağlanmadan uygunsuz bir mesaj alır uygulama oturumunu sonlandırmasına yardımcı olabilir.
• Web Alıcı uygulaması belirli bir süre boyunca boşta kaldığında 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ü sırasında önemli bir hatayla karşılaşır.

Web Buyer SDK, tüm yaygın durumları Kullanıcı deneyimi kurallarını inceleyin.

Ana sınıflar

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

• cast.framework.CastReceiverContext - Yönetir ve gerekli kitaplıkları yükler. Bu nesneyle yapabilecekleriniz:

  • Uygulama yapılandırma seçeneklerini ayarlama
  • Sistem etkinliklerini (ör. gönderenin bağlı olması veya bağlantının kesilmesi) işleme
  • Özel kanallar oluşturun
  • Yayın iletişimini başlatma

• cast.framework.PlayerManager - Medyayı yönetir oynatmaya devam edebilirsiniz. Temel oynatıcıyı ve medya öğesini isteği gönderir. Bu nesneyle yapabilecekleriniz:

  • Oynatma işlemlerini gerçekleştirme
  • Gönderenden gelen oynatmayla ilgili istekleri işleme
  • Oynatmayla ilgili etkinlikleri işleme

Web Alıcı uygulamanızı kaydedin

Bir Web Receiver uygulaması geliştirmeden önce, uygulamanızın Google Cast SDK Geliştirici Konsolu'na sahip alıcı uygulaması. Görüntüleyin Daha fazla bilgi için Kayıt. Tüm Web Alıcısı uygulamalar, gönderen uygulamalarının komut mesajlarıyla birlikte bir uygulama kimliği sağlamasını gerektirir gönderen API'sı aracılığıyla Web Alıcısı'na gönderdikleri. Web sitenizi kaydettirdiğinizde alıcı başvurusuna atadıktan sonra, alıcınızın uygulama kimliğini API çağrıları.

Temel Web Alıcı uygulaması oluşturma

Aşağıda, herhangi bir varsayılan alan adı olmayan temel bir Web Receiver uygulamasının ana yapısı verilmiştir. özelleştirme:

1. Medya oynatıcıyı temsil eden cast-media-player HTML öğesi.
2. Web Alıcı çerçevesini yüklemek için bir komut dosyası HTML öğesi.
3. Telefonla arama start() Web Alıcı uygulamasını hiçbir seçenek olmadan başlatın.

Burada, Cast uygulamasını kullanan bir Web Alıcı uygulaması için gereken minimum kodu bulabilirsiniz Özelleştirme gerektirmeyen çerçeve. Bu komut dosyasını bire bir kopyalayıp yapıştırabilirsiniz oluşturmak için uygulamanıza olduğu gibi yapıştırın.

<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çıp yayın cihazına bağlanabilir. ardından medyaya gidin ve Web Alıcısı'na akışı gerçekleştirmesini söyleyen Oynat düğmesine basın kullanıcının izlemesi için TV'ye medya.

Bu temel Web Alıcısı'nı, özelleştirilmiş alıcı uygulaması.

Medya ve oynatıcılar

Cast çerçevesi, cast-media-player HTML öğesi. Bu medya oynatıcı şu cihazda oynatmayı destekliyor: MPEG-DASH, HLS ve Smooth Streaming gibi akış protokollerini destekler.

Desteklenen medya codec'leri ve kapsayıcıları grubu şu adreste listelenmiştir: Desteklenen Medya. Geliştiriciler, Cast mesajlaşması sayesinde yükleme, oynatma, duraklatma ve gönderme gibi, gönderen tarafından başlatılan Burada Cast SDK'sının medya ile olan etkileşimleri işler. Şunlar için: işlemler için uygulamanızın platformuyla ilgili gönderen API referansına bakın: Android Sender'da RemoteMediaClient, iOS Sender içinde GCKMediaControlChannel ve Web Sender'da Media.

Kaynaklar Arası Kaynak Paylaşımı

Google Cast, Merkezler Arası Kaynak Paylaşımı'nı (CORS) tam olarak destekler. Canlı yayın'da etkinleştirme protokoller, çoğu dosya tabanlı protokolün aksine, içeriğe eş zamansız şekilde XMLHttpRequest kullanın. CORS dünyasında bu talepler, kaynağın olmadığı sunucudan CORS üstbilgisi tarafından uygunsuz erişim ortaya çıkar. Diğer bir deyişle, içeriğinizin sunucusu içeriğin nasıl dahil. Modern tarayıcıların çoğu CORS'yi tam olarak destekler. iOS ve Android cihazlar daha alt düzeyde erişim sağlayın ve bu başlıklara bakmayın. Bu genellikle bir geliştirici, akış hizmetleri kullanmak istediğinde ortaya çıkan ilk sorundur. içerik. Kaynaklar Arasında Kaynak Paylaşımı: Kaynaklar Arası Kaynak Paylaşımı bolca fırsat sunuyor.