किसी Android ऐप्लिकेशन या ब्राउज़र से एआर में इंटरैक्टिव 3D मॉडल दिखाने के लिए, सीन व्यूअर का इस्तेमाल करना

सीन व्यूअर एक ध्यान खींचने वाला व्यूअर है, जो आपकी वेबसाइट या Android ऐप्लिकेशन से 3D और एआर (ऑगमेंटेड रिएलिटी) का अनुभव देता है. इसकी मदद से, Android मोबाइल डिवाइस इस्तेमाल करने वाले लोग, वेब पर होस्ट किए गए 3D मॉडल की झलक आसानी से देख सकते हैं, उन्हें सही जगह पर लगा सकते हैं, देख सकते हैं, और उनके साथ इंटरैक्ट कर सकते हैं.

ज़्यादातर Android ब्राउज़र पर, सीन व्यूअर की सुविधा काम करती है. सीन व्यूअर को कई Google पार्टनर ने लागू किया है, ताकि 3D और एआर (ऑगमेंटेड रिएलिटी) का इस्तेमाल, भरोसेमंद तरीके से किया जा सके. यह Google Search के लिए भी इन अनुभवों को बेहतर बनाता है.

लागू करना आसान है:

  • वेब पर आधारित सुविधाओं के लिए, वेब पेज पर सही तरीके से फ़ॉर्मैट किए गए लिंक की ज़रूरत होती है.

  • ऐप्लिकेशन आधारित अनुभवों के लिए Java कोड की कुछ ही लाइनों को शामिल करना ज़रूरी है.

सीन व्यूअर रनटाइम की ज़रूरी शर्तें

सीन व्यूअर के साथ एआर (ऑगमेंटेड रिएलिटी) का इस्तेमाल करने के लिए, उपयोगकर्ताओं के पास:

  • Android 7.0 Nougat (एपीआई लेवल 24) या इसके बाद के वर्शन पर चलने वाला ARCore काम करने वाला डिवाइस.
  • Google Play Services for AR का अप-टू-डेट (हाल ही का) वर्शन. यह सेवा अपने-आप इंस्टॉल होती है और ARCore के साथ काम करने वाले ज़्यादातर डिवाइसों पर अप-टू-डेट रखी जाती है.
  • यह Google ऐप्लिकेशन का अप-टू-डेट वर्शन है. यह ऐप्लिकेशन पहले से इंस्टॉल होता है. साथ ही, यह कई ऐसे डिवाइसों पर अपने-आप अप-टू-डेट रहता है जिन पर ARCore काम करता है.

ऐसे मामलों में, जब एआर के लिए Google Play services या Google app मौजूद न हों या इंस्टॉल किए गए वर्शन बहुत पुराने हों, तो ऐसे मामलों में फ़ॉलबैक यूआरएल तय किया जा सकता है जो वैकल्पिक अनुभव लॉन्च करता हो. उदाहरण के लिए, वेब पेज, गड़बड़ी वाला मैसेज या आपके बनाए हुए फ़ॉलबैक अनुभव.

इस्तेमाल के उदाहरण

इस्तेमाल का मकसद सुझाया गया ऐप्लिकेशन फ़ायदे
किसी वेबसाइट या Android ऐप्लिकेशन पर दिए गए बटन या लिंक से, किसी 3D मॉडल का नेटिव एआर व्यू लॉन्च करें.

अगर डिवाइस पर Google Play Services for AR मौजूद नहीं है, तो मॉडल को सीन व्यूअर के ज़रिए चलाए जाने वाले 3D मोड में दिखाने के लिए, आराम से बैठें.
Google Search पैकेज के लिए किसी खास इंटेंट का इस्तेमाल करके सीन व्यूअर लॉन्च करें. साथ ही, 3D मॉडल दिखाने के लिए सही mode सेटिंग चुनें.
  • ar_preferred: यह सुविधा हमेशा एआर व्यूअर में शुरू होती है और उपयोगकर्ता मैन्युअल तरीके से 3D व्यूअर पर स्विच कर सकते हैं. अगर Google Play Services for AR मौजूद नहीं है, तो 3D व्यूअर में अच्छी तरह से चालू हो जाता है.
  • 3d_preferred: इसकी शुरुआत हमेशा 3D व्यूअर में होती है. इसे इस्तेमाल करने वाले लोग, मैन्युअल तरीके से एआर व्यूअर पर स्विच कर सकते हैं. Google Play Services for AR मौजूद न होने पर, उपयोगकर्ता 3D व्यूअर से स्विच नहीं कर सकते.
  • 3d_only: यह हमेशा सिर्फ़ 3D व्यूअर में दिखता है. इसमें, उपयोगकर्ता एआर व्यूअर पर स्विच नहीं कर सकते.
  • ज़्यादा से ज़्यादा डिवाइसों पर काम करें.
  • बिना एआर (ऑगमेंटेड रिएलिटी) के इस्तेमाल के मामलों में, सीन व्यूअर के 3D मोड में अपने-आप वापस आ जाता है.
किसी वेबसाइट या Android ऐप्लिकेशन पर मौजूद बटन या लिंक से, किसी 3D मॉडल का नेटिव एआर व्यू लॉन्च करें.

