একটি অ্যান্ড্রয়েড অ্যাপ বা ব্রাউজার থেকে এআর-এ ইন্টারেক্টিভ 3D মডেলগুলি প্রদর্শন করতে দৃশ্য ভিউয়ার ব্যবহার করা

সিন ভিউয়ার হলো একটি ইমারসিভ ভিউয়ার যা আপনার ওয়েবসাইট বা অ্যান্ড্রয়েড অ্যাপ থেকে থ্রিডি এবং এআর অভিজ্ঞতা প্রদান করে। এটি অ্যান্ড্রয়েড মোবাইল ডিভাইসের ব্যবহারকারীদের তাদের পরিবেশে ওয়েব-হোস্টেড থ্রিডি মডেলগুলো সহজে প্রিভিউ করতে, স্থাপন করতে, দেখতে এবং সেগুলোর সাথে ইন্টারঅ্যাক্ট করতে দেয়।

বেশিরভাগ অ্যান্ড্রয়েড ব্রাউজার সিন ভিউয়ার সমর্থন করে। অনেক গুগল পার্টনার নির্ভরযোগ্যভাবে থ্রিডি এবং এআর অভিজ্ঞতা প্রদানের জন্য সফলভাবে সিন ভিউয়ার প্রয়োগ করেছে। এটি গুগল সার্চের জন্যও এই অভিজ্ঞতাগুলোকে শক্তি জোগায়।

বাস্তবায়ন খুবই সহজ:

• ওয়েব-ভিত্তিক অভিজ্ঞতার জন্য একটি ওয়েব পেজে শুধু যথাযথভাবে ফরম্যাট করা লিঙ্কই যথেষ্ট।

• অ্যাপ-ভিত্তিক অভিজ্ঞতার জন্য মাত্র কয়েক লাইন জাভা কোড ইন্টিগ্রেট করলেই চলে।

দৃশ্য দর্শকের রানটাইম প্রয়োজনীয়তা

Scene Viewer-এর মাধ্যমে AR অভিজ্ঞতা লাভ করতে ব্যবহারকারীদের অবশ্যই নিম্নলিখিতগুলির মধ্যে একটি থাকতে হবে:

• অ্যান্ড্রয়েড ৭.০ নুগাট (এপিআই লেভেল ২৪) বা তার পরবর্তী সংস্করণে চালিত একটি এআরকোর সমর্থিত ডিভাইস ।
• এআর-এর জন্য গুগল প্লে সার্ভিসেস- এর একটি হালনাগাদ (সাম্প্রতিক) সংস্করণ। এই পরিষেবাটি এআরকোর সমর্থিত অধিকাংশ ডিভাইসে স্বয়ংক্রিয়ভাবে ইনস্টল এবং হালনাগাদ রাখা হয়।
• গুগল অ্যাপের একটি হালনাগাদ সংস্করণ। এই অ্যাপটি অধিকাংশ ARCore সমর্থিত ডিভাইসে আগে থেকেই ইনস্টল করা থাকে এবং স্বয়ংক্রিয়ভাবে হালনাগাদও হয়।

এমন পরিস্থিতির জন্য যেখানে Google Play Services for AR বা Google অ্যাপটি উপস্থিত নেই অথবা ইনস্টল করা সংস্করণগুলো অনেক পুরোনো, আপনি একটি ফলব্যাক URL নির্দিষ্ট করতে পারেন যা একটি বিকল্প অভিজ্ঞতা চালু করবে; যেমন—একটি ওয়েব পেজ, একটি ত্রুটির বার্তা, বা আপনার তৈরি করা কোনো ফলব্যাক অভিজ্ঞতা।

সমর্থিত ব্যবহারের ক্ষেত্রসমূহ

