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" को बदलें आपको ऐप्लिकेशन आईडी से जोड़ना होगा.

    &lt;key&gt;NSBonjourServices&lt;/key&gt;
    &lt;array&gt;
      &lt;string&gt;_googlecast._tcp&lt;/string&gt;
      &lt;string&gt;_ABCD1234._googlecast._tcp&lt;/string&gt;
    &lt;/array&gt;
  3. NSLocalNetworkUsageDescription को अपने Info.plist

    हमारा सुझाव है कि आप अपने ऐप्लिकेशन के Info.plist फ़ाइल NSLocalNetworkUsageDescription का इस्तेमाल, कास्ट के बारे में जानकारी देने के लिए किया जाता है और अन्य डिस्कवरी सेवाएं, जैसे कि DIAL.

    &lt;key&gt;NSLocalNetworkUsageDescription&lt;/key&gt;
    <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.

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

अगर मैं अपने कॉन्टेंट को फिर से रिलीज़ करूं, तो क्या होगा क्या Cast SDK v4.4.8 और Xcode 12 के साथ सेंडर ऐप्लिकेशन कास्ट करना है?

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

अगर मैं अपने ऐप्लिकेशन को नए Cast SDK के साथ फिर से रिलीज़ करूं, तो क्या क्या मेरे उपयोगकर्ता iOS 13 या इससे पहले के वर्शन पर काम कर रहे हैं?

हालांकि, उन्हें पहले की तरह ही उपयोगकर्ता अनुभव मिलेगा फिर से रिलीज़ करने के लिए कहा जाता है. उपयोगकर्ताओं को दिखाई देने वाले बदलाव सिर्फ़ उपयोगकर्ताओं तक ही सीमित हैं जो iOS 14 पर चल रहे हैं.

नया अपडेट आने पर मुझे अपने ऐप्लिकेशन को अपडेट करने के लिए क्या करना होगा Cast SDK का वर्शन रिलीज़ कर दिया गया है?

  • लोकल नेटवर्क शामिल करने के लिए, अपने ऐप्लिकेशन के Info.plist को अपडेट करें इस्तेमाल के बारे में जानकारी.
  • NSBonjourServices को अपने ऐप्लिकेशन में जोड़ें Info.plist और कास्ट के लिए बोनस सेवा का नाम दें और आपका ऐप्लिकेशन आईडी शामिल कर सकते हैं.
  • Cast SDK 4.6.0 का इस्तेमाल करने के लिए, भेजने वाले ऐप्लिकेशन को अपग्रेड करें.
  • अपने ऐप्लिकेशन को Apple ऐप स्टोर पर फिर से रिलीज़ करें.

मेरे कस्टम डिवाइस पर डिवाइस दिखना बंद क्यों हो गए 4.6.0 में अपग्रेड करने के बाद चुनूं?

यह एक जानी-पहचानी समस्या है. यह समस्या, कस्टम डिवाइस का इस्तेमाल करने पर हो सकती है पिकर इस्तेमाल करने की सुविधा मिलती है. 4.4.8 वर्शन में Cast SDK टूल और इससे पहले के वर्शन में, डिवाइस को अपने-आप स्कैन करने की सुविधा काम करती थी. वर्शन में शुरुआत 4.6.0 के साथ, आपको साफ़ तौर पर startDiscovery को कॉल करना होगा का तरीका डिवाइस खोज शुरू करने के लिए GCKDiscoveryManager क्लास.

यह बदलाव, लोकल नेटवर्क ऐक्सेस (एलएनए) की वजह से हुआ है ऐप्लिकेशन के पहली बार स्कैन करने के बाद, अनुमतियों का अनुरोध दिखेगा समय. इसकी वजह से, अलग-अलग जगहों पर अनुमतियों वाले डायलॉग दिख सकते हैं आपके ऐप्लिकेशन में.

अपने ऐप्लिकेशन के लिए कस्टम डिवाइस पिकर बनाने वाले डेवलपर को डिवाइस को चालू करने से पहले, पेज पर अचानक दिखने वाला एक विज्ञापन दिखना चाहिए iOS 14 पर पहली बार स्कैन किया जा रहा है.

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 ज़रूरी है.