अगर डिवाइस पर Google Play Services for AR मौजूद नहीं है, तो फ़ॉलबैक के काम करने के तरीके को कंट्रोल करें.
Google Play Services for AR (ARCore) के साफ़ इंटेंट का इस्तेमाल करके सीन व्यूअर लॉन्च करें. साथ ही, 3D मॉडल दिखाने के लिए, सही mode सेटिंग चुनें.
  • ar_preferred: यह सुविधा हमेशा एआर व्यूअर में शुरू होती है. साथ ही, लोग मैन्युअल तरीके से 3D व्यूअर पर स्विच कर सकते हैं. अगर 'एआर के लिए Google Play Services' मौजूद नहीं है, तो सीन व्यूअर आपकी कॉन्फ़िगर की जाने वाली कार्रवाई में वापस आ जाता है.
  • ar_only: यह हमेशा सिर्फ़ एआर व्यूअर में दिखता है. इसमें 3D व्यूअर नहीं दिखाया जा सकता. अगर Google Play Services for AR मौजूद नहीं है, तो वह उसी तरीके से काम करेगा जिसे आपने कॉन्फ़िगर किया है. उदाहरण के लिए, खुद का फ़ुल-स्क्रीन 3D अनुभव लॉन्च किया जा सकता है या एक गड़बड़ी का मैसेज दिखाया जा सकता है. इससे पता चलेगा कि उपयोगकर्ता के डिवाइस पर फ़िलहाल एआर की सुविधा काम नहीं करती.
अपने खुद के 3D मॉडल व्यूअर का इस्तेमाल करें या बिना एआर (ऑगमेंटेड रिएलिटी) इस्तेमाल के उदाहरणों के लिए, अपने डिज़ाइन का दूसरा फ़ॉलबैक रिस्पॉन्स दें.
अपनी वेबसाइट पर 3D मॉडल का इनलाइन व्यू होस्ट करें और उपयोगकर्ता को मैन्युअल रूप से फ़ुल-स्क्रीन नेटिव एआर मोड में जाने की अनुमति दें. किसी सीन व्यूअर को मूल रूप से एआर (ऑगमेंटेड रिएलिटी) में 3D मॉडल दिखाने के लिए, <model-viewer> या वेब पर आधारित किसी दूसरे 3D व्यूअर का इस्तेमाल करें.
  • किसी वेब पेज में एम्बेड किए गए 3D मॉडल से, सीधे एआर (ऑगमेंटेड रिएलिटी) में सीन व्यूअर लॉन्च करें.
  • उपयोगकर्ताओं को उस प्लैटफ़ॉर्म पर 3D अनुभव उपलब्ध कराएं जिस पर आपका मालिकाना हक है और जिन पर आपका कंट्रोल है. आपके पास यह विकल्प होगा कि आप उपयोगकर्ताओं को धीरे-धीरे, ऐसा एआर (ऑगमेंटेड रिएलिटी) का बेहतर अनुभव दे सकें जो उनके मकसद का हो.

किसी अश्लील इंटेंट (3D या एआर) का इस्तेमाल करके सीन व्यूअर लॉन्च करें

ज़्यादातर Android डिवाइसों पर काम करने के लिए, सीन व्यूअर को लॉन्च करने के लिए, साफ़ तौर पर Android के इंटेंट का इस्तेमाल करें. एक्सप्लिसिट इंटेंट को किसी एचटीएमएल पेज या किसी खास Android ऐप्लिकेशन से ट्रिगर किया जा सकता है. इस इंटेंट को Google ऐप्लिकेशन से मैनेज किया जाएगा, जो ARCore के साथ काम करने वाले Android डिवाइसों पर पहले से इंस्टॉल होता है.

कॉन्फ़िगर किए गए इंटेंट पैरामीटर और डिवाइस की क्षमताओं के आधार पर, इंटरैक्टिव 3D मॉडल को उपयोगकर्ता के माहौल में रखा जा सकता है या 3D व्यूअर में दिखाया जा सकता है.

  • अगर डिवाइस पर Google Play Services for AR मौजूद है और वह अप-टू-डेट है, तो सीन व्यूअर, मॉडल को एआर के नेटिव व्यू या 3D व्यू में दिखाएगा.

  • अगर Google Play Services for AR मौजूद नहीं है या वह अप-टू-डेट नहीं है, तो सीन व्यूअर अच्छी तरह से 3D व्यू में मॉडल को दिखाने लगता है.

  • अगर कोई 3D मॉडल नहीं दिखाया जा सकता, जैसे कि Google ऐप्लिकेशन इंस्टॉल न होने या पुराना वर्शन होने पर, S.browser_fallback_url पैरामीटर का इस्तेमाल फ़ॉलबैक वेब पेज को दिखाने के लिए किया जाएगा.

एचटीएमएल या Java से सीन व्यूअर लॉन्च करें

एचटीएमएल

एचटीएमएल से एक्सप्लिसिट इंटेंट को ट्रिगर करने के लिए, नीचे दिए गए सिंटैक्स का इस्तेमाल करें:

<a href="intent://arvr.google.com/scene-viewer/1.0?file=https://raw.githubusercontent.com/KhronosGroup/glTF-Sample-Models/master/2.0/Avocado/glTF/Avocado.gltf#Intent;scheme=https;package=com.google.android.googlequicksearchbox;action=android.intent.action.VIEW;S.browser_fallback_url=https://developers.google.com/ar;end;">Avocado</a>

