नवंबर 2022 में, Android के लिए ARCore SDK टूल (Kotlin/Java) से कैमरा इस्तेमाल करने के तरीकों को हटाना

Google Play Services for AR नवंबर 2022 में, एनडीके कैमरा इमेज और मेटाडेटा से जुड़े काम न करने वाले तरीकों को हटा देगा.

ARCore SDK टूल के जिन वर्शन में इन तरीकों का इस्तेमाल उन पर इन तरीकों का इस्तेमाल हो रहा है, हो सकता है वे अलग तरह से काम करना शुरू कर सकते हैं या जब उपयोगकर्ता 'एआर के लिए Google Play Services' अपडेट करते हैं, तो वे क्रैश हो सकते हैं.

ऐसे ऐप्लिकेशन जिन पर असर पड़ा है

नवंबर 2022 से, जब उपयोगकर्ता Google Play Services for AR को नए वर्शन में अपडेट करेंगे, तो आपका ऐप्लिकेशन काम करना बंद कर सकता है या क्रैश हो सकता है. हालांकि, ऐसा तब होगा, जब:

  1. आपके ऐप्लिकेशन को उस SDK टूल के साथ कंपाइल किया गया था जिस पर असर हुआ है
  2. आपका ऐप्लिकेशन, इनमें से किसी भी ऐसे एपीआई का इस्तेमाल करता है जिस पर असर पड़ा हो:
अगर आपके ऐप्लिकेशन को
ARCore SDK टूल के वर्शन के साथ कंपाइल किया गया था...
साथ ही, उन एपीआई का इस्तेमाल करता है जिन पर असर पड़ा है... नवंबर 2022 से, नुकसान पहुंचाने वाली गतिविधियां
1.19.0 या इससे कम Frame.getImageMetadata() IllegalArgumentException देता है.
1.10.0 या इससे कम Frame.acquireCameraImage() 0x0 साइज़ की इमेज दिखाता है.

जिन ऐप्लिकेशन पर असर हुआ है उन्हें ठीक करना

नवंबर 2022 से, इन ऐप्लिकेशन में रुकावट आ सकती है. इसे कम करने के लिए, सबसे नए ARCore SDK टूल का इस्तेमाल करके अपना ऐप्लिकेशन फिर से बनाएं. आपको कम से कम, ARCore SDK टूल के 1.20.0 या इसके बाद के वर्शन पर अपग्रेड करना होगा.

पुष्टि करें कि जिस ऐप्लिकेशन पर असर हुआ है उसे ठीक कर दिया गया है

नवंबर 2022 में किए गए बदलावों को पहले से सिम्युलेट करके, ऐप्लिकेशन को टेस्ट करें. इसके लिए, अपने ऐप्लिकेशन के AndroidManifest.xml में meta-data की एक खास एंट्री जोड़ें:

  1. पक्का करें कि टारगेट किए गए डिवाइस पर Play Services for AR का 1.29.0 या इसके बाद वाला वर्शन इंस्टॉल किया गया हो.
  2. ऐप्लिकेशन की AndroidManifest.xml फ़ाइल में, मौजूदा <application> एलिमेंट के चाइल्ड के तौर पर नया <meta-data> टैग जोड़ें :

    <application …>
      …
    
      <!--
           Simulate the November 2022 changes in advance.
           IMPORTANT: Remove this tag when testing is completed.
           Do not include this tag in published versions of your app.
      -->
      <meta-data android:name="com.google.ar.core.session_settings"
                 android:value="camera_stack_option,unified_mono" />
    </application>
    
  3. अपने ऐप्लिकेशन की जांच करें और पुष्टि करें कि ARCore की सभी सुविधाएं उम्मीद के मुताबिक काम कर रही हैं या नहीं.

  4. जांच पूरी होने पर, <meta-data> टैग को हटा दें. अपने पब्लिश किए गए ऐप्लिकेशन में इस टैग को जगह पर छोड़ने से, आने वाले समय में गलत व्यवहार हो सकता है.

अगर ऐप्लिकेशन सामान्य तरीके से काम कर रहा है, तो इसका मतलब है कि नवंबर 2022 में किए जाने वाले बदलावों के लिए ऐप्लिकेशन तैयार है.

टाइमलाइन

समयावधि इवेंट
नवंबर 2020
(ARCore SDK टूल का 1.20.0 वर्शन)
नेटिव एपीआई का इस्तेमाल बंद करें.
वैकल्पिक नेटिव एपीआई का इस्तेमाल करने के लिए, लागू करने की प्रक्रिया को अपडेट करें.
नवंबर 2021 नवंबर 2022 में, Google Play Services for एआर से जिन एपीआई पर असर हुआ है उन्हें हटाए जाने की वजह से, आने वाले समय में होने वाले नुकसान के बारे में सूचना दें.
नवंबर 2022 एआर के लिए Google Play Services से उन एपीआई को हटाएं जिन पर असर हुआ है.
ARCore वर्शन का इस्तेमाल करने वाले ऐप्लिकेशन के लिए, 1.20.0 से पहले के नए बदलाव पेश करें.