XR রানটাইম

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

XR রানটাইমের উপর নির্ভরতা যোগ করতে, আপনার প্রোজেক্টে Google Maven রিপোজিটরি যোগ করতে হবে। আরও তথ্যের জন্য Google এর Maven রিপোজিটরি পড়ুন।

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

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha07"

    // Optional dependencies for asynchronous conversions
    implementation "androidx.xr.runtime:runtime-guava:1.0.0-alpha07"
    implementation "androidx.xr.runtime:runtime-rxjava3:1.0.0-alpha07"

    // Use in environments that do not support OpenXR
    testImplementation "androidx.xr.runtime:runtime-testing:1.0.0-alpha07"
}

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha07")

    // Optional dependencies for asynchronous conversions
    implementation("androidx.xr.runtime:runtime-guava:1.0.0-alpha07")
    implementation("androidx.xr.runtime:runtime-rxjava3:1.0.0-alpha07")

    // Use in environments that do not support OpenXR
    testImplementation("androidx.xr.runtime:runtime-testing:1.0.0-alpha07")
}

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

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

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

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

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

সংস্করণ 1.0

সংস্করণ 1.0.0-alpha07

২২ অক্টোবর, ২০২৫

androidx.xr.runtime:runtime-*:1.0.0-alpha07 প্রকাশিত হয়েছে। সংস্করণ 1.0.0-alpha07-এ এই কমিটগুলি রয়েছে।

API পরিবর্তনগুলি

• SessionConfigureConfigureNotSupported মুছে ফেলুন এবং এটিকে UnsupportedOperationException দিয়ে প্রতিস্থাপন করুন। ( I7680f )

সংস্করণ 1.0.0-alpha06

২৪ সেপ্টেম্বর, ২০২৫

androidx.xr.runtime:runtime-*:1.0.0-alpha06 প্রকাশিত হয়েছে। সংস্করণ 1.0.0-alpha06-এ এই কমিটগুলি রয়েছে।

API পরিবর্তনগুলি

• HandJointType xr:arcore:arcore xr:runtime:runtime arcore:arcore এ সরানো হয়েছে। ( Iadb9c , b/409058039 )
• Vector2 , Vector3 , Vector4 জন্য componentWiseMultiplication এর টাইমস অপারেটরকে স্কেলে পরিবর্তন করা এবং অন্যান্য গণিত লাইব্রেরির সাথে সামঞ্জস্যের জন্য অপারেটর প্রতীকটি সরিয়ে ফেলা। এছাড়াও Vector.scale(otherVector.inverse()) ব্যবহারের পরিবর্তে Vector ক্লাস থেকে componentWiseDivision অপসারণ করা হচ্ছে। ( I8e1f6 , b/399146447 )
• এক স্কেল বিশিষ্ট একটি ম্যাট্রিক্স ফেরত দিতে [unscaled] যোগ করা হচ্ছে। ( I6381d , b/434928658 )
• :xr:runtime:runtime-guava মুছে ফেলা হবে কারণ Coroutines.kt এর পরিবর্তে SuspendtoFutureAdapter ব্যবহার করা হয়েছে। ( I0cd3c , b/406597902 )

সংস্করণ 1.0.0-alpha05

৩০ জুলাই, ২০২৫

androidx.xr.runtime:runtime-*:1.0.0-alpha05 প্রকাশিত হয়েছে। সংস্করণ 1.0.0-alpha05-এ এই কমিটগুলি রয়েছে।

নতুন বৈশিষ্ট্য

• HandJointType এবং TrackingState যোগ করুন। ( I55880 , b/334645808 )
• কনফিগ বাস্তবায়ন সর্বজনীন করুন। ( I95860 , b/334645808 )
• নতুন SessionCreateResult এবং SessionConfigureResult প্রকারগুলি চালু করা হয়েছে। ( Icb8cb , b/334645808 )
• একটি নতুন BoundingBox ক্লাস যোগ করুন যা 3D স্পেসে একটি অক্ষ-সারিবদ্ধ বাউন্ডিং বক্স উপস্থাপন করে, যা তার সর্বনিম্ন এবং সর্বোচ্চ কোণার বিন্দু দ্বারা সংজ্ঞায়িত। ( Ic68c5 , b/423073468 )

API পরিবর্তনগুলি

