iOS अनुमतियां और खोज

iOS 14 और उसके बाद के वर्शन में, ऑपरेटिंग सिस्टम नई पाबंदियां लागू करेगा और इन अनुमतियों से कास्ट उपयोगकर्ता के अनुभव पर असर पड़ता है. इसका यह भी असर पड़ेगा कि अपने ऐप्लिकेशन में Cast SDK टूल बनाएं. आपके ऐप्लिकेशन के लिए, कास्ट करने की सुविधा बनाए रखने के लिए तो आपको iOS के सबसे नए वर्शन के साथ काम करने के लिए अपडेट करने होंगे. अनुमतियों में बदलाव किए जा सकते हैं.

iOS 14

डेवलपर को अपने iOS कास्ट भेजने वाले ऐप्लिकेशन को Google Cast SDK में अपडेट करना चाहिए वर्शन 4.6.0 या इसके बाद के वर्शन. ये वर्शन, iOS 14 और इससे जुड़ी ज़रूरी शर्तों के हिसाब से काम करते हैं.

iOS 14 और इसके बाद के वर्शन में, लोकल नेटवर्क पर डिवाइसों को स्कैन करने वाले ऐप्लिकेशन अब लोगों को एक बार इस्तेमाल किया जाने वाला, अनुमतियों वाला डायलॉग बॉक्स दिखेगा. इस डायलॉग बॉक्स में, लोकल नेटवर्क डिवाइसें. Cast प्लैटफ़ॉर्म, लोकल नेटवर्क का इस्तेमाल करके, कास्ट डिवाइसों को कंट्रोल कर सकता है, ताकि अगर उपयोगकर्ता अनुमति न दे, तो कास्ट करें.

उपयोगकर्ता अनुभव को बेहतर बनाने के लिए, हम SDK टूल में कुछ बदलाव कर रहे हैं. जो स्टैंडर्ड डिवाइस पिकर का इस्तेमाल कर रहे हैं. UX में किए गए ये बदलाव उपयोगकर्ताओं को साफ़ तौर पर यह बताना कि लोकल नेटवर्क के ऐक्सेस की अनुमतियों की ज़रूरत क्यों है, साथ ही, अगर लोकल नेटवर्क डिवाइस का ऐक्सेस पहले से मौजूद है, तो कास्ट करने की सुविधा को कैसे चालू किया जाए बंद किया गया.

v4.4.8 या इससे पहले के वर्शन का इस्तेमाल करके Cast SDK वाले वर्शन के साथ बनाए गए ऐप्लिकेशन चलते रहेंगे तब तक काम करते हैं, जब तक कि वे Xcode 11.7 या इससे पहले के वर्शन के साथ बनाए गए हों. अगर आप अगर आपको iOS 14 और Xcode 12 या इसके बाद के वर्शन के लिए कोई वर्शन बनाना है, तो हमारा सुझाव है कि आप Google Cast SDK टूल v4.6.0 या इसके बाद के वर्शन का इस्तेमाल करें, ताकि यह पक्का किया जा सके कि Cast ऐप्लिकेशन ठीक से काम करता रहेगा.

Cast iOS SDK v4.6.0 या उसके बाद के वर्शन को CocoaPods के साथ डाउनलोड करने के लिए, नीचे दिए गए निर्देशों का पालन करें CocoaPods का सेटअप या मैन्युअल तरीके से मैन्युअल सेटअप के बाद. इस रिलीज़ में में खोज करने के तरीके में बदलाव शामिल हैं, ताकि उन ऐप्लिकेशन को अनुमति दी जा सके को Xcode 12 के साथ बनाया गया है, ताकि नेटवर्क पर कास्ट डिवाइसों को ढूंढा जा सके. कास्ट करें बटन अब हमेशा दिखाएं. अगर उपयोगकर्ता के कास्ट पर टैप करने के दौरान कोई डिवाइस मौजूद नहीं हो इस बटन पर क्लिक करने से, आपको एक डायलॉग बॉक्स दिखेगा. इसमें बताया जाएगा कि उपलब्ध है. इसमें लोकल-नेटवर्क ऐक्सेस को फिर से चालू करने के बारे में जानकारी शामिल है अनुमति.

Cast SDK टूल में किए गए बदलाव

पहली बार कास्ट करने की सुविधा

जब कोई उपयोगकर्ता पहली बार कास्ट करने की कोशिश करता है, तो लोकल नेटवर्क ऐक्सेस (एलएनए) इंटरस्टीशियल डायलॉग दिखेगा. इसमें बताया जाएगा कि लोकल नेटवर्किंग ऐक्सेस iOS के लोकल नेटवर्क के ऐक्सेस की अनुमति Apple से मिली प्रॉम्प्ट. यहां दिए गए मॉक में, फ़्लो को दिखाया गया है:

कास्ट करने की सुविधा उपलब्ध नहीं है

भेजने वाले के लिए iOS SDK टूल 4.6.0 और इसके बाद के वर्शन में, 'कास्ट करें' बटन हमेशा तब दिखता है, जब उपयोगकर्ता वाई-फ़ाई से कनेक्ट है. कास्ट डिवाइस उपलब्ध न होने पर, कास्ट करें बटन पर टैप करने से एक डायलॉग बॉक्स आता है. कास्ट के उपलब्ध न होने की संभावित वजहों के बारे में बताया गया है. यहां कुछ उदाहरण दिए गए हैं:

iOS 14 पर आपका ऐप्लिकेशन अपडेट किया जा रहा है

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

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

   या फिर, SDK टूल को मैन्युअल तौर पर फ़ेच किया जा सकता है.

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

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

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

   appID, आपका रिसीवर आईडी होता है. यह वही आईडी होता है जो आपके 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} लोकल नेटवर्क का इस्तेमाल करके, आपके वाई-फ़ाई पर कास्ट करने की सुविधा वाले डिवाइसों को खोजता है
   नेटवर्क.</string>

   यह मैसेज, iOS लोकल नेटवर्क ऐक्सेस डायलॉग के हिस्से के तौर पर इस तरह दिखेगा मॉक में दिखाया गया है.

   
4. अपने ऐप्लिकेशन को Apple App Store पर फिर से रिलीज़ करना

   हमारा सुझाव है कि आप भी 4.8.3 का इस्तेमाल करके अपना ऐप्लिकेशन इस तरह फिर से रिलीज़ करें जल्द से जल्द.

कस्टमाइज़ेशन

कास्ट डिवाइस खोजने की शुरुआत

डिफ़ॉल्ट रूप से, उपयोगकर्ता के पहली बार टैप करने पर कास्ट डिवाइस को खोजने की सुविधा डिफ़ॉल्ट रूप से शुरू हो जाती है कास्ट करें बटन (GCKUICastButton). अगर उपयोगकर्ता ने पहली बार ऐसा किया है iOS में अपग्रेड करने के बाद लोकल नेटवर्क पर Cast ऐप्लिकेशन का इस्तेमाल करने की कोशिश की 14 नंबर पर, नया LNA इंटरस्टीशियल दिखेगा. इसके बाद, iOS लोकल नेटवर्क दिखेगा ऐक्सेस की अनुमतियों का डायलॉग बॉक्स.

एक नया फ़्लैग उपलब्ध है. इसकी मदद से, यह कंट्रोल किया जा सकता है कि डिवाइस को खोजने की सुविधा कब शुरू होगी और UX की कुछ चीज़ों के व्यवहार में बदलाव ला सकते हैं:

startDiscoveryAfterFirstTapOnCastButton: BOOL(true/false)

डिफ़ॉल्ट वैल्यू true है. यह फ़्लैग सिर्फ़ तब लागू होता है, जब GCKCastOptions::disableDiscoveryAutostart false पर सेट है.

अगर इसे true पर सेट किया जाता है, तो कास्ट डिवाइस को खोजने की सुविधा तब शुरू होती है, जब कोई उपयोगकर्ता पहली बार GCKUICastButton. एक सूचना वाला मैसेज दिखेगा उपयोगकर्ता को दिखाया जाएगा. इसमें बताया जाएगा कि लोकल नेटवर्क की अनुमति क्यों है की ज़रूरत नहीं है. इस मैसेज के बाद, iOS 14 एलएनए मैसेज दिखेगा. मैसेज स्वीकार किए जाने के बाद, कास्ट डिवाइस को खोजने की सुविधा शुरू हो जाती है.

बाद में लॉन्च होने वाले ऐप्लिकेशन में, GCKUICastButton हमेशा दिखता है.

अगर false पर सेट किया जाता है, तो डिवाइस डिस्कवरी, फ़्लैग करें GCKCastOptions::disableDiscoveryAutostart.

अक्सर पूछे जाने वाले सवाल

iOS 13

iOS 13 के साथ, अनुमतियों से जुड़ी नई ज़रूरी शर्तें जोड़ी गईं. इससे Google Cast SDK का इस्तेमाल करने वाले ऐप्लिकेशन.

Google Cast SDK v4.4.3 के बाद से, एक अतिरिक्त SDK टूल उपलब्ध है जो Bluetooth® अनुमति की ज़रूरत नहीं है. यह डेवलपर साइट, दोनों पर उपलब्ध है साइट और नए google-cast-sdk-no-bluetooth कोकोपॉड.

ऐप्लिकेशन का ब्रेकडाउन

फ़िलहाल, आपके इस्तेमाल किए जा रहे iOS SDK टूल के वर्शन के हिसाब से, यहां ब्रेकडाउन दिया गया है इसका इस्तेमाल करके:

iOS 12 SDK टूल या इससे पहले के वर्शन वाले ऐप्लिकेशन

• सुझाई गई कार्रवाई. डिवाइस को खोजने की परफ़ॉर्मेंस में तब कमी आ सकती है, जब जो iOS 13 पर काम करते हैं. हालांकि, वे अब भी काम करेंगे. हमारा सुझाव है कि आप: उपलब्ध होने पर डेवलपर, Cast SDK v4.4.4 पर अपग्रेड कर सकते हैं.
• iOS 13, उपयोगकर्ताओं से इस ऐप्लिकेशन को Bluetooth® की अनुमतियां देने का अनुरोध करेगा.

iOS 13 SDK टूल की मदद से बनाए गए ऐप्लिकेशन

• कार्रवाई ज़रूरी है: कास्ट SDK टूल 4.4.4 में अपडेट करें या 'कास्ट करें' बटन शायद काम न करे यदि उपयोगकर्ता स्थान की अनुमति नहीं देता है, तो प्रदर्शित होती है. Cast SDK पर अपग्रेड किया जा रहा है iOS 13 पर कास्ट करने का भरोसेमंद अनुभव देने के लिए, वर्शन 4.4.4 ज़रूरी है.