Jetpack XR-এর জন্য ARCore

Jetpack XR-এর জন্য ARCore

ব্যবহারকারীর নির্দেশিকা

API রেফারেন্স
androidx.xr.arcore

উপলব্ধি ক্ষমতার সাথে বাস্তব জগতে ডিজিটাল সামগ্রী আনুন।

সর্বশেষ আপডেট	স্থিতিশীল রিলিজ	প্রার্থী মুক্তি	বিটা রিলিজ	আলফা রিলিজ
ডিসেম্বর 12, 2024	-	-	-	1.0.0-আলফা01

নির্ভরতা ঘোষণা করা

Jetpack XR-এর জন্য ARCore-এর উপর নির্ভরতা যোগ করতে, আপনাকে অবশ্যই আপনার প্রোজেক্টে Google Maven সংগ্রহস্থল যোগ করতে হবে। আরও তথ্যের জন্য Google এর Maven সংগ্রহস্থল পড়ুন।

আপনার অ্যাপ বা মডিউলের জন্য build.gradle ফাইলে আপনার প্রয়োজনীয় আর্টিফ্যাক্টগুলির জন্য নির্ভরতা যোগ করুন:

গ্রোভি

dependencies {
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha01"
}

কোটলিন

dependencies {
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha01")
}

নির্ভরতা সম্পর্কে আরও তথ্যের জন্য, বিল্ড নির্ভরতা যুক্ত করুন দেখুন।

প্রতিক্রিয়া

আপনার প্রতিক্রিয়া জেটপ্যাককে আরও ভাল করতে সাহায্য করে। আপনি যদি নতুন সমস্যা আবিষ্কার করেন বা এই লাইব্রেরির উন্নতির জন্য ধারনা পান তাহলে আমাদের জানান। আপনি একটি নতুন তৈরি করার আগে অনুগ্রহ করে এই লাইব্রেরিতে বিদ্যমান সমস্যাগুলি দেখুন৷ আপনি তারকা বোতামে ক্লিক করে একটি বিদ্যমান সমস্যায় আপনার ভোট যোগ করতে পারেন।

একটি নতুন সমস্যা তৈরি করুন

আরও তথ্যের জন্য ইস্যু ট্র্যাকার ডকুমেন্টেশন দেখুন।

সংস্করণ 1.0

সংস্করণ 1.0.0-alpha01

ডিসেম্বর 12, 2024

androidx.xr.arcore:arcore-* 1.0.0-alpha01 প্রকাশিত হয়েছে।

প্রাথমিক প্রকাশের বৈশিষ্ট্য

বিদ্যমান ARCore লাইব্রেরি দ্বারা অনুপ্রাণিত হয়ে, জেটপ্যাক XR লাইব্রেরির জন্য ARCore বাস্তব বিশ্বের সাথে ডিজিটাল বিষয়বস্তু মিশ্রিত করার ক্ষমতা প্রদান করে। এই লাইব্রেরিতে মোশন ট্র্যাকিং, ক্রমাগত নোঙ্গর, হিট টেস্টিং, এবং শব্দার্থিক লেবেলিং সহ সমতল সনাক্তকরণ রয়েছে (উদাহরণস্বরূপ, মেঝে, দেয়াল এবং ট্যাবলেটপস)। Jetpack XR-এর জন্য ARCore-এর সাথে কাজ করার বিষয়ে আরও জানতে বিকাশকারী নির্দেশিকা দেখুন।

• Session : জেটপ্যাক XR-এর জন্য ARCore এর কার্যকারিতা পাওয়ার জন্য Jetpack XR রানটাইম ব্যবহার করে। Jetpack XR API-এর জন্য বেশিরভাগ ARCore-এর সাথে ইন্টারঅ্যাক্ট করতে আপনি একটি সেশন ব্যবহার করবেন, তাই অনুগ্রহ করে এর ডকুমেন্টেশন দেখুন।

