اشیاء را فوراً قرار دهید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
راهنماهای مخصوص پلتفرم
Instant Placement API به کاربر این امکان را می دهد که اشیاء AR را فوراً قرار دهد، بدون اینکه ابتدا دستگاه خود را حرکت دهد تا ARCore بتواند ردیابی کامل و تشخیص هندسه سطح را ایجاد کند.
پس از اینکه کاربر یک شی را قرار داد، هنگام حرکت کاربر در محیط، حالت آن در زمان واقعی اصلاح می شود. هنگامی که ARCore بتواند موقعیت صحیح را در منطقه ای که شی AR قرار داده شده است تعیین کند، حالت و روش ردیابی شی را به روز می کند.
در مثال زیر، یک شی در ابتدا با استفاده از یک حالت تخمینی قرار می گیرد که با رنگ خاکستری آن مشخص می شود. هنگامی که بتوان یک ژست دقیق را تعیین کرد، جسم رنگی می شود که نشان می دهد از یک ژست دقیق استفاده می کند. تغییر ناگهانی ژست روی "اندازه" ظاهری یا مقیاس درک شده شی نیز تأثیر می گذارد.
در شکل 1، Instant Placement غیرفعال است و هندسه سطح تعریف نشده است. اشیایی که در سمت راست میز بیلیارد روی زمین قرار می گیرند (چهار نقطه کوچک آبی رنگ) به نظر می رسد ضربه خورده است، وضعیت آنها نامشخص است.
در شکل 2، Instant Placement از منوی زیر نماد چرخ دنده فعال شده است.
در شکل 3، با فعال کردن Instant Placement، یک شی جدید در صحنه قرار می گیرد. به جای رنگی در مقیاس خاکستری به نظر می رسد که نشان می دهد هنوز برای یک حالت دقیق تصحیح نشده است.
در شکل 4، زمانی که هندسه سطح (توصیف شده توسط خطوط شبکه قابل ردیابی ) تشخیص داده شود، شی جدید رنگی می شود و حالت آن دقیق است.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThis page provides developer guides for instant placement in AR experiences using various platforms like Android, Unity, and Unreal Engine.\u003c/p\u003e\n"],["\u003cp\u003eInstant Placement allows users to place AR objects immediately without waiting for full tracking, enhancing the user experience.\u003c/p\u003e\n"],["\u003cp\u003eInitially placed objects have an estimated pose, which is later refined for accuracy as ARCore gathers more environmental data.\u003c/p\u003e\n"],["\u003cp\u003eVisual cues, such as grayscale, indicate when an object's pose is estimated and transitions to color when the pose becomes accurate.\u003c/p\u003e\n"],["\u003cp\u003eThe provided figures illustrate the difference between instant placement enabled and disabled, showcasing the pose refinement process.\u003c/p\u003e\n"]]],[],null,["# Place objects instantly\n\n**Platform-specific guides** \n\n### Android (Kotlin/Java)\n\n- [Instant placement developer guide for Android (Java)](/ar/develop/java/instant-placement/developer-guide)\n\n### Android NDK (C)\n\n- [Instant placement developer guide for Android NDK](/ar/develop/c/instant-placement/developer-guide)\n\n### Unity (AR Foundation)\n\n- [Instant placemnt developer guide for Unity (AR Foundation)](/ar/develop/unity-arf/instant-placement/developer-guide)\n\n### Unreal Engine\n\n- [ARCore SDK for Unreal Engine (official documentation)](https://docs.unrealengine.com/5.0/en-US/developing-for-arcore-in-unreal-engine/)\n\nThe Instant Placement API allows the user to place AR objects instantly, without\nhaving to first move their device to allow ARCore to establish full tracking and\ndetect surface geometry.\n\nAfter the user has placed an object, its pose is refined in real time as the\nuser moves through the environment. Once ARCore is able to determine the correct\npose in the region where the AR object has been placed, it updates the object's\npose and tracking method.\n\nIn the following example, an object is initially placed using an estimated pose,\nwhich is indicated by its grayscale color. Once an accurate pose can be determined,\nthe object becomes colored, indicating that it is using an accurate pose. The\nsudden change in pose also affects the apparent \"size\" or perceived scale of the\nobject.\n\nIn Figure 1, Instant Placement is disabled and surface geometry is undefined.\nObjects placed on the floor to the right of the pool table (four small blue dots)\nappear knocked-over, their poses are undefined.\n\nIn Figure 2, Instant Placement is enabled from the menu under the gear icon.\n\nIn Figure 3, with Instant Placement enabled, a new object is placed in the scene.\nIt appears in grayscale, instead of colored, to denote that it has not been\ncorrected for an accurate pose yet.\n\nIn Figure 4, the new object becomes colored, and its pose is accurate, when the\nsurface geometry (described by the *trackable* grid lines) is detected."]]
