Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

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

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

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

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

Scene Viewer को चलाने के लिए ज़रूरी शर्तें

Scene Viewer के साथ एआर का इस्तेमाल करने के लिए, लोगों के पास ये चीज़ें होनी चाहिए:

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

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

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

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

एक्सप्लिसिट इंटेंट (3D या एआर) का इस्तेमाल करके Scene Viewer लॉन्च करना

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

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

अगर डिवाइस पर Google Play Services for AR मौजूद है और यह अप-टू-डेट है, तो Scene Viewer, मॉडल को एआर नेटिव व्यू या 3D व्यू में दिखाएगा.
अगर Google Play Services for AR मौजूद नहीं है या अप-टू-डेट नहीं है, तो Scene Viewer, मॉडल को 3D व्यू में दिखाता है.
अगर 3D मॉडल नहीं दिखाया जा सकता, तो फ़ॉलबैक वेब पेज दिखाने के लिए S.browser_fallback_url पैरामीटर का इस्तेमाल किया जाएगा. उदाहरण के लिए, ऐसा तब होता है, जब Google ऐप्लिकेशन इंस्टॉल न हो या उसका पुराना वर्शन इस्तेमाल किया जा रहा हो.

एचटीएमएल या Java से Scene Viewer लॉन्च करना

एचटीएमएल

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

<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 का इस्तेमाल किया गया था. Scene Viewer की नई सुविधाओं का इस्तेमाल करने के लिए, आपको Scene Viewer को ज़्यादा इंटेंट वाले वर्शन के साथ लॉन्च करना पड़ सकता है. यह वर्शन, आपकी ज़रूरत के हिसाब से सुविधाओं के साथ काम करता है.

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

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

Google Search पैकेज के लिए, साफ़ तौर पर इंटेंट बताने वाले इन पैरामीटर का इस्तेमाल किया जा सकता है.

इंटेंट पैरामीटर	अनुमति वाली वैल्यू	टिप्पणियां
`file` (ज़रूरी)	मान्य यूआरएल	इस यूआरएल से, उस glTF या glb फ़ाइल के बारे में पता चलता है जिसे Scene Viewer में लोड किया जाना चाहिए. इसे यूआरएल-एस्केप किया जाना चाहिए.
`S.browser_fallback_url` (एचटीएमएल पर आधारित इंटेंट के लिए ज़रूरी है)	मान्य यूआरएल	यह Google Chrome की एक सुविधा है. यह सिर्फ़ वेब पर लागू होने वाले कोड के साथ काम करती है. अगर डिवाइस पर Google ऐप्लिकेशन मौजूद नहीं है, तो Google Chrome इस यूआरएल पर नेविगेट करता है.
`mode` (वैकल्पिक)	`3d_preferred` (डिफ़ॉल्ट)	Scene Viewer, मॉडल को 3D मोड में दिखाता है. साथ ही, इसमें अपने आस-पास की चीज़ों को ऑगमेंटेड रिएलिटी में देखें बटन होता है. अगर डिवाइस पर Google Play Services for AR मौजूद नहीं है, तो अपने आस-पास की जगह पर देखें बटन नहीं दिखता है.
	`3d_only`	Scene Viewer, 3D मोड में मॉडल के साथ लॉन्च होता है. भले ही, डिवाइस पर Google Play Services for AR मौजूद हो. अपनी चुनी हुई जगह पर देखें बटन कभी नहीं दिखता.
	`ar_preferred`	Scene Viewer, एंट्री मोड के तौर पर एआर नेटिव मोड में लॉन्च होता है. उपयोगकर्ता को ऑगमेंटेड रिएलिटी (एआर) में देखें और 3D में देखें बटन के ज़रिए, एआर और 3D मोड के बीच स्विच करने का विकल्प मिलता है. अगर Google Play Services for AR मौजूद नहीं है, तो Scene Viewer, एंट्री मोड के तौर पर 3D मोड पर वापस आ जाता है.
	`ar_only`	इस वैल्यू का इस्तेमाल करते समय, आपको `com.google.ar.core` को लॉन्च करने के लिए, Android के एक्सप्लिसिट इंटेंट का इस्तेमाल करना चाहिए. ध्यान दें: Google ऐप्लिकेशन को लॉन्च करने के लिए, Android के एक्सप्लिसिट इंटेंट के ज़रिए लॉन्च करते समय, `ar_only` मोड का इस्तेमाल न करें.
