برای Jetpack XR با ARCore کار کنید

ARCore برای Jetpack XR به برنامه‌ها اجازه می‌دهد تا با مفاهیم اولیه واقعیت افزوده (AR)، با استفاده از مفاهیم اولیه درک صحنه و ردیابی حرکت کار کنند. هنگام ایجاد تجربیات AR از ARCore برای Jetpack XR استفاده کنید و باید از داده های مسطح استفاده کنید یا محتوا را به یک مکان ثابت در فضا متصل کنید.

چرخه عمر Session را درک کنید

همه اشیاء ردیابی شده توسط ARCore برای Jetpack XR باید از طریق یک Session قابل دسترسی باشند. مشابه چرخه حیات Activity ، اشیاء Session همچنین دارای چرخه حیاتی هستند که باید مطابق با استفاده برنامه شما از ویژگی‌های یک شی Session حفظ شود. اگر برنامه شما دارای یک فعالیت فعال با XR است، چرخه عمر Session را با استفاده از یک مؤلفه Lifecycle-aware مدیریت کنید.

دسترسی به یک Session

هنگام استفاده از ARCore برای Jetpack XR باید یک Session ایجاد شود .

هنگام استفاده از Jetpack Compose برای XR، از LocalSession برای دسترسی به جلسه ای که برای شما ایجاد شده است استفاده کنید.

یک جلسه را از سر بگیرید

از سرگیری یک جلسه باید زمانی انجام شود که برنامه شما برای مدیریت تغییرات وضعیت از ARCore برای Jetpack XR آماده باشد. در بسیاری از موارد، این کار در پاسخ به تماس onResume() Activity شما انجام می شود، اما برنامه شما ممکن است بخواهد پردازش را تا زمان تعامل کاربر به تعویق بیندازد.

قطعه کد زیر نمونه ای از از سرگیری یک جلسه را نشان می دهد. 

when (val result = session.resume()) {
    is SessionResumeSuccess -> {
        // Session has been created successfully.
        // Attach any successful handlers here.
    }

    is SessionResumePermissionsNotGranted -> {
        // Request permissions in `result.permissions`.
    }
}
Session.kt

SessionResumeResult برای دلایل عدم از سرگیری Session ببینید.

یک جلسه را متوقف کنید

وقتی فعالیت شما به پس‌زمینه رفت، با استفاده از [ Session.pause() ][Session.pause] Session را متوقف کنید. توقف موقت یک جلسه، ردیابی را تا زمان از سرگیری جلسه متوقف می کند و وضعیت سیستم ادراک را حفظ می کند.

یک جلسه را از بین ببرید

برای از بین بردن دائمی یک Session ، از [ Session.destroy() ][Session.destroy] استفاده کنید. این کار منابع در حال استفاده توسط جلسه را آزاد می کند و تمام حالت های جلسه را از بین می برد.

همچنین ببینید