• androidx.xr.scenecore.PixelDimensions নাম পরিবর্তন করে androidx.xr.runtime.math.IntSize2d করা হয়েছে। androidx.xr.scenecore.Dimensions এর নাম পরিবর্তন করে androidx.xr.runtime.math.FloatSize3d করা হয়েছে। androidx.xr.scenecore.PlaneType এর নাম পরিবর্তন করে androidx.xr.scenecore.PlaneOrientation করা হয়েছে। androidx.xr.scenecore.PlaneSemantic নাম পরিবর্তন করে androidx.xr.scenecore.PlaneSemanticType করা হয়েছে। ( Ifd405 , b/416456228 )
• androidx.xr.runtime.FoV ক্লাসটি সরানো হয়েছে। পরিবর্তে androidx.xr.runtime.FieldOfView ব্যবহার করুন। ( I9ae27 )
• Session.create জন্য একটি অতিরিক্ত ওভারলোড যোগ করা হয়েছে যা Session-এর সাথে সংযুক্ত করার জন্য একটি LifecycleOwner প্রদান করতে পারে। মনে রাখবেন যে রিসোর্স মালিকানার জন্য এখনও একটি Activity প্রদান করতে হবে এবং LifecycleOwner Activity-এর মধ্যে অন্তর্ভুক্ত করতে হবে। ( I1690b )
• FakeRuntimeAnchor.anchorsCreated নাম পরিবর্তন করে anchorsCreatedCount ( I96df9 , b/424441218 )
• কনফিগ *Mode ভ্যালগুলিকে তাদের আচরণ প্রতিফলিত করার জন্য পুনঃনামকরণ করা হয়েছে। ( I6d247 , b/414648065 )
• Kotlin 2.0 দিয়ে মুক্তিপ্রাপ্ত প্রকল্পগুলির জন্য KGP 2.0.0 বা তার নতুন সংস্করণ ব্যবহার করা প্রয়োজন ( Idb6b5 , b/344563182 )
• ম্যানিফেস্ট স্ট্রিং সম্পর্কিত API গুলি :xr:runtime:runtime থেকে :xr:runtime:runtime-manifest এ স্থানান্তরিত হয়েছে। প্যাকেজের নাম androidx.xr.runtime থেকে androidx.xr.runtime.manifest এ পরিবর্তিত হয়েছে। ( I610ad , b/418800249 )
• Session.resume() , Session.pause() , এবং Session.destroy() API সারফেস থেকে সরানো হয়েছে। Session আর LifecycleOwner নয়। Session এর জীবনচক্র এখন Session.create() এ পাস করা Activity এর জীবনচক্রের সাথে সংযুক্ত থাকবে। ( I28a03 )
• এই লাইব্রেরিটি এখন JSpecify nullness annotations ব্যবহার করে, যা টাইপ-ব্যবহারের। সঠিক ব্যবহার জোরদার করার জন্য Kotlin ডেভেলপারদের নিম্নলিখিত কম্পাইলার আর্গুমেন্ট ব্যবহার করা উচিত: -Xjspecify-annotations=strict (এটি Kotlin কম্পাইলারের 2.1.0 সংস্করণ থেকে শুরু করে ডিফল্ট) ( Ia8420 , b/326456246 )
• প্রধান রানটাইম আর্টিফ্যাক্ট ( :xr:runtime:runtime ) তে শুধুমাত্র Kolin-স্টাইলের অ্যাসিঙ্ক API থাকবে। জাভা ডেভেলপাররা সামঞ্জস্যপূর্ণ API অ্যাক্সেস করার জন্য :xr:runtime:runtime-guava এর উপর নির্ভর করতে পারেন। ( I05d4a , b/426639315 )
• প্রধান রানটাইম আর্টিফ্যাক্ট ( :xr:runtime:runtime ) তে শুধুমাত্র Kotlin-স্টাইলের অ্যাসিঙ্ক API থাকবে। জাভা ডেভেলপাররা সামঞ্জস্যপূর্ণ API অ্যাক্সেস করার জন্য xr:runtime:runtime-rxjava3 লাইব্রেরির উপর নির্ভর করতে পারে। ( I64122 , b/426639775 )
• Coroutines কে :xr:runtime:runtime-guava এবং Flows কে :xr:runtime:runtime-rxjava3 সরান। ( I60ae9 )
• Session.create এবং Session.configure এখন SecurityException থ্রো করে যখন পর্যাপ্ত অনুমতি মঞ্জুর করা না হয় SessionCreatePermissionsNotGranted বা SessionConfigurePermissionsNotGranted ফেরত দেওয়ার পরিবর্তে। ( I7c488 , b/430651879 )

সংস্করণ 1.0.0-alpha04

৭ মে, ২০২৫