Java

Java से एक्सप्लिसिट इंटेंट ट्रिगर करने के लिए, इस कोड का इस्तेमाल करें:

Intent sceneViewerIntent = new Intent(Intent.ACTION_VIEW);
sceneViewerIntent.setData(Uri.parse("https://arvr.google.com/scene-viewer/1.0?file=https://raw.githubusercontent.com/KhronosGroup/glTF-Sample-Models/master/2.0/Avocado/glTF/Avocado.gltf"));
sceneViewerIntent.setPackage("com.google.android.googlequicksearchbox");
startActivity(sceneViewerIntent);

इंटेंट वर्शनिंग

इंटेंट वर्शन को, arvr.google.com/scene-viewer के बाद के वर्शन नंबर से दिखाया जाता है. उदाहरण के लिए, शुरुआती रिलीज़ में वर्शन 1.0 का इस्तेमाल किया गया था. जब सीन व्यूअर की नई सुविधाओं की ज़रूरत हो, तो सीन व्यूअर को हाई इंटेंट वर्शन में लॉन्च किया जा सकता है. इसके लिए, ज़रूरी सुविधाओं का इस्तेमाल किया जा सकता है.

इंटेंट वर्शन 1.1 में, intent:// लिंक के साथ काम करने की सुविधा जोड़ी गई. ये लिंक, यूआरएल के बजाय सीधे Android ऐप्लिकेशन में लॉन्च किए जा सकते हैं. अगर आपको यह पक्का करना है कि सीन व्यूअर, लॉन्च होने पर इस सुविधा के उपलब्ध होने की गारंटी दे और किसी अन्य तरीके से लॉन्च न कर सके, तो intent://arvr.google.com/scene-viewer/1.1 के मकसद से सीन व्यूअर लॉन्च करें.

इस्तेमाल किए जा सकने वाले इंटेंट पैरामीटर

नीचे दिए पैरामीटर, Google Search पैकेज के लिए एक्सप्लिसिट इंटेंट के लिए काम करते हैं.

इंटेंट पैरामीटर अनुमति वाली वैल्यू टिप्पणियां
file (ज़रूरी) मान्य यूआरएल यह यूआरएल उस glTF या glb फ़ाइल के बारे में बताता है जिसे Story Viewer में लोड किया जाना चाहिए. यूआरएल-एस्केप्ड होना चाहिए.
S.browser_fallback_url (एचटीएमएल-आधारित इंटेंट के लिए ज़रूरी है) मान्य यूआरएल यह Google Chrome की एक सुविधा है, जो सिर्फ़ वेब पर काम करने के लिए काम करती है. जब डिवाइस पर Google app मौजूद नहीं होता, तो Google Chrome इस यूआरएल पर जाता है.
mode (ज़रूरी नहीं) 3d_preferred (डिफ़ॉल्ट) सीन व्यूअर, मॉडल को 3D मोड में आपके स्पेस में देखें बटन से दिखाता है.



अगर डिवाइस पर Google Play Services for AR मौजूद नहीं है, तो अपने स्पेस में देखें बटन नहीं दिखेगा.

3d_only सीन व्यूअर को 3D मोड में दिखाए गए मॉडल के साथ लॉन्च किया जाता है. भले ही, डिवाइस पर Google Play Services for AR मौजूद हो. आपके स्पेस में देखें बटन कभी नहीं दिखाया जाता.

ar_preferred सीन व्यूअर, एआर नेटिव मोड में एंट्री मोड के तौर पर लॉन्च होता है. 3D में देखें और अपने स्पेस में देखें बटन की मदद से, उपयोगकर्ता को एआर और 3D मोड के बीच स्विच करने का विकल्प दिया जाता है.



अगर 'Google Play Services for AR' मौजूद नहीं है, तो सीन व्यूअर अच्छी तरह एंट्री मोड के तौर पर 3D मोड में वापस चला जाता है.

ar_only इस वैल्यू का इस्तेमाल करते समय, आपको अश्लील Android इंटेंट से com.google.ar.core पर लॉन्च करना चाहिए.

ध्यान दें: Google app पर अश्लील Android इंटेंट से लॉन्च करते समय, ar_only मोड का इस्तेमाल न करें.

link (ज़रूरी नहीं) मान्य यूआरएल किसी बाहरी वेबपेज का यूआरएल. अगर यह मौजूद होगा, तो यूज़र इंटरफ़ेस (यूआई) में एक बटन दिखेगा. इस बटन पर क्लिक करने से, उपयोगकर्ता इस यूआरएल पर ले जाएगा.

title (ज़रूरी नहीं) मान्य स्ट्रिंग मॉडल का नाम. अगर यह मौजूद होता है, तो यह यूज़र इंटरफ़ेस (यूआई) में दिखेगा. नाम को 60 वर्णों के बाद एलिप्सिस से छोटा कर दिया जाएगा.

आवाज़ (ज़रूरी नहीं) मान्य यूआरएल लूप वाले ऑडियो ट्रैक का यूआरएल, जो glTF फ़ाइल में एम्बेड किए गए पहले ऐनिमेशन के साथ सिंक होता है. इसे glTF के साथ-साथ मिलते-जुलते लंबाई वाले ऐनिमेशन के साथ दिया जाना चाहिए. अगर यह मौजूद है, तो मॉडल लोड होने के बाद आवाज़ को लूप में चलाया जाता है. यूआरएल-एस्केप्ड होना चाहिए.
resizable (ज़रूरी नहीं) true (डिफ़ॉल्ट)

