نمای کلی ساختمان برای اندروید XR

Android XR توسعه‌ای از پلتفرم و اکوسیستم اندروید است. Android XR SDK به گونه ای طراحی شده است که به شما امکان می دهد برنامه های XR را با استفاده از چارچوب ها و ابزارهای آشنای Android یا با استفاده از استانداردهای باز مانند OpenXR و WebXR بسازید. همه برنامه های سازگار با موبایل یا صفحه نمایش بزرگ برای نصب روی هدست های XR از فروشگاه Play در دسترس خواهند بود. ملاحظات سازگاری را بررسی کنید تا ببینید آیا برنامه شما سازگار است یا خیر.

این راهنما زمینه های زیر را توضیح می دهد:

• ابزارها و فناوری های توسعه خود را انتخاب کنید
• طراحی اپلیکیشن برای اندروید XR
• در حال پیکربندی فایل مانیفست برنامه شما
• ملاحظات سازگاری مانیفست برنامه
• آشنایی با مجوزهای اندروید XR
• اطمینان از کیفیت برنامه Android XR
• بسته بندی و توزیع برنامه شما برای Android XR

ابزارها و فناوری های توسعه خود را انتخاب کنید

هنگام ساخت یک برنامه برای Android XR، می‌توانید از میان پلتفرم‌ها و فناوری‌های توسعه زیر یکی را انتخاب کنید:

Jetpack XR SDK

Jetpack XR SDK شامل کتابخانه‌های Android XR Jetpack است که برای استفاده از قابلیت‌های منحصر به فرد دستگاه‌های XR ساخته شده‌اند. اگر می‌خواهید یکی از موارد زیر را انجام دهید، با این SDK شروع کنید:

• یک برنامه تلفن همراه یا رایانه لوحی Android موجود را بهینه یا ارتقا دهید
• با استفاده از Android Studio و Jetpack یک برنامه Android XR جدید بسازید

اگر از قبل با Android Jetpack توسعه می‌دهید، Jetpack XR SDK برای شما مناسب است. این طراحی شده است تا به طور یکپارچه با آن چارچوب ها و کتابخانه ها یکپارچه شود و به شما امکان می دهد از دانش موجود برای ایجاد تجربیات فراگیر XR استفاده کنید.

درباره توسعه با Jetpack XR SDK بیشتر بیاموزید .

وحدت

Unity Engine یک موتور توسعه سه بعدی بلادرنگ است که به هنرمندان، طراحان و توسعه دهندگان اجازه می دهد تا برای ایجاد تجربیات همهجانبه و تعاملی با یکدیگر همکاری کنند. پشتیبانی Unity از Android XR به شما سطح بالایی از کنترل را بر تجربیات سه بعدی که توسعه می‌دهید، می‌دهد، در حالی که از اکوسیستم توسعه‌دهنده و پشتیبانی OpenXR Unity بهره می‌برید.

اگر قبلاً یک تجربه XR ساخته شده با Unity دارید یا اگر با توسعه Unity آشنا هستید، با این گزینه شروع کنید.

درباره توسعه با Unity برای Android XR بیشتر بدانید .

OpenXR

OpenXR یک استاندارد باز و بدون حق امتیاز است که می تواند برای ایجاد تجربیات XR با کارایی بالا و چند پلتفرمی استفاده شود. Android XR از OpenXR 1.0 و 1.1 پشتیبانی می کند و ما در حال گسترش مشخصات با افزونه های جدید برای Android XR هستیم. از آنجا که Android XR بر اساس استانداردهای باز ساخته شده است، ابزارهای توسعه ای که از OpenXR و Android پشتیبانی می کنند باید با Android XR سازگار باشند.

درباره پشتیبانی OpenXR برای Android XR بیشتر بدانید .

WebXR

WebXR به شما امکان می دهد تجربیات همه جانبه ای برای وب ایجاد کنید. این امکان دسترسی به دستگاه های واقعیت مجازی و واقعیت افزوده را در مرورگرهای وب سازگار مانند Chrome در Android XR فراهم می کند.

