Mulai iOS 14, sistem operasi akan menerapkan batasan dan izin baru yang memengaruhi pengalaman pengguna Cast. Hal ini juga akan memengaruhi cara Anda mem-build Cast SDK ke dalam aplikasi. Agar aplikasi Anda dapat mempertahankan fungsi Cast dengan versi iOS terbaru, Anda harus melakukan update untuk menangani perubahan izin ini.
iOS 14
Developer harus mengupdate aplikasi pengirim Cast iOS mereka ke Google Cast SDK v4.6.0 atau yang lebih baru. Versi ini memberikan dukungan untuk iOS 14 dan persyaratannya.
Mulai iOS 14, aplikasi yang memindai perangkat di jaringan lokal kini akan meminta pengguna dengan dialog izin satu kali untuk menemukan dan terhubung ke perangkat jaringan lokal. Platform Cast menggunakan jaringan lokal untuk menemukan dan mengontrol perangkat Cast, sehingga pengguna tidak dapat melakukan transmisi jika menolak izin.
Untuk meningkatkan pengalaman pengguna, kami melakukan beberapa modifikasi UX pada SDK untuk aplikasi yang menggunakan pemilih perangkat standar. Perubahan UX ini memperjelas kepada pengguna mengapa izin akses jaringan lokal diperlukan, serta cara mengaktifkan transmisi jika akses perangkat jaringan lokal telah dinonaktifkan.
Aplikasi yang di-build dengan versi Cast SDK menggunakan v4.4.8 atau yang lebih lama akan terus berfungsi selama aplikasi tersebut di-build dengan Xcode 11.7 atau yang lebih lama. Jika Anda membangun aplikasi untuk iOS 14 dengan Xcode 12 atau yang lebih baru, sebaiknya update ke Cast SDK v4.6.0 atau yang lebih baru untuk memastikan aplikasi Cast akan terus berfungsi dengan baik.
Cast iOS SDK v4.6.0 atau yang lebih baru dapat didownload menggunakan CocoaPods dengan mengikuti penyiapan CocoaPods atau secara manual dengan mengikuti penyiapan manual. Rilis ini mencakup perubahan pada mekanisme penemuan yang mendasarinya untuk memungkinkan aplikasi yang di-build dengan Xcode 12 menemukan perangkat Cast di jaringan. Tombol Cast kini akan selalu ditampilkan. Jika tidak ada perangkat yang tersedia saat pengguna mengetuk tombol Cast, dialog akan ditampilkan yang memberikan panduan tentang alasan perangkat mungkin tidak tersedia, termasuk informasi tentang cara mengaktifkan kembali izin akses jaringan lokal.
Perubahan SDK Cast
Transmisi pertama kali
Saat pengguna pertama kali mencoba melakukan Transmisi, dialog interstisial akses jaringan lokal (LNA) akan muncul yang menjelaskan alasan diperlukannya akses jaringan lokal, diikuti dengan prompt izin akses jaringan lokal iOS yang disediakan Apple. Contoh di bawah ini menggambarkan alur:
Transmisi tidak tersedia
Mulai dari SDK pengirim iOS 4.6.0, tombol Cast selalu muncul saat pengguna terhubung ke Wi-Fi. Jika perangkat Cast tidak tersedia, mengetuk tombol Cast akan memunculkan dialog yang memberikan petunjuk kepada pengguna tentang kemungkinan alasan Cast tidak tersedia, seperti yang ditunjukkan pada tiruan di bawah ini:
Mengupdate aplikasi di iOS 14
-
Tambahkan Cast iOS SDK 4.8.1 ke project Anda
Jika menggunakan CocoaPods, gunakan
pod update
untuk menambahkan SDK 4.8.1 ke project Anda.Jika tidak, tarik SDK secara manual.
-
Tambahkan
NSBonjourServices
keInfo.plist
AndaTentukan
NSBonjourServices
diInfo.plist
agar penemuan jaringan lokal berhasil di iOS 14.Anda harus menambahkan
_googlecast._tcp
dan_<your-app-id>._googlecast._tcp
sebagai layanan agar penemuan perangkat berfungsi dengan baik.AppID adalah ID penerima Anda, yang merupakan ID yang sama dengan yang ditentukan dalam
GCKDiscoveryCriteria
.Perbarui contoh definisi
NSBonjourServices
berikut dan ganti "ABCD1234" dengan appID Anda. -
Tambahkan
NSLocalNetworkUsageDescription
keInfo.plist
Sebaiknya sesuaikan pesan yang ditampilkan di perintah Jaringan Lokal dengan menambahkan string izin khusus aplikasi di file
Info.plist
aplikasi Anda untukNSLocalNetworkUsageDescription
seperti untuk mendeskripsikan penemuan Cast dan layanan penemuan lainnya, seperti DIAL.Pesan ini akan muncul sebagai bagian dari dialog Local Network Access iOS seperti yang ditampilkan dalam tiruan.
-
Merilis ulang aplikasi Anda ke Apple App Store
Sebaiknya rilis ulang aplikasi menggunakan versi 4.8.1 sesegera mungkin.
Penyesuaian
Inisiasi penemuan perangkat transmisi
Secara default, penemuan perangkat Cast dimulai saat pengguna pertama kali mengetuk
tombol Cast (GCKUICastButton
). Jika ini adalah pertama kalinya pengguna
mencoba menggunakan aplikasi Cast di jaringan lokal setelah mengupgrade ke iOS
14, interstisial LNA baru akan muncul, diikuti dengan dialog izin Akses
Jaringan Lokal iOS.
Flag baru tersedia untuk memungkinkan Anda mengontrol kapan penemuan perangkat dimulai dan perilaku elemen UX tertentu:
startDiscoveryAfterFirstTapOnCastButton: BOOL(true/false)
Nilai default-nya adalah true
. Flag ini hanya berlaku jika flag
GCKCastOptions::disableDiscoveryAutostart
ditetapkan ke false
.
Jika disetel ke true
, penemuan perangkat Transmisi dimulai saat pengguna mengetuk
GCKUICastButton
untuk pertama kalinya. Pesan informasi akan
ditampilkan kepada pengguna dan memberi tahu mereka alasan diperlukannya izin jaringan
lokal. Setelah pesan tersebut, pesan LNA iOS 14 akan ditampilkan.
Penemuan perangkat transmisi dimulai setelah pesan dikonfirmasi.
Dalam peluncuran Aplikasi berikutnya, GCKUICastButton
akan selalu ditampilkan.
Jika ditetapkan ke false
, penemuan perangkat akan dimulai berdasarkan nilai
flag
GCKCastOptions::disableDiscoveryAutostart
.
Pertanyaan umum (FAQ)
Apa yang terjadi jika saya merilis ulang aplikasi pengirim Cast dengan Cast SDK v4.4.8 dan Xcode 12?
Aplikasi Anda mungkin tidak dapat menemukan perangkat Cast di jaringan lokal, kecuali jika Anda telah memperoleh hak multicast jaringan dari Apple. Perhatikan bahwa Apple tidak akan memberikan hak multicast hanya untuk tujuan mendukung Cast. Jika berencana membangun aplikasi dengan Xcode 12, Anda harus merilis aplikasi dengan Cast 4.6.0.
Jika saya merilis ulang aplikasi dengan Cast SDK baru, apa yang akan dijalankan pengguna di iOS 13 atau versi yang lebih lama?
Mereka akan terus melihat pengalaman pengguna yang sama seperti sebelum merilis ulang aplikasi Anda. Perubahan yang terlihat oleh pengguna terbatas untuk pengguna yang menjalankan iOS 14.
Apa yang harus saya lakukan untuk memperbarui aplikasi setelah versi baru Cast SDK dirilis?
- Update
Info.plist
aplikasi Anda untuk menyertakan deskripsi penggunaan jaringan lokal. - Tambahkan
NSBonjourServices
keInfo.plist
aplikasi Anda dan berikan nama layanan Bonjour untuk Cast dan ID aplikasi. - Upgrade aplikasi pengirim Anda untuk menggunakan Cast SDK 4.6.0.
- Luncurkan ulang aplikasi Anda ke Apple App Store.
Mengapa perangkat berhenti muncul di pemilih perangkat kustom setelah saya mengupgrade ke versi 4.6.0?
Ini adalah masalah umum yang dapat terjadi jika Anda menggunakan pemilih perangkat
kustom, bukan pemilih perangkat standar. Pada Cast SDK versi 4.4.8
dan yang lebih lama, pemindaian perangkat dilakukan secara otomatis. Mulai versi 4.6.0, Anda harus memanggil metode startDiscovery
secara eksplisit pada class
GCKDiscoveryManager
untuk memulai penemuan perangkat.
Alasan perubahan ini adalah karena dialog izin Akses Jaringan Lokal (LNA) akan muncul setelah aplikasi memindai untuk pertama kalinya. Hal ini dapat menyebabkan dialog izin muncul di tempat acak di aplikasi Anda.
Developer yang membuat pemilih perangkat kustom untuk aplikasi mereka diharapkan menyediakan interstisial satu kali sebelum memulai pemindaian perangkat untuk pertama kalinya di iOS 14.
iOS 13
Pada iOS 13, persyaratan izin baru diperkenalkan yang memengaruhi aplikasi menggunakan Google Cast SDK.
Mulai dari Google Cast SDK v4.4.3, tersedia SDK tambahan yang
tidak memerlukan izin Bluetooth®. Fitur ini tersedia di situs
developer dan di
google-cast-sdk-no-bluetooth
Cocoapods baru.
Pengelompokan aplikasi
Berikut ini perinciannya bergantung pada versi iOS SDK yang saat ini Anda gunakan:
Aplikasi yang dibuat dengan iOS 12 SDK atau versi sebelumnya
- Tindakan yang Disarankan. Performa penemuan perangkat dapat menurun saat berjalan di iOS 13, tetapi akan tetap berfungsi. Sebaiknya developer mengupgrade ke Cast SDK v4.4.4 jika tersedia.
- iOS 13 akan meminta pengguna untuk memberikan izin Bluetooth® ke aplikasi.
Aplikasi yang dibangun dengan iOS 13 SDK
- Tindakan Diperlukan: Update ke Cast SDK 4.4.4 atau tombol Cast mungkin tidak muncul jika pengguna tidak memberikan izin akses lokasi. Upgrade ke Cast SDK 4.4.4 diperlukan untuk memastikan pengalaman transmisi yang andal di iOS 13.