উদ্দিষ্ট ব্যবহারের ক্ষেত্র	প্রস্তাবিত আবেদন	সুবিধা
ওয়েবসাইট বা অ্যান্ড্রয়েড অ্যাপের কোনো বাটন বা লিঙ্ক থেকে একটি 3D মডেলের নেটিভ AR ভিউ চালু করুন। যদি ডিভাইসে Google Play Services for AR উপস্থিত না থাকে, তাহলে মডেলটিকে স্বয়ংক্রিয়ভাবে Scene Viewer-চালিত 3D মোডে দেখানো হবে।	Google Search প্যাকেজের জন্য একটি সুস্পষ্ট ইন্টেন্ট ব্যবহার করে Scene Viewer চালু করুন , এবং 3D মডেলটি প্রদর্শনের জন্য একটি উপযুক্ত mode সেটিং বেছে নিন। ar_preferred : সর্বদা একটি AR ভিউয়ারে শুরু হয়, এবং ব্যবহারকারীরা ম্যানুয়ালি একটি 3D ভিউয়ারে পরিবর্তন করতে পারেন। যদি Google Play Services for AR উপস্থিত না থাকে, তবে এটি স্বয়ংক্রিয়ভাবে 3D ভিউয়ারে ফিরে যায়। 3d_preferred : সর্বদা একটি 3D ভিউয়ারে শুরু হয়, এবং ব্যবহারকারীরা ম্যানুয়ালি একটি AR ভিউয়ারে পরিবর্তন করতে পারেন। যদি Google Play Services for AR উপস্থিত না থাকে, তবে ব্যবহারকারীরা 3D ভিউয়ার থেকে অন্য ভিউয়ারে পরিবর্তন করতে পারবেন না। 3d_only : সর্বদা শুধুমাত্র একটি 3D ভিউয়ারে প্রদর্শিত হয়, ব্যবহারকারীদের জন্য AR ভিউয়ারে পরিবর্তন করার কোনো উপায় থাকে না।	সর্বাধিক সংখ্যক ডিভাইস সমর্থন করুন। এআর-বহির্ভূত ব্যবহারের ক্ষেত্রে সিন ভিউয়ারের নেটিভ ৩ডি মোডে স্বয়ংক্রিয়ভাবে ফিরে যাবে।
ওয়েবসাইট বা অ্যান্ড্রয়েড অ্যাপের কোনো বাটন বা লিঙ্ক থেকে একটি 3D মডেলের নেটিভ AR ভিউ চালু করুন। ডিভাইসে যদি Google Play Services for AR উপস্থিত না থাকে, তাহলে ফলব্যাক আচরণ নিয়ন্ত্রণ করুন।	Google Play Services for AR (ARCore)-কে একটি সুস্পষ্ট ইন্টেন্ট ব্যবহার করে Scene Viewer চালু করুন , এবং 3D মডেলটি প্রদর্শনের জন্য একটি উপযুক্ত mode সেটিং বেছে নিন। ar_preferred : সর্বদা AR ভিউয়ারে শুরু হয়, এবং ব্যবহারকারীরা ম্যানুয়ালি একটি 3D ভিউয়ারে পরিবর্তন করতে পারেন। যদি Google Play Services for AR উপস্থিত না থাকে, তাহলে Scene Viewer আপনার কনফিগার করা আচরণে ফিরে যায়। ar_only : সর্বদা শুধুমাত্র AR ভিউয়ারে প্রদর্শিত হয়, 3D ভিউয়ারে পরিবর্তন করার কোনো সুযোগ থাকে না। যদি Google Play Services for AR উপস্থিত না থাকে, তবে এটি আপনার কনফিগার করা আচরণে ফিরে যায়। উদাহরণস্বরূপ, আপনি আপনার নিজস্ব ফুল-স্ক্রিন 3D অভিজ্ঞতা চালু করতে পারেন অথবা একটি সহজবোধ্য ত্রুটির বার্তা দেখাতে পারেন যা নির্দেশ করে যে ব্যবহারকারীর ডিভাইসটি এখনও AR সক্ষমতা সমর্থন করে না।	আপনার নিজস্ব ৩ডি মডেল ভিউয়ার ব্যবহার করুন অথবা এআর-বহির্ভূত ব্যবহারের ক্ষেত্রে আপনার নিজস্ব নকশার অন্য কোনো বিকল্প ব্যবস্থা রাখুন।
আপনার ওয়েবসাইটে একটি 3D মডেলের ইনলাইন ভিউ হোস্ট করুন এবং ব্যবহারকারীকে ম্যানুয়ালি ফুল-স্ক্রিন নেটিভ AR মোডে প্রবেশ করার অনুমতি দিন।	<model-viewer> অথবা অন্য কোনো ওয়েব-ভিত্তিক 3D ভিউয়ার ব্যবহার করে সিন ভিউয়ার চালু করুন, যা এআর-এ 3D মডেলটিকে সরাসরি প্রদর্শন করবে।	ওয়েব পেজে এমবেড করা একটি 3D মডেল থেকে সরাসরি AR-এ নেটিভভাবে সিন ভিউয়ার চালু করুন। আপনার মালিকানাধীন ও নিয়ন্ত্রিত কোনো পৃষ্ঠে ব্যবহারকারীদের একটি 3D অভিজ্ঞতা প্রদান করুন এবং তাদের অভিপ্রায় বুঝতে পারলে, পর্যায়ক্রমে তাদেরকে আরও গভীর ও নিমগ্ন একটি AR অভিজ্ঞতায় নিয়ে যাওয়ার বিকল্প রাখুন।

একটি সুস্পষ্ট অভিপ্রায় (3D বা AR) ব্যবহার করে সিন ভিউয়ার চালু করুন

সর্বাধিক সংখ্যক অ্যান্ড্রয়েড ডিভাইসকে সাপোর্ট করার জন্য, সিন ভিউয়ার চালু করতে একটি সুস্পষ্ট অ্যান্ড্রয়েড ইন্টেন্ট ব্যবহার করুন। এই সুস্পষ্ট ইন্টেন্টটি একটি HTML পেজ বা একটি নেটিভ অ্যান্ড্রয়েড অ্যাপ থেকে ট্রিগার করা যেতে পারে। ARCore সমর্থিত অ্যান্ড্রয়েড ডিভাইসগুলিতে আগে থেকে ইনস্টল করা Google অ্যাপটি এই ইন্টেন্টটি পরিচালনা করবে।

কনফিগার করা ইনটেন্ট প্যারামিটার এবং ডিভাইসের সক্ষমতার ওপর নির্ভর করে, ইন্টারেক্টিভ ৩ডি মডেলগুলো ব্যবহারকারীর পরিবেশে স্থাপন করা যেতে পারে অথবা একটি ৩ডি ভিউয়ারে প্রদর্শিত হতে পারে।

• যদি ডিভাইসটিতে গুগল প্লে সার্ভিসেস ফর এআর (Google Play Services for AR) উপস্থিত থাকে এবং তা হালনাগাদ করা থাকে, তাহলে সিন ভিউয়ার (Scene Viewer) মডেলটিকে একটি এআর নেটিভ ভিউ বা থ্রিডি ভিউতে দেখাবে।