اگر می خواهید یک تجربه XR برای وب بسازید یا اگر می خواهید قابلیت های XR را به یک برنامه وب اضافه کنید، با این گزینه شروع کنید. تجربه‌های موجود WebXR روی Android XR نیز کار خواهند کرد.

درباره ساختن برنامه های وب با WebXR بیشتر بیاموزید .

طراحی برای XR

XR سطح طراحی را فراتر از صفحه نمایش های تخت سنتی گسترش می دهد. شما می توانید تجربه های همه جانبه ای طراحی کنید که واقعیت فیزیکی و مجازی را با هم ترکیب کنند. چه در حال ساختن یک تجربه کاملاً جدید باشید و چه در حال افزودن عناصر فراگیر به یک برنامه موجود، راهنمای طراحی برای Android XR می تواند به شما در شروع کار کمک کند.

فایل مانیفست برنامه خود را پیکربندی کنید

مانند سایر پروژه های برنامه Android، برنامه Android XR شما باید دارای یک فایل AndroidManifest.xml با تنظیمات مانیفست خاص باشد. فایل مانیفست اطلاعات ضروری در مورد برنامه شما را برای ابزارهای ساخت Android، سیستم عامل Android و Google Play توضیح می دهد. برای اطلاعات بیشتر به راهنمای نمای کلی مانیفست برنامه مراجعه کنید.

توجه: اگر از یکی از بسته‌های Android XR برای Unity استفاده می‌کنید، نیازی به افزودن این عناصر یا ویژگی‌ها به صورت دستی ندارید. بسته های Unity بر اساس تنظیمات پروژه و ساخت، مانیفست را برای برنامه شما ایجاد می کنند.

برای برنامه‌های متمایز XR ، فایل مانیفست شما باید دارای عناصر و ویژگی‌های زیر باشد:

ویژگی PROPERTY_ACTIVITY_XR_START_MODE

ویژگی android:name="android.window.PROPERTY_ACTIVITY_XR_START_MODE" به سیستم این امکان را می دهد که هنگام شروع فعالیت، یک فعالیت باید در حالت خاصی راه اندازی شود.

سه مقدار ممکن برای این ویژگی وجود دارد:

• XR_ACTIVITY_START_MODE_HOME_SPACE (فقط Jetpack XR SDK)
• XR_ACTIVITY_START_MODE_FULL_SPACE_MANAGED (فقط Jetpack XR SDK)
• XR_ACTIVITY_START_MODE_FULL_SPACE_UNMANAGED (فقط OpenXR)

XR_ACTIVITY_START_MODE_HOME_SPACE

(برنامه هایی که فقط با Jetpack XR SDK ساخته شده اند)

از این حالت شروع برای راه اندازی برنامه خود در Home Space استفاده کنید. در Home Space، چندین برنامه می توانند در کنار هم اجرا شوند، بنابراین کاربران می توانند چند کار را انجام دهند. هر برنامه اندرویدی تلفن همراه یا صفحه نمایش بزرگ می تواند در Home Space و همچنین برنامه های XR ساخته شده با استفاده از Jetpack XR SDK کار کند.

<manifest ... >

   <application ... >
       <property
           android:name="android.window.PROPERTY_XR_ACTIVITY_START_MODE"
           android:value="XR_ACTIVITY_START_MODE_HOME_SPACE" />
       <activity
           android:name="com.example.myapp.MainActivity" ... >

           <intent-filter>
               <action android:name="android.intent.action.MAIN" />

               <category android:name="android.intent.category.LAUNCHER" />
           </intent-filter>
       </activity>
   </application>
</manifest>

XR_ACTIVITY_START_MODE_FULL_SPACE_MANAGED

(برنامه هایی که فقط با Jetpack XR SDK ساخته شده اند)

