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

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

सभी क्लास और तरीकों के बारे में जानकारी पाने के लिए, Google Cast iOS API रेफ़रंस देखें.

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

Xcode सेटअप करना

चेतावनी: 'सबसे तेज़ और बेहतर ऑप्टिमाइज़ेशन' के लिए, Apple Clang - Code Generation Optimization Level फ़्लैग को -Ofast पर सेट करने पर, Cast 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 एसडीके जोड़ने के लिए, pod update का इस्तेमाल करें.

   इसके अलावा, SDK टूल को मैन्युअल तरीके से इंपोर्ट करें.

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

   iOS 14 पर लोकल नेटवर्क डिस्कवरी की सुविधा चालू करने के लिए, अपने Info.plist में NSBonjourServices डालें.

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

   appID आपका receiverID होता है. यह वही आईडी होता है जो आपके GCKDiscoveryCriteria में बताया गया है.

   यहां दिए गए उदाहरण में NSBonjourServices की परिभाषा अपडेट करें और "ABCD1234" की जगह अपना appID डालें.

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

3. अपने Info.plist में NSLocalNetworkUsageDescription जोड़ना

   हमारा सुझाव है कि आप लोकल नेटवर्क प्रॉम्प्ट में दिखाए गए मैसेज को अपनी ज़रूरत के मुताबिक बनाएं. इसके लिए, अपने ऐप्लिकेशन की Info.plist फ़ाइल में, ऐप्लिकेशन के हिसाब से अनुमति वाली स्ट्रिंग जोड़ें. उदाहरण के लिए, DIAL जैसी डिस्कवरी सेवाओं और Cast डिस्कवरी के बारे में बताने के लिए.NSLocalNetworkUsageDescription

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

   यह मैसेज, iOS के लोकल नेटवर्क ऐक्सेस डायलॉग के हिस्से के तौर पर दिखेगा, जैसा कि मॉक में दिखाया गया है.

   
4. Apple App Store पर अपने ऐप्लिकेशन को फिर से रिलीज़ करना

   हमारा सुझाव है कि आप जल्द से जल्द 4.8.3 का इस्तेमाल करके, अपने ऐप्लिकेशन को फिर से रिलीज़ करें.

iOS 13

iOS 13 से जुड़ी चेतावनी: Apple ने iOS 13 और Xcode 11 में अनुमतियों से जुड़े बदलाव किए हैं. इनसे Google Cast के iOS SDK पर कई तरह से असर पड़ा है. आपके ऐप्लिकेशन पर क्या असर पड़ेगा, यह जानने के लिए कृपया iOS 13 में हुए बदलाव दस्तावेज़ देखें.

iOS 12

iOS 12 के लिए चेतावनी: अगर Xcode 10 का इस्तेमाल करके ऐप्लिकेशन डेवलप किया जा रहा है, तो Cast डिवाइसों को ढूंढने और उनसे कनेक्ट करने के लिए, "वाई-फ़ाई की जानकारी ऐक्सेस करें" सुविधा की ज़रूरत होती है.

पक्का करें कि टारगेट के क्षमताएं सेक्शन में, वाई-फ़ाई की जानकारी ऐक्सेस करें स्विच "चालू" पर सेट हो.

इसके अलावा, आपकी प्रोविज़निंग प्रोफ़ाइल में वाई-फ़ाई की जानकारी ऐक्सेस करने की सुविधा होनी चाहिए. इसे Apple Developer Portal में जोड़ा जा सकता है.

CocoaPods सेटअप करना

Google Cast को इंटिग्रेट करने के लिए, CocoaPods का इस्तेमाल करने का सुझाव दिया जाता है. इंटिग्रेशन के लिए, google-cast-sdk CocoaPods का इस्तेमाल करें.

शुरू करने के लिए, शुरू करने की गाइड देखें.

CocoaPods सेट अप करने के बाद, Podfile बनाने और अपने प्रोजेक्ट को Google Cast SDK टूल के साथ इस्तेमाल करने के लिए, CocoaPods का इस्तेमाल करने से जुड़ी गाइड में दिए गए निर्देशों का पालन करें.

google-cast-sdk CocoaPod को अपनी प्रोजेक्ट फ़ाइल में जोड़ने का उदाहरण यहां दिया गया है: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.3 वर्शन और अगले मुख्य वर्शन (major.minor.patch) तक के वर्शन इस्तेमाल किए जा सकते हैं:

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

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

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

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

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

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

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

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

Cast iOS Sender SDK 4.8.3 लाइब्रेरी:

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

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

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

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

Mac Catalyst का सेटअप

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