Penerima Web Kustom

Jump start - Kode untuk membuat Penerima Web Kustom dasar sederhana. Lanjutkan ke mendaftarkan aplikasi Penerima Web, lalu buat aplikasi Penerima Web dasar.

Web Receiver SDK menggunakan pemutar media bawaan untuk memberikan pengalaman pemutaran yang lancar dan mudah. Layanan ini memberikan dukungan siap pakai untuk Asisten Google serta fitur khusus Cast yang otomatis didukung di semua pengirim dan perangkat yang mendukung sentuhan. Saat dirilis, fitur baru akan terus didukung tanpa perubahan pengirim tambahan.

Penerima Web Khusus adalah aplikasi HTML5 yang dibuat khusus dan harus dihosting untuk menampilkan konten Anda di perangkat yang kompatibel untuk Cast. Anda mungkin perlu membuat Penerima Web Kustom bergantung pada kebutuhan bisnis Anda. Untuk membantu memutuskan jenis penerima yang akan digunakan, lihat memilih panduan Penerima Web.

SDK Penerima Web Google

Aplikasi Web Receiver Anda mengakses Web Receiver API dengan referensi berikut:

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

Praktik terbaik untuk protokol URL: Perhatikan bahwa URL di atas tidak menentukan protokol "http:" atau "https:". Dengan menghilangkan protokol ini saat mencari resource cast_receiver_framework.js, resource ini dapat diambil menggunakan protokol yang sama dengan server yang menghosting aplikasi Penerima Web. Artinya, peralihan antara HTTP untuk pengembangan dan HTTPS untuk produksi bersifat transparan dan tidak memerlukan perubahan kode. (Aplikasi Penerima Web yang dipublikasikan harus dihosting di server yang mendukung TLS.)

Jangan menghosting sendiri resource cast_receiver_framework.js (Web Receiver SDK), bahkan untuk pengembangan lokal. Selalu gunakan Web Receiver SDK yang dihosting oleh Google menggunakan referensi gstatic.com. Web Receiver SDK yang dihosting oleh Google disimpan setara dengan firmware platform, dan diupdate secara berkala untuk mengatasi perbaikan bug dan menambahkan fitur baru. Selama pengembangan, Anda dapat menghosting aplikasi Penerima Web secara lokal di jaringan pribadi untuk pengujian, tetapi menghosting Web Receiver SDK secara lokal dapat menyebabkan aplikasi Anda rusak.

Pratinjau SDK

Versi pra-rilis Cast Web Receiver SDK juga tersedia untuk digunakan dalam pengujian aplikasi non-produksi. Informasi selengkapnya tentang URL pratinjau SDK dapat ditemukan di URL Pratinjau SDK Penerima Web Google Cast.

Siklus proses aplikasi

Siklus proses aplikasi Penerima Web dimulai dari tahap ketika Penerima Web dimuat ke perangkat Cast dan berlanjut ke titik saat aplikasi dirusak dan perangkat Cast kembali ke status defaultnya.

Selama siklus proses aplikasi Penerima Web, pesan dipertukarkan antara Penerima Web dan aplikasi pengirim yang terhubung. Aplikasi pengirim akan mengirim pesan awal ke perangkat Google Cast yang meminta sesi dibuat menggunakan ID aplikasi tertentu. Hal ini dimulai dari siklus proses Penerima Web, karena perangkat Google Cast akan mencoba memuat aplikasi Penerima Web. Dengan asumsi tidak ada masalah jaringan, aplikasi Penerima Web akan didownload dari jaringan menggunakan URL yang telah diselesaikan yang dikaitkan dengan ID aplikasi. Setelah dimuat, aplikasi Penerima Web akan menjalankan operasi penyiapannya dan menunjukkan bahwa aplikasi siap untuk memproses pesan dari aplikasi pengirim yang terhubung.

Aplikasi Penerima Web dapat terputus (mengakhiri siklus proses saat ini dan menutup aplikasi) dalam kondisi berikut:

• Aplikasi Penerima Web mendapatkan pesan eksplisit dari pengirim yang terakhir terhubung untuk mengakhiri sesi aplikasi.
• Aplikasi Web Receiver tidak aktif selama jangka waktu tertentu tanpa pengirim yang terhubung dan memutuskan untuk mengakhiri sesi aplikasi.
• Sesi transmisi yang berbeda telah dimulai.
• Penerima Web mengalami kesalahan fatal selama siklus prosesnya normalnya.