false

अगर इस नीति को false पर सेट किया जाता है, तो उपयोगकर्ता एआर (ऑगमेंटेड रिएलिटी) अनुभव में इस मॉडल को स्केल नहीं कर पाएंगे. स्केलिंग, 3D अनुभव में सामान्य रूप से काम करती है.
enable_vertical_placement (ज़रूरी नहीं) false (डिफ़ॉल्ट)

true

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

UX के लिए दिशा-निर्देश

हमारा सुझाव है कि उपयोगकर्ताओं को बेहतरीन UX देने के लिए, स्क्रीन पर दिख रहे कॉल-टू-ऐक्शन से यह पता चलना चाहिए कि उपयोगकर्ता, इमर्सिव मोड में जाने ही वाला है.

3D व्यूअर अनुभव के लिए, हम 3D में देखें लेबल वाले ऐसे कॉल-टू-ऐक्शन का सुझाव देते हैं जो नीचे दी गई इमेज में से किसी एक के जैसा दिखता हो:

Google Play Services for AR (सिर्फ़ एआर मोड) में किसी खास इंटेंट से सीन व्यूअर लॉन्च करें

सीन व्यूअर में एआर मोड, Google Play Services for AR की मदद से काम करता है.

यह पक्का करने के लिए कि एआर (ऑगमेंटेड रिएलिटी) को सीन व्यूअर में उपलब्ध कराया जा सकता है, किसी वेबसाइट या Android के खास ऐप्लिकेशन से साफ़ तौर पर बताए गए Android इंटेंट का इस्तेमाल किया जा सकता है. ऐसा com.google.ar.core package के ज़रिए सीन व्यूअर को लॉन्च करने के लिए किया जा सकता है और browser_fallback_url दिया जा सकता है. इस तरह, आप यह पक्का कर सकते हैं कि सभी उपयोगकर्ताओं को या तो सीन व्यूअर से मूल एआर (ऑगमेंटेड रिएलिटी) का अनुभव मिले या ऐसा फ़ॉलबैक अनुभव जो आपने खुद बनाया है. उदाहरण के लिए, खुद का 3D व्यूअर या सुंदर गड़बड़ी का मैसेज जैसे फ़ॉलबैक अनुभव बनाए जा सकते हैं.

एचटीएमएल से एक्सप्लिसिट इंटेंट को ट्रिगर करने के लिए, नीचे दिए गए सिंटैक्स का इस्तेमाल करें:

<a href="intent://arvr.google.com/scene-viewer/1.0?file=https://raw.githubusercontent.com/KhronosGroup/glTF-Sample-Models/master/2.0/Avocado/glTF/Avocado.gltf&mode=ar_only#Intent;scheme=https;package=com.google.ar.core;action=android.intent.action.VIEW;S.browser_fallback_url=https://developers.google.com/ar;end;">Avocado</a>;

Java से एक्सप्लिसिट इंटेंट ट्रिगर करने के लिए, इस कोड का इस्तेमाल करें:

Intent sceneViewerIntent = new Intent(Intent.ACTION_VIEW);
Uri intentUri =
    Uri.parse("https://arvr.google.com/scene-viewer/1.0").buildUpon()
    .appendQueryParameter("file", "https://raw.githubusercontent.com/KhronosGroup/glTF-Sample-Models/master/2.0/Avocado/glTF/Avocado.gltf")
    .appendQueryParameter("mode", "ar_only")
    .build();
sceneViewerIntent.setData(intentUri);
sceneViewerIntent.setPackage("com.google.ar.core");
startActivity(sceneViewerIntent);

इस्तेमाल किए जा सकने वाले इंटेंट पैरामीटर

नीचे दिए गए पैरामीटर, Google Play services for AR पैकेज के खास इंटेंट के लिए काम करते हैं.

इंटेंट पैरामीटर अनुमति वाली वैल्यू टिप्पणियां
browser_fallback_url (एचटीएमएल-आधारित इंटेंट के लिए ज़रूरी है) मान्य यूआरएल इसका इस्तेमाल सिर्फ़ वेब पर आधारित टूल को लागू करने के लिए किया जाता है. अगर डिवाइस पर Google Play Services for AR मौजूद नहीं है या अप-टू-डेट नहीं है, तो इस यूआरएल पर नेविगेट किया जाता है.
mode (ज़रूरी नहीं) ar_only सीन व्यूअर हमेशा 3D मॉडल को नेटिव एआर व्यू में लॉन्च करता है और सीन व्यूअर 3D व्यूअर पर स्विच करने के लिए, किसी भी यूज़र इंटरफ़ेस (यूआई) को छिपा देता है.

अगर Google Play Services for AR मौजूद नहीं है, तो सीन व्यूअर उस यूआरएल को लॉन्च करता है जिसे आपने browser_fallback_url में सेट किया है. ऐसा, वेब पर आधारित अनुभव देने के लिए किया जाता है. ऐप्लिकेशन के हिसाब से बनाए गए अनुभवों के लिए, सीन व्यूअर किसी दूसरे अनुभव पर वापस जाता है. जैसे, गड़बड़ी का मैसेज या ऐसा कोई दूसरा अनुभव जिसे आपने खुद बनाया हो.