• যদি Google Play Services for AR উপস্থিত না থাকে বা হালনাগাদ করা না থাকে, তাহলে Scene Viewer স্বয়ংক্রিয়ভাবে মডেলটিকে একটি 3D ভিউতে প্রদর্শন করে।

• যদি কোনো 3D মডেল প্রদর্শন করা না যায়, উদাহরণস্বরূপ কারণ গুগল অ্যাপ ইনস্টল করা নেই বা এটি একটি পুরোনো সংস্করণ, তাহলে এর পরিবর্তে একটি ফলব্যাক ওয়েব পেজ দেখানোর জন্য S.browser_fallback_url প্যারামিটারটি ব্যবহার করা হবে।

HTML বা Java থেকে সিন ভিউয়ার চালু করুন

এইচটিএমএল

HTML থেকে সুস্পষ্ট অভিপ্রায় (explicit intent) সক্রিয় করতে, নিম্নলিখিত সিনট্যাক্সটি ব্যবহার করুন:

<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>

জাভা

জাভা থেকে এক্সপ্লিসিট ইনটেন্ট ট্রিগার করতে, নিম্নলিখিত কোডটি ব্যবহার করুন:

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 পরে থাকা ভার্সন নম্বরটি ইন্টেন্ট ভার্সন নির্দেশ করে। উদাহরণস্বরূপ, প্রাথমিক রিলিজে ভার্সন ১.০ ব্যবহৃত হয়েছিল। যখন সিন ভিউয়ারের নতুন ফিচারগুলোর প্রয়োজন হবে, তখন আপনি আপনার প্রয়োজনীয় ফিচারগুলোর সাথে সামঞ্জস্যপূর্ণ একটি উচ্চতর ইন্টেন্ট ভার্সন দিয়ে সিন ভিউয়ার চালু করতে পারেন।

ইনটেন্ট সংস্করণ ১.১-এ intent:// লিঙ্কের জন্য সমর্থন যোগ করা হয়েছে, যা কোনো URL-এ না নিয়ে সরাসরি একটি অ্যান্ড্রয়েড অ্যাপে নিয়ে যেতে পারে। আপনি যদি চান যে সিন ভিউয়ার চালু করার সময় এই কার্যকারিতাটি উপলব্ধ থাকবে এবং অন্যথায় এটি চালু হবে না, তাহলে intent://arvr.google.com/scene-viewer/1.1 এই ইনটেন্টটি দিয়ে সিন ভিউয়ার চালু করুন।

সমর্থিত অভিপ্রায় পরামিতি

গুগল সার্চ প্যাকেজের জন্য একটি সুস্পষ্ট অভিপ্রায়ের ক্ষেত্রে নিম্নলিখিত প্যারামিটারগুলো সমর্থিত।

অভিপ্রায় পরামিতি	অনুমোদিত মান	মন্তব্য
file (প্রয়োজনীয়)	একটি বৈধ URL	এই URL-টি সেই glTF বা glb ফাইলকে নির্দিষ্ট করে, যা সিন ভিউয়ারে লোড করা হবে। এটিকে অবশ্যই URL-escaped করতে হবে।
S.browser_fallback_url (HTML-ভিত্তিক ইন্টেন্টের জন্য আবশ্যক)	একটি বৈধ URL	এটি গুগল ক্রোমের একটি ফিচার যা শুধুমাত্র ওয়েব-ভিত্তিক সংস্করণগুলোর জন্য সমর্থিত। ডিভাইসে গুগল অ্যাপটি উপস্থিত না থাকলে, গুগল ক্রোম এই ইউআরএলটিতে নেভিগেট করে।
mode (ঐচ্ছিক)	3d_preferred (ডিফল্ট)	সিন ভিউয়ারে একটি 'ভিউ ইন ইওর স্পেস' বাটনের মাধ্যমে মডেলটি ৩ডি মোডে প্রদর্শিত হয়। ডিভাইসে যদি Google Play Services for AR উপস্থিত না থাকে, তাহলে ‘ View in your space’ বাটনটি লুকানো থাকে।
	3d_only	ডিভাইসে গুগল প্লে সার্ভিসেস ফর এআর (Google Play Services for AR) উপস্থিত থাকলেও, সিন ভিউয়ার (Scene Viewer) চালু হলে মডেলটি ৩ডি মোডে প্রদর্শিত হয়। ‘ ভিউ ইন ইওর স্পেস’ (View in your space) বাটনটি কখনোই দেখানো হয় না।
	ar_preferred	সিন ভিউয়ার এন্ট্রি মোড হিসেবে এআর নেটিভ মোডে চালু হয়। ব্যবহারকারীকে ' ভিউ ইন ইওর স্পেস' এবং 'ভিউ ইন থ্রিডি' বাটনগুলোর মাধ্যমে এআর এবং থ্রিডি মোডের মধ্যে পরিবর্তন করার সুযোগ দেওয়া হয়। যদি গুগল প্লে সার্ভিসেস ফর এআর (Google Play Services for AR) উপস্থিত না থাকে, তাহলে সিন ভিউয়ার (Scene Viewer) স্বয়ংক্রিয়ভাবে এন্ট্রি মোড হিসেবে ৩ডি মোডে ফিরে যায়।
	ar_only	এই মানটি ব্যবহার করার সময়, আপনাকে একটি সুস্পষ্ট অ্যান্ড্রয়েড ইন্টেন্টের মাধ্যমে com.google.ar.core চালু করতে হবে। দ্রষ্টব্য: সুস্পষ্ট অ্যান্ড্রয়েড ইন্টেন্টের মাধ্যমে গুগল অ্যাপ চালু করার সময় ar_only মোড ব্যবহার করবেন না।
