Penerima Web Kustom

Jump start - Kode untuk membuat Web Kustom dasar Penerima sederhana. Maju ke daftarkan Penerima Web Anda aplikasi, lalu buat model Aplikasi Penerima Web.

Web Receiver SDK menggunakan pemutar media yang sudah ada di dalamnya untuk memberikan pengalaman pemutaran yang lebih baik. Alat ini juga memberikan dukungan siap pakai untuk Asisten Google sebagai fitur khusus Cast yang didukung secara otomatis di semua pengirim dan perangkat yang mendukung sentuhan. Ketika fitur baru dirilis, fitur tersebut akan terus didukung tanpa perubahan pengirim tambahan.

Penerima Web Khusus adalah aplikasi HTML5 yang dibuat khusus yang harus dihosting ke menampilkan konten di perangkat yang kompatibel untuk Cast. Anda mungkin perlu membuat Web Receiver bergantung pada kebutuhan bisnis Anda. Untuk membantu menentukan penerima yang digunakan, lihat pilih panduan Penerima Web.

SDK Penerima Web Google

Aplikasi Web Receiver Anda mengakses Web Receiver API dengan referensi:

<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 "http:" atau "https:" dan berperforma tinggi karena merupakan protokol biner. Menghilangkan protokol ini saat mencari Resource cast_receiver_framework.js memungkinkan resource ini diambil menggunakan protokol yang sama seperti server yang menjadi {i>host<i} aplikasi {i>Web Receiver<i}. Hal ini berarti bahwa peralihan antara HTTP untuk pengembangan dan HTTPS untuk produksi bersifat transparan dan tidak memerlukan perubahan kode. (Aplikasi Penerima Web yang dipublikasikan harus dihosting pada server yang mendukung TLS.)

Jangan menghosting sendiri Resource cast_receiver_framework.js (Web Receiver SDK), tidak untuk pengembangan lokal. Selalu gunakan SDK Penerima Web yang dihosting oleh Google menggunakan referensi gstatic.com. Web Receiver SDK yang dihosting oleh Google diselaraskan dengan {i>firmware<i} platform, dan diperbarui secara berkala untuk mengatasi perbaikan {i>bug<i} 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 kerusakan aplikasi Anda.

Pratinjau SDK

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

Siklus proses aplikasi

Siklus hidup aplikasi Penerima Web dimulai dari titik saat Penerima Web dimuat ke perangkat Transmisi dan dilanjutkan ke titik saat aplikasi dihapus dan perangkat Transmisi kembali ke status default.

Selama siklus hidup aplikasi Penerima Web, pesan dipertukarkan antara Penerima Web dan aplikasi pengirim yang tersambung. Aplikasi pengirim akan mengirim pesan awal ke perangkat Google Cast yang meminta dibuatkan sesi menggunakan ID aplikasi tertentu. Ini memulai siklus hidup {i>Web Receiver<i}, sebagai perangkat Google Cast akan mencoba memuat aplikasi Penerima Web. Dengan asumsi tidak ada masalah jaringan, aplikasi Penerima Web akan diunduh dari jaringan menggunakan URL yang di-resolve yang terkait dengan ID aplikasi. Setelah dimuat, Penerima Web aplikasi akan melakukan operasi penyiapannya dan menunjukkan bahwa aplikasi siap untuk diproses pesan dari setiap aplikasi pengirim yang tersambung.

Aplikasi Penerima Web mungkin disingkirkan (mengakhiri siklus hidupnya saat ini dan menutup ) dalam kondisi berikut:

• Aplikasi Web Receiver mendapatkan pesan vulgar dari yang terakhir terhubung pengirim untuk mengakhiri sesi aplikasi.
• Aplikasi Web Receiver tidak ada aktivitas selama jangka waktu yang ditentukan tanpa pengirim yang terhubung dan memutuskan untuk mengakhiri sesi aplikasi.
• Sesi transmisi yang berbeda dimulai.
• Penerima Web mengalami error fatal selama siklus hidup normalnya.

SDK Penerima Web menangani semua kasus umum sesuai dengan Panduan UX.

Kelas utama

Framework Web Receiver SDK memiliki 2 class utama:

• cast.framework.CastReceiverContext - Mengelola secara keseluruhan dan memuat semua 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 media pemutaran. API 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 Web Receiver Anda

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

Membuat aplikasi Web Receiver dasar

Berikut ini adalah struktur utama dari 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 Web Receiver.
3. Telepon start() untuk memulai aplikasi Web Receiver tanpa opsi.

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

<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, menghubungkan ke perangkat Transmisi, lalu arahkan ke media dan tekan Putar, yang akan 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 direpresentasikan oleh Elemen HTML cast-media-player. Pemutar media ini mendukung pemutaran untuk protokol streaming seperti MPEG-DASH, HLS, dan Smooth Streaming.

Sekumpulan codec dan kontainer media yang didukung tercantum di Media yang Didukung. Melalui pesan Cast, developer dapat mendukung daftar operasi yang dimulai pengirim seperti memuat, memutar, menjeda, dan cari, tempat SDK Cast menangani interaksi dengan media. Untuk daftar operasi yang didukung, lihat referensi API pengirim untuk platform aplikasi Anda: RemoteMediaClient di Android Sender, GCKMediaControlChannel di Pengirim Pesan iOS dan Media di Web Sender.

Cross-Origin Resource Sharing (CORS)

Google Cast sepenuhnya mendukung Cross-Origin Resource Sharing (CORS). Streaming tidak seperti kebanyakan protokol berbasis file, mengakses konten dalam protokol asinkron menggunakan XMLHttpRequest. Di dunia CORS, permintaan ini dilindungi dari akses yang tidak pantas oleh header CORS dari server tempat resource asal. Ini berarti bahwa server konten Anda dapat memutuskan di mana disertakan. Sebagian besar browser modern sepenuhnya mendukung CORS. Perangkat iOS dan Android mengakses konten di tingkat yang lebih rendah dan jangan melihat {i>header<i} ini. Ini adalah sering kali menjadi masalah pertama yang muncul ketika developer ingin menggunakan fitur streaming saat ini. Lihat Cross-Origin Resource Sharing (CORS) untuk spesifikasi pendukung.