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

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

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

Xcode सेटअप

iOS 14

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

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

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

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

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

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

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

iOS 13

iOS 12

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

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

CocoaPods सेटअप

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

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

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

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

use_frameworks!

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

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

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

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

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

डाउनलोड

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

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

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

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

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

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

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

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 टारगेट के लिए कंपाइल करने पर, लिंकर में गड़बड़ी होती है.