androidx.xr.runtime:runtime:1.0.0-alpha04 , androidx.xr.runtime:runtime-openxr:1.0.0-alpha04 , এবং androidx.xr.runtime:runtime-testing:1.0.0-alpha04 প্রকাশিত হয়েছে। সংস্করণ 1.0.0-alpha04-এ এই কমিটগুলি রয়েছে।

নতুন বৈশিষ্ট্য

• বিদ্যমান অ্যান্ড্রয়েড লাইফসাইকেল প্যারাডিজমের সাথে আরও আন্তঃকার্যক্ষমতার জন্য সেশন এখন androidx.lifecycle.LifecycleOwner প্রয়োগ করে।
• Android XR-এর জন্য ম্যানিফেস্ট স্ট্রিংগুলি এখানে নির্দিষ্ট এবং নথিভুক্ত করা হয়েছে।
• দৃশ্যের বিষয়বস্তু ব্যবহারকারীর দৃশ্যক্ষেত্রের ভিতরে বা বাইরে সরে গেলে তা পর্যবেক্ষণের জন্য স্থানিক দৃশ্যমানতা কলব্যাক এক্সটেনশন পদ্ধতি যোগ করা হয়েছে।
• JxrPlatformAdapter (এবং এর সাথে সম্পর্কিত সমস্ত ক্লাস) এর একটি অসম্পূর্ণ সংস্করণ যোগ করা হয়েছে।
• SceneCore এ Session-এর পরিবর্তে SceneCore এবং Runtime উভয় ক্ষেত্রেই Session ব্যবহার করা হবে।
• ActivityPose.hitTest যোগ করা হয়েছে, যা ভার্চুয়াল কন্টেন্টের বিরুদ্ধে একটি hitTest সক্ষম করে।
• কম্পাইলের সময় একাধিক রানটাইম বাস্তবায়ন নির্দিষ্ট করা এখন সমর্থিত। বর্তমান ডিভাইসের বৈশিষ্ট্য সেটের উপর ভিত্তি করে কার্যকর করার সময় শুধুমাত্র একটি লোড করা হবে।
• নতুন কম্পোনেন্ট টাইপ SpatialPointerComponent যোগ করা হয়েছে, যা ক্লায়েন্টদের পয়েন্টারের জন্য রেন্ডার করা আইকন নির্দিষ্ট করতে বা আইকনটি নিষ্ক্রিয় করতে দেয়। এই কম্পোনেন্টটি বর্তমানে শুধুমাত্র PanelEntity ইনস্ট্যান্সের সাথে সংযুক্ত করা যেতে পারে।

API পরিবর্তনগুলি

• কনফিগ বাস্তবায়ন সর্বজনীন করুন। ( I95860 )
• HandJointType এবং TrackingState যোগ করুন। ( I55880 )
• Kotlin 2.0 দিয়ে মুক্তিপ্রাপ্ত প্রকল্পগুলির জন্য KGP 2.0.0 বা তার নতুন সংস্করণ ব্যবহার করা প্রয়োজন ( Idb6b5 )
• Hand.isActive (boolean) Hand.trackingState এ পরিবর্তন করা হয়েছে। OpenXR বাস্তবায়ন সেই অনুযায়ী পরিবর্তন করা হয়েছে।
• Session.configure এ android.permission.SCENE_UNDERSTANDING অনুমতির প্রয়োজনীয়তা পরিবর্তন করে android.permission.SCENE_UNDERSTANDING_COARSE করা হয়েছে।
• LifecycleManager.configure বাস্তবায়িত হয়েছে এবং এখন এটি একটি Config অবজেক্টে পাস করে যেখানে প্রতিটি কনফিগারযোগ্য রানটাইম বৈশিষ্ট্যের জন্য একটি বৈশিষ্ট্য থাকে।
• উপলব্ধ রানটাইম বৈশিষ্ট্যগুলি কনফিগার করার জন্য এখন Session.configure একটি Config দিয়ে কল করা যেতে পারে।
• Session.create এখন CoroutineDispatcher এর পরিবর্তে CoroutineContext পাস করা সমর্থন করে।
• Session.create Jetpack XR এবং/অথবা SceneCore এর জন্য ARCore লোড করা সমর্থন করে। কমপক্ষে একটি প্রদান করতে হবে (পরীক্ষামূলক সংস্করণ উপলব্ধ)।
• যখন একটি অবৈধ UUID Anchor.load এবং Anchor.unpersist এ পাস করা হয় তখন FakePerceptionManager একটি AnchorInvalidUuidException ফেলে দেয়।
• CoreState আর কোনও ডেটা ক্লাস নয়।