link (ঐচ্ছিক)	একটি বৈধ URL	একটি বাহ্যিক ওয়েবপেজের ইউআরএল। যদি এটি উপস্থিত থাকে, তাহলে ইউজার ইন্টারফেসে একটি বাটন প্রদর্শিত হবে, যেটি ক্লিক করলে এই ইউআরএল-টিতে নিয়ে যাবে।
title (ঐচ্ছিক)	বৈধ স্ট্রিং	মডেলটির জন্য একটি নাম। যদি থাকে, তবে তা UI-তে প্রদর্শিত হবে। নামটি ৬০ অক্ষরের পর ডট ডট (তিনটি বিন্দু) দিয়ে সংক্ষিপ্ত করা হবে।
শব্দ (ঐচ্ছিক)	একটি বৈধ URL	একটি লুপিং অডিও ট্র্যাকের ইউআরএল, যা একটি glTF ফাইলে এমবেড করা প্রথম অ্যানিমেশনের সাথে সিঙ্ক্রোনাইজ করা থাকে। এটি অবশ্যই একই দৈর্ঘ্যের অ্যানিমেশনসহ একটি glTF ফাইলের সাথে প্রদান করতে হবে। যদি এটি উপস্থিত থাকে, তবে মডেলটি লোড হওয়ার পর সাউন্ডটি লুপ হতে থাকে। এটিকে অবশ্যই ইউআরএল-এসকেপ করতে হবে।
resizable (ঐচ্ছিক)	true (ডিফল্ট) false	যখন এটি false এ সেট করা হয়, তখন ব্যবহারকারীরা AR অভিজ্ঞতায় মডেলটি স্কেল করতে পারবেন না। 3D অভিজ্ঞতায় স্কেলিং স্বাভাবিকভাবে কাজ করে।
enable_vertical_placement (ঐচ্ছিক)	false (ডিফল্ট) true	' true তে সেট করা হলে, ব্যবহারকারীরা মডেলটিকে একটি উল্লম্ব পৃষ্ঠে স্থাপন করতে পারবেন।

ইউএক্স নির্দেশনা

ব্যবহারকারীদের সর্বোত্তম ইউএক্স (UX) প্রদানের জন্য, আমরা সুপারিশ করি যে দৃশ্যমান কল টু অ্যাকশনগুলো যেন এই বার্তা দেয় যে ব্যবহারকারী একটি ইমারসিভ পরিবেশে প্রবেশ করতে চলেছেন।

থ্রিডি ভিউয়ার অভিজ্ঞতার জন্য, আমরা ‘ভিউ ইন থ্রিডি’ লেবেলযুক্ত একটি কল টু অ্যাকশন রাখার পরামর্শ দিই, যা দেখতে নিচের ছবিগুলোর যেকোনো একটির মতো হবে:

গুগল প্লে সার্ভিসেস ফর এআর-এর জন্য একটি সুস্পষ্ট ইন্টেন্ট ব্যবহার করে সিন ভিউয়ার চালু করুন (শুধুমাত্র এআর মোডের জন্য)

সিন ভিউয়ারের এআর মোডটি গুগল প্লে সার্ভিসেস ফর এআর দ্বারা চালিত।

সিন ভিউয়ারে এআর (AR) উপলব্ধ আছে কিনা তা নিশ্চিত করতে, আপনি কোনো ওয়েবসাইট বা নেটিভ অ্যান্ড্রয়েড অ্যাপ থেকে একটি সুস্পষ্ট অ্যান্ড্রয়েড ইন্টেন্ট ব্যবহার করে com.google.ar.core package মাধ্যমে সিন ভিউয়ার চালু করতে পারেন এবং একটি browser_fallback_url প্রদান করতে পারেন। এইভাবে, আপনি নিশ্চিত করতে পারেন যে সমস্ত ব্যবহারকারী হয় সিন ভিউয়ারের মাধ্যমে একটি নেটিভ এআর অভিজ্ঞতা পাবেন, অথবা আপনার নিজের তৈরি করা একটি ফলব্যাক অভিজ্ঞতা পাবেন। উদাহরণস্বরূপ, আপনি আপনার নিজস্ব ৩ডি ভিউয়ার বা একটি মার্জিত ত্রুটি বার্তার মতো ফলব্যাক অভিজ্ঞতা তৈরি করতে পারেন।

HTML থেকে সুস্পষ্ট অভিপ্রায় (explicit intent) সক্রিয় করতে, নিম্নলিখিত সিনট্যাক্সটি ব্যবহার করুন:

<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>;

