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

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

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

Xcode सेटअप करना

iOS 14

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

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

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

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

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

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

   ऐप्लिकेशन आईडी, आपका रिसीवर आईडी होता है. यह वही आईडी होता है जो आपके GCKDiscoveryCriteria में तय किया गया है.

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

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

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

   हमारा सुझाव है कि आप लोकल नेटवर्क प्रॉम्प्ट में दिखने वाले मैसेज को पसंद के मुताबिक बनाएं. इसके लिए, अपने ऐप्लिकेशन के Info.plist फ़ाइल में, ऐप्लिकेशन के हिसाब से अनुमति स्ट्रिंग जोड़ें. जैसे, Cast डिवाइस ढूंढने और DIAL जैसी अन्य डिवाइस ढूंढने की सेवाओं के बारे में बताने के लिए.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.6 का इस्तेमाल करके जल्द से जल्द फिर से रिलीज़ करें.

iOS 13

iOS 12

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

इसके अलावा, आपकी प्रोविज़निंग प्रोफ़ाइल में वाई-फ़ाई की जानकारी ऐक्सेस करने की सुविधा होनी चाहिए. इसे 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 टारगेट के लिए लाइब्रेरी बनाते समय लिंकर से जुड़ी गड़बड़ी होती है.