Web Receiver SDK menangani semua kasus umum sesuai dengan pedoman UX kami.

Kelas utama

Framework Web Receiver SDK memiliki 2 class utama:

• cast.framework.CastReceiverContext - Mengelola framework keseluruhan dan memuat library yang diperlukan. Dengan objek ini, Anda dapat:

  • Menyetel opsi konfigurasi aplikasi
  • Menangani peristiwa sistem (seperti pengirim terhubung atau terputus)
  • Buat saluran khusus
  • Memulai komunikasi transmisi

• cast.framework.PlayerManager - Mengelola pemutaran media. Komponen ini menangani pemutar dan elemen media yang mendasarinya sesuai dengan permintaan dari pengirim. Dengan objek ini, Anda dapat:

  • Menangani operasi pemutaran
  • Menangani permintaan terkait pemutaran dari pengirim
  • Menangani peristiwa terkait pemutaran

Mendaftarkan aplikasi Penerima Web Anda

Sebelum mengembangkan aplikasi Web Receiver, Anda harus mendaftarkan aplikasi Penerima Web ke Konsol Developer Google Cast SDK. Lihat Pendaftaran untuk mengetahui informasi selengkapnya. Semua aplikasi Penerima Web memerlukan aplikasi pengirim untuk memberikan ID aplikasi dengan pesan perintah yang mereka kirim ke Web Receiver melalui API pengirim. Saat mendaftarkan aplikasi Penerima Web, Anda akan menerima ID aplikasi untuk disertakan dalam panggilan API pengirim.

Membuat aplikasi Penerima Web dasar

Berikut adalah struktur utama aplikasi Web Receiver dasar yang tidak memiliki penyesuaian:

1. Elemen HTML cast-media-player untuk mewakili pemutar media.
2. Elemen HTML skrip untuk memuat framework Penerima Web.
3. Panggil start() untuk memulai aplikasi Penerima Web tanpa opsi.

Berikut adalah kode minimum untuk aplikasi Penerima Web yang menggunakan Framework Aplikasi Cast tanpa penyesuaian apa pun. Anda dapat menyalin dan menempelkan skrip ini apa adanya ke aplikasi Anda untuk membuat aplikasi Penerima Web.

<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>

Pada tahap ini, pengguna dapat membuka aplikasi pengirim, terhubung ke perangkat Cast, lalu membuka media dan menekan Play, yang memberi tahu Penerima Web untuk melakukan streaming media ke TV untuk ditonton pengguna.

Bandingkan Penerima Web dasar ini dengan aplikasi penerima yang disesuaikan.

Media dan pemutar

Framework Cast menyediakan pemutar media bawaan, yang diwakili oleh elemen HTML cast-media-player. Pemutar media ini mendukung pemutaran untuk protokol streaming seperti MPEG-DASH, HLS, dan Smooth Streaming.

Serangkaian codec dan penampung media yang didukung tercantum di Media yang Didukung. Melalui pesan Cast, developer dapat mendukung daftar operasi yang dimulai pengirim seperti pemuatan, pemutaran, jeda, dan cari, tempat Cast SDK menangani interaksi dengan media. Untuk daftar operasi yang didukung, lihat referensi API pengirim untuk platform aplikasi Anda: RemoteMediaClient di Pengirim Android, GCKMediaControlChannel di Pengirim iOS dan Media di Pengirim Web.

Berbagi Resource Lintas Asal

Google Cast sepenuhnya mendukung Cross-Origin Resource Sharing (CORS). Tidak seperti protokol berbasis file pada umumnya, streaming protokol tidak lagi menggunakan XMLHttpRequest secara asinkron. Dalam dunia CORS, permintaan ini dilindungi dari akses yang tidak tepat oleh header CORS dari server tempat resource berasal. Ini berarti server konten Anda memiliki tempat untuk menyertakannya. Sebagian besar browser modern sepenuhnya mendukung CORS. Perangkat iOS dan Android mengakses konten pada tingkat yang lebih rendah dan tidak melihat header ini. Masalah ini biasanya merupakan masalah pertama yang muncul saat developer ingin menggunakan konten streaming. Lihat Berbagi Resource Lintas Asal untuk mengetahui detailnya.