เฟรมเวิร์ก Cast รองรับ iOS 14 ขึ้นไป และมาในเฟรมเวิร์กทั้งแบบคงที่และแบบไดนามิก
ดูคำอธิบายคลาสและเมธอดทั้งหมดได้ที่ข้อมูลอ้างอิง API ของ Google Cast สำหรับ iOS
การตั้งค่า Xcode
iOS 14
-
เพิ่ม Cast iOS SDK 4.8.1 ลงในโปรเจ็กต์ของคุณ
หากใช้ CocoaPods ให้ใช้
pod update
เพื่อเพิ่ม SDK 4.8.1 ในโปรเจ็กต์ของคุณไม่เช่นนั้น ให้ ดึง SDK ด้วยตนเอง
-
เพิ่ม
NSBonjourServices
ลงในInfo.plist
ระบุ
NSBonjourServices
ในInfo.plist
เพื่อให้การค้นหาเครือข่ายภายในเครื่องประสบความสำเร็จใน iOS 14คุณจะต้องเพิ่มทั้ง
_googlecast._tcp
และ_<your-app-id>._googlecast._tcp
เป็นบริการเพื่อให้การค้นหาอุปกรณ์ทำงานได้อย่างถูกต้องappID คือ ReceiverID ซึ่งเป็นรหัสเดียวกับที่ระบุไว้ใน
GCKDiscoveryCriteria
อัปเดตคําจํากัดความ
NSBonjourServices
ตัวอย่างต่อไปนี้และแทนที่ "ABCD1234" ด้วยรหัสแอปของคุณ -
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
สำหรับโปรเจ็กต์ คุณควรระบุช่วงสำหรับพ็อดเพื่อป้องกันการเปลี่ยนแปลงที่เสียหายที่ไม่คาดคิดตามรายละเอียดในคำแนะนำสำหรับ Podfile
ในข้อมูลโค้ดนี้ เราอนุญาตให้ใช้เวอร์ชัน 4.8.1 และเวอร์ชันจนถึงเวอร์ชันหลักถัดไป (major.minor.patch)
pod 'google-cast-sdk', '~> 4.8.1'
ตัวอย่างเช่น "~> 1.6.7" จะรวมทุกเวอร์ชันตั้งแต่ 1.6.7 ขึ้นไป แต่ไม่รวมเวอร์ชัน 2.0.0
ตั้งค่าด้วยตนเอง
วิธีการต่อไปนี้มีไว้สำหรับการเพิ่ม Cast iOS SDK ลงในโปรเจ็กต์โดยไม่ต้องใช้ CocoaPods
รายการที่ดาวน์โหลด
หลังจากดาวน์โหลดไลบรารีที่เหมาะสมด้านล่าง ให้ทำตามขั้นตอนการตั้งค่าเพื่อเพิ่มเฟรมเวิร์กลงในโปรเจ็กต์ของคุณ
ไลบรารีของ Cast iOS Sender SDK 4.8.1
ขั้นตอนการตั้งค่า
วิธีติดตั้งไลบรารี
- ดาวน์โหลดและดึงข้อมูล SDK ที่เหมาะสมสำหรับโปรเจ็กต์ของคุณ
- ตั้งค่าไลบรารี GoogleCastSDK แบบไดนามิกโดยทำดังนี้
-
ลาก
.xcframework
ที่แตกแล้วไปยังโปรเจ็กต์หลักในโปรแกรมนำทางโปรเจ็กต์ Xcode (ไม่ใช่ลงในโปรเจ็กต์พ็อด หากมี) เลือก "คัดลอกรายการทั้งหมดหากจำเป็น" แล้วเพิ่มลงในเป้าหมายทั้งหมด -
ในเป้าหมาย Xcode ในแท็บ
General
ให้เลือกEmbed and Sign
สำหรับGoogleCast.xcframework
หากคุณกำลังตั้งค่าไลบรารีแบบคงที่ โปรดทำตามขั้นตอนเหล่านี้เพิ่มเติมจากขั้นตอนก่อนหน้า
- ตั้งค่าไลบรารี Protobuf ด้วยเวอร์ชัน v3.13 ขั้นต่ำ
- หากโปรเจ็กต์ของคุณใช้ CocoaPods ให้ทำดังนี้
-
เปิด
Podfile
และนำgoogle-cast-sdk
ออก หากมี:pod 'google-cast-sdk'
-
เพิ่มไลบรารี
Protobuf
หากไม่มี:pod 'Protobuf', '3.13'
-
เรียกใช้
pod install
ในโฟลเดอร์รูทของโปรเจ็กต์ - หากโปรเจ็กต์ไม่ได้ใช้ CocoaPods ให้ทำดังนี้
-
นำ
GoogleCastSDK
เวอร์ชันปัจจุบันออก หากมี - เพิ่มไลบรารี Protobuf เวอร์ชัน 3.13 ขึ้นไป โดยทำตามวิธีการที่อยู่ในที่เก็บ Protobuf GitHub
-
ในโปรเจ็กต์ Xcode ให้เพิ่มแฟล็ก
-ObjC -lc++
ไปยังการตั้งค่าบิลด์ > แฟล็ก Linker อื่นๆ -
ค้นหาโฟลเดอร์ "ทรัพยากร" ในไดเรกทอรีที่คลายการบีบอัด แล้วลาก
GoogleCastCoreResources.bundle
,GoogleCastUIResources.bundle
และMaterialDialogs.bundle
ไปยังโปรเจ็กต์ที่ติดกับGoogleCast.xcframework
ที่คุณเพิ่มไว้ก่อนหน้านี้ เลือก "คัดลอกรายการทั้งหมดหากจำเป็น" แล้วเพิ่มลงในเป้าหมายทั้งหมด
ตั้งค่า Mac Catalyst
สำหรับแอปที่รองรับ Mac Catalyst ให้ใช้ไลบรารีแบบไดนามิกของ Cast SDK ทำตามขั้นตอนการตั้งค่าด้วยตนเองเพื่อเพิ่มเฟรมเวิร์กลงในโปรเจ็กต์ จากนั้นยกเว้น Cast SDK จากเป้าหมาย Mac อย่างมีเงื่อนไขตามที่ระบุไว้ในเอกสารประกอบของ Apple ไลบรารีแบบคงที่ได้รับการคอมไพล์ล่วงหน้าสำหรับสถาปัตยกรรม iOS ซึ่งทำให้เกิดข้อผิดพลาด Linker เมื่อสร้างตามเป้าหมายของ Mac