iOS के लिए, कास्ट ऐप्लिकेशन फ़्रेमवर्क (सीएएफ़) के साथ डेवलप करने के लिए सेटअप

Cast फ़्रेमवर्क, iOS 14 और इसके बाद के वर्शन पर काम करता है. यह दोनों वर्शन में उपलब्ध है स्टैटिक और डाइनैमिक फ़्रेमवर्क के बारे में बताया गया है.

Google Cast iOS API संदर्भ देखें सभी क्लास और तरीकों की जानकारी.

ध्यान दें: नए वर्शन Cast iOS SDK XCFrameworks का अब उपलब्ध है, जो डेवलपमेंट में मदद करता है Apple Silicon कंप्यूटर पर.

Xcode सेटअप करना

चेतावनी: Apple Clang - Code Generation Optimization Level फ़्लैग सेट किया जा रहा है 'सबसे तेज़, सक्रिय ऑप्टिमाइज़ेशन' के लिए -Ofast को को इस्तेमाल करने वाले ऐप्लिकेशन ऑप्टिमाइज़ेशन के साथ काम न करने की वजह से, iOS SDK टूल को क्रैश होने की वजह से कास्ट करें. SDK टूल 'सबसे तेज़, सबसे छोटे' के लिए डिफ़ॉल्ट वैल्यू -Os का इस्तेमाल करता है.

iOS 14

iOS 14 के लिए चेतावनी: iOS 14 में हुए बदलाव लोकल नेटवर्क ऐक्सेस करने की अनुमतियों का असर Google Cast iOS SDK टूल पर पड़ा है. मदद मिलती है. कृपया iOS 14 में हुए बदलाव दस्तावेज़ देखें.

1. अपने प्रोजेक्ट में Cast iOS SDK 4.8.3 जोड़ना

   अगर CocoaPods का इस्तेमाल किया जा रहा है, तो अपने प्रोजेक्ट में 4.8.3 SDK टूल जोड़ने के लिए pod update का इस्तेमाल करें.

   या फिर, SDK टूल को मैन्युअल तौर पर फ़ेच किया जा सकता है.

   ध्यान दें: अगर आपने अपने ऐप्लिकेशन में पसंद के मुताबिक डिवाइस पिकर बनाया है, तो आपको इन चीज़ों की ज़रूरत होगी startDiscovery मेथड को कॉल करने के लिए GCKDiscoveryManager क्लास का इस्तेमाल करें. अपने-आप स्कैन होने की सुविधा को इसके ज़रिए बंद किया गया यह डिफ़ॉल्ट रूप से, Cast SDK टूल के v4.5.0 वर्शन से शुरू होता है.
2. NSBonjourServices को अपने Info.plist में जोड़ें

   अपने Info.plist में NSBonjourServices तय करें, ताकि iOS 14 पर लोकल नेटवर्क डिस्कवरी को कामयाब होने दें.

   आपको _googlecast._tcp और, दोनों को जोड़ना होगा डिवाइस के लिए सेवाओं के तौर पर _<your-app-id>._googlecast._tcp खोजने के लिए डिज़ाइन किया गया है.

   appID, आपका रिसीवर आईडी होता है. यह वही आईडी होता है जो आपके GCKDiscoveryCriteria.

   नीचे दिए गए उदाहरण NSBonjourServices की परिभाषा को अपडेट करें और "ABCD1234" को बदलें आपको ऐप्लिकेशन आईडी से जोड़ना होगा.

   <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.3 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

अपने प्रोजेक्ट के लिए, आपको अपने पॉड के लिए एक रेंज तय करनी चाहिए, ताकि अचानक से ऐसा होने से रोका जा सके में बताए गए बदलावों के हिसाब से, पॉडफ़ाइल गाइड देखें.

इस स्निपेट में, वर्शन 4.8.3 और अगले वर्शन तक के वर्शन मेजर वर्शन (major.minor.patch) की अनुमति है:

pod 'google-cast-sdk', '~> 4.8.3'

उदाहरण के लिए, '~> 1.6.7' इसमें 1.6.7 और उससे लेकर अब तक के सभी वर्शन शामिल होंगे, लेकिन इसमें वर्शन 2.0.0 भी शामिल है.

मैन्युअल सेटअप