জাভা থেকে এক্সপ্লিসিট ইনটেন্ট ট্রিগার করতে, নিম্নলিখিত কোডটি ব্যবহার করুন:

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 (HTML-ভিত্তিক ইন্টেন্টের জন্য আবশ্যক)	একটি বৈধ URL	এটি শুধুমাত্র ওয়েব-ভিত্তিক বাস্তবায়নের জন্য সমর্থিত। যখন ডিভাইসে Google Play Services for AR উপস্থিত থাকে না বা হালনাগাদ করা থাকে না, তখন এটি এই URL-টিতে নেভিগেট করে।
mode (ঐচ্ছিক)	ar_only	সিন ভিউয়ার সর্বদা 3D মডেলটিকে একটি নেটিভ AR ভিউতে চালু করে এবং সিন ভিউয়ার 3D ভিউয়ারে স্যুইচ করার জন্য যেকোনো UI লুকিয়ে রাখে। যদি Google Play Services for AR উপস্থিত না থাকে, তাহলে Scene Viewer ওয়েব-ভিত্তিক অভিজ্ঞতার জন্য browser_fallback_url এ আপনার সেট করা URL-টি চালু করে। অ্যাপ-ভিত্তিক অভিজ্ঞতার ক্ষেত্রে, Scene Viewer একটি বিকল্প অভিজ্ঞতায় ফিরে যায়, যেমন একটি ত্রুটির বার্তা বা আপনার নিজের তৈরি করা অন্য কোনো অভিজ্ঞতা।
	ar_preferred	সিন ভিউয়ার এন্ট্রি মোড হিসেবে এআর নেটিভ মোডে চালু হয় এবং ব্যবহারকারীদের ' ভিউ ইন ইওর স্পেস' ও 'ভিউ ইন থ্রিডি' বাটনগুলোর মাধ্যমে এআর এবং থ্রিডি মোডের মধ্যে পরিবর্তন করার সুযোগ দেয়। যদি Google Play Services for AR উপস্থিত না থাকে, তাহলে Scene Viewer ওয়েব-ভিত্তিক অভিজ্ঞতার জন্য browser_fallback_url এ আপনার সেট করা URL-টি চালু করে। অ্যাপ-ভিত্তিক অভিজ্ঞতার ক্ষেত্রে, Scene Viewer একটি বিকল্প অভিজ্ঞতায় ফিরে যায়, যেমন একটি ত্রুটির বার্তা বা আপনার নিজের তৈরি করা অন্য কোনো অভিজ্ঞতা।
link (ঐচ্ছিক)	একটি বৈধ URL	একটি বাহ্যিক ওয়েবপেজের ইউআরএল। যদি এটি উপস্থিত থাকে, তাহলে ইউজার ইন্টারফেসে একটি বাটন প্রদর্শিত হবে, যেটি ক্লিক করলে এই ইউআরএল-টিতে নিয়ে যাবে। সংস্করণ ১.১-এ সিন ভিউয়ারে intent:// লিঙ্কের জন্য সমর্থন যোগ করা হয়েছে, যাতে সিন ভিউয়ারের ভিজিট বাটনটি সরাসরি অন্যান্য অ্যাপে ট্রিগার করতে পারে। উল্লেখ্য যে, এটি সতর্কতার সাথে ব্যবহার করা উচিত এবং শুধুমাত্র তখনই নির্দিষ্ট করা উচিত যখন প্রদত্ত ইন্টেন্টের জন্য একটি ইন্টেন্ট হ্যান্ডলারের উপস্থিতি নিশ্চিত থাকে।
title (ঐচ্ছিক)	বৈধ স্ট্রিং	মডেলটির জন্য একটি নাম। যদি থাকে, তবে তা UI-তে প্রদর্শিত হবে। নামটি ৬০ অক্ষরের পর ডট ডট (তিনটি বিন্দু) দিয়ে সংক্ষিপ্ত করা হবে। সংস্করণ ১.১-এ টাইটেল কন্টেন্টের এইচটিএমএল স্টাইলিং-এর সুবিধা যোগ করা হয়েছে, যেখানে যথেচ্ছ পরিমাণ টেক্সট ব্যবহার করা যাবে। উল্লেখ্য যে, টাইটেলটি অবশ্যই ইউআরএল-এসকেপড হতে হবে।
sound (ঐচ্ছিক)	একটি বৈধ URL	একটি লুপিং অডিও ট্র্যাকের ইউআরএল, যা একটি glTF ফাইলে এমবেড করা প্রথম অ্যানিমেশনের সাথে সিঙ্ক্রোনাইজ করা থাকে। এটি অবশ্যই একই দৈর্ঘ্যের অ্যানিমেশনসহ একটি glTF ফাইলের সাথে প্রদান করতে হবে। যদি এটি উপস্থিত থাকে, তবে মডেলটি লোড হওয়ার পর শব্দটি লুপ হতে থাকে।
resizable (ঐচ্ছিক)	true (ডিফল্ট) false	যখন এটি false এ সেট করা হয়, তখন ব্যবহারকারীরা AR অভিজ্ঞতায় মডেলটি স্কেল করতে পারবেন না। 3D অভিজ্ঞতায় স্কেলিং স্বাভাবিকভাবে কাজ করে।
disable_occlusion (ঐচ্ছিক)	false (ডিফল্ট) true	যখন এটি ' true তে সেট করা হয়, তখন দৃশ্যে রাখা বস্তুগুলি সর্বদা দৃশ্যের বাস্তব বস্তুগুলির সামনে প্রদর্শিত হয়। আরও তথ্যের জন্য [Enable occlusion](/ar/develop/depth#enable_occlusion) দেখুন।

ইউএক্স নির্দেশনা

ব্যবহারকারীদের সর্বোত্তম ইউএক্স (UX) প্রদানের জন্য, আমরা এই নির্দেশিকাগুলো অনুসরণ করার পরামর্শ দিই।