`link` (वैकल्पिक)	मान्य यूआरएल	किसी बाहरी वेबपेज का यूआरएल. अगर यह मौजूद है, तो यूज़र इंटरफ़ेस (यूआई) में एक बटन दिखेगा. इस पर क्लिक करने से, उपयोगकर्ता इस यूआरएल पर पहुंच जाएगा.
`title` (वैकल्पिक)	मान्य स्ट्रिंग	मॉडल का नाम. अगर यह मौजूद है, तो इसे यूज़र इंटरफ़ेस (यूआई) में दिखाया जाएगा. नाम में 60 वर्णों के बाद, उसे काट दिया जाएगा और आखिर में तीन बिंदु (एललिप्सिस) लगा दिए जाएंगे.
आवाज़ (ज़रूरी नहीं)	मान्य यूआरएल	लूप में चलने वाले ऑडियो ट्रैक का यूआरएल. यह glTF फ़ाइल में एम्बेड किए गए पहले ऐनिमेशन के साथ सिंक किया जाता है. इसे उसी अवधि के ऐनिमेशन वाले glTF के साथ उपलब्ध कराया जाना चाहिए. यह मौजूद होने पर, मॉडल लोड होने के बाद आवाज़ लूप हो जाती है. इसे यूआरएल-एस्केप किया जाना चाहिए.
`resizable` (वैकल्पिक)	`true` (डिफ़ॉल्ट) `false`	इस विकल्प को `false` पर सेट करने पर, लोग एआर अनुभव में मॉडल को बड़ा या छोटा नहीं कर पाएंगे. 3D व्यू में, स्केलिंग की सुविधा सामान्य तरीके से काम करती है.
`enable_vertical_placement` (वैकल्पिक)	`false` (डिफ़ॉल्ट) `true`	इस विकल्प को `true` पर सेट करने पर, उपयोगकर्ता मॉडल को किसी वर्टिकल सतह पर रख पाएंगे.

यूएक्स से जुड़े दिशा-निर्देश

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

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

Google Play Services for AR (सिर्फ़ एआर मोड) के लिए, साफ़ तौर पर बताए गए इंटेंट का इस्तेमाल करके Scene Viewer लॉन्च करना

Scene Viewer में एआर मोड, Google Play Services for AR की मदद से काम करता है.