از این حالت شروع برای راه اندازی برنامه خود در فضای کامل استفاده کنید. در فضای کامل، تنها یک برنامه در یک زمان اجرا می شود، بدون محدودیت فضایی، و همه برنامه های دیگر پنهان هستند.

<manifest ... >

   <application ... >
       <property
           android:name="android.window.PROPERTY_XR_ACTIVITY_START_MODE"
           android:value="XR_ACTIVITY_START_MODE_FULL_SPACE_MANAGED" />
       <activity
           android:name="com.example.myapp.MainActivity" ... >

           <intent-filter>
               <action android:name="android.intent.action.MAIN" />

               <category android:name="android.intent.category.LAUNCHER" />
           </intent-filter>
       </activity>
   </application>
</manifest>

XR_ACTIVITY_START_MODE_FULL_SPACE_UNMANAGED

(برنامه های ساخته شده فقط با OpenXR)

برنامه‌هایی که با OpenXR در فضای کامل راه‌اندازی می‌شوند و باید از حالت شروع XR_ACTIVITY_START_MODE_FULL_SPACE_UNMANAGED استفاده کنند. سیگنال های فضای کامل مدیریت نشده به Android XR برنامه از OpenXR استفاده می کند.

توجه: اگر از یکی از بسته‌های Android XR برای Unity استفاده می‌کنید، برنامه شما نیز در فضای کامل راه‌اندازی می‌شود. با این حال، لازم نیست این مورد را به صورت دستی به مانیفست خود اضافه کنید. بسته های Unity بر اساس تنظیمات پروژه و ساخت، مانیفست را برای برنامه شما ایجاد می کنند.

<manifest ... >

   <application ... >
       <property
           android:name="android.window.PROPERTY_XR_ACTIVITY_START_MODE"
           android:value="XR_ACTIVITY_START_MODE_FULL_SPACE_UNMANAGED" />
       <activity
           android:name="com.example.myapp.MainActivity" ... >

           <intent-filter>
               <action android:name="android.intent.action.MAIN" />

               <category android:name="android.intent.category.LAUNCHER" />
           </intent-filter>
       </activity>
   </application>
</manifest>

ویژگی های PackageManager برای برنامه های XR

وقتی برنامه ها را از طریق فروشگاه Google Play توزیع می کنید ، می توانید ویژگی های سخت افزاری یا نرم افزاری مورد نیاز را در مانیفست برنامه مشخص کنید. عنصر uses-feature به Play Store اجازه می دهد تا برنامه های نمایش داده شده به کاربران را به درستی فیلتر کند.

ویژگی های زیر مختص برنامه های XR است.

android.software.xr.immersive

اگر برنامه شما پلتفرم Android XR را هدف قرار می دهد و فقط روی پلتفرم هایی اجرا می شود که از XR پشتیبانی می کنند، مقدار را روی true تنظیم کنید. اگر برنامه شما دارای برخی ویژگی‌های بهینه‌شده XR است اما می‌تواند روی دستگاه‌های غیر XR نیز اجرا شود، مقدار را روی false تنظیم کنید.

برنامه هایی که با OpenXR یا Unity ساخته شده اند باید این مقدار را روی true تنظیم کنند.

<uses-feature android:name="android.software.xr.immersive" android:required="true" />

android.hardware.xr.input.controller

این ویژگی نشان می دهد که برنامه برای عملکرد صحیح به ورودی یک کنترلر حرکتی با دقت بالا و 6DoF (درجه آزادی) نیاز دارد. اگر برنامه شما از کنترلرها پشتیبانی می کند و نمی تواند بدون آنها کار کند، مقدار را روی true تنظیم کنید. اگر برنامه شما از کنترلرها پشتیبانی می کند اما می تواند بدون آنها کار کند، آن را روی false تنظیم کنید.

توجه: کنترل‌کننده‌های حرکتی 6DoF یک جفت کنترل‌کننده سخت‌افزاری هستند، یکی برای هر دست. هر کنترل کننده به طور مستقل در فضا از طریق شش درجه آزادی - هر دو حرکت خطی و چرخشی - ردیابی می شود. این کنترلرها معمولا دارای چندین دکمه سخت افزاری از جمله یک ماشه و همچنین بازخورد لمسی هستند.

