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

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

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

इन्हें आसानी से लागू किया जा सकता है:

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

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

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

सीन व्यूअर की मदद से एआर का अनुभव करने के लिए, उपयोगकर्ताओं के पास:

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

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

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

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

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

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

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

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

नीचे दिए गए पैरामीटर, Google को साफ़ तौर पर इंटेंट दिखाने के लिए इस्तेमाल किए जा सकते हैं पैकेज खोजें.

इंटेंट पैरामीटर अनुमति वाली वैल्यू टिप्पणियां
file (ज़रूरी) मान्य यूआरएल यह यूआरएल उस glTF या glb फ़ाइल के बारे में बताता है जिसे लोड किया जाना चाहिए सीन व्यूअर. इसका यूआरएल एस्केप होना चाहिए.
S.browser_fallback_url (एचटीएमएल-आधारित इंटेंट के लिए ज़रूरी है) मान्य यूआरएल यह Google Chrome की एक सुविधा है. यह सुविधा सिर्फ़ वेब पर आधारित काम करने के तरीके के लिए काम करती है. जब Google app डिवाइस पर मौजूद नहीं है, यह वह URL है जिस पर 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 मौजूद नहीं है, तोViews Viewer की मदद से 3D मोड पर वापस जाएं.

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

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

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

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

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

false

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

true

true पर सेट करने पर, उपयोगकर्ता मॉडल को किसी वर्टिकल सरफ़ेस.

उपयोगकर्ता अनुभव के लिए सलाह

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

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

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

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

यह पक्का करने के लिए कि सीन Viewer में एआर की सुविधा उपलब्ध है, आप किसी अश्लील Android डिवाइस का इस्तेमाल कर सकते हैं इंटेंट किसी वेबसाइट या स्थानीय Android ऐप्लिकेशन से सीन Viewer लॉन्च करने के लिए com.google.ar.core package और browser_fallback_url दें. इस तरह, आपको यह पक्का कर सकता है कि सभी उपयोगकर्ताओं को Score 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 पर साफ़ तौर पर इंटेंट के लिए काम करते हैं एआर पैकेज के लिए सेवाएं.

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

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

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

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

   

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



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



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

false

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

true

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

उपयोगकर्ता अनुभव के लिए सलाह

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

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

  • ऐसा हो सकता है कि लोगों के पास Google Play Services for एआर अपने डिवाइस पर इंस्टॉल किया जा सकता है. यहां बताया गया है कि <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 मौजूद नहीं है, तो इस बटन पर टैप करने से <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 (कठिन सीमा)
  • यूवी: हर मेश पर एक यूवी (हार्ड लिमिट)
  • मॉडल का साइज़: 10 एमबी (बड़े मॉडल की वजह से, उपयोगकर्ताओं को खराब अनुभव मिल सकता है.)
शैडो की सुविधा हार्ड शैडो अपने-आप रेंडर होते हैं किसी ऑब्जेक्ट को रखने के दौरान, सीन Viewer की मदद लें. इसलिए, हमारा सुझाव है कि आप उसे बेक न करें शैडो आपके मॉडल में शामिल कर देते हैं.
टेक्सचर सपोर्ट
  • PNG फ़ॉर्मैट: PNG-24, इंडेक्स किया गया PNG-8.
    अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है पारदर्शिता न होने पर JPG को प्राथमिकता दी जाती है, क्योंकि वे साइज़ कम करते हैं.
  • कलर स्पेस: sRGB
मटीरियल PBR
फ़ाइल लोड हो रही है एचटीटीपीएस
सीन
  • ऐक्सिस: दाएं हाथ से, इन प्रॉपर्टी के साथ:
    • +X सही है
    • +Y ऊपर है
    • -Z मूल से आगे की ओर इशारा करता है (दूसरे शब्दों में, इसका "आगे" का हिस्सा ऐसेट का फ़ोकस +Z के सामने होना चाहिए)
  • स्केल: 1 यूनिट = 1 मीटर (जैसा कि glTF स्पेसिफ़िकेशन में बताया गया है पक्का करें कि मॉडल को सही स्केल में एआर (ऑगमेंटेड रिएलिटी) में रखा गया हो)

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

