การตั้งค่าสำหรับการพัฒนาด้วย Cast Application Framework (CAF) สำหรับ iOS

เฟรมเวิร์กของ Cast รองรับ iOS 14 ขึ้นไป และมีทั้งเฟรมเวิร์กแบบคงที่และแบบไดนามิก

ดูคำอธิบายคลาสและเมธอดทั้งหมดได้ที่เอกสารอ้างอิง Google Cast iOS API

หมายเหตุ: ตอนนี้ Cast iOS SDK XCFrameworks เวอร์ชันใหม่พร้อมใช้งานแล้ว ซึ่งรองรับการพัฒนาในคอมพิวเตอร์ Apple Silicon

ตั้งค่า Xcode

คำเตือน: การตั้งค่า Flag Apple Clang - Code Generation Optimization Level เป็น -Ofast สำหรับ "การเพิ่มประสิทธิภาพอย่างรวดเร็วที่สุด (Aggresive Optimizations)" จะทำให้แอปที่ใช้ Cast iOS SDK ขัดข้องเนื่องจากความไม่เข้ากันกับการเพิ่มประสิทธิภาพ SDK รองรับค่าเริ่มต้น -Os สําหรับ "Fastest, Smallest"

iOS 14

คำเตือนสำหรับ iOS 14: การเปลี่ยนแปลงสิทธิ์เข้าถึงเครือข่ายภายในของ iOS 14 ส่งผลต่อ Google Cast iOS SDK หลายประการ โปรดดูเอกสารการเปลี่ยนแปลงของ iOS 14 เพื่อดูว่าแอปได้รับผลกระทบอย่างไร

1. เพิ่ม Cast iOS SDK 4.8.1 ลงในโปรเจ็กต์

   หากใช้ CocoaPods ให้ใช้ pod update เพื่อเพิ่ม SDK 4.8.1 ลงในโปรเจ็กต์

   มิเช่นนั้น ให้ ดึง SDK ด้วยตนเอง

   หมายเหตุ: หากสร้างเครื่องมือเลือกอุปกรณ์ที่กำหนดเองในแอป คุณจะต้องเรียกใช้เมธอด startDiscovery อย่างชัดเจนในคลาส GCKDiscoveryManager เพื่อเริ่มการค้นหาอุปกรณ์ การสแกนอัตโนมัติถูกปิดใช้โดยค่าเริ่มต้นตั้งแต่เวอร์ชัน Cast SDK เวอร์ชัน 4.5.0
2. เพิ่ม NSBonjourServices ลงใน Info.plist ของคุณ

   ระบุ NSBonjourServices ใน Info.plist เพื่อให้การค้นหาเครือข่ายในเครื่องประสบความสำเร็จใน iOS 14

   คุณจะต้องเพิ่มทั้ง _googlecast._tcp และ _<your-app-id>._googlecast._tcp เป็นบริการเพื่อให้การค้นหาอุปกรณ์ทำงานได้อย่างถูกต้อง

   appID คือ getrID ซึ่งเป็นรหัสเดียวกับที่กําหนดไว้ใน GCKDiscoveryCriteria

   อัปเดตคำจำกัดความของ NSBonjourServices ในตัวอย่างต่อไปนี้และแทนที่ "ABCD1234" ด้วย appID ของคุณ

   <key>NSBonjourServices</key>
   <array>
     <string>_googlecast._tcp</string>
     <string>_ABCD1234._googlecast._tcp</string>
   </array>

3. Add NSLocalNetworkUsageDescription to your Info.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 the NSLocalNetworkUsageDescription such as to describe Cast discovery and other discovery services, like DIAL.

   <key>NSLocalNetworkUsageDescription</key>
   <string>${PRODUCT_NAME} uses the local network to discover Cast-enabled devices on your WiFi
   network.</string>

   This message will appear as part of the iOS Local Network Access dialog as shown in the mock.

   
4. 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 13 Warning: Apple permissions changes to iOS 13 and Xcode 11 have impacted the Google Cast iOS SDK in a number of ways. Please see the iOS 13 Changes document to see how your app will be impacted.

iOS 12

iOS 12 Warning: If developing using Xcode 10, the "Access WiFi Information" capability is required in order to discover and connect to Cast devices.

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

ประเด็นหลัก: ตั้งแต่เวอร์ชัน 4.3.1 เป็นต้นไป CocoaPods จะใช้ไลบรารีแบบคงที่เพื่อหลีกเลี่ยงคำเตือนสัญลักษณ์ที่ซ้ำกันซึ่งเกิดจากทรัพยากร Dependency ของไลบรารี Protobuf ที่แชร์เมื่อใช้ Firebase และ SDK ของ Cast ร่วมกัน แม้ว่าการเปลี่ยนแปลงนี้จะส่งผลให้มีการดาวน์โหลดขนาดใหญ่ขึ้น แต่ขนาดแอปสุดท้ายจะไม่เพิ่มขึ้น