यह पक्का करने के लिए कि Scene Viewer में एआर की सुविधा उपलब्ध है, किसी वेबसाइट या नेटिव Android ऐप्लिकेशन से एक्सप्लिसिट Android इंटेंट का इस्तेमाल किया जा सकता है. इससे com.google.ar.core package के ज़रिए Scene Viewer लॉन्च किया जा सकता है और browser_fallback_url उपलब्ध कराया जा सकता है. इस तरह, यह पक्का किया जा सकता है कि सभी उपयोगकर्ताओं को Scene Viewer के ज़रिए नेटिव एआर अनुभव मिले या उन्हें आपके बनाए गए फ़ॉलबैक अनुभव का इस्तेमाल करने का विकल्प मिले. उदाहरण के लिए, फ़ॉलबैक के तौर पर अपने 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`	Scene Viewer, 3D मॉडल को हमेशा नेटिव एआर व्यू में लॉन्च करता है. साथ ही, Scene Viewer 3D व्यूअर पर स्विच करने के लिए किसी भी यूज़र इंटरफ़ेस (यूआई) को छिपा देता है. अगर Google Play Services for AR मौजूद नहीं है, तो Scene Viewer उस यूआरएल को लॉन्च करता है जिसे आपने वेब पर आधारित अनुभवों के लिए `browser_fallback_url` में सेट किया है. ऐप्लिकेशन पर आधारित अनुभवों के लिए, Scene Viewer किसी अन्य अनुभव पर वापस आ जाता है. जैसे, गड़बड़ी का मैसेज या आपके बनाए गए अन्य अनुभव.
`mode` (वैकल्पिक)	`ar_preferred`	Scene Viewer, एआर नेटिव मोड में लॉन्च होता है. यह एंट्री मोड के तौर पर काम करता है. साथ ही, लोगों को अपने आस-पास की चीज़ों को ऑगमेंटेड रिएलिटी में देखें और 3D में देखें बटन के ज़रिए, एआर और 3D मोड के बीच स्विच करने का विकल्प देता है. अगर Google Play Services for AR मौजूद नहीं है, तो Scene Viewer उस यूआरएल को लॉन्च करता है जिसे आपने वेब पर आधारित अनुभवों के लिए `browser_fallback_url` में सेट किया है. ऐप्लिकेशन पर आधारित अनुभवों के लिए, Scene Viewer किसी अन्य अनुभव पर वापस आ जाता है. जैसे, गड़बड़ी का मैसेज या आपके बनाए गए अन्य अनुभव.
`link` (वैकल्पिक)	मान्य यूआरएल	किसी बाहरी वेबपेज का यूआरएल. अगर यह मौजूद है, तो यूज़र इंटरफ़ेस (यूआई) में एक बटन दिखेगा. इस पर क्लिक करने से, उपयोगकर्ता इस यूआरएल पर पहुंच जाएगा. वर्शन 1.1 में, Scene Viewer में intent:// लिंक इस्तेमाल करने की सुविधा जोड़ी गई है. इससे Scene Viewer में मौजूद 'देखें' बटन को सीधे तौर पर दूसरे ऐप्लिकेशन में ट्रिगर किया जा सकेगा. ध्यान दें कि इसका इस्तेमाल सावधानी से किया जाना चाहिए. साथ ही, इसे सिर्फ़ तब तय किया जाना चाहिए, जब दिए गए इंटेंट के लिए इंटेंट हैंडलर मौजूद हो.
`title` (वैकल्पिक)	मान्य स्ट्रिंग	मॉडल का नाम. अगर यह मौजूद है, तो इसे यूज़र इंटरफ़ेस (यूआई) में दिखाया जाएगा. नाम में 60 वर्णों के बाद, उसे काट दिया जाएगा और आखिर में तीन बिंदु (एललिप्सिस) लगा दिए जाएंगे. वर्शन 1.1 में, टाइटल के कॉन्टेंट को एचटीएमएल स्टाइल में दिखाने की सुविधा जोड़ी गई है. इसमें टेक्स्ट की कोई सीमा नहीं है. ध्यान दें कि टाइटल को यूआरएल-एस्केप किया जाना चाहिए.
`sound` (वैकल्पिक)	मान्य यूआरएल	लूप में चलने वाले ऑडियो ट्रैक का यूआरएल. यह glTF फ़ाइल में एम्बेड किए गए पहले ऐनिमेशन के साथ सिंक होता है.. इसे उसी अवधि के ऐनिमेशन वाले glTF के साथ उपलब्ध कराया जाना चाहिए. इस पैरामीटर के मौजूद होने पर, मॉडल लोड होने के बाद आवाज़ लूप होती है.
`resizable` (वैकल्पिक)	`true` (डिफ़ॉल्ट) `false`	इस विकल्प को `false` पर सेट करने पर, लोग एआर अनुभव में मॉडल को बड़ा या छोटा नहीं कर पाएंगे. 3D व्यू में, स्केलिंग की सुविधा सामान्य तरीके से काम करती है.
`disable_occlusion` (वैकल्पिक)	`false` (डिफ़ॉल्ट) `true`	`true` पर सेट होने पर, सीन में रखे गए ऑब्जेक्ट हमेशा सीन में मौजूद असल दुनिया के ऑब्जेक्ट के सामने दिखते हैं. ज़्यादा जानकारी के लिए, [ऑक्लूज़न की सुविधा चालू करना](/ar/develop/depth#enable_occlusion) लेख पढ़ें.

यूएक्स से जुड़े दिशा-निर्देश

उपयोगकर्ताओं को बेहतरीन यूज़र एक्सपीरियंस देने के लिए, हमारा सुझाव है कि आप इन दिशा-निर्देशों का पालन करें.

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

ऐसा हो सकता है कि उपयोगकर्ताओं ने अपने डिवाइस पर 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);

Scene Viewer लॉन्च करने के लिए, `<model-viewer>` का इस्तेमाल करना

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

<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 मोड का इस्तेमाल करने पर, यह नेटिव एआर व्यू पर स्विच हो जाता है. साथ ही, उपयोगकर्ता को Scene Viewer का इस्तेमाल करके, मॉडल को अपने एनवायरमेंट में रखने का न्योता देता है.

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

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

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

Scene Viewer में मॉडल के लिए, ये सुविधाएं उपलब्ध हैं और इन सीमाओं के साथ काम करती हैं.

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

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

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

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

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

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

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

ब्राउज़र में ऑनलाइन प्रीव्यू करने वाले टूल को खोलें.
फ़ाइलों को प्रीव्यू करने वाले टूल में जोड़ने के लिए, इनमें से कोई एक तरीका इस्तेमाल करें:
- खींचें और छोड़ें. कोई glb या glTF फ़ाइल और उससे जुड़ी सभी फ़ाइलें (या इन फ़ाइलों वाली कोई ZIP फ़ाइल) चुनें. इसके बाद, चुनी गई फ़ाइलों या ZIP फ़ाइल को पूर्वावलोकन करने वाले टूल में खींचें और छोड़ें.
- झलक दिखाने वाले टूल से. प्रीव्यू करने वाले टूल में, Scene Viewer > Load File को चुनें. कोई glb या glTF फ़ाइल और उससे जुड़ी सभी फ़ाइलें (या इन फ़ाइलों वाली zip फ़ाइल) चुनें. इसके बाद, खोलें पर क्लिक करें.

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

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

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

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

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

ब्राउज़र में मॉडल एडिटर टूल खोलें.
फ़ाइलों को प्रीव्यू करने वाले टूल में जोड़ने के लिए, इनमें से कोई एक तरीका इस्तेमाल करें:
- पुष्टि करने के लिए, फ़ाइलों को खींचें और छोड़ें. इसके लिए, glb या glTF फ़ाइल और उससे जुड़ी कोई भी फ़ाइल चुनें. इसके अलावा, इन फ़ाइलों वाली zip फ़ाइल भी चुनी जा सकती है. इसके बाद, इसे झलक दिखाने वाले टूल में खींचें और छोड़ें.
- झलक देखने वाले टूल से फ़ाइलें चुनें. प्रीव्यू करने वाले टूल में, Scene Viewer > Load File को चुनें. glb या glTF फ़ाइल और उससे जुड़ी सभी फ़ाइलों (या इन फ़ाइलों वाली zip फ़ाइल) को एक साथ चुनें. इसके बाद, खोलें पर क्लिक करें.

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

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

Scene Viewer को चलाने के लिए ज़रूरी शर्तें

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

एक्सप्लिसिट इंटेंट (3D या एआर) का इस्तेमाल करके Scene Viewer लॉन्च करना

एचटीएमएल या Java से Scene Viewer लॉन्च करना

एचटीएमएल

Java

इंटेंट वर्शन

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

यूएक्स से जुड़े दिशा-निर्देश

Google Play Services for AR (सिर्फ़ एआर मोड) के लिए, साफ़ तौर पर बताए गए इंटेंट का इस्तेमाल करके Scene Viewer लॉन्च करना

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

यूएक्स से जुड़े दिशा-निर्देश

Scene Viewer लॉन्च करने के लिए, <model-viewer> का इस्तेमाल करना

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

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

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

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

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

Scene Viewer लॉन्च करने के लिए, `<model-viewer>` का इस्तेमाल करना