<uses-feature android:name="android.hardware.xr.input.controller" android:required="true" />

android.hardware.xr.input.hand_tracking

این پرچم نشان می دهد که برنامه برای عملکرد صحیح به ردیابی دست با وفاداری بالا از جمله موقعیت، جهت و سرعت مفاصل در دست کاربر نیاز دارد. اگر برنامه شما از ردیابی دست پشتیبانی می کند و بدون آن نمی تواند کار کند، مقدار را روی true تنظیم کنید. اگر برنامه شما از ردیابی دست پشتیبانی می کند، اما می تواند بدون آن کار کند، آن را روی false تنظیم کنید.

توجه: این پرچم برای تشخیص حرکات اولیه مانند نیشگون گرفتن، نوک زدن، هدف گیری و گرفتن لازم نیست.

<uses-feature android:name="android.hardware.xr.input.hand_tracking" android:required="true" />

android.hardware.xr.input.eye_tracking

این پرچم نشان می دهد که برنامه برای عملکرد صحیح ورودی به ردیابی چشم با وفاداری بالا نیاز دارد. اگر برنامه شما از ردیابی چشم برای ورودی پشتیبانی می کند و بدون آن نمی تواند کار کند، مقدار را روی true تنظیم کنید. اگر برنامه شما از ردیابی چشم برای ورودی پشتیبانی می کند، اما می تواند بدون آن کار کند، آن را روی false تنظیم کنید.

<uses-feature android:name="android.hardware.xr.input.eye_tracking" android:required="true" />

توجه: ردیابی دست و ردیابی چشم روش‌های ورودی حساس به حریم خصوصی هستند و برنامه‌ها را ملزم به درخواست مجوزهای ویژه می‌کنند. برای اطلاعات بیشتر در مورد اعلام مجوزها به درک مجوزهای XR در این صفحه مراجعه کنید.

ملاحظات سازگاری مانیفست برنامه برای برنامه های موبایل و صفحه نمایش بزرگ

توجه: این بخش فقط برای برنامه های موبایل یا صفحه نمایش بزرگ که برای XR بهینه نشده اند اعمال می شود. به طور پیش‌فرض، این نوع برنامه‌های اندروید روی اندروید XR اجرا می‌شوند. با این حال، اگر برنامه شما به یک یا چند ویژگی در این بخش نیاز داشته باشد، برنامه در فروشگاه Play در Android XR نشان داده نخواهد شد.

همانطور که در بخش ویژگی‌های PackageManager برای برنامه‌های XR توضیح داده شد، برنامه‌ها اعلام می‌کنند که از یک ویژگی با اعلام آن در عنصر <uses-feature> در مانیفست برنامه استفاده می‌کنند. برخی از ویژگی ها، مانند تلفن یا GPS، ممکن است با همه دستگاه ها سازگار نباشند.

توجه: برای دریافت فهرستی از ویژگی‌هایی که برای یک دستگاه فعال هستند، adb shell pm list features اجرا کنید.

ویژگی های پشتیبانی نشده

فروشگاه Google Play برنامه‌های موجود برای نصب در دستگاه را با استفاده از اعلامیه‌های ویژگی Android زیر فیلتر می‌کند .

احتیاط: اگر برنامه شما به ویژگی نیاز دارد که در دستگاه پشتیبانی نمی‌شود، آن برنامه برای نصب از فروشگاه Play برای دستگاه‌های XR در دسترس نخواهد بود. اگر برنامه شما از این ویژگی استفاده می کند، اما برای اجرا بدون آن طراحی شده است، باید android:required="false " را تنظیم کنید. برای مثال، <uses-feature android:name="android.hardware.location.gps" android:required="false" /> .

سخت افزار دوربین

android.hardware.camera.ar

android.hardware.camera.autofocus