หากสถานการณ์ของคุณมีความแตกต่างกันด้านขนาด ให้ดาวน์โหลดไลบรารีแบบไดนามิกเพื่อให้ได้ขนาดที่คล้ายคลึงกับไลบรารี CocoaPods เวอร์ชันก่อน 4.3.1

รายการที่ดาวน์โหลด

หลังจากดาวน์โหลดไลบรารีที่เหมาะสมด้านล่างแล้ว ให้ทำตามขั้นตอนการตั้งค่าเพื่อเพิ่มเฟรมเวิร์กลงในโปรเจ็กต์ของคุณ

ไลบรารี Cast iOS Sender เวอร์ชัน 4.8.1

คงที่ ไดนามิก

ขั้นตอนการตั้งค่า

วิธีติดตั้งไลบรารี

1. ดาวน์โหลดและแยก SDK ที่เหมาะกับโปรเจ็กต์ของคุณ
2. ตั้งค่าไลบรารี GoogleCastSDK แบบไดนามิก
3. ลาก .xcframework ที่แยกไฟล์แล้วไปยังโปรเจ็กต์หลักในตัวนำทางโปรเจ็กต์ Xcode (ไม่ใช่ลงในโปรเจ็กต์พ็อด หากมี) เลือก "คัดลอกรายการทั้งหมดหากจำเป็น" แล้วเพิ่มลงในเป้าหมายทั้งหมด
4. ในเป้าหมาย Xcode ในแท็บ General ให้เลือก Embed and Sign สำหรับ GoogleCast.xcframework

หากคุณตั้งค่าไลบรารีแบบคงที่ ให้ทำตามขั้นตอนเหล่านี้เพิ่มเติมจากขั้นตอนก่อนหน้า

1. ตั้งค่าไลบรารี Protobuf ด้วยเวอร์ชันขั้นต่ำ v3.13
1. หากโปรเจ็กต์ใช้ CocoaPods ให้ทำดังนี้
1. เปิด Podfile และนำ google-cast-sdk ออก (หากมี):

   pod 'google-cast-sdk'

2. เพิ่มไลบรารี Protobuf หากไม่มี:

   pod 'Protobuf', '3.13'

3. เรียกใช้ pod install ในโฟลเดอร์รูทของโปรเจ็กต์
2. หากโปรเจ็กต์ไม่ได้ใช้ CocoaPods ให้ทำดังนี้
1. นำ GoogleCastSDK เวอร์ชันปัจจุบันออก หากมี
2. เพิ่มไลบรารี Protobuf v3.13 หรือเวอร์ชันที่ใหม่กว่า โดยทำตามวิธีการที่อยู่ในที่เก็บ Protobuf GitHub
2. ในโปรเจ็กต์ Xcode ให้เพิ่มแฟล็ก -ObjC -lc++ ไปยังการตั้งค่าบิลด์ > แฟล็กอื่นๆ ของ Linker
3. ค้นหาโฟลเดอร์ทรัพยากรในไดเรกทอรีที่แตกไฟล์แล้ว และลาก GoogleCastCoreResources.bundle, GoogleCastUIResources.bundle และ MaterialDialogs.bundle ลงในโปรเจ็กต์ถัดจาก GoogleCast.xcframework ที่เพิ่มไว้ก่อนหน้านี้ เลือก "คัดลอกรายการทั้งหมดหากจำเป็น" และเพิ่มไปยังเป้าหมายทั้งหมด

การตั้งค่า Mac Catalyst

สำหรับแอปที่รองรับ Mac Catalyst ให้ใช้ไลบรารีแบบไดนามิกของ Cast SDK ทำตามขั้นตอนการตั้งค่าด้วยตนเองเพื่อเพิ่มเฟรมเวิร์กลงในโปรเจ็กต์ จากนั้นให้ยกเว้น Cast SDK อย่างมีเงื่อนไขจากเป้าหมาย Mac ตามที่ได้กล่าวไว้ในเอกสารประกอบของ Apple ไลบรารีแบบคงที่ได้รับการคอมไพล์ล่วงหน้าสำหรับสถาปัตยกรรม iOS ซึ่งทำให้เกิดข้อผิดพลาด Linker เมื่อสร้างโดยเทียบกับเป้าหมาย Mac