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

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

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

Xcode सेटअप करना

iOS 14

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

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

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

2. NSBonjourServices को अपनी Info.plist में जोड़ें

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

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

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

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

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

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

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

   <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.6 का इस्तेमाल करके जल्द से जल्द फिर से रिलीज़ करें.

iOS 13

iOS 12

पक्का करें कि टारगेट के सुविधाएं सेक्शन में मौजूद, वाई-फ़ाई की जानकारी ऐक्सेस करें स्विच को "चालू है" पर सेट किया गया हो.

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

CocoaPods सेटअप करना

Google Cast को इंटिग्रेट करने का सबसे सही तरीका, CocoaPods का इस्तेमाल करना है. इंटिग्रेशन के लिए, google-cast-sdk CocoaPods का इस्तेमाल करें.

शुरू करने के लिए, शुरुआती निर्देश देखें.

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

यहां दिए गए उदाहरण में बताया गया है कि google-cast-sdk CocoaPod को अपने Podfile में कैसे जोड़ा जा सकता है:

use_frameworks!

platform :ios, '16.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.6 और इसके बाद के वर्शन के साथ-साथ अगले मेजर वर्शन (major.minor.patch) तक के वर्शन इस्तेमाल किए जा सकते हैं:

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

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

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

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

डाउनलोड

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

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

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

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

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

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

अगर आपको डाइनैमिक लाइब्रेरी सेट अप करनी है, तो पिछले चरणों के साथ-साथ यह तरीका भी अपनाएं:

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 repo पर दिए गए निर्देशों का पालन करें.

अगर आपको स्टैटिक लाइब्रेरी सेट अप करनी है, तो पिछले चरणों के साथ-साथ यह तरीका भी अपनाएं:

1. अपने Xcode प्रोजेक्ट में, -ObjC -lc++ फ़्लैग को Build Settings > Other Linker Flags में जोड़ें.
2. अनज़िप की गई डायरेक्ट्री में Resources फ़ोल्डर ढूंढें. इसके बाद, सभी .bundle फ़ाइलों को अपने प्रोजेक्ट में, पहले जोड़े गए GoogleCast.xcframework के बगल में खींचें और छोड़ें. 'अगर ज़रूरी हो, तो सभी आइटम कॉपी करें' को चुनें और सभी टारगेट में जोड़ें.

Mac Catalyst सेटअप करना

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