android.hardware.camera.capability.manual_post_processing

android.hardware.camera.capability.manual_sensor

android.hardware.camera.capability.raw

android.hardware.camera.concurrent

android.hardware.camera.external

android.hardware.camera.flash

android.hardware.camera.level.full

قابلیت اتصال

android.hardware.ethernet

android.hardware.uwb

android.hardware.ipsec_tunnel_migration

پیکربندی دستگاه

android.hardware.ram.low

پیکربندی فاکتور فرم

android.hardware.type.automotive

android.hardware.type.embedded

android.hardware.type.pc

android.hardware.type.television

android.hardware.type.watch

android.software.leanback

android.software.leanback_only

android.software.live_tv

ورودی

android.hardware.consumerir

android.software.input_methods

مکان

android.hardware.location.gps

ارتباط میدان نزدیک

android.hardware.nfc

android.hardware.nfc.ese

android.hardware.nfc.hce

android.hardware.nfc.hcef

android.hardware.nfc.uicc

android.hardware.nfc.beam

پیکربندی امنیتی و سخت افزار

android.hardware.se.omapi.ese

android.hardware.se.omapi.sd

android.hardware.se.omapi.uicc

android.hardware.biometrics.face

android.hardware.fingerprint

android.hardware.identity_credential

android.hardware.identity_credential_direct_access

android.hardware.keystore.limited_use_key

android.hardware.keystore.single_use_key

android.hardware.strongbox_keystore

حسگرها

android.hardware.sensor.accelerometer_limited_axes

android.hardware.sensor.accelerometer_limited_axes_uncalibrated

android.hardware.sensor.ambient_temperature

android.hardware.sensor.barometer

android.hardware.sensor.gyroscope_limited_axes

android.hardware.sensor.gyroscope_limited_axes_uncalibrated

android.hardware.sensor.heading

android.hardware.sensor.heartrate

android.hardware.sensor.heartrate.ecg

android.hardware.sensor.hinge_angle

android.hardware.sensor.light

android.hardware.sensor.relative_humidity

android.hardware.sensor.stepcounter

android.hardware.sensor.stepdetector

پیکربندی نرم افزار

android.software.backup

android.software.connectionservice

android.software.expanded_picture_in_picture

android.software.live_wallpaper

android.software.picture_in_picture

android.software.telecom

android.software.wallet_location_based_suggestions

تلفن

android.hardware.telephony

android.hardware.telephony.calling

android.hardware.telephony.cdma

android.hardware.telephony.data

android.hardware.telephony.euicc

android.hardware.telephony.euicc.mep

android.hardware.telephony.gsm

android.hardware.telephony.ims

android.hardware.telephony.mbms

android.hardware.telephony.messaging

android.hardware.telephony.radio.access

android.hardware.telephony.subscription

android.software.sip

android.software.sip.voip

واقعیت مجازی (میراث)

android.hardware.vr.headtracking

android.hardware.vr.high_performance

android.software.vr.mode

ابزارک ها

android.software.app_widgets

درک مجوزهای XR

درست مانند برنامه‌ها در دستگاه‌های تلفن همراه و سایر عوامل شکل، برخی از عملکردهای ارائه شده توسط برنامه‌های XR ممکن است به برنامه شما نیاز داشته باشد که مجوزها را در فایل AndroidManifest برنامه شما اعلام کند . در مورد مجوزهای خطرناک، برنامه شما ممکن است نیاز به درخواست مجوزهای زمان اجرا داشته باشد. برای اطلاعات عمیق تر، مجوزها را در Android و بهترین شیوه های مجوز را بخوانید.

مجوز برای ویژگی های XR

مجوزهای زیر ممکن است توسط برنامه های XR استفاده شود. همه مجوزهای موجود در این بخش مجوزهای خطرناکی در نظر گرفته می شوند، بنابراین باید آنها را در مانیفست برنامه خود اعلام کنید و در زمان اجرا درخواست کنید.

android.permission.EYE_TRACKING

