Framework Cast mendukung iOS 14 dan yang lebih baru, serta tersedia dalam framework statis dan dinamis.
Lihat Referensi API iOS Google Cast untuk mengetahui deskripsi semua class dan metode.
Penyiapan Xcode
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. -
Add
NSLocalNetworkUsageDescription
to yourInfo.plist
We strongly recommend that you customize the message shown in the Local Network prompt by adding an app-specific permission string in your app's
Info.plist
file for theNSLocalNetworkUsageDescription
such as to describe Cast discovery and other discovery services, like DIAL.This message will appear as part of the iOS Local Network Access dialog as shown in the mock.
-
Re-release your app to the Apple App Store
We recommend you also re-release your app using 4.8.1 as soon as possible.
iOS 13
iOS 12
Ensure that the Access WiFi Information switch in the Capabilities section of the target is set to "On".
Additionally, your provisioning profile will need to support the Access WiFi Information capability. This can be added in the Apple Developer Portal.
CocoaPods setup
The recommended way of integrating Google Cast is using
CocoaPods. For integration, use the
google-cast-sdk
CocoaPods.
To get started, follow the getting started guide.
Once CocoaPods is set up, follow the
using CocoaPods guide
to get your Podfile
created and your project ready to use with the Google Cast
SDK.
Here's an example of how to add the google-cast-sdk
CocoaPod to your
Podfile
:
use_frameworks!
platform :ios, '14.0'
def target_pods
pod 'google-cast-sdk'
end
target 'CastVideos-objc' do
target_pods
end
target 'CastVideos-swift' do
target_pods
end
Untuk project, Anda harus menentukan rentang pod untuk mencegah perubahan yang dapat menyebabkan gangguan yang tidak terduga seperti yang dijelaskan dalam panduan podfile.
Dalam cuplikan ini, versi 4.8.1 dan versi hingga versi utama berikutnya (major.minor.patch) diizinkan:
pod 'google-cast-sdk', '~> 4.8.1'
Misalnya, '~> 1.6.7' akan mencakup semua versi dari 1.6.7 dan yang lebih baru, tetapi tidak termasuk, versi 2.0.0.
Penyiapan manual
Petunjuk berikut adalah untuk menambahkan Cast iOS SDK ke project Anda tanpa menggunakan CocoaPods:
Hasil download
Setelah mendownload library yang sesuai di bawah, ikuti langkah-langkah penyiapan untuk menambahkan framework ke project Anda.
Library Cast iOS Sender SDK 4.8.1:
Langkah-langkah penyiapan
Untuk menginstal library:
- Download dan ekstrak SDK yang sesuai untuk proyek Anda.
- Siapkan library GoogleCastSDK dinamis:
-
Tarik file
.xcframework
yang telah diekstrak ke project utama Anda di navigator project Xcode (bukan ke project Pod jika Anda memilikinya). Centang 'Salin semua item jika diperlukan', dan tambahkan ke semua target. -
Di target Xcode, pada tab
General
, pilihEmbed and Sign
untukGoogleCast.xcframework
.
Jika Anda menyiapkan library statis, ikuti langkah-langkah berikut selain langkah sebelumnya:
- Menyiapkan library Protobuf dengan versi minimum v3.13.
- Jika project Anda menggunakan CocoaPods:
-
Buka
Podfile
dan hapusgoogle-cast-sdk
jika ada:pod 'google-cast-sdk'
-
Tambahkan library
Protobuf
jika tidak ada:pod 'Protobuf', '3.13'
-
Jalankan
pod install
di folder root project Anda. - Jika project Anda tidak menggunakan CocoaPods:
-
Hapus versi
GoogleCastSDK
saat ini jika ada. - Tambahkan library Protobuf v3.13 atau yang lebih baru, dengan mengikuti petunjuk yang ada di repo GitHub Protobuf.
-
Di project Xcode Anda, tambahkan flag
-ObjC -lc++
ke Build Settings > Other Linker Flags. -
Temukan folder Resources dalam direktori yang telah diekstrak, lalu tarik
GoogleCastCoreResources.bundle
,GoogleCastUIResources.bundle
, danMaterialDialogs.bundle
ke project Anda di sampingGoogleCast.xcframework
yang telah ditambahkan sebelumnya. Centang 'Copy all items if needed', dan tambahkan ke semua target.
Penyiapan Mac Catalyst
Untuk Aplikasi yang mendukung Mac Catalyst, gunakan library dinamis SDK Cast. Ikuti proses penyiapan manual untuk menambahkan framework ke project Anda. Kemudian, kecualikan Cast SDK secara bersyarat dari target Mac seperti yang disebutkan dalam dokumentasi Apple. Library statis telah dikompilasi sebelumnya untuk arsitektur iOS, yang menyebabkan error linker saat melakukan build terhadap target Mac.