Jetpack XR-এর জন্য ARCore দিয়ে অ্যাঙ্কর তৈরি করুন

প্রযোজ্য এক্সআর ডিভাইস

এই নির্দেশিকা আপনাকে এই ধরনের এক্সআর ডিভাইসগুলির জন্য অভিজ্ঞতা তৈরি করতে সাহায্য করে।

এক্সআর ডিভাইসের প্রকারভেদ সম্পর্কে জানুন →

এক্সআর ডিভাইসের প্রকারভেদ সম্পর্কে জানুন →

অ্যাঙ্কর বাস্তব জগতে একটি নির্দিষ্ট অবস্থান ও অভিমুখ নির্দেশ করে। কোনো বস্তুকে অ্যাঙ্করের সাথে সংযুক্ত করলে তা বাস্তব জগতে বাস্তবসম্মতভাবে স্থাপিত বলে মনে হয়।

একটি সেশনে প্রবেশ করুন

একটি ARCore for Jetpack XR Session মাধ্যমে অ্যাঙ্কর তৈরি করুন। আপনি যদি Jetpack Compose for XR ব্যবহার করে স্পেশিয়াল UI উন্নত করেন, তাহলে Jetpack Compose for XR থেকে একটি সেশন অ্যাক্সেস করুন । আপনি যদি Jetpack SceneCore লাইব্রেরি থেকে স্পেশিয়ালাইজড এনটিটি নিয়ে কাজ করেন, তাহলে Jetpack XR Runtime থেকে একটি সেশন অ্যাক্সেস করুন ।

সেশনটি কনফিগার করুন

অ্যাঙ্কর তৈরি এবং লোড করার জন্য সেশন কনফিগার করার প্রয়োজন হয় না। তবে, XR সেশনে অ্যাঙ্কর পার্সিস্টেন্স ডিফল্টরূপে সক্রিয় থাকে না। লোকাল স্টোরেজ থেকে অ্যাঙ্কর পার্সিস্ট এবং লোড করতে, সেশনটি কনফিগার করুন এবং AnchorPersistenceMode.LOCAL মোড সেট করুন:

val newConfig = session.config.copy(
    anchorPersistence = AnchorPersistenceMode.LOCAL,
)
when (val result = session.configure(newConfig)) {
    is SessionConfigureSuccess -> TODO(/* Success! */)
    else ->
        TODO(/* The session could not be configured. See SessionConfigureResult for possible causes. */)
}
Anchors.kt

বিষয়বস্তুকে স্থানের একটি নির্দিষ্ট অবস্থানে স্থির করুন

একটি Pose ব্যবহার করে অ্যাঙ্কর তৈরি করা হয়, যা কোনো বিদ্যমান Anchorable এর সাপেক্ষে বা ছাড়া ব্যাখ্যা করা যেতে পারে। Anchorable হলো এমন একটি Trackable যাতে অ্যাঙ্কর সংযুক্ত করা যায়।

একটি অ্যাঙ্করেবলের সাপেক্ষে একটি অ্যাঙ্কর তৈরি করুন

যখন কোনো Anchorable (যেমন একটি Plane এর সাপেক্ষে একটি অ্যাঙ্কর তৈরি করা হয়, তখন অ্যাঙ্করটি সংযুক্ত Anchorable স্থান পরিবর্তনের সাথে সাথে সেটিকে অনুসরণ করে।

when (val result = anchorable.createAnchor(pose)) {
    is AnchorCreateSuccess -> { /* anchor stored in `result.anchor`. */ }
    else -> { /* handle failure */ }
}
Anchors.kt

অ্যাঙ্করেবল ছাড়া অ্যাঙ্কর তৈরি করুন

এমন একটি অ্যাঙ্কর তৈরি করতে যা কোনো Anchorable সাথে সংযুক্ত নয়:

when (val result = Anchor.create(session, pose)) {
    is AnchorCreateSuccess -> { /* anchor stored in `result.anchor`. */ }
    else -> { /* handle failure */ }
}
Anchors.kt

একটি এনটিটিকে একটি অ্যাঙ্করের সাথে সংযুক্ত করুন

এই অবস্থানে একটি মডেল রেন্ডার করতে, একটি GltfModel তৈরি করুন এবং এর প্যারেন্টকে একটি AnchorEntity তে সেট করুন।

AnchorEntity.create(session, anchor).apply {
    parent = session.scene.activitySpace
    addChild(entity)
}
Anchors.kt

ট্র্যাকিং অবস্থা বুঝুন

প্রতিটি Trackable একটি TrackingState থাকে যা ব্যবহার করার আগে যাচাই করে নেওয়া উচিত। যে Trackable TrackableState ' Tracking থাকে, সিস্টেম তার Pose সক্রিয়ভাবে আপডেট করে। একটি ' Paused ' Trackable ভবিষ্যতে Tracking হতে পারে, কিন্তু যেটি Stopped সেটি কখনোই Tracking হবে না।

সেশন জুড়ে একটি অ্যাঙ্কর বজায় রাখুন

যে অ্যাঙ্করটি পারসিস্ট করা হয় না, সেটি একটি সেশন শেষ হয়ে যাওয়ার পর অদৃশ্য হয়ে যায়। একটি অ্যাঙ্কর পারসিস্ট করার মাধ্যমে, আপনার অ্যাপ তার নিজস্ব অ্যাপ ডেটাতে সেই অ্যাঙ্করটির অবস্থান মনে রাখে। এই অ্যাঙ্করটি পরবর্তী সেশনে পুনরুদ্ধার করা যায় এবং এটি ওয়ার্ল্ডের একই অবস্থানে অ্যাঙ্কর করা থাকে।

একটি অ্যাঙ্করকে স্থায়ী করতে, এখানে দেখানো অনুযায়ী Anchor.persist() ব্যবহার করুন:

val uuid = anchor.persist()
AnchorPersistence.kt

আপনার অ্যাপ ভবিষ্যতের কোনো সেশনে UUID ব্যবহার করে অ্যাঙ্করটি পুনরুদ্ধার করতে পারবে:

when (val result = Anchor.load(session, uuid)) {
    is AnchorCreateSuccess -> {
        // Loading was successful. The anchor is stored in result.anchor.
    }
    else -> {
        // handle failure
    }
}
AnchorPersistence.kt

যখন আপনার কোনো অ্যাঙ্করের আর প্রয়োজন হবে না, তখন unpersist() কল করুন। এটি আপনার অ্যাপের স্টোরেজ থেকে অ্যাঙ্করটি সরিয়ে দেয় এবং Anchor.load() কল করার ক্ষেত্রে প্রদত্ত UUID-টিকে পুনরুদ্ধার-অযোগ্য করে তোলে।

Anchor.unpersist(session, uuid)
AnchorPersistence.kt

আপনার অ্যাপ সেইসব সংরক্ষিত অ্যাঙ্করের একটি তালিকাও অনুরোধ করতে পারে যেগুলো এখনও আপনার অ্যাপের স্টোরেজে বিদ্যমান আছে:

val uuids = Anchor.getPersistedAnchorUuids(session)
AnchorPersistence.kt