از مواردی استفاده کنید که به این مجوز نیاز دارند

نشان دادن حالت و جهت گیری چشم کاربر، برای اهداف آواتارها

ویژگی‌های Jetpack XR SDK که به این مجوز نیاز دارند

n/a

پسوندهای OpenXR که به این مجوز نیاز دارند

XR_ANDROID_avatar_eyes

ویژگی های یونیتی که به این مجوز نیاز دارند

Android XR: AR Face

android.permission.EYE_TRACKING_FINE

از مواردی استفاده کنید که به این مجوز نیاز دارند

ورودی نگاه و تعاملات چشمی

ویژگی‌های Jetpack XR SDK که به این مجوز نیاز دارند

n/a

پسوندهای OpenXR که به این مجوز نیاز دارند

XR_EXT_eye_gaze_interaction

ویژگی های یونیتی که به این مجوز نیاز دارند

Eye Gaze Interaction

android.permission.FACE_TRACKING

از مواردی استفاده کنید که به این مجوز نیاز دارند

ردیابی و رندر حالات چهره

ویژگی‌های Jetpack XR SDK که به این مجوز نیاز دارند

n/a

پسوندهای OpenXR که به این مجوز نیاز دارند

XR_ANDROID_face_tracking

ویژگی های یونیتی که به این مجوز نیاز دارند

XRFaceTrackingFeature

android.permission.HAND_TRACKING

توجه: این مجوز برای تشخیص حرکات اولیه مانند نیشگون گرفتن، نوک زدن، هدف گیری و گرفتن لازم نیست.

از مواردی استفاده کنید که به این مجوز نیاز دارند

ردیابی موقعیت های مفصل دست و سرعت های زاویه ای و خطی. با استفاده از نمایش مش از دست های کاربر

ویژگی‌های Jetpack XR SDK که به این مجوز نیاز دارند

n/a

پسوندهای OpenXR که به این مجوز نیاز دارند

XR_ANDROID_hand_mesh

XR_EXT_hand_tracking

ویژگی های یونیتی که به این مجوز نیاز دارند

XR Hands

XRHandMeshFeature

android.permission.SCENE_UNDERSTANDING

از مواردی استفاده کنید که به این مجوز نیاز دارند

تخمین نور؛ پخش گذر بر روی سطوح مش. انجام پرتوهای ردیابی در محیط. ردیابی هواپیما؛ ردیابی اشیا؛ کار با عمق برای تست انسداد و ضربه؛ لنگرهای مداوم

ویژگی‌های Jetpack XR SDK که به این مجوز نیاز دارند

ردیابی هواپیما

تست زدن را بزنید

پایداری لنگر

پسوندهای OpenXR که به این مجوز نیاز دارند

XR_ANDROID_anchor_persistence

XR_ANDROID_depth_texture

XR_ANDROID_light_estimation

XR_ANDROID_composition_layer_passthrough_mesh

XR_ANDROID_raycast

XR_ANDROID_trackables

XR_ANDROID_trackables_object

ویژگی های یونیتی که به این مجوز نیاز دارند

XRAnchorFeature

XRDepthTextureFeature

XRLightEstimationFeature

XRPassthroughFeature

XRTrackableFeature

XRObjectTrackingFeature

از کیفیت برنامه Android XR اطمینان حاصل کنید

برای اطمینان از اینکه برنامه شما یک تجربه کاربری عالی ارائه می دهد، دستورالعمل های کیفیت برنامه Android XR ما را مرور کنید.

برنامه خود را برای Android XR بسته بندی و توزیع کنید

Android XR طیف گسترده ای از برنامه ها و تجربیات را از طریق Google Play به هدست های XR می آورد. در راهنمای بسته‌بندی و توزیع برنامه‌ها برای Android XR ، اطلاعاتی درباره شروع کار با Play Store و Play Console، انتشار آهنگ‌ها، آماده‌سازی بسته‌های برنامه Android و محدودیت‌های اندازه برنامه پیدا خواهید کرد.