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

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

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

Xcode सेटअप करना

iOS 14

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

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

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

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

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

   डिवाइस ढूंढने की सुविधा ठीक से काम करे, इसके लिए आपको _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. अपने Info.plist में NSLocalNetworkUsageDescription जोड़ें

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

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, '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 टूल जोड़ने के लिए, यहां दिए गए निर्देशों का पालन करें:

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

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

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

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

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

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

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

Mac Catalyst का सेटअप

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