বাগ ফিক্স

• স্থির রানটাইম প্রোগার্ড কনফিগারেশন।

সংস্করণ 1.0.0-alpha03

২৬ ফেব্রুয়ারী, ২০২৫

androidx.xr.runtime:runtime:1.0.0-alpha03 , androidx.xr.runtime:runtime-openxr:1.0.0-alpha03 , এবং androidx.xr.runtime:runtime-testing:1.0.0-alpha03 প্রকাশিত হয়েছে, শেষ আলফার পর থেকে কোনও উল্লেখযোগ্য পরিবর্তন হয়নি। সংস্করণ 1.0.0-alpha03-এ এই কমিটগুলি রয়েছে।

সংস্করণ 1.0.0-alpha02

১২ ফেব্রুয়ারী, ২০২৫

androidx.xr.runtime:runtime:1.0.0-alpha02 , androidx.xr.runtime:runtime-openxr:1.0.0-alpha02 , এবং androidx.xr.runtime:runtime-testing:1.0.0-alpha02 প্রকাশিত হয়েছে। সংস্করণ 1.0.0-alpha02-এ এই কমিটগুলি রয়েছে।

ভঙ্গুরতা এবং আচরণগত পরিবর্তন

• OpenXR রানটাইম ফাংশন যা একটি Anchor ফেরত দেয় এখন AnchorResourcesExhaustedException নিক্ষেপ করে যদি তারা একটি ত্রুটি কোডের সম্মুখীন হয় যা OpenXR রিসোর্স সীমায় পৌঁছেছে তা জানিয়ে দেয়।
• Session.create এবং Session.resume জন্য এখন android.permission.HAND_TRACKING অনুমতি প্রয়োজন।

নতুন বৈশিষ্ট্য

• হাত ট্র্যাকিং সমর্থন যোগ করা হয়েছে।

বাগ সংশোধন

• এমুলেটরে চালানোর সময় অ্যাঙ্কর তৈরি করা আরও স্থিতিশীল।

সংস্করণ 1.0.0-alpha01

১২ ডিসেম্বর, ২০২৪

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

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

Jetpack XR Runtime এর প্রাথমিক প্রকাশ। এই লাইব্রেরিতে Jetpack XR লাইব্রেরির স্যুটের জন্য মৌলিক কার্যকারিতা রয়েছে। এর মধ্যে রয়েছে ক্ষমতা আবিষ্কার, জীবনচক্র ব্যবস্থাপনা, কনফিগারেশন এবং আরও অনেক কিছু। রানটাইম লাইব্রেরি এক্সিকিউশন প্ল্যাটফর্মের উপর নির্ভর করে বিভিন্ন বৈচিত্র্য (যেমন runtime-openxr বা runtime-testing ) প্রদান করে। অতিরিক্তভাবে, এই লাইব্রেরিটি Vector3 এবং Matrix4 এর মতো মৌলিক গণিত বিমূর্ততা প্রদান করে যা সমগ্র Jetpack XR API পৃষ্ঠ জুড়ে ব্যবহৃত হয়।

• Session : আপনাকে XR সিস্টেমের উপর সূক্ষ্ম নিয়ন্ত্রণ প্রদান করে, যার মধ্যে রয়েছে কখন প্রক্রিয়াকরণ কার্যকর করা হবে এবং কখন করা হবে না তা নির্ধারণ করা এবং সামগ্রিক কনফিগারেশন। এটি এমন একটি হ্যান্ডেল যা আপনি অন্যান্য সমস্ত API তে অন্তর্নিহিত সিস্টেম ক্ষমতাগুলি আনলক করতে ব্যবহার করবেন।

• Pose : একটি নির্বিচারে স্থানাঙ্ক ব্যবস্থার একটি অবস্থান যার সাথে একটি অবস্থান এবং ওরিয়েন্টেশন যুক্ত থাকে। আপনি এই ক্লাসটি Jetpack XR এবং Jetpack SceneCore-এর জন্য ARCore-এর সাথে বস্তুর অবস্থান যোগাযোগ করতে ব্যবহার করবেন।

জ্ঞাত সমস্যা

• configure বর্তমানে একটি নো-অপশন। ভবিষ্যতের রিলিজগুলিতে নতুন সেটিংস যুক্ত হবে যা আপনি Session এর আচরণ নিয়ন্ত্রণ করতে ব্যবহার করতে পারবেন।