यह पक्का करने के लिए कि आपकी 3D मॉडल फ़ाइल Site Viewer में ठीक से दिखे, इसके लिए हमारे ऑनलाइन झलक देखने वाला टूल की पुष्टि करें.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

गड़बड़ी कोड गंभीरता मैसेज वर्तमान समर्थित मान
INVALID_INPUT_FILE_EXTENSION गड़बड़ी इनपुट फ़ाइल [filename] का ऐसा फ़ाइल एक्सटेंशन है जो पुष्टि करने वाले प्रोग्राम के साथ काम नहीं करता है. ['.glb', '.gltf']
REC_INPUT_BINARY_SIZE_EXCEEDED चेतावनी उपयोगकर्ता के दिए गए इनपुट में बाइनरी साइज़ है, जो तय सीमा से ज़्यादा है सीन व्यूअर स्पेसिफ़िकेशन के मुताबिक इसका सुझाव दिया जाता है. साइज़ [size] एमबी की सुझाई गई सीमा है. 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] ऐनिमेशन शामिल हो सकते हैं. 1
MORPH_TARGET_USED गड़बड़ी glTF में एक मॉर्फ़ टारगेट है, जो सीन के लिए व्यूअर के बारे में जानकारी.
MATERIAL_LIMIT_EXCEEDED चेतावनी glTF में सामग्री की संख्या इसके लिए सुझाई गई सीमा से ज़्यादा है सीन Viewer की खास जानकारी, जो ज़्यादा से ज़्यादा [num] सामग्री है. 10
TEXTURE_RESOLUTION_LIMIT_EXCEEDED चेतावनी glTF में इंडेक्स [idx] पर इमेज का रिज़ॉल्यूशन, तय सीमा से ज़्यादा है सीन व्यूअर के लिए दिए गए निर्देशों के हिसाब से इसका सुझाव दिया जाता है, जो ज़्यादा से ज़्यादा रिज़ॉल्यूशन है [res] x [res] में से. 2048 x 2048
UV_LIMIT_EXCEEDED गड़बड़ी glTF में हर मेश पर यूवी की संख्या, सीन व्यूअर के बारे में जानकारी, जो कि हर मेश पर ज़्यादा से ज़्यादा [num] UV हो सकती है. 1
VERTEX_COLOR_USED गड़बड़ी glTF में एक वर्टेक्स रंग होता है, जो इसके साथ काम नहीं करता सीन Viewer की खास जानकारी के बारे में बताया गया है.
JOINT_LIMIT_EXCEEDED गड़बड़ी glTF में जॉइंट की संख्या इस सीमा से ज़्यादा है: सीन Viewer के बारे में जानकारी मौजूद है. इसमें ज़्यादा से ज़्यादा [num] जोड़ हैं. 254
TRIANGLE_LIMIT_EXCEEDED चेतावनी glTF में त्रिभुजों की संख्या सुझाई गई सीमा से ज़्यादा है सीन Viewer के इस्तेमाल के लिए दिए गए हैं. इसमें ज़्यादा से ज़्यादा [num] त्रिभुज हैं. 1,00,000
PRIMITIVE_MODE_UNSUPPORTED गड़बड़ी सीन व्यूअर के स्पेसिफ़िकेशन के मुताबिक, प्रिमिटिव मोड [mode] का इस्तेमाल नहीं किया जा सकता. {4 : त्रिभुज सूची, 5 : ट्रायएंगल स्ट्रिप, 6 : ट्रायंगल फ़ैन}
MISSING_PBR_METALLIC_ROUGHNESS जानकारी इंडेक्स [idx] के कॉन्टेंट में pbrMetallicRoughness मौजूद नहीं है प्रॉपर्टी. अगर धातुओं का इस्तेमाल किया गया है, तो सीन व्यूअर स्पेसिफ़िकेशन के लिए इसकी ज़रूरत नहीं है इसके बजाय, खुरदरापन वाले फ़ैक्टर का इस्तेमाल किया जाता है. अगर इनमें से किसी का भी इस्तेमाल न हो, तो कॉन्टेंट में डिफ़ॉल्ट वैल्यू का इस्तेमाल किया जाएगा. इसकी वजह से, अनचाहे नतीजे मिल सकते हैं.