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

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

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

Xcode सेटअप करना

iOS 14

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

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

   अगर ऐसा नहीं है, तो SDK टूल को मैन्युअल तरीके से इंस्टॉल करें.

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

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

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

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

   नीचे दिए गए उदाहरण NSBonjourServices की परिभाषा को अपडेट करें और "ABCD1234" को अपने appID से बदलें.

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

3. Add NSLocalNetworkUsageDescription to your Info.plist

   We strongly recommend that you customize the message shown in the Local Network prompt by adding an app-specific permission string in your app's Info.plist file for the NSLocalNetworkUsageDescription such as to describe Cast discovery and other discovery services, like DIAL.

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

   This message will appear as part of the iOS Local Network Access dialog as shown in the mock.

   
4. Re-release your app to the Apple App Store

   We recommend you also re-release your app using 4.8.1 as soon as possible.

iOS 13

iOS 12

Ensure that the Access WiFi Information switch in the Capabilities section of the target is set to "On".

Additionally, your provisioning profile will need to support the Access WiFi Information capability. This can be added in the Apple Developer Portal.

CocoaPods setup

The recommended way of integrating Google Cast is using CocoaPods. For integration, use the google-cast-sdk CocoaPods.

To get started, follow the getting started guide.

Once CocoaPods is set up, follow the using CocoaPods guide to get your Podfile created and your project ready to use with the Google Cast SDK.

Here's an example of how to add the google-cast-sdk CocoaPod to your 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

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

इस स्निपेट में, वर्शन 4.8.1 और अगले मेजर वर्शन (major.minor.patch) तक के वर्शन की अनुमति है:

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

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

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

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

डाउनलोड किया गया कॉन्टेंट

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

iOS सेंडर SDK 4.8.1 लाइब्रेरी कास्ट करें:

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

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

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

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

Mac कैटलिस्ट सेटअप

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