ar_preferred सीन व्यूअर, एआर (ऑगमेंटेड रिएलिटी) मोड में एंट्री मोड के तौर पर लॉन्च होता है. यह उपयोगकर्ताओं को अपनी जगह में देखें और 3D में देखें बटन की मदद से एआर और 3D मोड के बीच स्विच करने का विकल्प देता है.

अगर Google Play Services for AR मौजूद नहीं है, तो सीन व्यूअर उस यूआरएल को लॉन्च करता है जिसे आपने browser_fallback_url में सेट किया है. ऐसा, वेब पर आधारित अनुभव देने के लिए किया जाता है. ऐप्लिकेशन के हिसाब से बनाए गए अनुभवों के लिए, सीन व्यूअर किसी दूसरे अनुभव पर वापस जाता है. जैसे, गड़बड़ी का मैसेज या ऐसा कोई दूसरा अनुभव जिसे आपने खुद बनाया हो.

   

link (ज़रूरी नहीं) मान्य यूआरएल किसी बाहरी वेबपेज का यूआरएल. अगर यह मौजूद होगा, तो यूज़र इंटरफ़ेस (यूआई) में एक बटन दिखेगा. इस बटन पर क्लिक करने से, उपयोगकर्ता इस यूआरएल पर ले जाएगा.



वर्शन 1.1 में, सीन व्यूअर में इंटेंट:// लिंक के लिए सहायता जोड़ी गई, ताकि सीन व्यूअर के विज़िट करने वाले बटन को सीधे दूसरे ऐप्लिकेशन में ट्रिगर किया जा सके. ध्यान दें कि इसका इस्तेमाल सावधानी के साथ किया जाना चाहिए और इसे सिर्फ़ तब तय किया जाना चाहिए, जब किसी इंटेंट हैंडलर के मौजूद होने की गारंटी हो.
title (ज़रूरी नहीं) मान्य स्ट्रिंग मॉडल का नाम. अगर यह मौजूद होता है, तो यह यूज़र इंटरफ़ेस (यूआई) में दिखेगा. नाम को 60 वर्णों के बाद एलिप्सिस से छोटा कर दिया जाएगा.



वर्शन 1.1 में, टाइटल के कॉन्टेंट की एचटीएमएल स्टाइलिंग के लिए सहायता जोड़ी गई. इसमें अपने हिसाब से टेक्स्ट की अनुमति दी गई. ध्यान दें कि टाइटल यूआरएल-एस्केप्ड होना चाहिए.
sound (ज़रूरी नहीं) मान्य यूआरएल लूप वाले ऑडियो ट्रैक का यूआरएल, जिसे glTF फ़ाइल में एम्बेड किए गए पहले ऐनिमेशन के साथ सिंक किया जाता है.. इसे glTF के साथ-साथ मेल खाने वाली लंबाई वाले ऐनिमेशन के साथ दिया जाना चाहिए. अगर यह मौजूद है, तो मॉडल लोड होने के बाद आवाज़ को लूप में चलाया जाता है.
resizable (ज़रूरी नहीं) true (डिफ़ॉल्ट)

false

अगर इस नीति को false पर सेट किया जाता है, तो उपयोगकर्ता एआर (ऑगमेंटेड रिएलिटी) अनुभव में इस मॉडल को स्केल नहीं कर पाएंगे. स्केलिंग, 3D अनुभव में सामान्य रूप से काम करती है.
disable_occlusion (ज़रूरी नहीं) false (डिफ़ॉल्ट)

true

