জেটপ্যাক সিনকোর
| সর্বশেষ আপডেট | স্থিতিশীল রিলিজ | রিলিজ প্রার্থী | বিটা রিলিজ | আলফা রিলিজ |
|---|---|---|---|---|
| ১৭ জুন, ২০২৬ | - | - | - | ১.০.০-আলফা১৬ |
নির্ভরতা ঘোষণা করা
XR SceneCore-এর উপর নির্ভরতা যোগ করতে হলে, আপনাকে আপনার প্রজেক্টে Google Maven রিপোজিটরিটি যুক্ত করতে হবে। আরও তথ্যের জন্য Google-এর Maven রিপোজিটরিটি পড়ুন।
আপনার অ্যাপ বা মডিউলের build.gradle ফাইলে প্রয়োজনীয় আর্টিফ্যাক্টগুলোর ডিপেন্ডেন্সি যোগ করুন:
গ্রোভি
dependencies { implementation "androidx.xr.scenecore:scenecore:1.0.0-alpha16" // Use to write unit tests testImplementation "androidx.xr.scenecore:scenecore-testing:1.0.0-alpha16" }
কোটলিন
dependencies { implementation("androidx.xr.scenecore:scenecore:1.0.0-alpha16") // Use to write unit tests testImplementation("androidx.xr.scenecore:scenecore-testing:1.0.0-alpha16") }
নির্ভরতা সম্পর্কে আরও তথ্যের জন্য, 'বিল্ড নির্ভরতা যোগ করুন ' দেখুন।
প্রতিক্রিয়া
আপনার মতামত জেটপ্যাককে আরও উন্নত করতে সাহায্য করে। আপনি যদি নতুন কোনো সমস্যা খুঁজে পান অথবা এই লাইব্রেরিটি উন্নত করার জন্য কোনো ধারণা থাকে, তবে আমাদের জানান। নতুন কোনো সমস্যা তৈরি করার আগে অনুগ্রহ করে এই লাইব্রেরির বিদ্যমান সমস্যাগুলো দেখে নিন। আপনি তারকা বোতামে ক্লিক করে কোনো বিদ্যমান সমস্যায় আপনার ভোট যোগ করতে পারেন।
আরও তথ্যের জন্য ইস্যু ট্র্যাকার ডকুমেন্টেশন দেখুন।
সংস্করণ ১.০
সংস্করণ 1.0.0-alpha16
১৭ জুন, ২০২৬
androidx.xr.scenecore:scenecore-*:1.0.0-alpha16 প্রকাশিত হয়েছে। সংস্করণ 1.0.0-alpha16-এ এই কমিটগুলো অন্তর্ভুক্ত রয়েছে।
এপিআই পরিবর্তন
-
CustomMesh.BuilderFromMeshDataএবংCustomMesh.BuilderFromMeshBufferএaddVertexData,setIndexData, এবংaddSubsetজন্য ওভারলোড যোগ করা হয়েছে। এই ওভারলোডগুলি ডেভেলপারদের ByteBufferRegion বাByteBufferRegionমতো মধ্যবর্তী অবজেক্টে মোড়ানোর প্রয়োজন ছাড়াই সরাসরি কাঁচা ডেটা এবংMeshSubset(যেমন,ByteBuffer,offset,size,topology,indexOffset,indexCount) পাস করার সুযোগ দেয়। ( I84d5c ) -
Scene.requestFullSpaceMode()এবংScene.requestHomeSpaceMode()এর নাম পরিবর্তন করে যথাক্রমেrequestFullSpace()এবংrequestHomeSpace()রাখা হয়েছে। "হোম স্পেস মোড" এবং "ফুল স্পেস মোড" সম্পর্কিত অন্যান্য মেথড এবং ডকুমেন্টেশনও একইভাবে আপডেট করা হয়েছে। ( I45751 ) -
PanelEntityTesterএবংMainPanelEntityTester( I961e4 ) পাবলিক টেস্ট এপিআই প্রদান করে -
SoundEffectPoolComponentএpointSourceParamsপ্রপার্টি যোগ করা ( I4a750 ) - পাবলিক টেস্ট এপিআই
MovableComponentTester( I0c972 ) প্রদান করে - পাবলিক টেস্ট এপিআই প্রদান করে
PointerCaptureComponentTester( Ic0d4f ) - পাবলিক টেস্ট এপিআই
ActivityPanelEntityTester( I837c4 ) প্রদান করে - পাবলিক টেস্ট এপিআই
ResizableComponentTester( I0a3a4 ) প্রদান করে - পাবলিক টেস্ট এপিআই
BoundsComponentTester.( Iefd53 ) - পাবলিক টেস্ট এপিআই
SpatialMediaPlayerTester( Ia3e09 ) প্রদান করে - পাবলিক টেস্ট এপিআই
SpatialEnvironmentTester( Icf60f ) প্রদান করে - পাবলিক টেস্ট এপিআই
GltfModelTesterএবংSceneCoreTestRule.getGltfModelTesterপ্রদান করে। ( I33fcb ) - পাবলিক টেস্ট এপিআই
InteractableComponentTesterপ্রদান করে। ( Ia7096 ) - পাবলিক টেস্ট এপিআই
SurfaceEntityTesterপ্রদান করে। ( Ic0740 ) - পাবলিক টেস্ট এপিআই
GltfModelEntityTester,TestGltfModelNodeএবংTestGltfAnimationপ্রদান করে। ( I72c4d ) - পাবলিক টেস্ট এপিআই
SceneTesterএবংSceneCoreTestRule.sceneTesterপ্রদান করে। ( Ib4ec5 ) - পাবলিক টেস্ট এপিআই
PerceptionSpaceTesterএবংSceneCoreTestRule.perceptionSpaceTesterপ্রদান করে। ( Icf739 ) - পাবলিক টেস্ট এপিআই
MeshEntityTesterপ্রদান করে। ( I63801 ) -
ImageBasedLightingAssetTesterএবংSceneCoreTestRule.getTesterনামক পাবলিক টেস্ট এপিআই ওভারলোড প্রদান করে। ( I57ec4 ) - পাবলিক টেস্ট এপিআই
TextureTester( Ia865b ) প্রদান করে - পাবলিক টেস্ট এপিআই
PositionalAudioComponentTester( Icd96e ) প্রদান করে - পাবলিক টেস্ট এপিআই
SpatialSoundPoolTester( Ia3531 ) প্রদান করে - পাবলিক টেস্ট এপিআই
SoundEffectPoolTester( If349a ) প্রদান করে - পাবলিক টেস্ট এপিআই
ActivitySpaceTesterএবংSceneCoreTestRule.activitySpaceTesterপ্রদান করে। ( I2d5c2 ) - পাবলিক টেস্ট এপিআই
SpatialWindowTester( I41837 ) প্রদান করে - পাবলিক টেস্ট এপিআই
AnchorEntityTester( I68404 ) প্রদান করে - পাবলিক টেস্ট এপিআই ইন্টারফেস
SceneCoreTestRuleপ্রদান করে। ( Ic72d3 ) -
ActivitySpaceএ সঠিক ভৌত মাত্রা ম্যাপিংয়ের জন্য হার্ডওয়্যার-ভিত্তিক পিক্সেল-প্রতি-মিটার অনুপাত প্রদান করতেPixelDensityক্লাস যোগ করা হয়েছে এবং এটিকেScene#virtualPixelDensityএর মাধ্যমে উন্মুক্ত করা হয়েছে। ( I0e3ac ) - কাস্টম মেশ তৈরি এবং রেন্ডার করার জন্য পাবলিক এপিআই যোগ করা হয়েছে। ( I7ad2f )
-
VertexLayoutAPI-কেVertexBufferLayoutএর একটি তালিকা ব্যবহার করার জন্য আপডেট করা হয়েছে, যেখানে প্রতিটিVertexBufferLayoutএকটি একক ভার্টেক্স বাফারের মধ্যে থাকা অ্যাট্রিবিউটগুলো বর্ণনা করে। এটি আরও নমনীয় ভার্টেক্স ডেটা বিন্যাসের সুযোগ দেয়, যার মধ্যে কাস্টম স্ট্রাইড এবং অফসেট সহ ইন্টারলিভড অ্যাট্রিবিউটও অন্তর্ভুক্ত। ( Ic426b ) - একটি ARCore Trackable-কে Activity Space-এর সাপেক্ষে একটি পোজে রূপান্তর করার জন্য
MovableComponent.createTrackingMovableপ্রদান করে। ( I12249 ) -
Entity.createএ parent-এর ডিফল্ট মান null-এ আপডেট করা হয়েছে। ( Ic3145 ) -
Entityইন্টারফেসের পরিবর্তে একটি ক্লাস হিসেবে আপডেট করা হয়েছে এবং এটি এখন সকল Entity টাইপের বেস ক্লাস। এই পরিবর্তনের অংশ হিসেবেBaseEntityসরিয়ে দেওয়া হয়েছে। ( I7fbc9 ) -
GltfModel,ExrImage, এবংImageBasedLightingAssetএখনAutoCloseableইমপ্লিমেন্ট করে, যা কোটলিনেরuseব্লক ব্যবহার করে প্রচলিত রিসোর্স ম্যানেজমেন্টের সুযোগ দেয়। ( I1ac79 ) - স্থানিক পরিবেশের আলো সংজ্ঞায়িত করার জন্য
ExrImageপরিবর্তেImageBasedLightingAssetক্লাসটি চালু করা হয়েছে।ExrImageঅপ্রচলিত ঘোষণা করা হয়েছে এবং পাবলিক API থেকে সরিয়ে ফেলা হয়েছে।SpatialEnvironmentPreferenceImageBasedLightingAssetব্যবহার করার জন্য আপডেট করা হয়েছে। ( I6c92a ) - এর উদ্দেশ্যকে আরও ভালোভাবে প্রতিফলিত করার জন্য
SpatialEnvironmentএরskyboxপ্যারামিটারটির নাম পরিবর্তন করেimageBasedLightingAssetরাখা হয়েছে, এবং স্পষ্ট করা হয়েছে যে ভিজ্যুয়াল স্কাইবক্স টেক্সচারগুলো geometry প্যারামিটারের অন্তর্ভুক্ত করতে হবে। ( I24d4a ) - স্পেশাল এপিআই লেভেল ১ এবং ২-এ, স্পেশাল এনটিটিগুলো এখন পিক্সেল-টু-মিটার গণনার জন্য একটি স্থিতিশীল ডিভাইস ডেনসিটি ব্যবহার করে, যা সিস্টেম ডিসপ্লে ডেনসিটির পরিবর্তন নির্বিশেষে সামঞ্জস্যপূর্ণ আকার নিশ্চিত করে। ( I37051 )
সংস্করণ 1.0.0-alpha15
১৯ মে, ২০২৬
androidx.xr.scenecore:scenecore-*:1.0.0-alpha15 প্রকাশিত হয়েছে। সংস্করণ 1.0.0-alpha15-এ এই কমিটগুলো অন্তর্ভুক্ত রয়েছে।
এপিআই পরিবর্তন
-
Entity.dispose()এখন পাবলিক এপিআই হিসেবে সরিয়ে ফেলা হয়েছে। Entity ইনস্ট্যান্সগুলিতেdispose()কল করার পরিবর্তে, অ্যাপগুলিparentnullসেট করে এবং সেই ইনস্ট্যান্সগুলির সমস্ত strong reference মুছে দিয়ে ইনস্ট্যান্সগুলিকে cleanable করতে পারে। ( I396c9 ) -
SoundEffectPoolএরset/clearOnLoadCompleteListenerমেথডগুলো মুছে ফেলা হয়েছে। এর পরিবর্তেadd/removeLoadCompleteListenerব্যবহার করুন। ( Iae78d ) - Scene-এর
set/clearSpatialVisibilityChangedListeneradd/removeSpatialVisibilityChangedListenerদ্বারা প্রতিস্থাপন করা হয়েছে। ( I67dff ) - SceneCore-এর সমস্ত
add/removeOnFooListenerমেথডের নাম থেকেOnঅংশটি বাদ দিয়ে সেগুলোর নাম পরিবর্তন করেadd/removeFooListenerরাখা হয়েছে। ( Ibe50b ) - একাধিক একযোগে লিসেনারকে সমর্থন করার জন্য,
AnchorEntity.setOnOriginChangedListenerএবংAnchorEntity.setOnStateChangedListenerমেথডগুলোকেadd/removeFooListenerমেথড দ্বারা প্রতিস্থাপন করা হয়েছে। ( I13749 ) -
AnchorEntity.State.TIMEDOUTনাম পরিবর্তন করেState.TIMED_OUTরাখা হয়েছে। ( Id2b8d ) - উন্নত সুরক্ষা এবং প্রসারণযোগ্যতার জন্য কম্পোনেন্ট এপিআই (Component API) রিফ্যাক্টর করা হয়েছে।
Componentএখন একটি অ্যাবস্ট্রাক্ট ক্লাস। সরাসরি কল প্রতিরোধ করার জন্যonAttach()এবংonDetach()মেথডগুলো এখনprotected। কম্পোনেন্টের লাইফসাইকেল পরিচালনা করতে অনুগ্রহ করেEntity.addComponent()এবংEntity.removeComponent()ব্যবহার করুন। ( Id04e8 ) - SceneCore-এর
PlaneSemanticTypePlaneOrientationকনস্ট্যান্টগুলোকে Int থেকে কাস্টম টাইপে স্থানান্তরিত করা হয়েছে। এদেরANYকনস্ট্যান্টগুলো সরিয়ে ফেলা হবে, ক্লায়েন্টদের পরিবর্তে তাদের প্রয়োজনীয় সমস্ত কনস্ট্যান্ট স্পষ্টভাবে তালিকাভুক্ত করতে হবে, অথবা নতুন.ALLঅপরিবর্তনীয় Set কনস্ট্যান্টগুলো ব্যবহার করতে হবে।AnchorEntityফ্যাক্টরি মেথডটি এখন একটিমাত্র মানের পরিবর্তে এই টাইপগুলোর একটি Set গ্রহণ করে। ( Ib1033 ) - পরীক্ষামূলক কাস্টম মেশ এপিআই-তে স্কেলিটাল অ্যানিমেশন (স্কিনিং)-এর জন্য সমর্থন যোগ করা হয়েছে। ডেভেলপাররা এখন একটি
MeshEntityতৈরি করার সময়boneCountনির্দিষ্ট করে এবংMeshEntity.setBoneTransforms()ব্যবহার করে রিয়েল-টাইমে অ্যানিমেশন আপডেট করার মাধ্যমে কাস্টম মেশ অ্যানিমেট করতে পারবেন। ( Id8ba2 , b/496692490 ) - পরীক্ষামূলক
CustomMeshAPI চালু করা হয়েছে। ডেভেলপাররা এখনCustomMesh,MeshBuffer, এবংMeshEntityব্যবহার করে তাদের সিনে প্রোগ্রাম্যাটিকভাবে 3D জ্যামিতি তৈরি এবং রেন্ডার করতে পারবেন। ( I94617 ) -
androidx.xr.scenecore.SpatializerConstants.SourceType.SOURCE_TYPE_SOUND_FIELDসরিয়ে ফেলা হয়েছে। এর পরিবর্তেSourceType.SOUND_FIELDব্যবহার করুন। ( Ia68b9 ) - স্পেশিয়াল অডিও কম্পোনেন্ট যোগ করা:
PositionalAudioComponent,SoundEffectPoolComponentএবংSoundFieldAudioComponent( Ieda89 ) -
AnchorEntity.getAnchorAnchorEntity.anchorদ্বারা প্রতিস্থাপন করা হয়েছে এবং এখন থেকে যখনAnchorEntityএকটি ARCoreAnchorথেকে তৈরি করা হবে, তখন এটি একটিAnchorরিটার্ন করবে ( I5c7c8 )। -
ActivityPanelEntity,GltfModelEntity,GroupEntity,PanelEntity, এবংSurfaceEntityফ্যাক্টরি মেথডগুলিতেparentপ্যারামিটারের ডিফল্ট মানActivitySpaceথেকেnullএ পরিবর্তন করা হয়েছে। কোনো এনটিটিকে সিন গ্রাফে সংযুক্ত করতে এবং সেটিকে দৃশ্যমান করতে, ডেভেলপারদের এখন ইনস্ট্যানসিয়েশনের সময় অথবাEntity.parent = ...এর মাধ্যমে এর parent স্পষ্টভাবে সেট করতে হবে। ( Ie7cc1 )
বাগ সংশোধন
-
SceneCoreএখনEntityইনস্ট্যান্সগুলোকে ফ্যান্টম রিচেবল হয়ে গেলে স্বয়ংক্রিয়ভাবে রিক্লেইম করে, ফলে রিসোর্স মুক্ত করার জন্য ডেভেলপারদের আর স্পষ্টভাবেdispose()কল করার প্রয়োজন হয় না। একটি [Entity] ইনস্ট্যান্স সঠিকভাবে রিক্লেইম করা হয়েছে কিনা তা নিশ্চিত করতে, ডেভেলপারদের যা করা উচিত:- এর
parentnullসেট করে এটিকে সিন গ্রাফ থেকে বিচ্ছিন্ন করুন। - তাদের কোড থেকে ইনস্ট্যান্সটির সকল শক্তিশালী উল্লেখ পরিত্যাগ করুন।
- বিশেষ এনটিটি টাইপ সম্পর্কে দ্রষ্টব্য: যে সমস্ত এনটিটির প্যারেন্ট তৈরি করা যায় না (যেমন
AnchorEntity), সেগুলোর ইনস্ট্যান্স ব্যবহারের সময় ডেভেলপারদের অবশ্যই একটি স্ট্রং রেফারেন্স বজায় রাখতে হবে। যদি সমস্ত রেফারেন্স রিলিজ করে দেওয়া হয়, তাহলে এই ইনস্ট্যান্সগুলো ফ্যান্টম রিচেবল হয়ে যাবে এবং স্বয়ংক্রিয়ভাবে রিক্লেইম হয়ে যাবে। ( I83fe4 )
- এর
- সকল
SceneCoreলাইব্রেরির জন্য Proguard কিপ নিয়ম সংকুচিত করা হয়েছে। ( I98447 )
পরিচিত সমস্যা
- একটি নিষ্ক্রিয়
ExoPlayerইনস্ট্যান্স সহ কোনোEntityতেPositionalAudioComponentসংযুক্ত করলে ক্র্যাশ হবে। ExoPlayer বন্ধ থাকা অবস্থায়setPointSourceParamsকল করবেন না অথবা স্পেশিয়াল অডিও কম্পোনেন্টগুলো সংযুক্ত বা বিচ্ছিন্ন করবেন না। পরবর্তী রিলিজে এটি ঠিক করা হবে।
সংস্করণ 1.0.0-alpha14
০৬ মে, ২০২৬
androidx.xr.scenecore:scenecore-*:1.0.0-alpha14 প্রকাশিত হয়েছে। সংস্করণ 1.0.0-alpha14-এ এই কমিটগুলো অন্তর্ভুক্ত রয়েছে।
এপিআই পরিবর্তন
-
TrackingStateএবংVpsAvailabilityResultকেandroidx.xr.arcore packageস্থানান্তর করা হয়েছে, এবংandroidx.xr.runtimeএর টাইপগুলো এখন ডেপ্রিকেটেড। ( Ic7930 , b/480462213 ) -
Plane.Typeএর নাম পরিবর্তন করেPlaneTypeরাখা হয়েছে। ( I8c90c , b/482675376 ) -
Plane.Labelনাম পরিবর্তন করেPlaneLabelরাখা হয়েছে। ( Ic6b67 , b/482675376 ) -
androidx.xr.runtime.FieldOfViewঅপ্রচলিত হয়ে গেছে। এর পরিবর্তেandroidx.xr.runtime.math.FieldOfViewব্যবহার করুন। ( Ia01a0 , b/480233045 ) -
Matrix4.poseনাম পরিবর্তন করেMatrix4.toPose()রাখা হয়েছে। pose প্রপার্টিটি এখন অপ্রচলিত। ( I329b4 , b/493383490 ) -
HandJointTypeenum মানগুলির নাম পরিবর্তন করা হয়েছে। ( Ifbc83 , b/482670596 ) - কাস্টম
Componentইমপ্লিমেন্টেশনের সুযোগ দিতেComponent.onAttachএবংonDetachপাবলিক এপিআই হিসেবে উন্মুক্ত করুন। ( I0ca1f ) - স্থানিক অডিও উপাদান যোগ করা হচ্ছে ( I39ddd , b/489421980 , b/436642086 , b/436642499 )
-
PointSourceParamsথেকে Entity সরিয়ে ফেলা হয়েছে। এর পরিবর্তে Entity সরাসরিSpatialAudioTrack,SpatialSoundPool, এবংSpatialMediaPlayerসাথে ব্যবহৃত হবে ( Ib3685 , b/489421980 , b/436634048 )। -
DeviceTrackingMode.LAST_KNOWNএর নাম পরিবর্তন করেSPATIAL_LAST_KNOWNরাখা হয়েছে (একটি অপ্রচলিত ফলব্যাক সহ), 3DoF ট্র্যাকিংয়ের জন্যINERTIAL_LAST_KNOWNযোগ করা হয়েছে, এবংTrackingStateএTRACKING_DEGRADEDযোগ করা হয়েছে। ( Ie661c , b/445466590 ) -
GroupEntityএখন আর ব্যবহার করা হয় না। শুধুমাত্র বেস Entity-এর কার্যকারিতাসহ একটি Entity পেতে,Entity.createকল করুন, যা একটি Entity ইন্টারফেস রিটার্ন করবে। ( I4c450 , b/473867483 ) -
XrLogAPI যোগ করা হয়েছে। JetpackXR-এ লগিং চালু করতেXrLog.isEnabledtrueতে সেট করুন, এবং লগ লেভেল নির্ধারণ করতেXrLog.Levelব্যবহার করুন। ( I76a1f , b/463460895 , b/487378441 )
বাগ সংশোধন
-
Scene.keyEntityএখন ডিফল্টভাবেmainPanelEntityহবে। ( I6a3ef )
সংস্করণ 1.0.0-alpha13
২৫ মার্চ, ২০২৬
androidx.xr.scenecore:scenecore-*:1.0.0-alpha13 প্রকাশিত হয়েছে। সংস্করণ 1.0.0-alpha13-এ এই কমিটগুলো অন্তর্ভুক্ত রয়েছে।
এপিআই পরিবর্তন
-
Session.createথেকেunscaledGravityAlignedActivitySpaceফ্ল্যাগটি সরানো হয়েছে।ActivitySpaceএখন সর্বদা আনস্কেলড এবং গ্র্যাভিটি-অ্যালাইনড থাকবে। ( If6f11 , b/458173423 ) -
GltfModelEntityথেকে অপ্রচলিতsetMaterialOverrideএবংclearMaterialOverrideফাংশনগুলো সরিয়ে ফেলা হয়েছে, যেগুলো এখন স্বতন্ত্রGltfModelNodeওপর কল করা হয়। ( I2e5d2 ) -
PanelEntityতেtransformPixelCoordinatesToLocalPositionএবংtransformNormalizedCoordinatesToLocalPositionযোগ করা হয়েছে এবং সমতুল্য পরীক্ষামূলক পদ্ধতিগুলো সরিয়ে ফেলা হয়েছে যেগুলো আগেVector3পজিশনের পরিবর্তে পোজ রিটার্ন করত। ( Ib6960 , b/460123106 , b/458333591 ) -
SceneCoreএ glTF অ্যানিমেশন নিয়ন্ত্রণের জন্যGltfAnimationAPI যোগ করা হয়েছে। ( I2c172 , b/466065486 , b/465819070 , b/465818617 ) -
ScenePose.activitySpacePoseনাম পরিবর্তন করেScenePose.poseInActivitySpaceরাখা হয়েছে ( I8f175 , b/427822261 ) - Scenecore প্রজেক্টেড রানটাইম ইমপ্লিমেন্টেশন যোগ করা হয়েছে ( I9c4ab , b/476440158 )
- প্রধান প্যানেল এনটিটির আকার পরিবর্তন করার সময়, এটি
ActivitySpaceমূলবিন্দুতে চলে যেতে পারে। প্যানেলটিকে ম্যানুয়ালি বা প্রোগ্রাম্যাটিকভাবে তার আসল অবস্থানে ফিরিয়ে আনা ছাড়া এর অন্য কোনো সমাধান নেই। এই বাগটি ভবিষ্যতের একটি রিলিজে ঠিক করা হবে। ( b/489427007 )। - কিছু ক্ষেত্রে,
SurfaceEntityএবং অন্যান্য নন-প্যানেল এনটিটি টাইপের জন্যMovableComponentএর অ্যাফোর্ডেন্স দেখা নাও যেতে পারে। স্পষ্টভাবেMovableComponent.sizeসেট করলে অ্যাফোর্ডেন্সটি দেখা যাবে। এই বাগটি ভবিষ্যতের একটি রিলিজে ( b/490983469 ) ঠিক করা হবে।
সংস্করণ 1.0.0-alpha12
২৫শে ফেব্রুয়ারি, ২০২৬
androidx.xr.scenecore:scenecore-*:1.0.0-alpha12 প্রকাশিত হয়েছে। সংস্করণ 1.0.0-alpha12-এ এই কমিটগুলো অন্তর্ভুক্ত রয়েছে।
পরিচিত সমস্যা
- অ্যাঙ্কর করা সত্তাগুলো কয়েক সেকেন্ড পর তাদের অ্যাঙ্কর করা অবস্থান থেকে অ্যাক্টিভিটি স্পেসের মূলবিন্দুতে ফিরে আসতে পারে।
-
SurfaceEntityইনস্ট্যান্স তৈরি করার সময় অ্যাপ ক্র্যাশ করতে পারে। এই সমস্যাটিandroidx.xr.scenecore:scenecore-*:1.0.0-alpha13এবং পরবর্তী রিলিজগুলোতে সমাধান করা হয়েছে। প্রভাবিত অ্যাপগুলোকে সর্বশেষ সংস্করণে আপডেট করা উচিত।
এপিআই পরিবর্তন
-
ActivitySpace.addOnSpaceUpdatedListenerএবংActivitySpace.removeOnSpaceUpdatedListenerএর নাম পরিবর্তন করেaddOnOriginChangedListenerএবংremoveOnOriginChangedListenerরাখা হয়েছে।AnchorEntity.setOnSpaceUpdatedListenerএর নাম পরিবর্তন করেsetOnOriginChangedListenerরাখা হয়েছে। ( I5d8fb ) -
FakeEntityতে public name প্রপার্টি যোগ করা হয়েছে এবংFakePanelEntityতে ভিউটিকে পাবলিক করা হয়েছে। ( Ifa1f9 )
বাগ সংশোধন
- নতুন সিস্টেম ইমেজগুলিতে ( I57d04 ) স্থির পিক্সেল ঘনত্ব গণনা
সংস্করণ 1.0.0-alpha11
২৮ জানুয়ারী, ২০২৬
androidx.xr.scenecore:scenecore-*:1.0.0-alpha11 প্রকাশিত হয়েছে। সংস্করণ 1.0.0-alpha11-এ এই কমিটগুলো অন্তর্ভুক্ত রয়েছে।
এপিআই পরিবর্তন
-
PerceivedResolutionResult.InvalidCameraViewএর নাম পরিবর্তন করেPerceivedResolutionResult.InvalidRenderViewpointরাখা হয়েছে, কারণgetPerceivedResolutionAPI-গুলো এখনCameraViewScenePoseএর পরিবর্তে ARCore-এরRenderViewpointAPI-এর উপর নির্ভর করে। এই নামটি নতুন বাস্তবায়নকে আরও ভালোভাবে প্রতিফলিত করে। ( I8c967 , b/446989745 , b/419311998 ) -
PanelEntity/SurfaceEntity.getPerceivedResolutionমেথডগুলো এখন ডেভেলপারের দেওয়া একটিRenderViewpointআর্গুমেন্ট হিসেবে গ্রহণ করে। আগে, পারসিভড রেজোলিউশন গণনার জন্য রানটাইম যথেচ্ছভাবেRenderViewpointনির্বাচন করত। ( I8c967 , b/446989745 , b/419311998 ) -
SpatialUser,ScenePose.Head, এবংScenePose.CameraViewসরিয়ে ফেলা হয়েছে। এই API-গুলোর কার্যকারিতা Jetpack XR-এর জন্য ARCore-এর মধ্যে থাকাArDeviceএবংRenderViewpointAPI-গুলোর দ্বারা সম্পন্ন হয়। ব্যবহারকারীর মাথা অথবা বাম বা ডান চোখের সাথে সঙ্গতিপূর্ণ একটিScenePoseপেতে, ডেভেলপাররা ARCore API ব্যবহার করে প্রাপ্ত উপযুক্ত পোজের সাথেPerceptionSpace.getScenePoseFromPerceptionPoseব্যবহার করতে পারেন। ( I2f69c , b/446989745 )
সংস্করণ 1.0.0-alpha10
০৩ ডিসেম্বর, ২০২৫
androidx.xr.scenecore:scenecore-*:1.0.0-alpha10 প্রকাশিত হয়েছে। সংস্করণ 1.0.0-alpha10-এ এই কমিটগুলো অন্তর্ভুক্ত রয়েছে।
এপিআই পরিবর্তন
-
PanelEntity( I462b3 )-তেtransformPixelCoordinatesToPoseএবংtransformNormalizedCoordinatesToPoseযোগ করা হয়েছে -
SceneCore( I570b9 )-এর লজিকের উপর ভিত্তি করেSceneCoreরানটাইমে Utils নামে একটি হেল্পার ক্লাস যোগ করা হয়েছে।
বাগ সংশোধন
- সেশন ধ্বংস হয়ে গেলে এবং একটি
SpatialModeChangeEvent( If44e8 ) পেলে যে সম্ভাব্য ক্র্যাশটি ঘটতে পারতো, তা সমাধান করা হয়েছে। - একটি বাগ সংশোধন করা হয়েছে যার কারণে কোনো Activity থেকে বের হওয়ার বা পুনরায় প্রবেশ করার সময় একটি
IllegalStateExceptionথ্রো হতে পারতো। ( Ibff1c )
সংস্করণ 1.0.0-alpha09
১৯ নভেম্বর, ২০২৫
androidx.xr.scenecore:scenecore-*:1.0.0-alpha09 প্রকাশিত হয়েছে। সংস্করণ 1.0.0-alpha09-এ এই কমিটগুলো অন্তর্ভুক্ত রয়েছে।
নতুন বৈশিষ্ট্য
- একটি
ScenePoseপুনরুদ্ধার করার জন্য একটি API যোগ করা হয়েছে, যা পারসেপশন স্পেস অরিজিন পোজ এবং পারসেপশন স্পেস অরিজিনের সাপেক্ষে একটি পোজের সমন্বয়ে গঠিত। ( I5b50a ) -
getGravityAlignedPoseফাংশনটি যোগ করা হয়েছে। গ্র্যাভিটি অ্যালাইনড পোজ ঘূর্ণনের পিচ এবং রোল উপেক্ষা করে। ( I5ae21 ) -
AnchorEntity.Stateকনস্ট্যান্ট টাইপগুলো Int থেকে State সাবটাইপে পরিবর্তন করা হয়েছে। ( Ib0c49 ) - Entity ইন্টারফেসে
getChildren()যোগ করা হয়েছে।MainPanelEntityলাইফসাইকেল আপডেট করা হয়েছে। ( Ia69d6 )
এপিআই পরিবর্তন
-
PointerCaptureComponent.PointerCaptureStateকনস্ট্যান্ট টাইপগুলো Int থেকেPointerCaptureStateসাবটাইপে পরিবর্তন করা হয়েছে। ( Ic888a ) -
Scene.spatialCapabilitiesএখন একটি Int ফিল্ডের পরিবর্তেSet<SpatialCapability>টাইপের।SpatialCapabilityকনস্ট্যান্টগুলোর নাম পরিবর্তন করা হয়েছে। ( I9c109 ) -
SurfaceEntityকনস্ট্যান্ট টাইপগুলোর নাম পরিবর্তন করে Int থেকেSurfaceEntityসাবটাইপে পরিবর্তন করা হয়েছে। ( I419ed ) -
SpatializerConstantকনস্ট্যান্ট টাইপগুলোর নাম পরিবর্তন করে Int থেকেSpatializerConstantসাবটাইপে পরিবর্তন করা হয়েছে। ( Ia0e18 ) -
TextureSamplerকনস্ট্যান্ট টাইপগুলোর নাম পরিবর্তন করা হয়েছে এবং এগুলোকে Int থেকেTextureSamplerসাবটাইপে পরিবর্তন করা হয়েছে। ( I44078 ) -
SpatialVisibilityকনস্ট্যান্ট টাইপগুলো Int থেকেSpatialVisibilityসাবটাইপে পরিবর্তন করা হয়েছে। ( I70739 ) -
ResizeEvent.ResizeStateকনস্ট্যান্ট টাইপগুলোর নাম পরিবর্তন করে Int থেকেResizeStateসাবটাইপে পরিবর্তন করা হয়েছে। ( I384d5 ) -
InputEventকনস্ট্যান্ট টাইপগুলোর নাম পরিবর্তন করা হয়েছে এবং এগুলোকে Int থেকে পরিবর্তন করে নিজ নিজ এনক্লোজিং টাইপ থেকে ইনহেরিট করানো হয়েছে। ( I82817 ) -
GltfModelEntity.AnimationStateকনস্ট্যান্ট টাইপগুলো Int থেকেAnimationStateসাবটাইপে পরিবর্তন করা হয়েছে। ( I24f4e ) -
AlphaModeকনস্ট্যান্ট টাইপগুলোর নাম পরিবর্তন করে ইন্ট (Int) থেকেAlphaModeসাবটাইপে পরিবর্তন করা হয়েছে। ( I27b56 ) -
Spaceকনস্ট্যান্ট টাইপগুলো ইন্ট (Int) থেকে স্পেস সাবটাইপে পরিবর্তন করা হয়েছে। ( I9255b ) -
ScenePose.hitTestএবং সংশ্লিষ্ট মেথডগুলো এখন কোনো ছেদবিন্দু খুঁজে না পেলে, nullhitPositionসহ একটিHitTestResultএর পরিবর্তেnullরিটার্ন করে।HitTestResult.hitPositionআর null হতে পারে না। ( I1400a ) -
ActivityPoseএর রেফারেন্সScenePoseএ পরিবর্তন করা হয়েছে। ( I7fe43 )
সংস্করণ 1.0.0-alpha08
২২ অক্টোবর, ২০২৫
androidx.xr.scenecore:scenecore-*:1.0.0-alpha08 প্রকাশিত হয়েছে। সংস্করণ 1.0.0-alpha08-এ এই কমিটগুলো অন্তর্ভুক্ত রয়েছে।
এপিআই পরিবর্তন
-
ActivityPanelEntity.moveActivityনাম পরিবর্তন করেtransferActivityরাখা হয়েছে ( I273c5 , b/430332856 )
বাগ সংশোধন
-
:xr:scenecore:scenecore-spatial-renderingএবং:xr:scenecore:scenecore-spatial-core:xr:scenecore:scenecoreএর ইমপ্লিমেন্টেশন ডিপেন্ডেন্সি হিসেবে যোগ করা হয়েছে ( I6ab65 , b/447000520 ) - সেশন ধ্বংস হওয়ার পর
session.sceneঅ্যাক্সেস করা হলে একটি ব্যতিক্রম (Exception) থ্রো করা হয়। ( I77e6f )
সংস্করণ 1.0.0-alpha07
২৪ সেপ্টেম্বর, ২০২৫
androidx.xr.scenecore:scenecore:1.0.0-alpha07 , androidx.xr.scenecore:scenecore-guava:1.0.0-alpha07 , এবং androidx.xr.scenecore:scenecore-testing:1.0.0-alpha07 রিলিজ করা হয়েছে। ভার্সন 1.0.0-alpha07-এ এই কমিটগুলো রয়েছে।
এপিআই পরিবর্তন
-
fixedAspectRatioনাম পরিবর্তন করেisFixedAspectRatioEnabledরাখা হয়েছে এবং এটিকে একটি বুলিয়ান প্রপার্টিতে পরিণত করা হয়েছে ( I5c4e8 , b/440588971 ) -
ScenecoreFakes এখনxr:scenecore:scenecore-testingমডিউলে অবস্থিত। ( Idd951 ) -
shouldAutoHideContentএর নাম পরিবর্তন করেisAutoHideContentWhileResizingEnabledএবংshouldAlwaysShowOverlayএর নাম পরিবর্তন করেisAlwaysShowOverlayEnabledরাখা হয়েছে ( I97c36 , b/432335421 ) - পাঠযোগ্যতার জন্য
SceneCoreTextureSamplerকনস্ট্যান্টগুলো আপডেট করা হয়েছে, উদাহরণস্বরূপTextureSampler.MinFilter.LINEARএখনTextureSampler.MIN_FILTER_LINEAR( Ib159c )। - Scene-এর
setKeyEntityসেটারটিkeyEntityভেরিয়েবলের সাথে একীভূত করা হয়েছে।keyEntityAnchorEntityমতো কোনো অস্থানান্তরযোগ্য Entity-তে সেট করলে, বুলিয়ান false রিটার্ন করার পরিবর্তে একটিIllegalArgumentExceptionথ্রো হবে। ( I62080 , b/428721695 , b/422215745 ) - Scene-এর
SpatialModeChangeListenerভেরিয়েবলটিsetSpatialModeChangedListenerদ্বারা প্রতিস্থাপিত হয়েছে। এটিSpatialModeChangedListenerএর পরিবর্তে একটিConsumer<SpatialModeChangeEvent>গ্রহণ করে।setSpatialModeChangedListenerএখন ঐচ্ছিকভাবে একটি Executor গ্রহণ করতে পারে। ( I62080 , b/428721695 , b/422215745 ) -
ActivityPanelEntity.startActivityথেকেbundleপ্যারামিটারটি সরানো হয়েছে ( I64344 , b/430332856 , b/430333040 ) -
SpatializerConstants.SOURCE_TYPE_BYPASSকেSpatializerConstants.SOURCE_TYPE_DEFAULTএ পুনঃনামকরণ করা হয়েছে। ( Ifc7fe , b/422215565 ) -
SpatialSoundPool.PLAY_FAILEDধ্রুবকটি যোগ করা হয়েছে। ( Ifc7fe , b/422215565 ) -
SpatialSoundPool.playমেথডগুলোতে ডিফল্ট আর্গুমেন্ট যোগ করা হয়েছে। ( Ifc7fe , b/422215565 ) -
SpatialAudioTrackBuilderএর সেটারগুলোর রিটার্ন ভ্যালু সরানো হয়েছে। ( Ifc7fe , b/422215565 ) - পৃষ্ঠতল সত্তার পরিবর্তন
-
SurfaceEntity.CanvasShapeএর নাম পরিবর্তন করেShapeরাখা হয়েছে -
SurfaceEntity.CanvasShape.Vr180Hemisphereএর নাম পরিবর্তন করেHemisphereরাখা হয়েছে -
SurfaceEntity.CanvasShape.Vr360Sphereএর নাম পরিবর্তন করেSphereরাখা হয়েছে -
SurfaceEntity.EdgeFeatheringParams.SmoothFeatherএর নাম পরিবর্তন করেRectangleFeatherরাখা হয়েছে -
SurfaceEntity.EdgeFeathingParams.SolidEdgeএর নাম পরিবর্তন করেNoFeatheringরাখা হয়েছে -
SurfaceEntity.ContentSecurityLevelএর নাম পরিবর্তন করেSurfaceProtectionরাখা হয়েছে -
SurfaceEntity.ContentSecurityLevel.{values}একটিSURFACE_PROTECTION_প্রিফিক্স যোগ করেছে। -
SurfaceEntity.SuperSampling.{$values}একটিSUPER_SAMPLING_প্রিফিক্স যোগ করেছে -
SurfaceEntity.StereoMode.{values}একটিSTEREO_MODE_প্রিফিক্স যোগ করেছে -
SurfaceEntity.ContentColorMetadata.maxCLLএর নাম পরিবর্তন করেmaxContentLightLevelরাখা হয়েছে ( I7eb5f , b/422216050 , b/427529950 )
-
-
launchActivityনাম পরিবর্তন করেstartActivityরাখা হয়েছে ( I7db90 , b/430332856 ) -
Scene.activitySpaceRootসরানো হয়েছে। এর পরিবর্তেScene.activitySpaceব্যবহার করুন। ( I05ee8 , b/378706624 , b/422215745 ) -
configureBundleForFullSpaceModeLaunchএবংconfigureBundleForFullSpaceModeLaunchWithEnvironmentInheritedএর নাম পরিবর্তন করে যথাক্রমেcreateBundleForFullSpaceModeLaunchএবংcreateBundleForFullSpaceModeLaunchWithEnvironmentInheritedরাখা হয়েছে, এবং এগুলিকে LaunchUtils.kt ফাইলে শীর্ষ-স্তরের মেথড হিসেবে স্থানান্তর করা হয়েছে এবং প্রথম প্যারামিটার হিসেবে Session গ্রহণ করে ( I64a2c , b/437186050 ) -
GroupEntityফ্যাক্টরি এখন Entity-এর পরিবর্তেGroupEntityটাইপ রিটার্ন করে। ( I66042 )
বাগ সংশোধন
- ডিসপোজ করার পর কোনো এনটিটি ইনস্ট্যান্স ব্যবহার করা হলে একটি
IllegalStateExceptionথ্রো করুন। ( I90990 , b/427314036 , b/432063442 )
সংস্করণ 1.0.0-alpha06
১৩ আগস্ট, ২০২৫
androidx.xr.scenecore:scenecore:1.0.0-alpha06 , androidx.xr.scenecore:scenecore-guava:1.0.0-alpha06 , এবং androidx.xr.scenecore:scenecore-testing:1.0.0-alpha06 রিলিজ করা হয়েছে। ভার্সন 1.0.0-alpha06-এ এই কমিটগুলো রয়েছে।
এপিআই পরিবর্তন
-
SceneCoreএরBaseEntityএবংBaseScenePoseAPI-গুলোর উপর থেকে বিধিনিষেধ তুলে নিন ( 88c0ff6 )
সংস্করণ 1.0.0-alpha05
৩০ জুলাই, ২০২৫
androidx.xr.scenecore:scenecore-guava:1.0.0-alpha05 , androidx.xr.scenecore:scenecore-testing:1.0.0-alpha05 , এবং androidx.xr.scenecore:scenecore:1.0.0-alpha05 রিলিজ করা হয়েছে। ভার্সন 1.0.0-alpha05-এ এই কমিটগুলো রয়েছে।
নতুন বৈশিষ্ট্য
- প্যানেল এনটিটি এবং
SurfaceEntitiesতে পারসিভড রেজোলিউশন এপিআই যোগ করা হয়েছে। ( I118f6 ) - HSM-এ অ্যাক্টিভিটির প্রধান প্যানেলের অনুভূত রেজোলিউশন নিরীক্ষণ করার জন্য Scene.kt-তে
PerceivedResolutionকলব্যাক মেথড যোগ করা হয়েছে। ( I58084 ) -
SurfaceEntity- অ্যাপ্লিকেশনকে তৈরির সময় সুপার স্যাম্পলিং অনুরোধ করার সুবিধা যোগ করা হয়েছে। এটি অ্যাপ্লিকেশনগুলিকে অ্যান্টি-এলাইজিং এর জন্য সুপার স্যাম্পলিং ফিল্টার ব্যবহার করার সুযোগ দেয়। ( I06913 ) -
ActivitySpaceএrecommendedContentBoxInFullSpaceপ্রপার্টি যোগ করা হয়েছে। এটি Full Space Mode-এ থাকাকালীন কন্টেন্ট রাখার জন্য একটি প্রস্তাবিত বক্স রিটার্ন করে। ( I4cd6f ) - চলনযোগ্য মডিফায়ারের জন্য ওভারলোডেড কনস্ট্রাক্টর দেওয়া হয়েছে যা অ্যাঙ্করিং-এর সুবিধা দেয়। ( Ic0c70 )
এপিআই পরিবর্তন
এই রিলিজের জন্য SceneCore এর API-তে ব্যাপক পরিবর্তন আনা হয়েছে। বেশ কিছু ক্লাসের নাম পরিবর্তন করা হয়েছে এবং/অথবা সেগুলোকে ভিন্ন মডিউলে স্থানান্তর করা হয়েছে, এবং বেশিরভাগ গেটার/সেটার মেথডকে কোটলিন প্রপার্টি দিয়ে প্রতিস্থাপন করা হয়েছে। যদিও আমরা আমাদের প্রথম বিটা রিলিজের আগ পর্যন্ত ভবিষ্যতে API-তে বড় ধরনের পরিবর্তনের আশঙ্কা করছি, তবে সেগুলো এতটা বিঘ্ন সৃষ্টিকারী বা সংখ্যায় বেশি হবে না।
- নিম্নলিখিত ক্লাস ও ইন্টারফেসগুলির নাম পরিবর্তন এবং/অথবা স্থানান্তর করা হয়েছে:
androidx.xr.scenecore.PixelDimensionsথেকেandroidx.xr.runtime.math.IntSize2d;androidx.xr.scenecore.Dimensionsথেকেandroidx.xr.runtime.math.FloatSize3d;androidx.xr.scenecore.ActivityPoseথেকেScenePose,androidx.xr.scenecore.ContentlessEntityথেকেGroupEntity,androidx.xr.scenecore.PlaneTypeথেকেPlaneOrientation;androidx.xr.scenecore.PlaneSemanticথেকেPlaneSemanticType। ( Ifd405 )( I3b622 )( If534d ) -
Sceneএর প্রোপার্টিগুলোর বেশ কিছু সেটার প্রাইভেট করা হয়েছে;SceneCoreক্লায়েন্টদের দ্বারা এগুলো পরিবর্তন করার উদ্দেশ্য ছিল না:activitySpace,activitySpaceRoot,mainPanelEntity,perceptionSpace,spatialCapabilities,spatialEnvironment, এবংspatialUser। ( I2f506 ) - এনটিটিতে: নিম্নলিখিতগুলিকে প্রোপার্টিতে পরিবর্তন করা হয়েছে:
get/setParent(),setContentDescription;Entity.is/setHidden()অপ্রচলিত ঘোষণা করা হয়েছে, এর পরিবর্তেEntity.is/setEnabledব্যবহার করুন। ( Ibc4c6 ) -
androidx.xr.scenecore.BasePanelEntityক্লাসটি সরানো হয়েছে, এর পরিবর্তে সরাসরিPanelEntityব্যবহার করুন।PanelEntityএর গেটার এবং সেটারগুলোকে প্রোপার্টি দিয়ে প্রতিস্থাপন করা হয়েছে।PanelEntity.sizeপ্রোপার্টিটিFloat3dSizeথেকেFloat2dSizeএ পরিবর্তন করা হয়েছে। অপ্রচলিত মেথডandroidx.xr.scenecore.PanelEntity.getPixelDimensionsসরানো হয়েছে, এর পরিবর্তেgetSizeInPixelsব্যবহার করুন। ( Icc174 ) -
androidx.xr.scenecore.OnSpaceUpdatedListenerRunnableদ্বারা প্রতিস্থাপন করা হয়েছে। ( I19308 ) -
SpatialUser.getCameraViews()একটি প্রপার্টি দিয়ে প্রতিস্থাপন করা হয়েছে। ( Ib0cc5 )ExrImageএবংGltfModel:createমেথডগুলোকে suspend ফাংশনে পরিবর্তন করা হয়েছে; create প্যারামিটারগুলোকেStringএর পরিবর্তেUriবাPathগ্রহণ করার জন্য পরিবর্তন করা হয়েছে। ( Id8883 ) ( I0d247 ), ( I25706 ) -
SpatialEnvironment.requestFullSpaceModeএবংSpatialEnvironment.requestHomeSpaceModeScene-এ সরানো হয়েছে, উদাহরণস্বরূপsession.scene.requestFullSpaceMode()-এর পরিবর্তেsession.scene.spatialEnvironment.requestFullSpaceMode()ব্যবহার করুন।addOnPassthroughOpacityChangedListenerএবংaddOnSpatialEnvironmentChangedListenerএখন ওভাররাইড রয়েছে যা ঐচ্ছিক Executors গ্রহণ করে। ( I12fe0 ) ( I6b21e ) - নিম্নলিখিত অপ্রচলিত
SpatialEnvironmentমেথডগুলি সরানো হয়েছে:togglePassthrough,setPassthrough,setPassthroughOpacity,getPassthroughMode,getPassthroughOpacity,setSkybox, এবংsetGeometry। এছাড়াও অপ্রচলিত ক্লাসSpatialEnvironment.PassthroughModeসরানো হয়েছে ( I927bd ) ( I927bd ) ( I927bd ) - নিম্নলিখিত
SpatialEnvironmentগেটার এবং সেটারগুলিকে Kotlin প্রোপার্টি দিয়ে প্রতিস্থাপন করা হয়েছে:getCurrentPassthroughOpacity(),get/setPassthroughOpacityPreference(),get/setSpatialEnvironmentPreference(),isSpatialEnvironmentPreferenceActive()( I33a7b ) ( Ie06e2 ) ( Ie06e2 ) -
SpatialEnvironmentPreference.preferredPassthroughOpacityএর টাইপFloat?থেকেFloatএ পরিবর্তন করা হয়েছে। এটি আর null ভ্যালু গ্রহণ করে না। এর পরিবর্তে, কোনো অপাসিটি প্রেফারেন্স নেই তা বোঝাতেSpatialEnvironment.NO_PASSTHROUGH_OPACITY_PREFERENCEব্যবহৃত হয়। ( I40107 ) - create মেথডে
windowBoundsPxপ্যারামিটারটিকেpixelDimensionsএ এবং এর টাইপকে Rect থেকেIntSize2dতে আপডেট করা হয়েছে। ( I1926e ) -
SpatialEnvironmentকনস্ট্রাক্টর এখন অভ্যন্তরীণ ( I75a51 ) -
SpatialPointerIconNoneএবংSpatialPointerIconCircleক্লাস দুটিকে তাদের সহযোগী অবজেক্টSpatialPointerIcon.NONEএবংSpatialPointerIcon.CIRCLEদ্বারা প্রতিস্থাপন করা হয়েছে ( I416d2 ) -
SpatialPointerComponentএরSpatialPointerIconএখন আর null হতে পারে না। সিস্টেমের ডিফল্ট পয়েন্টার আইকন ব্যবহার করা হবে তা বোঝাতে null-এর পরিবর্তেSpatialPointerIcon.DEFAULTব্যবহার করুন। ( I416d2 ) -
androidx.xr.scenecore.AnchorEntity.getState()একটি রিড-অনলি প্রপার্টি দিয়ে প্রতিস্থাপন করা হয়েছে। স্পষ্টতার জন্যAnchorEntity.create()মেথডের প্যারামিটারগুলোর নাম পরিবর্তন করা হয়েছে।AnchorEntityএর লিসেনার সেট এবং যোগ করার মেথডগুলোতে, ট্রেইলিং ল্যাম্বডা সক্রিয় করার জন্য লিসেনারটিকে শেষ আর্গুমেন্টে সরানো হয়েছে।AnchorEntityএর জন্যandroidx.xr.scenecore.OnStateChangedListenerকেConsumer<AnchorEntity.State>দিয়ে প্রতিস্থাপন করা হয়েছে। ( I472e0 ) -
GltfModelEntity.getAnimationState()এখন একটি প্রপার্টি। ( I10b29 ) -
ActivitySpace.getBounds()একটি প্রপার্টি দিয়ে প্রতিস্থাপন করা হয়েছে।ActivitySpace.addBoundsChangedListenerএর নাম পরিবর্তন করেActivitySpace.addOnBoundsChangedListenerরাখা হয়েছে।ActivitySpace.setOnSpaceUpdatedListenerকে add/remove মেথড দিয়ে প্রতিস্থাপন করা হয়েছে। ( I4c956 ) -
AnchorPlacement: planeTypeFilterনাম পরিবর্তন করেanchorablePlaneOrientationsরাখা হয়েছে,planeSemanticFilterনাম পরিবর্তন করেanchorablePlaneSemanticTypesরাখা হয়েছে। একটিAnchorEntityবাActivitySpaceএ একটিMovableComponentযোগ করলে false রিটার্ন করবে,MoveListenerনাম পরিবর্তন করেEntityMoveListener shouldDisposeParentAnchorনাম পরিবর্তন করেdisposeParentOnReAnchor systemMovableরাখা হয়েছে,createফাংশন থেকে systemMovable সরিয়েcreeateCustomMovable,createSystemMovableএবংcreateAnchorable( If11c4 ) যোগ করা হয়েছে। -
SurfaceEntity.featherRadiusX/Yসরিয়ে দেওয়া হয়েছে এবংEdgeFeatheringParamsনামে একটি ক্লাস কনসেপ্ট যোগ করা হয়েছে। ( Ic78fc ) -
PanelEntity.enablePanelDepthTest()মেথডটিpanelClippingConfigপ্রপার্টি দ্বারা প্রতিস্থাপিত হয়েছে। ডেপথ-টেস্টিং চালু করতেScene.panelClippingConfig = PanelClippingConfig(isDepthTestEnabled = true)সেট করুন অথবা এটি বন্ধ করতেPanelClippingConfig(isDepthTestEnabled = false)সেট করুন। ( I0cbe0 ) -
Scene.mainPanelEntityএখনPanelEntityএর পরিবর্তেMainPanelEntityটাইপের ( I7125a ) - Scene-এর
setFullSpaceModeমেথডের নাম পরিবর্তন করেconfigureBundleForFullSpaceModeLaunchএবংsetFullSpaceModeWithEnvironmentInheritedমেথডের নাম পরিবর্তন করেconfigureBundleForFullSpaceModeLaunchWithEnvironmentInheritedরাখা হয়েছে। ( I0cbe0 ) ( I0cbe0 ) -
SpatialVisibilityএর UNKNOWN, OUTSIDE_FOV, PARTIALLY_WITHIN_FOV, এবং WITHIN_FOV মানগুলির নাম পরিবর্তন করে যথাক্রমে SPATIAL_VISIBILITY_UNKNOWN, SPATIAL_VISIBILITY_OUTSIDE_FIELD_OF_VIEW, SPATIAL_VISIBILITY_PARTIALLY_WITHIN_FIELD_OF_VIEW, এবং SPATIAL_VISIBILITY_WITHIN_FIELD_OF_VIEW রাখা হয়েছে ( Ie7e8c ) -
SpatialVisibilityক্লাসটিকে const Int ভ্যালু সহ একটি পাবলিক অবজেক্ট দ্বারা প্রতিস্থাপন করা হয়েছে।setSpatialVisibilityChangedListenerএখনConsumer<Int>এর পরিবর্তেConsumer<SpatialVisibility>গ্রহণ করে ( Ie7e8c ) -
PointerCaptureComponentধ্রুবকগুলোর নাম পরিবর্তন করেPointerCaptureComponent.PointerCaptureStateঅবজেক্টে স্থানান্তর করা হয়েছে ( I9c7ac ) -
PointerCaptureComponents' StateListenerConsumer<Int>দ্বারা প্রতিস্থাপন করা হয়েছে। ( I9c7ac ) -
InputEventListenerConsumer<InputEvent>দ্বারা প্রতিস্থাপন করা হয়েছে ( I9c7ac ) -
setPreferredAspectRatioScene ক্লাস থেকেSpatialWindowঅবজেক্টে স্থানান্তর করা হয়েছে এবং এটি প্রথম প্যারামিটার হিসেবে Session গ্রহণ করে। ( I7b717 ) -
Entity.setHidden()এর পরিবর্তেEntity.setEnabled()এবংEntity.isHidden()এর পরিবর্তেEntity.isEnabled()ব্যবহৃত হবে।setHidden(false)এবংsetEnabled(true)সমান এবংisHidden() == !isEnabled()। ( Icf0de ) -
Entity.contentDescriptionটাইপ String থেকেCharSequenceএ পরিবর্তন করা হয়েছে। ( Ie59be ) - পর্যাপ্ত অনুমতি না দেওয়া হলে
Session.createএবংSession.configureএখনSessionCreatePermissionsNotGrantedবাSessionConfigurePermissionsNotGrantedরিটার্ন করার পরিবর্তেSecurityExceptionথ্রো করে। ( I7c488 ) -
ResizableComponent.createজন্য এখন একটিConsumer<ResizeEvent> ResizeEventListenerConsumer<ResizeEvent> ResizableComponent.sizeদ্বারা প্রতিস্থাপন করা হয়েছে।ResizableComponent.affordanceSize ResizableComponent.minimumSizeএর নাম পরিবর্তন করেResizableComponent.minimumEntitySize ResizableComponent.maximumSizeনাম পরিবর্তন করেResizableComponent.maximumEntitySizeরাখা হয়েছে।ResizableComponent.autoHideContentএর নাম পরিবর্তন করে ResizableComponent.maximumEntitySize রাখা হয়েছে। ResizableComponent.autoHideContent-এর নাম পরিবর্তন করেResizableComponent.shouldAutoHideContentরাখা হয়েছে।ResizableComponent.forceShowResizeOverlayনাম পরিবর্তন করেResizableComponent.shouldAlwaysShowOverlayরাখা হয়েছে। ( I97a2d ) -
androidx.xr.scenecoreএবংandroidx.xr.composeএর জন্যminSDKকমিয়ে 24 করা হয়েছে। XR প্যাকেজগুলোর জন্য রানটাইমে এখনও API 34 প্রয়োজন। ( I17224 ) - সমস্ত Jetpack XR প্যাকেজ থেকে
RequiresApi(34)সীমাবদ্ধতা সরানো হয়েছে। এই সীমাবদ্ধতাটি অপ্রয়োজনীয় ছিল কারণ Jetpack XR বর্তমানে শুধুমাত্র API লেভেল 34+ যুক্ত ডিভাইসগুলিতে উপলব্ধ। ( Iae0f8 ) - মূল
SceneCoreআর্টিফ্যাক্ট (xr:scenecore:scenecore)-এ শুধুমাত্র কোটলিন-স্টাইলের অ্যাসিঙ্ক এপিআই থাকবে। জাভা ডেভেলপাররা সামঞ্জস্যপূর্ণ এপিআই অ্যাক্সেস করার জন্যxr:scenecore:scenecore-guavaলাইব্রেরির উপর নির্ভর করতে পারেন। ( If221b ) - Kotlin 2.0 দিয়ে প্রকাশিত প্রোজেক্টগুলি ব্যবহার করার জন্য KGP 2.0.0 বা তার নতুন সংস্করণ প্রয়োজন ( Idb6b5 )
- এই লাইব্রেরিটি এখন JSpecify নালনেস অ্যানোটেশন ব্যবহার করে, যা টাইপ-ইউজ। সঠিক ব্যবহার নিশ্চিত করতে কোটলিন ডেভেলপারদের নিম্নলিখিত কম্পাইলার আর্গুমেন্টটি ব্যবহার করা উচিত:
-Xjspecify-annotations=strict(কোটলিন কম্পাইলারের ২.১.০ সংস্করণ থেকে এটি ডিফল্ট হিসেবে সেট করা হয়েছে) ( Ia8420 ) - যেসব async মেথড
ListenableFutureরিটার্ন করে, সেগুলোকে Kotlin suspend ফাংশন দিয়ে প্রতিস্থাপন করা হয়েছে। যেসব জাভা ডেভেলপার Kotlin suspend ফাংশনের পরিবর্তেListenableFutureভিত্তিক async মেথড ব্যবহার করতে চান, তাদের এখন:xr:scenecore-scenecore-guavaতে থাকা এক্সটেনশন ফাংশনগুলো ব্যবহার করতে হবে। উদাহরণস্বরূপ,GuavaExrImageএ Guava-এর সমতুল্য ExrImage async ফাংশনগুলো,GuavaScenePoseএ Guava-এর সমতুল্যScenePoseasync ফাংশনগুলো,GuavaGltfModelএGuava-equivalent GltfModelasync ফাংশনগুলো ইত্যাদি রয়েছে। ( If7283 ) ( I0af60 ) ( If7283 ) ( Ia8515 ) ( I4efdf ) ( I54bbf ) ( I3467a ) ( I82a33 )
বাগ সংশোধন
- মিনিফাইড ক্লায়েন্টদের জন্য
AbstractMethodErrorপ্রতিরোধ করতে Jetpack XR ScenecoreProGuardনিয়মটি আপডেট করা হয়েছে। ( I91a01 ) - Jetpack XR
SceneCore( I4f47e )-এর জন্য Proguard মিনিফিকেশন সমর্থন করার অতিরিক্ত সংশোধন। - একটি বাগ সংশোধন করা হয়েছে যেখানে একটি
InteractableComponentক্র্যাশ করতে পারতো যদিInputEventএর HitInfo-তেhitPositionhitPositionথেকে null হলে ক্র্যাশ করতো ( I7a695 )। - কনফিগ *মোড ভ্যালুগুলোর আচরণ প্রতিফলিত করার জন্য সেগুলোর নাম পরিবর্তন করা হয়েছে। ( I6d247 )
-
SceneCoreTestApp-এ FOV এবংHitTestসংক্রান্ত সমস্যাগুলি সমাধান করা হয়েছে। ( I2c51e ) -
SpatialCapabilities.hasCapability()ফাংশনের একটি বাগ সংশোধন করা হয়েছে, যেখানে এটি বিটওয়াইজ OR ব্যবহার করে দেওয়া ক্যাপাবিলিটিগুলোর মধ্যে যেকোনো একটি সত্য হলেই true রিটার্ন করত, অথচ সবগুলো সত্য হলেই কেবল true রিটার্ন করার কথা ছিল। ( I2cd40 ) -
SurfaceEntity.StereoMode.TOP_BOTTOMআপডেট করা হয়েছে যাতে উপরের ম্যাপটি বাম চোখে এবং নিচের ম্যাপটি ডান চোখে থাকে। ( I4ae68 )
সংস্করণ 1.0.0-alpha04
৭ মে, ২০২৫
androidx.xr.scenecore:scenecore:1.0.0-alpha04 and androidx.xr.scenecore:scenecore-testing:1.0.0-alpha04 are released. Version 1.0.0-alpha04 contains these commits .
নতুন বৈশিষ্ট্য
- Backhandling will now work on panel entities without embedded activities. For backhandling to work you need to specify
android:enableOnBackInvokedCallback= "true"in the android manifest. -
StereoSurfaceEntitynow supports MV-HEVC playback through two newStereoModevalues: MULTIVIEW_LEFT_PRIMARY and MULTIVIEW_RIGHT_PRIMARY. -
PanelEntity.setSizeandPanelEntity.getSizenow return sizes in parent space. -
Entity.setPose,Entity.getPose,Entity.setScale,Entity.getScale,Entity.setAlphaandEntity.getAlphanow take a new paramrelativeTo, which allows get/set values relative to different spaces. The supported values are Parent, Activity and Real World spaces, and the default value for this param is Parent. - Spatial Visibility Callback extension methods added to
SessionExt.ktto monitor when the scene content moves inside or outside the user's field of view. -
setPointSourceParamshas been added toSpatialAudioTrack, allowing the params to be updated after the track has been built. - Added a new class, Scene, with references to
ScenecoreAPIs. Scene will be accessible as an extension property of Session. Functions inside ofSessionExthave been moved to Scene so imports will be need to be adjusted; for example,SessionExt.getScene(session).addSpatialCapababilitiesChangedListenerversusSessionExt.addSpatialCapabilitiesChangedListener. -
ActivityPose.hitTestAsyncwas added, enabling ahitTestagainst virtual content. - Added new Component type
SpatialPointerComponent, allowing clients to specify the icon rendered for the pointer, or to disable the icon. This Component can currently be attached toPanelEntityinstances only. - Introducing new
PanelEntityfactory, which takes panel dimensions in either meters or pixels. OlderPanelEntityfactory taking two Dimension type params for panel removed.
এপিআই পরিবর্তন
- Removed
RequiresApi(34)restriction on all Jetpack XR packages. This restriction was redundant as Jetpack XR is currently only available on devices with API level 34+. ( Iae0f8 ) - Projects released with Kotlin 2.0 require KGP 2.0.0 or newer to be consumed ( Idb6b5 )
-
PermissionHelperclass has been removed. -
PanelEntity.getPixelDensityis deprecated. -
PanelEntity.setPixelDimensionsandPanelEntity.getPixelDimensionare removed, replaced bysetSizeInPixelsandgetSizeInPixels. -
Entity.getActivitySpaceAlpharemoved. Can be replaced withEntity.getAlpha(Space.Activity). -
Entity.getWorldSpaceScaleremoved. Can be replaced withEntity.getScale(Space.REAL\_WORLD). - The Session class in
SceneCorehas been deleted in favor of the Session in XR Runtime. -
StereoSurfaceEntityhas been renamed toSurfaceEntity. -
Entity.setSizeandEntity.getSizeare removed, and the same methods were added toPanelEntity. -
PointSourceAttributeshas been renamed toPointSourceParams. -
SpatializerConstants.SOURCE\_TYPE\_BYPASShas been renamed toSpatializerConstants.SOURCE\_TYPE\_DEFAULT. -
PointSourceParamsentity has been modified from public to internal access. -
AnchorEntity.createnow requiresPlaneTrackingModeto be configured inSession.configure(). -
SpatialUserAPIs now requireHeadTrackingModeto be configured inSession.configure(). - When
ResizableComponentis not attached, it will give INFO-level log instead of ERROR-level log. - Fov class is now a regular Kotlin class.
- Split
Entity.ktto place each concrete entity type into its own file. - When creating a new
PanelEntity, most Views will be reparented to aFrameLayout. This facilitates the use ofLayoutInspectorwith Spatial Panels. - The currently used
XrExtensionsinstance is now registered with the platform, in a best effort way, to help with app debugging.
বাগ সংশোধন
- A fix was added to prevent a crash that could occur when a
PanelEntitywithMovableComponentandAnchorPlacementwas moved - Fixed an issue where
ResizableComponentwas providing stale sizes inonResizeStartcallback. - Fixed crash when
JxrPlatformAdapterAxr'sdispose()was called multiple times.
সংস্করণ 1.0.0-alpha03
February 26, 2025
androidx.xr.scenecore:scenecore:1.0.0-alpha03 and androidx.xr.scenecore:scenecore-testing:1.0.0-alpha03 are released. Version 1.0.0-alpha03 contains these commits .
নতুন বৈশিষ্ট্য
- Proguard minification is now supported for Jetpack XR code
বাগ সংশোধন
- Additional fixes to support Proguard minification for Jetpack XR SceneCore ( I4f47e )
- Updated Jetpack XR Scenecore
ProGuardrule to preventAbstractMethodErrorfor minified clients. ( I91a01 )
সংস্করণ 1.0.0-alpha02
February 12, 2025
androidx.xr.scenecore:scenecore:1.0.0-alpha02 and androidx.xr.scenecore:scenecore-testing:1.0.0-alpha02 are released. Version 1.0.0-alpha02 contains these commits .
Upcoming breaking change affecting apps built before 1.0.0-alpha02
- Factory methods have been moved from the
Sessionclass to a companion method on each respective type:-
Session.createActivityPanelEntity(Dimensions, String, Activity, Pose)has been deleted and replaced withActivityPanelEntity.create(Session, Dimensions, String, Pose) -
Session.createAnchorEntity(Anchor)has been deleted and replaced withAnchorEntity.create(Session, Anchor) -
Session.createAnchorEntity(Dimensions, Int, Int, Duration)has been deleted and replaced withAnchorEntity.create(Session, Dimensions, Int, Int, Duration) -
Session.createEntity(String, Pose)has been deleted and replaced withContentlessEntity.create(Session, String, Pose) -
Session.createExrImageResource(String)has been deleted and replaced withExrImage.create(Session, String) -
Session.createGltfEntity(GltfModel, Pose)has been deleted and replaced withGltfModelEntity.create(Session, GltfModel, Pose) -
Session.createGltfModelResource(String)has been deleted and replaced withGltfModel.create(Session, String) -
Session.createInteractableComponent(Executor, InputEventListener)has been deleted and replaced withInteractableComponent.create(Session, Executor, InputEventListener) -
Session.createMovableComponent(Boolean, Boolean, Set<AnchorPlacement>, Boolean)has been deleted and replaced withMovableComponent.create(Session, Boolean, Boolean, Set<AnchorPlacement>, Boolean) -
Session.createPanelEntity(View, Dimensions, Dimensions, String, Pose)has been deleted and replaced withPanelEntity.create(Session, View, Dimensions, Dimensions, String, Pose) -
Session.createResizableComponent(Dimensions, Dimensions)has been deleted and replaced withResizableComponent.create(Session, Dimensions, Dimensions) -
Session.createStereoSurfaceEntity(Int, Dimensions, Pose)has been deleted and replaced withStereoSurface.create(Session, Int, Dimensions, Pose)
-
- The following deprecated methods were removed:
-
Session.canEmbedActivityPanel(Activity)has been deleted. UsegetSpatialCapabilities.hasCapabilility(SPATIAL_CAPABILITY_EMBED_ACTIVITY)instead. -
Session.hasSpatialCapability(Int)has been deleted. It has been replaced in favor of usinggetSpatialCapabilities().hasCapability()as a more compartmentalized way to check for the presence of spatial capabilities sincegetSpatialCapabilities()returns aSpatialCapabilitiesobject. -
Session.requestFullSpaceMode()has been deleted and replaced withSpatialEnvironment.requestFullSpaceMode() -
Session.requestHomeSpaceMode()has been deleted and replaced withSpatialEnvironment.requestHomeSpaceMode()
-
-
Session.setFullSpaceMode(Bundle)andSession.setFullSpaceModeWithEnvironmentInherited(Bundle)have been moved to extension functions. Developer files will need to add the new imports for access:-
import androidx.xr.scenecore.setFullSpaceMode -
import androidx.xr.scenecore.setFullSpaceModeWithEnvironmentInherited
-
-
Session.setPreferredAspectRatio(Activity, Float)has been moved to an extension function. Developer files will need to add the new import for access:-
import androidx.xr.scenecore.setPreferredAspectRatio
-
-
Session.getEntitiesOfType(Class<out T>)andSession.getEntityForRtEntity(RtEntity)have been moved to extension functions. Developer files will need to add the new imports for access:-
import androidx.xr.scenecore.getEntitiesOfType -
import androidx.xr.scenecore.getEntityForRtEntity
-
-
Session.unpersistAnchor(Anchor)has been deleted -
Session.createPersistedAnchorEntity(UUID)has been deleted
Known issues
-
PanelEntity.setCornerRadius()andActivityPanelEntity.setCornerRadius()may not take effect until the panel is next moved, this can be mitigated by moving the panel to its current position - When
BoundsChangedis called on theActivitySpace, someActivityPoses may not have been correctly updated. It will be updated on the followingOnSpaceUpdatedcall on theActivitySpace
Breaking & behavioral changes
-
PanelEntityandActivityPanelEntitywill have a default corner radius of 32dp or smaller if the panel has a width or height smaller than 32dp
New APIs and capabilities
- Introduces
StereoSurface.CanvasShape, which allows for the creation ofSphericalandHemisphericalcanvases for rendering immersive media. -
StereoSurfaceEntity.create()now accepts aCanvasShapeparameter. (This parameter is currently ignored, but will be used in a future release) -
StereoSurfaceEntity.create()no longer takes aDimensionsparameter. Applications should control the size of the canvas through setting theCanvasShape -
StereoSurfaceEntityhas aCanvasShapemember which can be set dynamically. -
StereoSurfaceEntity.dimensionsis now a read-only property; applications should set theCanvasShapeto change dimensions. -
StereoSurfaceEntitynow allows theStereoModeto be re-set after construction.
অন্যান্য পরিবর্তন
- Reduced compile-time minSDK to 24. All Jetpack XR APIs continue to require API 34 at runtime.
-
SceneCore's Session factory (Session.create) no longer launches an intent to acquire theSCENE_UNDERSTANDINGpermission. Instead, the client application must explicitly request the permissions from the user, before attempting to create the anchors. Anchor creation will fail if the permission is not granted by the user.
বাগ সংশোধন
-
getActivitySpacePose()has been fixed to account for theActivitySpacescale by returning translation values in scaled meters rather than always returning non-scaled meters.transformPoseTonow also uses the right units to compute coordinate changes when theActivitySpaceis involved in the source or destination. - The skybox will now be set to an all-black skybox whenever a null skybox preference is passed using
setSpatialEnvironmentPreference(new SpatialEnvironmentPreference(null, geom)). To revert to the system default skybox and geometry, usesetSpatialEnvironmentPreference(null).
সংস্করণ 1.0.0-alpha01
December 12, 2024
androidx.xr.scenecore:scenecore-* 1.0.0-alpha01 is released.
Features of Initial Release Initial developer release of Jetpack SceneCore, a 3D scene graph library for creating and manipulating immersive scenes and environments. This library allows you to place and arrange 3D models and content panels relative to each other and your virtual or real-world environments.
- SpatialEnvironment : Create fully immersive experiences with a skybox image and/or 3D model geometry as the backdrop for your XR scene of your environment. Or enable passthrough, so your virtual scene can integrate with the user's real-world environment.
- PanelEntity : Add 2D content to your 3D scenes by embedding standard Android layouts and Activities into spatialized panels that can float or be anchored to real-world surfaces.
- GltfModelEntity : Place, animate, and interact with 3D models in your scene. SceneCore supports the glTF file format for ease of integration with existing models.
- SpatialAudio : Add ambient and point audio sources into your 3D scene for fully immersive, spatialized sound.
- StereoSurfaceEntity : SceneCore supports left/right eye routing of content rendered onto an Android Surface. This can be used to render stereoscopic content in a side-by-side or top-bottom format, such as stereo photos, 3D video, or other dynamically rendered UIs. Applications should use MediaPlayer or ExoPlayer for video decoding.
- Component System: SceneCore offers a robust and flexible component system for adding capabilities to your XR content, including affordances for users to move, resize, and interact with models and panels.
- Anchor : With passthrough enabled, you can attach panels and models to actual surfaces, giving users seamless integration of virtual content in their real-world environment.
- User Pose: Access the user's location in the virtual scene, to orient your content around the user's position.
- SpatialCapabilities : Build fully adaptive apps that take advantage of spatialized capabilities when available, such as 3D positioning of UI content. Not only that, but your app can monitor for changes to capabilities while the app is executing, to modify the experience based on how the user is using their Android XR device.
Known Issues
- Currently a minSDK of 30 is required to use Jetpack SceneCore. As a workaround add the following manifest entry
<uses-sdk tools:overrideLibrary="androidx.xr.scenecore, androidx.xr.compose"/>to be able to build and run with a minSDK of 23. - Session can become invalid in various situations that automatically recreate the Activity, including resizing a main panel, connecting peripherals, and changing between light and dark mode. If you encounter session invalidation issues, workarounds include making you main panel non-resizable, using a dynamic panel entity, disabling activity recreation for specific config changes or disabling light/dark mode theme changes.
- Movable and Resizable components are not supported on GltfEntity.
- Entity.getSize() is not supported on GltfEntity.
- Jetpack XR apps required to request
android.permission.SCENE_UNDERSTANDINGpermission in AndroidManifest. - Creating a session is only supported on an Android XR device. At this time, if you create a Session and try to use it on a non Android XR device, you'll get a RuntimeException.
- Setting the skybox to null via `SpatialEnvironment.setSpatialEnvironmentPreference() does not result in a solid black skybox as documented. It may result in the system default skybox or no change to the current skybox.
- SceneCore clients should add
implementation(“com.google.guava:listenablefuture-1.0”)to their Gradle configuration for their app's dependencies. In a future release, scenecore will include this library as anapidependency so clients will not need to explicitly declare it. - SceneCore erroneously includes
com.google.guava:guava-31.1-androidandcom.google.protobuf:protobuf-javaliteas transitive dependencies. If this results in duplicate class errors in your build, these two dependencies can be safely excluded. - If your app uses SceneCore and enables ProGuard, it will crash when you create a Session. As a workaround, disable ProGuard. See this guide for more information on how to enable ProGuard.