• AR অভিজ্ঞতার ক্ষেত্রে, দৃশ্যমান কল টু অ্যাকশনটি এমন হওয়া উচিত যা ব্যবহারকারীকে বোঝাবে যে তিনি একটি ইমারসিভ পরিবেশে প্রবেশ করতে চলেছেন। আমরা আপনাকে ‘ View in your space’ কল টু অ্যাকশনটি ব্যবহার করার পরামর্শ দিই:
  

• এমনটা হতে পারে যে ব্যবহারকারীদের ডিভাইসে গুগল প্লে সার্ভিসেস ফর এআর (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-সমর্থিত অ্যান্ড্রয়েড ডিভাইসে দেখলে, ar অ্যাট্রিবিউটসহ <model-viewer> কম্পোনেন্টযুক্ত একটি ওয়েবসাইট নিম্নলিখিত উদাহরণে দেখানো বোতামের মতো একটি বোতাম প্রদর্শন করে।

ar-modes যখন scene-viewer মোড ব্যবহার করা হয় , তখন এটি একটি নেটিভ এআর ভিউতে চলে যায় এবং ব্যবহারকারীকে সিন ভিউয়ার ব্যবহার করে তাদের পরিবেশে মডেলটি স্থাপন করার জন্য আমন্ত্রণ জানায়।

যদি গুগল প্লে সার্ভিসেস উইথ এআর (Google Play Services with AR) উপস্থিত না থাকে, তাহলে এই বাটনটিতে ট্যাপ করলে <model-viewer> এর ৩ডি ভিউয়ারে মডেলটি প্রদর্শিত হয়।

<model-viewer> দিয়ে কীভাবে কাজ শুরু করবেন সে সম্পর্কে আরও তথ্যের জন্য <model-viewer> ডকুমেন্টেশন দেখুন ।

মডেলের জন্য ফাইলের প্রয়োজনীয়তা

মডেলের জন্য সিন ভিউয়ারে নিম্নলিখিত সমর্থন ও সীমাবদ্ধতা রয়েছে।

ফাইল ফরম্যাট সমর্থন	glTF 2.0/ glb , এই এক্সটেনশনগুলি ব্যবহার করে: KHR_materials_unlit KHR_texture_transform
অ্যানিমেশন	লুপিং কঙ্কাল অ্যানিমেশন লুপিং রিজিড অ্যানিমেশন লুপিং ট্রান্সফর্ম অ্যানিমেশন অ্যানিমেশনটি লুপ আকারে চলতে থাকবে। যদি glTF ফাইলটিতে একাধিক অ্যানিমেশন থাকে, তাহলে সিন ভিউয়ার শুধুমাত্র প্রথম অ্যানিমেশনটিই চালাবে।
সুপারিশকৃত সীমা	অ্যাসেটের সামগ্রিক পারফরম্যান্স নির্ভর করে সীমাবদ্ধতা নির্ধারণ এবং ভার্টেক্স, ম্যাটেরিয়াল, টেক্সচার রেজোলিউশন, প্রতি ম্যাটেরিয়ালে মেশের সংখ্যা ও অন্যান্য বিষয়ের মধ্যে সমন্বয় সাধনের উপর। আপনার অ্যাসেট অপ্টিমাইজ করতে নিম্নলিখিত নির্দেশিকাগুলো ব্যবহার করুন। ট্রায়াঙ্গেলের সংখ্যা: প্রস্তাবিত সীমা হলো ১,০০,০০০ ট্রায়াঙ্গেল, কিন্তু সর্বনিম্ন সংখ্যাকে লক্ষ্য করলে সিন ভিউয়ারে উচ্চ পারফরম্যান্স বজায় থাকবে। ৩০,০০০ থেকে ৫০,০০০ একটি আদর্শ পরিসর। উপকরণের সংখ্যা: প্রস্তাবিত সীমা হলো ১০টি উপকরণ, যার মধ্যে দুটি আলফা হতে পারে। অ্যাসেটটির পারফরম্যান্স ভালো রাখতে সর্বনিম্ন সম্ভাব্য সংখ্যাটি লক্ষ্য করুন। প্রতি উপাদানে মেশের সংখ্যা: ১ সর্বোচ্চ টেক্সচার রেজোলিউশন: ২০৪৮ × ২০৪৮ হাড় (ওজনবিহীন অস্থিসন্ধি সহ): ২৫৪ (সর্বোচ্চ সীমা) প্রতিটি ভার্টেক্সে অস্থির ওজনের সীমা: ৪ (চূড়ান্ত সীমা) UV: প্রতি মেশে ১টি UV (সর্বোচ্চ সীমা) মডেলের আকার: ১০ এমবি (এর চেয়ে বড় মডেল ব্যবহারকারীর জন্য অস্বস্তিকর হতে পারে।)
ছায়া সমর্থন	কোনো অবজেক্ট স্থাপন করার সময় সিন ভিউয়ার স্বয়ংক্রিয়ভাবে হার্ড শ্যাডো রেন্ডার করে, তাই আমরা আপনার মডেলে শ্যাডো বেক না করার পরামর্শ দিই।
টেক্সচার সমর্থন	পিএনজি ফরম্যাট: পিএনজি-২৪, ইনডেক্সড পিএনজি-৮। স্বচ্ছতা না থাকলে JPG ফাইল বেশি পছন্দনীয়, কারণ এতে ফাইলের আকার কমে যায়। রঙের পরিসর: sRGB
উপাদান	পিবিআর
ফাইল লোড হচ্ছে	HTTPS
দৃশ্য	অক্ষ: ডান-হাতি, এবং এর নিম্নলিখিত বৈশিষ্ট্যগুলো রয়েছে: +X সঠিক +Y উপরে আছে -Z মূলবিন্দু থেকে সামনের দিকে নির্দেশ করে (অন্য কথায়, একটি সম্পদের "সামনে" +Z এর দিকে মুখ করে থাকা উচিত) স্কেল: ১ ইউনিট = ১ মিটার (glTF স্পেসিফিকেশন অনুযায়ী, যা মডেলটিকে AR-এ সঠিক স্কেলে স্থাপন করা নিশ্চিত করে)

আপনার 3D মডেলগুলো যাচাই করতে প্রিভিউয়ার টুল ব্যবহার করুন

আপনার 3D মডেল ফাইলটি সিন ভিউয়ারে সঠিকভাবে প্রদর্শিত হবে কিনা তা নিশ্চিত করতে, আমাদের অনলাইন প্রিভিউয়ার টুল ব্যবহার করে আপনার পিসিতে ফাইলগুলো যাচাই করুন।

আপনার 3D মডেল যাচাইকরণ

একটি মডেল যাচাই করার জন্য, প্রিভিউয়ার টুলটির একটি glb বা glTF ফাইল, এর সাথে সম্পর্কিত যেকোনো ইমেজ ও বিন ফাইল এবং একটি ঐচ্ছিক অডিও ফাইলের প্রয়োজন হয়। অডিও ফাইলটি অ্যানিমেশন ০-এর সাথে সাথে লুপ হতে থাকবে।

আপনি আলাদা আলাদা ফাইল নির্বাচন করতে পারেন, অথবা চাইলে glb বা glTF ফাইল এবং এর সাথে যুক্ত ফাইলগুলোকে একটি zip ফাইলে রাখতে পারেন। (zip ফাইল পদ্ধতিটি অডিও ফাইল সমর্থন করে না।)

আপনার 3D মডেল যাচাই করতে:

1. ব্রাউজারে অনলাইন প্রিভিউয়ার টুলটি খুলুন।

2. প্রিভিউয়ার টুলে ফাইলগুলো যোগ করতে এই পদ্ধতিগুলোর মধ্যে যেকোনো একটি ব্যবহার করুন:

   • ড্র্যাগ অ্যান্ড ড্রপ করুন । একটি glb বা glTF ফাইল এবং এর সাথে যুক্ত সমস্ত ফাইল (অথবা এই ফাইলগুলো ধারণকারী একটি জিপ ফাইল) নির্বাচন করুন এবং নির্বাচিত ফাইল বা জিপ ফাইলটিকে প্রিভিউয়ার টুলে ড্র্যাগ করুন।

   • প্রিভিউয়ার টুল থেকে । প্রিভিউয়ার টুলে, সিন ভিউয়ার > লোড ফাইল (Scene Viewer > Load File ) নির্বাচন করুন। একটি glb বা glTF ফাইল এবং এর সাথে সম্পর্কিত সমস্ত ফাইল (অথবা এই ফাইলগুলি ধারণকারী একটি জিপ ফাইল) নির্বাচন করুন এবং ওপেন (Open ) ক্লিক করুন।

প্রিভিউয়ার টুলে আপনার থ্রিডি মডেলের ফাইলগুলো লোড করার পর, ব্রাউজারের নিচের একটি কনসোলে যেকোনো ত্রুটির বার্তাসহ ফলাফলগুলো প্রদর্শিত হয়।

যাচাইকরণের জন্য 3D মডেল যোগ করা হচ্ছে

একটি 3D মডেল যাচাই করতে, 3D মডেলটি তৈরি করা ফাইলগুলো আমাদের মডেল এডিটর টুলে যোগ করুন।

একটি মডেল যাচাই করার জন্য, প্রিভিউয়ারের মডেলটির glb বা glTF ফাইল, এর সাথে যুক্ত যেকোনো ইমেজ ও bin ফাইল এবং একটি ঐচ্ছিক অডিও ফাইলের প্রয়োজন হয়। আপনি আলাদা আলাদা একাধিক ফাইল নির্বাচন করতে পারেন অথবা একটিমাত্র zip ফাইল যোগ করতে পারেন।

একটি জিপ ফাইল যোগ করার সময়, প্রিভিউয়ারটি প্রথম যে glb বা glTF ফাইলটি খুঁজে পায়, সেটির পাশাপাশি সেই জিপ ফাইলের মধ্যে থাকা সংশ্লিষ্ট ইমেজ এবং বিন ফাইলগুলোও লোড করে।

1. ব্রাউজারে মডেল এডিটর টুলটি খুলুন।

2. প্রিভিউয়ার টুলে ফাইলগুলো যোগ করতে এই পদ্ধতিগুলোর মধ্যে যেকোনো একটি ব্যবহার করুন:

   • যাচাইকরণের জন্য ফাইল ড্র্যাগ ও ড্রপ করতে, glb বা glTF ফাইল এবং এর সাথে যুক্ত ফাইলগুলো (অথবা এই ফাইলগুলো সম্বলিত একটি জিপ ফাইল) একসাথে নির্বাচন করুন এবং সেটিকে প্রিভিউয়ার টুলে টেনে আনুন।

   • প্রিভিউয়ার টুল থেকে ফাইল নির্বাচন করুন । প্রিভিউয়ার টুলে, সিন ভিউয়ার > লোড ফাইল (Scene Viewer > Load File ) বেছে নিন। glb বা glTF ফাইল এবং এর সাথে যুক্ত সমস্ত ফাইল (অথবা এই ফাইলগুলো সম্বলিত একটি জিপ ফাইল) একসাথে নির্বাচন করুন এবং ওপেন (Open ) ক্লিক করুন।

বৈধতা ত্রুটি

ত্রুটি কোড	তীব্রতা	বার্তা	বর্তমান সমর্থিত মান
INVALID_INPUT_FILE_EXTENSION	ত্রুটি	ইনপুট ফাইল [filename]-এর ফাইল এক্সটেনশনটি ভ্যালিডেটর দ্বারা সমর্থিত নয়।	['.glb', '.gltf']
REC_INPUT_BINARY_SIZE_EXCEEDED	সতর্কতা	প্রদত্ত ব্যবহারকারী ইনপুটের বাইনারি আকার সিন ভিউয়ার স্পেসিফিকেশন দ্বারা প্রস্তাবিত সীমা অতিক্রম করে, যা হলো [size] MB।	১০
MAX_INPUT_BINARY_SIZE_EXCEEDED	ত্রুটি	প্রদত্ত ব্যবহারকারী ইনপুটের বাইনারি আকার সিন ভিউয়ার স্পেসিফিকেশন দ্বারা সমর্থিত সর্বোচ্চ সীমা অতিক্রম করে, যার সর্বোচ্চ আকার সীমা হলো [size] MB।	১৫
UNSUPPORTED_GLTF_EXTENSION_USED	ত্রুটি	glTF ফাইলের [ext] এক্সটেনশনটি Scene Viewer স্পেসিফিকেশন দ্বারা সমর্থিত নয়।	['KHR_materials_pbrSpecularGlossiness', 'KHR_materials_unlit', 'KHR_texture_transform']
ANIMATION_LIMIT_EXCEEDED	ত্রুটি	glTF-এ অ্যানিমেশনের সংখ্যা সিন ভিউয়ার স্পেসিফিকেশন দ্বারা সমর্থিত সীমা অতিক্রম করেছে, যা সর্বোচ্চ [num] টি অ্যানিমেশন।	১
MORPH_TARGET_USED	ত্রুটি	glTF-টিতে একটি মर्फ টার্গেট রয়েছে, যা সিন ভিউয়ার স্পেসিফিকেশন দ্বারা সমর্থিত নয়।
MATERIAL_LIMIT_EXCEEDED	সতর্কতা	glTF-এ থাকা উপাদানের সংখ্যা সিন ভিউয়ার স্পেসিফিকেশন দ্বারা প্রস্তাবিত সীমা অতিক্রম করেছে, যার সর্বোচ্চ সীমা হলো [num] টি উপাদান।	১০
TEXTURE_RESOLUTION_LIMIT_EXCEEDED	সতর্কতা	glTF-এর [idx] ইন্ডেক্সে থাকা ছবিটির রেজোলিউশন সিন ভিউয়ার স্পেসিফিকেশন দ্বারা প্রস্তাবিত সীমা অতিক্রম করেছে, যার সর্বোচ্চ রেজোলিউশন হলো [res] x [res]।	২০৪৮ x ২০৪৮
UV_LIMIT_EXCEEDED	ত্রুটি	glTF-এ প্রতি মেশে UV-এর সংখ্যা সিন ভিউয়ার স্পেসিফিকেশন দ্বারা সমর্থিত সীমা অতিক্রম করে, যা প্রতি মেশে সর্বোচ্চ [num]টি UV।	১
VERTEX_COLOR_USED	ত্রুটি	glTF-এ একটি ভার্টেক্স কালার থাকে, যা সিন ভিউয়ার স্পেসিফিকেশন দ্বারা সমর্থিত নয়।
JOINT_LIMIT_EXCEEDED	ত্রুটি	glTF-এ জয়েন্টের সংখ্যা সিন ভিউয়ার স্পেসিফিকেশন দ্বারা সমর্থিত সীমা অতিক্রম করেছে, যার সর্বোচ্চ সীমা হলো [num] টি জয়েন্ট।	২৫৪
TRIANGLE_LIMIT_EXCEEDED	সতর্কতা	glTF-এ থাকা ত্রিভুজের সংখ্যা সিন ভিউয়ার স্পেসিফিকেশন দ্বারা প্রস্তাবিত সীমা অতিক্রম করেছে, যা হলো সর্বোচ্চ [num] টি ত্রিভুজ।	১০০,০০০
PRIMITIVE_MODE_UNSUPPORTED	ত্রুটি	প্রিমিটিভ মোড [mode] সিন ভিউয়ার স্পেসিফিকেশন দ্বারা সমর্থিত নয়।	{৪ : ত্রিভুজ তালিকা, ৫ : ত্রিভুজ স্ট্রিপ, ৬ : ত্রিভুজ ফ্যান}
MISSING_PBR_METALLIC_ROUGHNESS	তথ্য	[idx] ইনডেক্সে থাকা মেটেরিয়ালটিতে pbrMetallicRoughness প্রপার্টিটি নেই। সিন ভিউয়ার স্পেসিফিকেশন অনুযায়ী এটির প্রয়োজন হয় না, যদি এর পরিবর্তে মেটালিক এবং রাফনেস ফ্যাক্টর ব্যবহার করা হয়। যদি এগুলোর কোনোটিই ব্যবহার করা না হয়, তাহলে মেটেরিয়ালটি ডিফল্ট মান ব্যবহার করবে, যা অনাকাঙ্ক্ষিত আচরণের কারণ হতে পারে।