अगर नीति को true पर सेट किया जाता है, तो सीन में मौजूद ऑब्जेक्ट, हमेशा असल दुनिया में मौजूद ऑब्जेक्ट के सामने दिखते हैं. ज़्यादा जानकारी के लिए, [सुधार की सुविधा चालू करें](/ar/develop/depth#enable_oclusion) देखें.

UX के लिए दिशा-निर्देश

हमारा सुझाव है कि लोगों को बेहतरीन UX देने के लिए, इन दिशा-निर्देशों का पालन करें.

  • एआर अनुभवों के लिए, कॉल-टू-ऐक्शन से पता चलना चाहिए कि उपयोगकर्ता इमर्सिव मोड में जाने वाला है. हमारा सुझाव है कि आप अपने स्पेस में देखें कॉल-टू-ऐक्शन का इस्तेमाल करें:

  • ऐसा हो सकता है कि उपयोगकर्ताओं के डिवाइस पर Google Play Services for AR इंस्टॉल न हों. यहां बताया गया है कि <model-viewer>, फ़ॉलबैक को कैसे हैंडल करता है. साथ ही, शुरुआत में कोड के उस हिस्से का इस्तेमाल किया जा सकता है.

    // Check whether this is an Android device.
    const isAndroid = /android/i.test(navigator.userAgent);
    // This fallback URL is used if the Google app is not installed and up to date.
    const fallbackUrl = 'https://arvr.google.com/scene-viewer?file=https%3A%2F%2Fstorage.googleapis.com%2Far-answers-in-search-models%2Fstatic%2FTiger%2Fmodel.glb&link=https%3A%2F%2Fgoogle.com&title=Tiger';
    
    // This intent URL triggers Scene Viewer on Android and falls back to
    // fallbackUrl if the Google app is not installed and up to date.
    const sceneViewerUrl = 'intent://arvr.google.com/scene-viewer/1.0?file=https://storage.googleapis.com/ar-answers-in-search-models/static/Tiger/model.glb&title=Tiger#Intent;scheme=https;package=com.google.android.googlequicksearchbox;action=android.intent.action.VIEW;S.browser_fallback_url=' +
        fallbackUrl + ';end;';
    
    // Create a link.
    var a = document.createElement('a');
    a.appendChild(document.createTextNode('Tiger'));
    // Set the href to the intent URL on Android and the fallback URL
    // everywhere else.
    a.href = isAndroid ? sceneViewerUrl : fallbackUrl;
    // Add the link to the page.
    document.body.appendChild(a);
    

सीन व्यूअर लॉन्च करने के लिए, <model-viewer> का इस्तेमाल किया जा रहा है

आपके पास अपनी वेबसाइट से, सीन व्यूअर को चालू करने का विकल्प होता है. ऐसा करने के लिए, <model-viewer> वेब कॉम्पोनेंट को ar एट्रिब्यूट के साथ शामिल करें.

<model-viewer ar
              ar-modes="scene-viewer webxr quick-look"
              alt="A 3D model of an astronaut."
              src="Astronaut.gltf"></model-viewer>

ARCore के साथ काम करने वाले Android डिवाइस पर देखे जाने पर, ar एट्रिब्यूट के साथ <model-viewer> कॉम्पोनेंट वाली वेबसाइट पर एक बटन दिखता है, जैसा कि इस उदाहरण में दिखाया गया है.

जब ar-modes में scene-viewer मोड इस्तेमाल किया जाता है, तो यह नेटिव एआर व्यू पर स्विच हो जाता है और उपयोगकर्ता को सीन व्यूअर का इस्तेमाल करके, मॉडल को अपने एनवायरमेंट में रखने के लिए न्योता देता है.

अगर Google Play Services with एआर मौजूद नहीं है, तो इस बटन पर टैप करने से <model-viewer> के 3D व्यूअर में मॉडल दिखता है.

<model-viewer> का इस्तेमाल शुरू करने के बारे में ज़्यादा जानकारी के लिए, <model-viewer> का दस्तावेज़ देखें.

मॉडल के लिए फ़ाइल की ज़रूरतें

सीन व्यूअर के पास मॉडल के लिए, यहां दी गई सुविधाएं और सीमाएं हैं.

फ़ाइल फ़ॉर्मैट के लिए सहायता glTF 2.0/glb, इन एक्सटेंशन का इस्तेमाल करके:
  • KHR_materials_unlit
  • KHR_texture_transform
ऐनिमेशन
  • लगातार लूप में चलने वाला कंकाल ऐनिमेशन
  • लूप में चलने वाला जटिल ऐनिमेशन
  • लूप में चलने वाले रूपांतरण का ऐनिमेशन
ऐनिमेशन लूप में चलाया जाएगा. अगर glTF फ़ाइल में एक से ज़्यादा ऐनिमेशन हैं, तो सीन व्यूअर सिर्फ़ पहला ऐनिमेशन चलाता है.
सुझाई गई सीमाएं एसेट की पूरी परफ़ॉर्मेंस, कंस्ट्रेंट को सेट करने और वर्टेक्स, मटीरियल, टेक्सचर रिज़ॉल्यूशन, हर मटीरियल में मेश वगैरह के बीच संतुलन बनाने पर निर्भर करती है. अपनी एसेट ऑप्टिमाइज़ करने के लिए, नीचे दिए गए दिशा-निर्देशों का पालन करें.
  • ट्रायएंगल की संख्या: हमारा सुझाव है कि ज़्यादा से ज़्यादा 1,00,000 ट्रायएंगल रखें. हालांकि, सबसे कम संख्या को टारगेट करने से, सीन व्यूअर में बेहतर परफ़ॉर्मेंस बनी रहेगी. 30,000 से 50,000 की रेंज सही है.
  • सामग्री की संख्या: हमारा सुझाव है कि आप 10 सामग्री का इस्तेमाल करें. इनमें से दो सामग्री ऐल्फ़ा हो सकती हैं. एसेट की परफ़ॉर्मेंस बेहतर बनाने के लिए, सबसे कम संख्या को टारगेट करें.
  • मेश प्रति सामग्री: 1
  • ज़्यादा से ज़्यादा टेक्सचर रिज़ॉल्यूशन: 2048 × 2048
  • बोन (नॉन-वेटेड जॉइंट के साथ): 254 (कठोर सीमा)
  • हर वर्टेक्स सीमा के लिए हड्डी का वज़न: 4 (हार्ड सीमा)
  • यूवी: 1 यूवी प्रति मेश (कठोर सीमा)
  • मॉडल का साइज़: 10 एमबी (बड़े मॉडल की वजह से उपयोगकर्ता का अनुभव खराब हो सकता है.)
शैडो सपोर्ट किसी ऑब्जेक्ट को चिपकाने के दौरान, सीन व्यूअर की मदद से हार्ड शैडो अपने-आप रेंडर हो जाती हैं. इसलिए, हमारा सुझाव है कि आप अपने मॉडल में मौजूद शैडो को बेक न करें.
टेक्स्चर के लिए सहायता
  • PNG फ़ॉर्मैट: PNG-24, इंडेक्स किया गया PNG-8.
    अगर कोई इमेज पारदर्शी नहीं है, तो JPG का इस्तेमाल करना बेहतर होता है, क्योंकि इससे साइज़ कम हो जाता है.
  • कलर स्पेस: स्टैंडर्ड आरजीबी
सामग्री पीबीआर
फ़ाइल लोड हो रही है एचटीटीपीएस
सीन
  • ऐक्सिस: दाएं हाथ के साथ, इन प्रॉपर्टी में दिखाया जाता है:
    • +X सही है
    • +Y ऊपर है
    • -Z, ऑरिजिन से आगे की ओर दिखाता है (दूसरे शब्दों में, किसी ऐसेट के "आगे का हिस्सा" की ओर +Z होना चाहिए)
  • स्केल: 1 यूनिट = 1 मीटर (जैसा कि glTF स्पेसिफ़िकेशन में बताया गया है, ताकि यह पक्का किया जा सके कि मॉडल को सही स्केल पर एआर में रखा गया है)

अपने 3D मॉडल की पुष्टि करने के लिए, प्रीव्यू टूल का इस्तेमाल करना

सीन व्यूअर में 3D मॉडल फ़ाइल सही तरीके से दिखे, यह पक्का करने के लिए हमारे ऑनलाइन झलक दिखाने वाले टूल का इस्तेमाल करके, अपने पीसी पर मौजूद फ़ाइलों की पुष्टि करें.

आपके 3D मॉडल की पुष्टि करना

मॉडल की पुष्टि करने के लिए, झलक देखने वाले टूल को एक glb या glTF फ़ाइल, इससे जुड़ी कोई इमेज या बिन फ़ाइल, और एक वैकल्पिक ऑडियो फ़ाइल की ज़रूरत होती है. ऑडियो फ़ाइल ऐनिमेशन 0 के साथ लूप होगी.

अलग-अलग फ़ाइलों को एक से ज़्यादा बार चुना जा सकता है. आप चाहें, तो glb या glTF और उससे जुड़ी फ़ाइलों को zip फ़ाइल में डाल सकते हैं. (zip फ़ाइल में ऑडियो फ़ाइलें काम नहीं करतीं.)

अपने 3D मॉडल की पुष्टि करने के लिए:

  1. किसी ब्राउज़र में ऑनलाइन झलक दिखाने वाला टूल खोलें.

  2. झलक देखने वाले टूल में फ़ाइलें जोड़ने के लिए, इनमें से कोई एक तरीका अपनाएं:

    • खींचें और छोड़ें. कोई glb या glTF फ़ाइल और उससे जुड़ी सभी फ़ाइलें (या ऐसी zip फ़ाइल चुनें जिसमें ये फ़ाइलें हों) चुनें. इसके बाद, चुनी गई फ़ाइलों या zip फ़ाइल को प्रीव्यू टूल में खींचें और छोड़ें.

    • झलक दिखाने वाले टूल से. झलक देखने वाले टूल में, सीन व्यूअर > फ़ाइल लोड करें चुनें. कोई glb या glTF फ़ाइल और उससे जुड़ी सभी फ़ाइलें चुनें (या ऐसी zip फ़ाइल जिसमें ये फ़ाइलें हों) और खोलें पर क्लिक करें.

प्रीव्यू करने वाले टूल में आपके 3D मॉडल वाली फ़ाइलें लोड करने के बाद, ब्राउज़र के सबसे नीचे मौजूद कंसोल में गड़बड़ी के मैसेज के साथ नतीजे भी दिखते हैं.

पुष्टि करने के लिए 3D मॉडल जोड़ना

3D मॉडल की पुष्टि करने के लिए, हमारे मॉडल एडिटर टूल में वे फ़ाइलें जोड़ें जिनसे 3D मॉडल बनता है.

मॉडल की पुष्टि करने के लिए, झलक देखने वाले को मॉडल की glb या glTF फ़ाइल, उससे जुड़ी कोई इमेज और बिन फ़ाइल, और एक वैकल्पिक ऑडियो फ़ाइल की ज़रूरत होती है. एक से ज़्यादा फ़ाइलें चुनी जा सकती हैं. इसके अलावा, एक ZIP फ़ाइल जोड़ी जा सकती है.

ZIP फ़ाइल जोड़ते समय, झलक दिखाने वाला टूल, उसे मिलने वाला पहला glb या glTF लोड करता है. साथ ही, zip फ़ाइल में मौजूद इससे जुड़ी इमेज और बिन फ़ाइलों को भी लोड करता है.

  1. ब्राउज़र में मॉडल एडिटर टूल खोलें.

  2. झलक देखने वाले टूल में फ़ाइलें जोड़ने के लिए, इनमें से कोई एक तरीका अपनाएं:

    • पुष्टि करने के लिए फ़ाइलों को खींचें और छोड़ें, glb या glTF फ़ाइल और उससे जुड़ी किसी भी फ़ाइल को एक साथ चुनें (या इन फ़ाइलों वाली ZIP फ़ाइल चुनें) और उसे प्रीव्यू टूल में खींचें और छोड़ें.

    • झलक दिखाने वाले टूल से फ़ाइलें चुनें. झलक देखने वाले टूल में, सीन व्यूअर > फ़ाइल लोड करें चुनें. glb या glTF फ़ाइल और इससे जुड़ी सभी फ़ाइलों (या इन फ़ाइलों वाली zip फ़ाइल) को एक से ज़्यादा बार चुनें और खोलें पर क्लिक करें.

पुष्टि करने से जुड़ी गड़बड़ियां

गड़बड़ी कोड समस्या की गंभीरता मैसेज ऐसी मौजूदा वैल्यू जिनका इस्तेमाल किया जा सकता है
INVALID_INPUT_FILE_EXTENSION गड़बड़ी इनपुट फ़ाइल [filename] का फ़ाइल एक्सटेंशन, पुष्टि करने वाले प्रोग्राम के साथ काम नहीं करता. ['.glb', '.gltf']
REC_INPUT_BINARY_SIZE_EXCEEDED चेतावनी उपयोगकर्ता के दिए गए इनपुट में बाइनरी साइज़ इस सीमा से ज़्यादा है, जो सीन व्यूअर की तय की गई सीमा (साइज़) एमबी के लिए सुझाई गई साइज़ सीमा से ज़्यादा है. 10
MAX_INPUT_BINARY_SIZE_EXCEEDED गड़बड़ी उपयोगकर्ता के दिए गए इनपुट में ऐसा बाइनरी साइज़ है जो सीन व्यूअर की तय सीमा से ज़्यादा हो सकता है. सीन का साइज़ [size] एमबी से ज़्यादा नहीं होना चाहिए. 15
UNSUPPORTED_GLTF_EXTENSION_USED गड़बड़ी सीन व्यूअर की खास जानकारी के हिसाब से, glTF में [ext] एक्सटेंशन को इस्तेमाल नहीं किया जा सकता. ['KHR_materials_pbrSpecularGlossiness', 'KHR_materials_unlit', 'KHR_texture_transform']
ANIMATION_LIMIT_EXCEEDED गड़बड़ी glTF में ज़्यादा से ज़्यादा [num] ऐनिमेशन मौजूद हो सकते हैं. हालांकि, सामान्य तौर पर इस glTF में ज़्यादा ऐनिमेशन, सीन व्यूअर की तय की गई सीमा से ज़्यादा हो सकते हैं. 1
MORPH_TARGET_USED गड़बड़ी glTF में एक मॉर्फ़ टारगेट है, जो सीन व्यूअर की खास बातों में काम नहीं करता.
MATERIAL_LIMIT_EXCEEDED चेतावनी glTF में ज़्यादा से ज़्यादा [num] सामग्री वाले हिस्सा, सीन व्यूअर की स्पेसिफ़िकेशन में बताई गई संख्या से ज़्यादा हो सकते हैं. 10
TEXTURE_RESOLUTION_LIMIT_EXCEEDED चेतावनी glTF में इंडेक्स [idx] पर इमेज का रिज़ॉल्यूशन, सीन व्यूअर की सुझाई गई सीमा से ज़्यादा हो गया है. यह रिज़ॉल्यूशन [res] x [res] का ज़्यादा से ज़्यादा रिज़ॉल्यूशन होता है. 2,048 x 2048
UV_LIMIT_EXCEEDED गड़बड़ी glTF में हर मेश पर यूवी की संख्या, Screen Viewer की खास जानकारी के हिसाब से तय की गई सीमा से ज़्यादा है. यह संख्या, ज़्यादा से ज़्यादा [num] UV हर मेश नेटवर्क के लिए है. 1
VERTEX_COLOR_USED गड़बड़ी glTF में एक वर्टेक्स रंग होता है, जो सीन व्यूअर की खास जानकारी के हिसाब से काम नहीं करता.
JOINT_LIMIT_EXCEEDED गड़बड़ी glTF में जोड़ों की संख्या, ऊपर बताई गई दर से ज़्यादा हो गई है. 254
TRIANGLE_LIMIT_EXCEEDED चेतावनी glTF में ज़्यादा से ज़्यादा [num] त्रिभुज होने चाहिए. 1,00,000
PRIMITIVE_MODE_UNSUPPORTED गड़बड़ी सीन व्यूअर की खास जानकारी के हिसाब से, प्रिमिटिव मोड [mode] की सुविधा काम नहीं करती. {4 : त्रिकोण सूची, 5 : ट्रायएंगल स्ट्रिप, 6 : ट्रायएंगल फ़ैन}
MISSING_PBR_METALLIC_ROUGHNESS जानकारी इंडेक्स [idx] में मौजूद कॉन्टेंट में pbrMetallicRoughness प्रॉपर्टी मौजूद नहीं है. अगर इसके बजाय, धातु और खुरदरापन वाली चीज़ों का इस्तेमाल किया जाता है, तो सीन व्यूअर के लिए तय की गई वैल्यू के मुताबिक इसकी ज़रूरत नहीं है. अगर इनमें से किसी का भी इस्तेमाल नहीं किया जाता है, तो कॉन्टेंट में डिफ़ॉल्ट वैल्यू का इस्तेमाल किया जाएगा. इसकी वजह से, अनचाहे व्यवहार हो सकते हैं.