नीचे दिए गए निर्देश आपके प्रोजेक्ट में Cast iOS SDK जोड़ने के लिए हैं CocoaPods का इस्तेमाल किए बिना:

अहम जानकारी: वर्शन 4.3.1 और इसके बाद के वर्शन में, CocoaPods स्टैटिक लाइब्रेरी का इस्तेमाल करके, डुप्लीकेट सिंबल की चेतावनियों की वजह से Firebase और Cast SDK टूल का इस्तेमाल करते समय, शेयर की गई Protobuf लाइब्रेरी डिपेंडेंसी हैं बेमिसाल. हालांकि, इस बदलाव से डाउनलोड की संख्या में बढ़ोतरी होगी, लेकिन आखिरी ऐप्लिकेशन का आकार नहीं बढ़ेगा.

अगर साइज़ में अंतर आपके लिए समस्या पैदा करता है, तो की डाइनैमिक लाइब्रेरी है, जिसका साइज़ CocoaPods के 4.3.1 से पहले वाले वर्शन के जैसा है लाइब्रेरी.

डाउनलोड किए गए वीडियो

नीचे दी गई ज़रूरी लाइब्रेरी डाउनलोड करने के बाद, सेटअप चरण: प्रोजेक्ट.

iOS सेंडर SDK 4.8.3 लाइब्रेरी कास्ट करें:

स्टैटिक डाइनैमिक

सेटअप का तरीका

लाइब्रेरी इंस्टॉल करने के लिए:

1. अपने प्रोजेक्ट के लिए सही SDK टूल डाउनलोड करें और उसे एक्सट्रैक्ट करें.
2. डाइनैमिक GoogleCastSDK लाइब्रेरी सेट अप करें:
3. अनज़िप किए गए .xcframework को अपने मुख्य प्रोजेक्ट में खींचें और छोड़ें Xcode प्रोजेक्ट नेविगेटर (अगर आपके पास कोई Pods प्रोजेक्ट है, तो उसमें नहीं है). 'ज़रूरी होने पर सभी आइटम कॉपी करें' पर सही का निशान लगाएं और सभी टारगेट में जोड़ें.
4. अपने Xcode टारगेट में, General टैब के तहत, GoogleCast.xcframework के लिए Embed and Sign चुनें.

अगर स्टैटिक लाइब्रेरी सेट अप की जा रही है, तो इसके साथ में इन चरणों को पूरा करें पिछले चरण:

1. कम से कम वर्शन के साथ प्रोटोबफ़ लाइब्रेरी सेट अप करना 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. प्रोटोबफ़ लाइब्रेरी का v3.13 या उसके बाद का वर्शन जोड़ें, दिए गए निर्देशों का पालन करें. प्रोटोबफ़ GitHub रेपो के बगल में बने बॉक्स को दिखाता है.
2. अपने Xcode प्रोजेक्ट में, -ObjC -lc++ फ़्लैग जोड़ें बिल्ड सेटिंग > लिंक करने वाले अन्य फ़्लैग.
3. अनज़िप की गई डायरेक्ट्री में रिसॉर्स फ़ोल्डर को ढूंढें और GoogleCastCoreResources.bundle को खींचें, GoogleCastUIResources.bundle और MaterialDialogs.bundle को जोड़ने के लिए, GoogleCast.xcframework के बगल में मौजूद आपके प्रोजेक्ट से जुड़ें पहले जोड़ा गया. 'ज़रूरी होने पर सभी आइटम कॉपी करें' पर सही का निशान लगाएं और सभी आइटम में जोड़ें टारगेट के लिए.

Mac कैटलिस्ट सेटअप

Mac कैटलिस्ट के साथ काम करने वाले ऐप्लिकेशन के लिए, Cast SDK की डाइनैमिक लाइब्रेरी का इस्तेमाल करें. जोड़ने के लिए मैन्युअल सेटअप प्रोसेस का पालन करें फ़्रेमवर्क भी शामिल है. इसके बाद, Mac से Google Cast SDK टूल को कुछ शर्तों के साथ हटाना टारगेट के लिए, Apple के दस्तावेज़. स्टैटिक लाइब्रेरी, iOS आर्किटेक्चर के लिए पहले से कंपाइल की जाती हैं. इस वजह से, लिंकर बनता है Mac लक्ष्य से जोड़ते समय गड़बड़ी हुई है.