• Plane : আপনার চারপাশের বিশ্ব বুঝতে প্লেন ব্যবহার করুন। প্রতিটি প্লেনে একটি Label থাকে যা এটিকে শব্দার্থকভাবে বর্ণনা করে। আপনি সর্বশেষ সনাক্ত করা প্লেন সম্পর্কে অবহিত হওয়ার জন্য subscribe ব্যবহার করতে পারেন বা একটি নির্দিষ্ট বিমানের পরিবর্তনগুলি সম্পর্কে অবহিত হওয়ার জন্য state অবহিত করতে পারেন।

• Anchor : একটি ভার্চুয়াল বস্তু এবং একটি বাস্তব বিশ্বের অবস্থানের মধ্যে একটি লিঙ্ক। অ্যাঙ্করগুলি স্থানের একটি নির্দিষ্ট স্থানে সংযুক্ত করা যেতে পারে ( create ব্যবহার করে) বা একটি Trackable ( createAnchor ব্যবহার করে)।

  • অ্যাঙ্করগুলি সেশন জুড়ে পুনরায় ব্যবহার করা যেতে পারে। আপনি তাদের সংরক্ষণ করতে persist ব্যবহার করতে পারেন, তাদের গণনা করতে এবং সেগুলি পুনরুদ্ধার করার জন্য load getPersistedAnchorUuids । সেগুলি আর ব্যবহারে না থাকলে নিশ্চিত করুন যে আপনি সেগুলিকে unpersist ৷

  • Jetpack XR এবং Jetpack SceneCore-এর জন্য ARCore-এর মধ্যে অ্যাঙ্করগুলি আন্তঃঅপারেবল। আপনি একটি অ্যাঙ্কর ব্যবহার করে একটি AnchorEntity তৈরি করতে পারেন বা, আপনার যদি একটি বিদ্যমান AnchorEntity থাকে, তাহলে আপনি এটির ব্যাকিং অ্যাঙ্কর পুনরুদ্ধার করতে getAnchor ব্যবহার করতে পারেন।

  • hitTest ব্যবহার করে স্বাভাবিক ব্যবহারকারীর মিথস্ক্রিয়া অফার করুন। একটি হিটটেস্ট কোন বিষয়বস্তুকে ছেদ করে তা নির্ধারণ করতে এবং সেই অবস্থান থেকে একটি Anchor তৈরি করতে একটি Ray ব্যবহার করে। একটি InputEvent থেকে একটি হিটটেস্ট পরিচালনা করার কথা বিবেচনা করুন৷

পরিচিত সমস্যা

• getPersistedAnchorUuids দ্বারা প্রত্যাবর্তিত ফলাফল থেকে unpersist কল করা এবং এর UUID সরানোর মধ্যে বিলম্ব হতে পারে।

• নতুন নোঙ্গর ফেরত দেওয়ার জন্য সিস্টেমে যথেষ্ট সংস্থান আছে কিনা তা যাচাই create না। অতিরিক্ত পরিমাণে অ্যাঙ্কর তৈরি করলে ক্র্যাশ হতে পারে।

• একটি অ্যাঙ্করকে স্থির রাখা যা পূর্বে স্থির ছিল এবং অবিরত ছিল বর্তমানে সমর্থিত নয়৷

• এমুলেটরে ব্যবহার সমর্থিত, তবে আচরণটি প্রকৃত ডিভাইসে চলার মতো স্থিতিশীল নাও হতে পারে। বিশেষত, create করতে কলগুলি একটি নেটিভ কোড ত্রুটির সাথে ব্যর্থ হতে পারে এবং অবিলম্বে কার্যকলাপটি বন্ধ করে দিতে পারে৷

• নির্দিষ্ট পরিস্থিতিতে, একটি RuntimeException ভুলভাবে ছুড়ে দেওয়া হতে পারে যখন "অ্যাঙ্কর ছিল না" বার্তা সহ কলিং persist । সেই পরিস্থিতিতে, ফাংশনটি এখনও সফল হবে এবং অ্যাঙ্করটি অব্যাহত থাকবে। আমরা একটি ওয়ার্কঅ্যারাউন্ড হিসাবে একটি try ব্লক দিয়ে persist জন্য কলটি মোড়ানোর সুপারিশ করি৷