تغييرات جديدة وملحوظة في ARCore
الميزات الجديدة في الإصدار 1.45.0 من ARCore
واجهة برمجة تطبيقات وضع الفلاش
يتيح تطبيق ARCore الآن تفعيل وضع الكشاف في الجهاز، ما يتيح وإمكانيات الإدراك في البيئات المظلمة
Android (Kotlin/Java)
Config.FlashMode
: خيار ضبط لتفعيل وحدة الفلاش أو إيقافها على الجهاز- راجِع دليل المطوِّر للحصول على مزيد من التفاصيل حول كيفية اكتشاف إمكانات الفلاش وكيفية تفعيل وضع الفلاش.
Android NDK (C)
ArFlashMode
: خيار ضبط لتفعيل وحدة الفلاش أو إيقافها على الجهاز- راجِع دليل المطوِّر للحصول على مزيد من التفاصيل حول كيفية اكتشاف إمكانات الفلاش وكيفية تفعيل وضع الفلاش.
تدعم ARCore extensions for Unity's AR Foundation تطبيق AR Foundation 5
أصبحت ARCore extensions for AR Foundation توفّر الآن رسميًا AR Foundation 5: عند استخدام AR Foundation 5 (الإصدار الذي تم التحقّق منه في إصدارات Unity 2022 2023)، يمكنك استخدام طرق التثبيت التالية للحصول على إصدار متوافق من إضافات ARCore لمؤسسة AR:
- من خلال
Add package from git url...
: استخدامhttps://github.com/google-ar/arcore-unity-extensions.git#arf5
- حتى
Add package from tarball...
: استخدِم إصدارًا يحمل الاسمarf5
من صفحة الإصدارات.
يمكن للمشروعات المتبقية في الإصدار 4 من AR Foundation استخدام عملية التثبيت التالية الطرق:
- من خلال
Add package from git url...
: استخدامhttps://github.com/google-ar/arcore-unity-extensions.git#arf4
- حتى
Add package from tarball...
: استخدِم إصدارًا يحمل الاسمarf4
من صفحة الإصدارات.
لترقية مشروعك من AR Foundation 4 إلى AR Foundation 5، يُرجى الاطّلاع على migration guide.
رموز البرمجة النصية المخصّصة
مثل ARCORE_USE_ARF_5
من الدعم التجريبي.
الميزات الجديدة في الإصدار 1.44.0 من ARCore
لا يحتوي هذا الإصدار على ميزات جديدة.
الميزات الجديدة في الإصدار 1.43.0 من ARCore
واجهة Places API في نقل بيانات Geospatial Creator
تستخدم ميزة البحث في Geospatial Creator الآن New Places API من Google. لاستخدام ميزة البحث، فعِّل "Places API (New) (واجهة برمجة تطبيقات الأماكن (جديد))" في Google Cloud Console.
الميزات الجديدة في الإصدار 1.42.0 من ARCore
التقط صورة لـ Tile في Geospatial Creator for Unity
"محاذاة إلى الشاشة" تمت إضافة الزر إلى ARGeospatialCreatorAnchor
.
لوحة "أداة فحص المحرّر" يعين هذا الزر علامة ارتساء للتضاريس أو السطح
قيمة الارتفاع للمحرر فقط إلى أعلى هندسة الشكل الثلاثي الأبعاد في علامة الارتساء
خط العرض وخط الطول الحاليَين. تجدر الإشارة إلى أنّ هذه السمة لا تؤثّر في
السلوك في وقت التشغيل. ويساعد هذا في تعديل موضع الإرساء في المحرر
تطابق موضعها في وقت التشغيل
الميزات الجديدة في الإصدار 1.41.0 من ARCore
واجهة برمجة التطبيقات Geospatial Creator API
يتيح تطبيق Geospatial Creator for Unity الآن إنشاء عناصر Geospatial Creator ومعالجتها في وضع "Editor" (المحرر). يمكنك الاطّلاع على الفئات وواجهات برمجة التطبيقات المتوفّرة حديثًا في دليل واجهة برمجة التطبيقات Geospatial Creator API.
دعم الإصدار 5.x من AR Foundation (إصدار تجريبي)
أصبحت إصدارات ARCore الإضافات التي توفّرها Unity من مؤسسة AR Foundation متوافقة الآن مع إصدارات AR Foundation 5.x. لنقل مشروع حالي إلى AR Foundation، يُرجى الاطّلاع على migration guide.
الميزات الجديدة في الإصدار 1.40.0 من ARCore
دلالات المشهد على iOS
Scene Semantics API متوفّرة الآن في حزمة ARCore SDK لنظام التشغيل iOS وكذلك في ARCore extensions for Unity's AR Foundation تستهدف النظام الأساسي iOS. تتيح واجهة برمجة التطبيقات Scene Semantics للمطوّرين فهم المشهد المحيط بالمستخدم في الوقت الفعلي، مع تصنيف وحدات البكسل إلى 11 وفئات المكونات الخارجية. راجِع قسم مقدمة عن المنظر. دلالات الألفاظ لمزيد من المعلومات.
iOS
الانسجام (AR Foundation)
البحث عن نقاط الاهتمام في Geospatial Creator for Unity
يدعم Geospatial Creator for Unity الآن البحث النصي لوضع عرض مربّعات تصويرية ثلاثية الأبعاد عرض البحث عن نقاط الاهتمام في أداة إنشاء المواقع الجغرافية لمزيد من المعلومات.
الميزات الجديدة في الإصدار 1.39.0 من ARCore
لا يحتوي هذا الإصدار على ميزات جديدة.
الميزات الجديدة في الإصدار 1.38.0 من ARCore
لا يحتوي هذا الإصدار على ميزات جديدة.
الميزات الجديدة في الإصدار 1.37.0 من ARCore
دلالات المشهد
يوفر دلالات المشهد تفاصيل أكثر تفصيلاً حول المشهد المحيط، مما يسهل فهم العالم من حول المستخدم. تشغّل Scene Demantics نموذج تعلُّم الآلة في خلاصة صورة الكاميرا وتوفّر صورة دلالية مع كل بكسل تقابل أحد التصنيفات الـ 11 للمفاهيم المتوفّرة في الهواء الطلق.
للحصول على مزيد من المعلومات، يمكنك الاطّلاع على مقدمة عن دلالات المشهد ونموذج تطبيق semantics_java.
Android (Kotlin/Java)
Android NDK (C)
الانسجام (AR Foundation)
iOS
يمكنك الاطّلاع على الميزات الجديدة في الإصدار 1.40.0 من ARCore.
هندسة "التجوّل الافتراضي"
Geosscape Geometry هي واجهة برمجة تطبيقات جديدة من ARCore Geospatial API توفر هندسة المباني والتضاريس في منطقة حول المستخدم عند تفعيل Geospatial API.
Android (Kotlin/Java)
اطّلِع على دليل المطوِّرين حول الهندسة المعمارية في صور "التجوّل الافتراضي" (Kotlin/Java). بالإضافة إلى ذلك، تم تحديث نموذج تطبيق geospatial_java بحيث يتضمن هندسة التجوّل الافتراضي.
Android NDK (C)
راجع دليل المطوِّر (C) لهندسة التجوّل الافتراضي للحصول على مزيد من المعلومات.
الانسجام (AR Foundation)
اطّلِع على دليل المطوِّرين الهندسيين في "التجوّل الافتراضي" (Unity) للحصول على مزيد من المعلومات.
iOS
راجع دليل المطوِّر لهندسة التجوّل الافتراضي (iOS) للحصول على مزيد من المعلومات. إضافةً إلى ذلك، تم تحديث تطبيق GeospatialExample لتضمين هندسة التجوّل الافتراضي.
GARStreetscapeGeometry
:- يوفّر
GARStreetscapeGeometry.mesh
شبكات ثلاثية الأبعاد. - توفّر
GARStreetscapeGeometry.meshTransform
تحويل الأصل للشكل الهندسي بالنسبة إلى مساحة العالم للجلسة. - يحافظ
GARStreetscapeGeometry.trackingState
على حالة التتبّع. - يشير الرمز
GARStreetscapeGeometry.type
إلى ما إذا كان تضاريس أو هندسة مبنى. - يوفر
GARStreetscapeGeometry.quality
جودة الشكل الهندسي. - توفّر
GARStreetscapeGeometry.identifier
المعرّف الفريد للشكل الهندسي. - تنشئ
GARSession.createAnchorOnStreetscapeGeometry:transform:error:
علامة ارتساء في الموقع والاتجاه المحدّدَين. - يُجري
GARSession.raycastStreetscapeGeometry:direction:error:
بثًا شعاعيًا أمام "هندسة التجوّل الافتراضي" التي يتم تحميلها في المشهد.
مُثبّتات الأسطح
تُعد مثبتات الأسطح من نوع الإرساء الجديد المكاني الذي يساعدك في تثبيت المحتوى على السطح.
Android (Kotlin/Java)
راجع علامات الارتساء الجغرافية المكانية (Java). بالإضافة إلى ذلك، تم تحديث نموذج تطبيق geospatial_java ليشمل مراسي الأسطح السطحي.
Android NDK (C)
راجع علامات الارتساء الجغرافية المكانية (C) للحصول على مزيد من المعلومات.
الانسجام (AR Foundation)
راجع علامات الارتساء الجغرافية المكانية للحصول على مزيد من المعلومات. بالإضافة إلى ذلك، تم تعديل العينة الجغرافية المكانية لتشمل مراسي الأسطح.
- توفّر
ARAnchorManagerExtensions.ResolveAnchorOnRooftopAsync()
علامة ارتساء لعناصر اللعبة في المشهد عند خط العرض وخط الطول والارتفاع المحدّد فوق السطح واتجاهه. ResolveAnchorOnRooftopPromise
ResolveAnchorOnRooftopResult
iOS
راجع علامات الارتساء الجغرافية المكانية (iOS) للحصول على مزيد من المعلومات. بالإضافة إلى ذلك، تم تحديث تطبيق GeospatialExample ليشمل الإعلانات الثابتة على السطح.
GARSession.createAnchorWithCoordinate:altitudeAboveRooftop:eastUpSouthQAnchor:completionHandler:error:
ينشئ ارتساء "السطح" في الموقع المحدد، الارتفاع فوق السطح بالأمتار والاتجاه بالنسبة إلى الأرض.- يحمل
GARCreateAnchorOnRooftopFuture
الحالة غير المتزامنة لحل ثابت في السقف. - يصف
GARRooftopAnchorState
حالة تركيب مُثبّت على السطح.
العمق الجغرافي المكاني
عند تفعيل كل من وضعَي Depth API و Streetscape Geometry في جلسة ARCore في المناطق التي تتوفّر فيها تغطية VPS، يتم تحسين صور العمق التي تم إنشاؤها باستخدام ميزة Streetscape Geometry. يتم دمج "هندسة التجوّل الافتراضي" في كل صورة بعمق يتم إنشاؤها في نطاق 65.535 مترًا. لا حاجة إلى إجراء أي تغييرات عند طلب واجهة برمجة التطبيقات Depth API للاستفادة من هذه الميزة.
Android (Kotlin/Java)
راجع العمق الجغرافي المكاني (Java) للحصول على مزيد من المعلومات.
Android NDK (C)
راجِع العمق الجغرافي المكاني (C) للحصول على مزيد من المعلومات.
الانسجام (AR Foundation)
راجِع العمق الجغرافي المكاني (C) للحصول على مزيد من المعلومات.
iOS
دلالات المشهد غير متاحة حاليًا لنظام التشغيل iOS.
دعم عرض Vulkan
توفِّر ARCore الآن دعم عرض Vulkan من خلال عرض صورة الكاميرا باستخدام AHardwareBuffer
. يمكنك استخدام "مخزن الأجهزة المؤقت" هذا من خلال ربطه بـ VkImage
.
لمزيد من المعلومات، يمكنك الاطّلاع على عرض تطبيق ARCore باستخدام Vulkan وhello_ar_vulkan_c نموذج التطبيق.
Android (Kotlin/Java)
Android NDK (C)
الانسجام (AR Foundation)
لا يتوفّر عرض Vulkan حاليًا في Unity باستخدام AR Foundation.
التثبيت الإلكتروني للصورة (EIS)
يمكنك ضبط تطبيق ARCore لاستخدام ميزة "تثبيت الصورة الإلكتروني" التي تعمل على تجانس إطارات الكاميرا لتوفير تجربة أكثر سلاسة للمستخدم.
لمزيد من المعلومات، اطّلِع على مقالة تفعيل ميزة "تثبيت الصورة الإلكترونية" ونموذج تطبيق hello_eis_kotlin.
Android (Kotlin/Java)
Config.ImageStabilizationMode
Frame.transformCoordinates3d()
Session.isImageStabilizationModeSupported()
- هناك مشكلة معروفة حيث يؤدي طلب
Frame.transformCoordinates3d()
باستخدام إحداثيات ثنائية الأبعاد بخلافOPENGL_NORMALIZED_DEVICE_COORDINATES
إلى حدوث عُطل بدلاً من رميIllegalArgumentException
. سيتم حل هذه المشكلة في الإصدار التالي.
Android NDK (C)
ArImageStabilizationMode
ArFrame_transformCoordinates3d()
ArSession_isImageStabilizationModeSupported()
- هناك مشكلة معروفة تؤدي إلى إلغاء تطبيقك بدلاً من عرض
AR_ERROR_INVALID_ARGUMENT
باستخدامArFrame_transformCoordinates3d()
باستخدام إحداثيات ثنائية الأبعاد بخلافAR_COORDINATES_2D_OPENGL_NORMALIZED_DEVICE_COORDINATES
. سيتم حل هذه المشكلة في الإصدار التالي.
الانسجام (AR Foundation)
لا تتوفّر أداة EIS حاليًا في Unity باستخدام AR Foundation.
iOS
لا تتوفّر ميزة EIS حاليًا لنظام التشغيل iOS.
واجهات برمجة تطبيقات ARCore غير المتزامنة
يقدِّم هذا الإصدار واجهات برمجة تطبيقات جديدة غير متزامنة في ARCore لتحسين بيئة العمل عند العمل مع العمليات غير المتزامنة، وذلك وفقًا لنموذج "المستقبل" و"الوعد".
Android (Kotlin/Java)
- حلّ علامات ارتساء التضاريس: استخدِم
Earth.resolveAnchorOnTerrainAsync()
للحصول علىResolveAnchorOnTerrainFuture
. تم إيقاف الرمز القديمEarth.resolveAnchorOnTerrain()
نهائيًا وقد تتم إزالته في إصدار أحدث من ARCore. - حلّ مشاكل الارتساء على السحابة الإلكترونية: استخدِم
Session.resolveCloudAnchorAsync()
للحصول علىResolveCloudAnchorFuture
. تم إيقاف الرمز القديمSession.resolveCloudAnchor()
نهائيًا وقد تتم إزالته في إصدار أحدث من ARCore. - استضافة الارتساء على السحابة الإلكترونية: استخدِم
Session.hostCloudAnchorAsync()
للحصول علىHostCloudAnchorFuture
. تم إيقاف الرمزَين القديمَينSession.hostCloudAnchor()
وSession.hostCloudAnchorWithTtl()
نهائيًا وقد تتم إزالتهما في إصدار أحدث من ARCore. - التحقّق من مدى توفّر حِزمة APK: يمكنك استخدام
ArCoreApk.checkAvailabilityAsync()
لتسجيل معاودة الاتصال. لم يتم إيقاف الرمز القديمArCoreApk.checkAvailability()
نهائيًا.
Android NDK (C)
- حلّ علامات ارتساء التضاريس: استخدِم
ArEarth_resolveAnchorOnTerrainAsync()
للحصول علىArResolveAnchorOnTerrainFuture
أو استخدِمArResolveAnchorOnTerrainCallback
. تم إيقاف الرمز القديمArEarth_resolveAndAcquireNewAnchorOnTerrain()
نهائيًا وقد تتم إزالته في إصدار أحدث من ARCore. - حلّ مشاكل الارتساء على السحابة الإلكترونية: استخدِم
ArSession_resolveCloudAnchorAsync()
للحصول علىArResolveCloudAnchorFuture
أو استخدِمArResolveCloudAnchorCallback
. تم إيقاف الرمز القديمArSession_resolveAndAcquireNewCloudAnchor()
نهائيًا وقد تتم إزالته في إصدار أحدث من ARCore. - استضافة الارتساء على السحابة الإلكترونية: يمكنك استخدام
ArSession_hostCloudAnchorAsync()
للحصول علىArHostCloudAnchorFuture
أو استخدامArHostCloudAnchorCallback
. تم إيقاف الرمزَين القديمَينArSession_hostAndAcquireNewCloudAnchor()
وArSession_hostAndAcquireNewCloudAnchorWithTtl()
نهائيًا وقد تتم إزالتهما في إصدار أحدث من ARCore. - التحقّق من مدى توفّر حِزمة APK: يمكنك استخدام
ArCoreApk_checkAvailabilityAsync()
لتسجيل معاودة الاتصال. لم يتم إيقاف الرمز القديمArCoreApk_checkAvailability()
نهائيًا.
الانسجام (AR Foundation)
- حلّ علامات ارتساء التضاريس: استخدِم
ARAnchorManagerExtensions.ResolveAnchorOnTerrainAsync()
للحصول علىResolveAnchorOnTerrainPromise
. تم إيقاف الرمز القديمARAnchorManagerExtensions.ResolveAnchorOnTerrain()
نهائيًا وقد تتم إزالته في إصدار أحدث من ARCore. - حلّ مشاكل الارتساء على السحابة الإلكترونية: استخدِم
ARAnchorManagerExtensions.ResolveCloudAnchorAsync()
للحصول علىResolveCloudAnchorPromise
. تم إيقاف الرمز القديمARAnchorManagerExtensions.ResolveCloudAnchorId()
نهائيًا وقد تتم إزالته في إصدار أحدث من ARCore. - استضافة الارتساء على السحابة الإلكترونية: استخدِم
ARAnchorManagerExtensions.HostCloudAnchorAsync()
للحصول علىHostCloudAnchorPromise
. تم إيقاف رموزARAnchorManagerExtensions.HostCloudAnchor()
القديمة نهائيًا وقد تتم إزالتها في إصدار أحدث من ARCore.
iOS
- حلّ علامات ارتساء التضاريس: استخدِم
GARSession.createAnchorWithCoordinate:altitudeAboveTerrain:eastUpSouthQAnchor:completionHandler:error:
للحصول علىGARCreateAnchorOnTerrainFuture
. تم إيقاف الرمز القديمGARSession.createAnchorWithCoordinate:altitudeAboveTerrain:eastUpSouthQAnchor:error:
نهائيًا وقد تتم إزالته في إصدار أحدث من ARCore. - حلّ مشاكل الارتساء على السحابة الإلكترونية: استخدِم
GARSession.resolveCloudAnchorWithIdentifier:completionHandler:error:
للحصول علىGARResolveCloudAnchorFuture
. تم إيقاف الرمز القديمGARSession.resolveCloudAnchorWithIdentifier:error:
نهائيًا وقد تتم إزالته في إصدار أحدث من ARCore. - استضافة الارتساء على السحابة الإلكترونية: استخدِم
GARSession.hostCloudAnchor:TTLDays:completionHandler:error:
للحصول علىGARHostCloudAnchorFuture
. تم إيقاف الرمزَين القديمَينGARSession.hostCloudAnchor:error:
وGARSession.hostCloudAnchor:TTLDays:error:
نهائيًا وقد تتم إزالتهما في إصدار أحدث من ARCore.
الميزات الجديدة في الإصدار 1.36.0 من ARCore
دعم Swift Package Manager على نظام التشغيل iOS
تدعم الآن حزمة ARCore SDK لنظام التشغيل iOS تطبيق Swift Package Manager رسميًا. راجع تفعيل الواقع المعزّز في تطبيق iOS للحصول على تعليمات حول كيفية الدمج مع ARCore باستخدام "مدير الحزم" في Swift.
الميزات الجديدة في الإصدار 1.35.0 من ARCore
تحل دقة الوضع الجغرافي المكاني محل العنوان بالزاوية
تكشف جميع الأوضاع الجغرافية المكانية الآن عن دقة اتجاه دوران الانحراف، مما يحل محل دقة العنوان.
- Java/Kotlin: استبدل
GeospatialPose.getHeading()
بـGeospatialPose.getEastUpSouthQuaternion()
وGeospatialPose.getHeadingAccuracy()
بـGeospatialPose.getOrientationYawAccuracy()
. - ج: استبدال
ArGeospatialPose_getHeading()
بـArGeospatialPose_getEastUpSouthQuaternion()
وArGeospatialPose_getHeadingAccuracy()
بـArGeospatialPose_getOrientationYawAccuracy()
- iOS: استبدِل
GARGeospatialTransform.heading
بـGARGeospatialTransform.eastUpSouthQTarget
وGARGeospatialTransform.headingAccuracy
بـGARGeospatialTransform.orientationYawAccuracy
. - الانسجام: استبدال
GeospatialPose.Heading
بـGeospatialPose.EunRotation
وGeospatialPose.HeadingAccuracy
بـGeospatialPose.OrientationYawAccuracy
.
تغييرات وتعديلات إضافية
يمكنك الاطّلاع على ملاحظات الإصدار لمعرفة التغييرات الأخرى وإصلاحات الأخطاء وتحسينات الأداء:
- ملاحظات إصدار حزمة تطوير البرامج (SDK) من ARCore لنظام التشغيل Android
- ملاحظات إصدار ARCore لنظام التشغيل Android NDK
- ملاحظات إصدار حزمة تطوير البرامج (SDK) من ARCore لنظام التشغيل iOS
- ملاحظات إصدار ARCore الإضافات في مؤسسة AR Foundation
الميزات الجديدة في الإصدار 1.34.0 من ARCore
تحقَّق من توفّر الإمكانات الجغرافية المكانية في الموقع الجغرافي الحالي للجهاز.
يمكن لواجهة برمجة التطبيقات Geospatial API الآن التحقق من مدى توفر نظام تحديد المواقع المرئي (VPS) في موضع أفقي محدد في وقت التشغيل. يمكن استخدام واجهة برمجة التطبيقات هذه بدون جلسة الواقع المعزّز نشطة، على سبيل المثال، لعرض "Enter AR" فقط عندما يكون VPS متاحًا.
- Java/Kotlin:
Session.checkVpsAvailabilityAsync()
- ج:
ArSession_checkVpsAvailabilityAsync()
- نظام التشغيل iOS:
GARSession.checkVPSAvailabilityAtCoordinate:completionHandler:
- Unity (AR Foundation):
AREarthManager.CheckVpsAvailability()
الاتجاه الجغرافي المكاني
تعرض الأوضاع الجيوفضائية الآن اتجاهها في مساحة ثلاثية الأبعاد.
- Java/Kotlin:
feedbackGeospatialPose.getEastUpSouthQuaternion()
- ج:
ArEarth_getGeospatialPose()
- نظام التشغيل iOS:
GARGeospatialTransform.eastUpSouthQTarget
- الانسجام:
GeospatialPose.EunRotation()
الإحالات الناجحة للمواقع الجغرافية المكانية
يمكن الآن تحويل الأوضاع الجغرافية المكانية من أوضاع الفضاء العالمي (AR) وإليها.
للحصول على الوضع الجغرافي المكاني من وضع الواقع المعزّز:
- Java/Kotlin:
Earth.getGeospatialPose()
- ج:
ArEarth_getGeospatialPose()
- نظام التشغيل iOS:
GARSession.geospatialTransformFromTransform:error:
- الانسجام:
AREarthManager.Convert(Pose)
للحصول على وضع الواقع المعزّز من وضع جيوفضائي:
- Java/Kotlin:
Earth.getPose()
- ج:
ArEarth_getPose()
- نظام التشغيل iOS:
GARSession.transformFromGeospatialCoordinate:altitude:eastUpSouthQTarget:error:
- الانسجام:
AREarthManager.Convert(GeospatialPose)
يكون للأوضاع الجغرافية المكانية التي يتم الحصول عليها من هذه الدوال قيمة عنوان تعيين إلى صفر. بدلاً من ذلك، يمكنك استخدام ما يلي:
- Android (Java/Kotlin/C): الرباعية رباعية الوضعية
- iOS: الوضعية
eastUpSouthQTarget
- الانسجام: الوضع
EunRotation
تغييرات وتعديلات إضافية
يمكنك الاطّلاع على ملاحظات الإصدار لمعرفة التغييرات الأخرى وإصلاحات الأخطاء وتحسينات الأداء:
- ملاحظات إصدار حزمة تطوير البرامج (SDK) من ARCore لنظام التشغيل Android
- ملاحظات إصدار ARCore لنظام التشغيل Android NDK
- ملاحظات إصدار حزمة تطوير البرامج (SDK) من ARCore لنظام التشغيل iOS
- ملاحظات إصدار ARCore الإضافات في مؤسسة AR Foundation
الميزات الجديدة في الإصدار 1.33.0 من ARCore
نقطة نهاية Cloud Anchors الجديدة
- لاستخدام Cloud Anchors، يجب الآن تفعيل ARCore API بدلاً من واجهة ARCore Cloud Anchor API القديمة، والتي تم إيقافها نهائيًا. وللتوافق مع الإصدارات القديمة من التطبيق، يمكنك تفعيل كليهما أثناء إجراء عملية النقل. تستهدف التطبيقات التي تم إنشاؤها باستخدام الإصدار 1.32.0 أو إصدار أقدم من حزمة ARCore SDK واجهة برمجة التطبيقات القديمة، في حين تستهدف التطبيقات التي تم إنشاؤها باستخدام الإصدار 1.33.0 أو إصدار أحدث من ARCore SDK واجهة برمجة التطبيقات الجديدة. يُرجى مراعاة ما يلي:
- تستخدم واجهة برمجة التطبيقات الجديدة اسم النطاق
arcore.googleapis.com
بدلاً منarcorecloudanchor.googleapis.com
. - إذا كنت تستخدم مفتاح واجهة برمجة تطبيقات مقيّدًا بواجهة برمجة التطبيقات، يجب السماح بـ ARCore API.
- في حال إرسال طلبات إلى واجهة برمجة تطبيقات ARCore Cloud Anchor Management API من الخلفية، عليك أيضًا تغيير اسم النطاق إلى
arcore.googleapis.com
، بعد تفعيل واجهة برمجة التطبيقات ARCore. - سيستمر دعم واجهة برمجة التطبيقات/نقطة النهاية القديمة حتى آب (أغسطس) 2023.
- يُرجى الاطّلاع على التغييرات في نقاط نهاية ARCore 1.33 Cloud Anchor لمعرفة مزيد من التفاصيل.
- تستخدم واجهة برمجة التطبيقات الجديدة اسم النطاق
علامات تثبيت التضاريس
- تنشئ واجهة برمجة تطبيقات ارتساء التضاريس الجغرافية علامة ارتساء في موضع أفقي وارتفاع محدّدين بالنسبة إلى تضاريس الموضع الأفقي.
تغييرات وتعديلات إضافية
يمكنك الاطّلاع على ملاحظات الإصدار لمعرفة التغييرات الأخرى وإصلاحات الأخطاء وتحسينات الأداء:
- ملاحظات إصدار حزمة تطوير البرامج (SDK) من ARCore لنظام التشغيل Android
- ملاحظات إصدار ARCore لنظام التشغيل Android NDK
- ملاحظات إصدار حزمة تطوير البرامج (SDK) من ARCore لنظام التشغيل iOS
- ملاحظات إصدار ARCore الإضافات في مؤسسة AR Foundation
الميزات الجديدة في الإصدار 1.32.0 من ARCore
لا يحتوي هذا الإصدار على ميزات جديدة.
Android وUnity (AR Foundation) لنظام التشغيل Android
- تم تحديث
targetSdkVersion
في ARCore إلى المستوى 32 لواجهة برمجة تطبيقات Android. وإذا لم يحدّدtargetSdkVersion
تطبيقك، سيصبحtargetSdkVersion
في تطبيقك 32 نتيجة دمج البيان.- حزمة تطوير البرامج (SDK) لنظام التشغيل Android: يؤدي تحديد
targetSdkVersion
فيbuild.gradle
أوAndroidManifest.xml
لمشروعك إلى إلغاء قيمةtargetSdkVersion
في ARCore. - AR Foundation for Android: تحديد مستوى واجهة برمجة التطبيقات المستهدَف في إعدادات المشروع (Project Settings)> ضمن مشروع Unity اللاعب > Android > ستلغي "الإعدادات الأخرى" قيمة
targetSdkVersion
في ARCore.
- حزمة تطوير البرامج (SDK) لنظام التشغيل Android: يؤدي تحديد
تغييرات وتعديلات إضافية
يمكنك الاطّلاع على ملاحظات الإصدار لمعرفة التغييرات الأخرى وإصلاحات الأخطاء وتحسينات الأداء:
- ملاحظات إصدار حزمة تطوير البرامج (SDK) من ARCore لنظام التشغيل Android
- ملاحظات إصدار ARCore لنظام التشغيل Android NDK
- ملاحظات إصدار حزمة تطوير البرامج (SDK) من ARCore لنظام التشغيل iOS
- ملاحظات إصدار ARCore الإضافات في مؤسسة AR Foundation
الميزات الجديدة في الإصدار 1.31.0 من ARCore
واجهة برمجة تطبيقات ARCore Geospatial
تستخدم واجهة برمجة التطبيقات ARCore Geospatial API الجديدة البيانات من التصاميم الثلاثية الأبعاد في Google Earth بيانات صور "التجوّل الافتراضي" من "خرائط Google" لإتاحة تجربة غامرة لتطبيقك لتجارب الواقع المعزّز المستنِدة إلى الموقع الجغرافي وعلى مستوى العالم.
يمكنك الاطّلاع على مقدمة إلى ARCore Geospatial API للحصول على وثائق المطورين الخاصة بالنظام الأساسي، وبدء استخدام واجهة برمجة التطبيقات Geospatial API.
عمق بعيد المدى
تم تحسين واجهة برمجة تطبيقات ARCore Depth الآن لتتضمن إمكانية استشعار العمق على المدى البعيد زيادة نطاق ملاحظات العمق القابلة للتمثيل. جميع 16 بت من صورة العمق، مما يوفر نطاقًا أقصى يبلغ 65535 ملم. سابقًا تمت تعبئة 13 وحدة بت فقط، بحد أقصى 8191 ملليمتر.
اطّلِع على التغييرات في العمق في وثائق المطورين الخاصة بكل نظام أساسي، وفهم التغييرات التي تطرأ على واجهة برمجة التطبيقات Depth API
ملاحظات خاصة بالنظام الأساسي
Android
واجهات برمجة تطبيقات ARCore Geospatial الجديدة
Java
- يوفّر
Earth
إمكانية الأقلمة في الإحداثيات النسبية للأرض.Earth.createAnchor()
تؤدي إلى إنشاءAnchor
جديد في الموقع والاتجاه المحدّدَين نسبةً إلى الأرض.
Earth.Earthstate
يصف حالةEarth
الحالية، بما في ذلكTrackingState
.GeospatialPose
يصف موقعًا محددًا والمسقط الرأسي وعنوان البوصلة بالنسبة إلى Google Earth
- يوفّر
C
ArEarth
يوفر إمكانية الترجمة في الإحداثيات النسبية للأرض.ArEarth_acquireNewAnchor()
تؤدي إلى إنشاءAnchor
جديد في الموقع والاتجاه المحدّدَين نسبةً إلى الأرض.ArEarthState
يصف حالةArEarth
الحالية، بما في ذلكArTrackingState
.
ArGeospatialPose
يصف موقعًا محددًا والمسقط الرأسي وعنوان البوصلة بالنسبة إلى Google Earth
واجهات برمجة تطبيقات ARCore Depth API المعدّلة
Java
- تم تغيير طلبات دالة Depth API:
Frame.acquireDepthImage
لـFrame.acquireDepthImage16Bits
.Frame.acquireRawDepthImage
لـFrame.acquireRawDepthImage16Bits
.- تم تغيير تنسيقات صور الإخراج لكلا المكالمتين من
من
android.graphics.ImageFormat#DEPTH16
إلىandroid.hardware.HardwareBuffer#D_16
- لا يزال العمق ممثلًا كعدد صحيح 16 بت بوحدات ولكن تُستخدم الآن جميع وحدات 16 بت لتمثيل العمق، مما يسمح للحصول على أقصى نطاق قابل للتعبير عنه من 8191 مم إلى 65535 مم.
- تستدعي دالة Depth API
Frame.acquireDepthImage
تم إيقافFrame.acquireRawDepthImage
نهائيًا. يُرجى استخدامFrame.acquireDepthImage16Bits
وFrame.acquireRawDepthImage16Bits
بدلاً من ذلك.
- تم تغيير طلبات دالة Depth API:
C
- تم تغيير طلبات دالة Depth API:
ArFrame_acquireDepthImage
لـArFrame_acquireDepthImage16Bits
.- من
ArFrame_acquireRawDepthImage
إلىArFrame_acquireRawDepthImage16Bits
- تم تغيير تنسيقات صور الإخراج لكلا المكالمتين من
AR_IMAGE_FORMAT_DEPTH16
إلىAR_IMAGE_FORMAT_D_16
- لا يزال العمق ممثلًا كعدد صحيح 16 بت بوحدات ولكن تُستخدم الآن جميع وحدات 16 بت لتمثيل العمق، مما يسمح للحصول على أقصى نطاق قابل للتعبير عنه من 8191 مم إلى 65535 مم.
- تستدعي دالة Depth API
ArFrame_acquireDepthImage
تم إيقافArFrame_acquireRawDepthImage
نهائيًا. يُرجى استخدامArFrame_acquireDepthImage16Bits
وArFrame_acquireRawDepthImage16Bits
بدلاً من ذلك.
- تم تغيير طلبات دالة Depth API:
الانسجام (AR Foundation)
واجهات برمجة تطبيقات ARCore Geospatial الجديدة:
AREarthManager
يوفر إمكانية الترجمة في الإحداثيات النسبية للأرض.EarthTrackingState
للحصول على حالة تعقب الأرض لأحدث إطار.EarthState
تحافظ على حالات الخطأ في Earth.
GeospatialPose
يصف موقعًا محددًا وارتفاعًا واتجاه بوصلة بالنسبة للأرض.ARGeospatialAnchor
لتوفير نقطة إرساء لعناصر اللعبة في المشهد، ومحددة في مكان معيّن والاتجاه بالنسبة إلى الأرض.
iOS
واجهات برمجة تطبيقات ARCore Geospatial الجديدة:
GAREarth
يتم تقديم عملية أقلمة مرتبطة بالأرض.GAREarthState.earthState
يدير حالات الخطأ والشروط.GAREarthState.trackingState
ويحافظ على حالة التتبع، المطلوبة للبيانات الجغرافية المكانية.
GARGeospatialTransform
يشير ذلك المصطلح إلى تحوُّل عام يشمل الموقع الجغرافي والعنوان والارتفاع. وتقديرات الدقة.GARSession.createAnchorWithCoordinate:altitude:eastUpSouthQAnchor:error:
تنشئ ارتساء جيوفضائي في الموقع والاتجاه المحددين نسبةً إلى الأرض.
التغييرات الأخرى
يمكنك الاطّلاع على ملاحظات الإصدار لمعرفة التغييرات الأخرى وإصلاحات الأخطاء وتحسينات الأداء:
- ملاحظات إصدار حزمة تطوير البرامج (SDK) من ARCore لنظام التشغيل Android
- ملاحظات إصدار ARCore لنظام التشغيل Android NDK
- ملاحظات إصدار حزمة تطوير البرامج (SDK) من ARCore لنظام التشغيل iOS
- ملاحظات إصدار ARCore الإضافات في مؤسسة AR Foundation
الميزات الجديدة في الإصدار 1.30.0 من ARCore
لا يحتوي هذا الإصدار على ميزات جديدة.
Android
- القيم المعروضة في واجهة برمجة التطبيقات التوضيحية مع
@NonNull
و@Nullable
- تحديث إصدارات أداة التصميم المستخدمة لإنشاء النماذج: Gradle إلى 7.0.2 والمكون الإضافي لنظام Gradle المتوافق مع Android إلى 7.0.4. ليس عليك ترقية هذه الأدوات لتطبيقات ARCore الحالية. بالنسبة إلى الميزات الجديدة والمشكلات المعروفة معلومات عدم التوافق، راجع مستندات Android حول المكوّن الإضافي لنظام Gradle المتوافق مع Android
الانسجام (AR Foundation)
تمت إضافة إصدار
arcore-unity-extensions-without-edm4u.tgz
جديد. صيغة الإصدار هذه لا تقوم بتجميع التبعيات الخارجية مثل مدير التبعية الخارجية في Unity وتسمح عمليات الترقية إلى موسيقى الرقص الإلكترونية قد يؤدي استخدام هذا الإصدار البسيط إلى حلّ حالات عدم التوافق عند استخدام Firebase. المكتبات. عرض تعليمات تثبيت ARCore المفضَّلة لمؤسسة AR لبدء استخدامهاتمت ترقية ExternalDependencyManager إلى الإصدار 1.2.168 من أجل دعم الإصدار 2021.2 أو الإصدارات الأحدث. يُرجى الاطّلاع على التفاصيل في سجلّ تغييرات موسيقى الرقص الإلكترونية
تم إصلاح مشكلة ضبط جلسة ARCore لكل إطار حتى إذا لم تكن هناك تغيير في إعدادات الجلسة، ما يتسبب في انخفاض عدد اللقطات في الثانية.
iOS
- إصلاح أخطاء متنوعة وإجراء تحسينات في الأداء
الميزات الجديدة في الإصدار 1.29.0 من ARCore
لا يحتوي هذا الإصدار على ميزات جديدة.
Android
- hello_ar_java وhello_ar_kotlin: تم تغيير لون الكائن عند وضعه باستخدام
SCREENSPACE_WITH_APPROXIMATE_DISTANCE
للتمييز بشكلٍ أفضل عن العناصر الموضوعة باستخدام موضع الإعلان الفوري. - persistent_cloud_anchor_java: تمت إضافة تبعية إصدار غير متوفّرة إلى النموذج. إصلاح خطأ ظهور حالة
CloudAnchorState ERROR_NOT_AUTHORIZED
لاستضافة أي إعلان ثابت حتى في حال إعداد المشروع بشكل صحيح
الانسجام (AR Foundation)
- تعتمد حزمة إضافات ARCore الآن على مكون ARKit XR الإضافي لضمان توافق إصدار ARKit المُثبَّت من المؤسسة مع إصدار المكوِّن الإضافي ARKit XR. يؤدي ذلك إلى إصلاح خطأ في التجميع عند تثبيت إضافات ARCore على Unity 2019.x وتفعيل المكوّن الإضافي ARKit XR.
- تم نقل إعدادات مشروع إضافات ARCore من إعدادات المشروع >. XR > إضافات ARCore إلى إعدادات المشروع > إدارة المكون الإضافي XR > إضافات ARCore
- تم نقل
ARCoreExtensionsConfig
وARCoreExtensionsCameraConfigFilter
وARCoreRecordingConfig
من إنشاء >. XR > إضافات ARCore من أجل الإنشاء > قائمة XR.
iOS
- إصلاح أخطاء متنوعة وإجراء تحسينات في الأداء
إكمال ملاحظات الإصدار
- ملاحظات الإصدار الكاملة لحزمة تطوير البرامج (SDK) من ARCore لنظام التشغيل Android
- ملاحظات إصدار ARCore for Android NDK الكاملة
- ملاحظات الإصدار الكاملة لحزمة تطوير البرامج (SDK) من ARCore لنظام التشغيل iOS
- ملاحظات إصدار ARCore الإضافات في مؤسسة AR Foundation
الميزات الجديدة في الإصدار 1.28.0 من ARCore
- اعتبارًا من تشرين الثاني (نوفمبر) 2022، لن يعود بإمكان التطبيقات التي تستخدم الواقع المعزّز الحصول على الصور أو البيانات الوصفية للصور من NDK. تعتمد إصدارات حزمة تطوير البرامج (SDK) المتأثرة على الوظيفة المحدَّدة التي يتم طلبها. يمكنك الاطّلاع على الإشعار عن الإيقاف النهائي لمزيد من المعلومات.
- ج: ستعرض المكالمات التي يتم إجراؤها إلى
ArImage_getNdkImage()
وArImage_getNdkCameraMetadata()
دائمًاnullptr
للعنصرAImage
وACameraMetadata
. - Java: سيكون حجم الكائن
Image
الذي يعرضهFrame#acquireCameraImage()
بحجم0
×0
بكسل. ستعرض المكالمات التي يتم إجراؤها إلىFrame#getImageMetadata()
القيمةIllegalArgumentException
دائمًا. - Unity (AR Foundation): عند استخدام AR Foundation 2.1 (Unity 2019 LTS)، ستظهر دائمًا عمليات توجيه الطلبات إلى
XRCameraSubsystem.TryGetLatestImage(out XRCameraImage)
بقيمةfalse
. لن تتأثّر بذلك الإصدار 4.x والإصدارات الأحدث من AR Foundation، وسيتم الاتصال بـXRCameraSubsystem.TryGetLatestImage(out XRCameraImage)
بشكل طبيعي. - ARCore SDK for Unity (متوقّف نهائيًا): سيكون حجم الطلبات إلى
Frame.CameraImage.AcquireCameraImageBytes()
بحجم0
×0
بكسل. المكالمات إلىFrame.CameraMetadata.GetAllCameraMetadataTags()
ستعرضList<CameraMetadataTag>
فارغة.
- ج: ستعرض المكالمات التي يتم إجراؤها إلى
- Java: تعرض "
ArImage#getCropRect()
" الآن مستطيل اقتصاص بالحجم الكامل، أي أنّ جميع وحدات البكسل في الصورة صالحة. يمكنك الانتقال إلىandroid.media.Image#getCropRect()
للاطّلاع على معلومات إضافية.
الميزات الجديدة في الإصدار 1.27.0 من ARCore
لا يحتوي هذا الإصدار على ميزات جديدة. يمكنك الاطّلاع على ملاحظات الإصدار التالية إصلاح الأخطاء وتحسينات في الأداء.
- ملاحظات الإصدار الكاملة لحزمة تطوير البرامج (SDK) من ARCore لنظام التشغيل Android
- ملاحظات إصدار ARCore for Android NDK الكاملة
- ملاحظات الإصدار الكاملة لحزمة تطوير البرامج (SDK) من ARCore لنظام التشغيل iOS
- ملاحظات إصدار ARCore الإضافات في مؤسسة AR Foundation
بالإضافة إلى إصلاحات الأخطاء المتنوعة، تضمن هذا الإصدار ما يلي.
نماذج تطبيقات في لغة Kotlin
تمت إضافة hello_ar_kotlin لتوضيح أفضل الممارسات عند استخدام Kotlin.
يمكنك الاطلاع على QuickStart for Android لمزيد من المعلومات.
تمت إضافة ml_kotlin لتوضيح كيفية استخدام نموذج تصنيف الصور مع ARCore.
راجِع استخدام ARCore كإدخال لنماذج تعلُّم الآلة لمزيد من المعلومات.
الميزات الجديدة في الإصدار 1.26.0 من ARCore
يضيف هذا الإصدار التغييرات الملحوظة التالية:
- معرِّفات الموارد المنتظمة (URI) متاحة الآن لمجموعات البيانات في قسم التسجيل التشغيل:
تغييرات وتعديلات إضافية
يمكنك الاطّلاع على ملاحظات الإصدار التالية للتعرّف على إصلاحات الأخطاء الإضافية والتغييرات الأخرى التي قد تؤدي إلى أعطال.
- ملاحظات الإصدار الكاملة لحزمة تطوير البرامج (SDK) من ARCore لنظام التشغيل Android
- ملاحظات إصدار ARCore for Android NDK الكاملة
- ملاحظات الإصدار الكاملة لحزمة تطوير البرامج (SDK) من ARCore لنظام التشغيل iOS
- ملاحظات إصدار ARCore الإضافات في مؤسسة AR Foundation
الميزات الجديدة في الإصدار 1.25.0 من ARCore
لا يحتوي هذا الإصدار على ميزات جديدة. يمكنك الاطّلاع على ملاحظات الإصدار التالية إصلاح الأخطاء وتحسينات في الأداء.
- ملاحظات الإصدار الكاملة لحزمة تطوير البرامج (SDK) من ARCore لنظام التشغيل Android
- ملاحظات إصدار ARCore for Android NDK الكاملة
- ملاحظات الإصدار الكاملة لحزمة تطوير البرامج (SDK) من ARCore لنظام التشغيل iOS
- ملاحظات الإصدار المكتملة من ARCore SDK for Unity
- ملاحظات إصدار ARCore الإضافات في مؤسسة AR Foundation
الميزات الجديدة في الإصدار 1.24.0 من ARCore
يضيف هذا الإصدار التغييرات الملحوظة التالية:
- Raw Depth API جديدة توفّر صورة بعمق بدون فلترة مسافات الصور
- إمكانية تسجيل مسار البيانات المخصص لتسجيل واجهة برمجة تطبيقات التشغيل
- القدرة على إجراء اختبارات العمق
عمق الخام
توفّر واجهة برمجة التطبيقات Raw Depth API بيانات عمق لصورة الكاميرا ذات بدقة أعلى من بيانات واجهة برمجة التطبيقات Depth API الكاملة، ولكنها لا تغطي دائمًا كل بكسل. خام الصور المتعمقة، إلى جانب صور الثقة المطابقة، يمكن أن تكون أكثر ما يسمح للتطبيقات باستخدام بيانات العمق ذات الدقة الكافية حسب حالة الاستخدام الفردية لكل منها.
أدلة المطوِّرين:
- Android (Java أو Kotlin)
- Android NDK (C)
- إضافات ARCore لمؤسسة AR
- حزمة تطوير البرامج (SDK) من ARCore لمنصة Unity
تسجيل مسار مخصّص
إمكانية تتبع البيانات المخصصة الجديدة في قسم "التسجيل" تتيح لك واجهة برمجة التطبيقات Deployment API إضافة بيانات مخصصة إلى إطار ARCore أثناء التسجيل واسترداد تلك البيانات البيانات من الإطار أثناء التشغيل.
أدلة المطوِّرين:
- Android (Java أو Kotlin)
- Android NDK (C)
- إضافات ARCore لمؤسسة AR
- حزمة تطوير البرامج (SDK) من ARCore لمنصة Unity
اختبارات العمق
في السابق، كان لا يمكن إجراء اختبارات النتائج إلا على الطائرات المكتشفة، مما يحد من المواقع إلى أسطح كبيرة ومستوية. تستفيد اختبارات النتائج العميقة من كلتيهما ومعلومات تفصيلية أولية لتقديم نتائج أكثر دقة، حتى الأسطح غير المسطحة وذات القوام المنخفض.
أدلة المطوِّرين:
تغييرات وتعديلات إضافية
يمكنك الاطّلاع على ملاحظات الإصدار التالية للتعرّف على إصلاحات الأخطاء الإضافية والتغييرات الأخرى التي قد تؤدي إلى أعطال.
- ملاحظات الإصدار الكاملة لحزمة تطوير البرامج (SDK) من ARCore لنظام التشغيل Android
- ملاحظات إصدار ARCore for Android NDK الكاملة
- ملاحظات الإصدار الكاملة لحزمة تطوير البرامج (SDK) من ARCore لنظام التشغيل iOS
- ملاحظات الإصدار المكتملة من ARCore SDK for Unity
- ملاحظات إصدار ARCore الإضافات في مؤسسة AR Foundation
الميزات الجديدة في الإصدار 1.23.0 من ARCore
في انتظار استخدام الكاميرا المزدوجة
سيتم طرح إمكانية استخدام الكاميرا المزدوجة في الأسابيع المقبلة. يمكنك الاطّلاع على الأجهزة المتوافقة للحصول على مزيد من المعلومات.
أدوات جديدة لتصحيح الأخطاء
من خلال إرسال هدف البث، يمكن للمطوّرين تفعيل ما يلي:
تسجيل طلب بيانات من واجهة برمجة التطبيقات ARCore في سجلّ تصحيح أخطاء Android
تراكب أداء ARCore
استضافة Cloud Anchors وحلها
أمّا التطبيقات المتوافقة مع الواقع المعزّز والتي تم إنشاؤها باستخدام الإصدار 1.11.0 أو إصدار أقدم من حزمة ARCore SDK، فلم يعد بإمكانها إجراء ما يلي: أو حل Cloud Anchors.
C: عرض Cloud Anchors بواسطة
ArSession_hostAndAcquireNewCloudAnchor
وArSession_resolveAndAcquireNewCloudAnchor
الحالةAR_CLOUD_ANCHOR_STATE_ERROR_INTERNAL
دائمًا.Java: عرض Cloud Anchors بواسطة
Session.hostCloudAnchor(Anchor)
وSession.resolveCloudAnchor(String)
الحالةAnchor.CloudAnchorState.ERROR_INTERNAL
دائمًا.Unity: عرض Cloud Anchors من خلال
XPSession.CreateCloudAnchor(Anchor)
وXPSession.ResolveCloudAnchor(string)
دائمًا حالةCloudServiceResponse.ErrorInternal
ولن تتأثر التطبيقات التي تم إنشاؤها باستخدام الإصدار 1.12.0 أو إصدار أحدث من حزمة ARCore SDK. استخدام واجهة برمجة التطبيقات ARCore Cloud Anchor API من خلال سياسة الإيقاف النهائي.
تغييرات وتعديلات إضافية
يمكنك الاطّلاع على ملاحظات الإصدار التالية للتعرّف على إصلاحات الأخطاء الإضافية وغيرها من الأعطال. التغييرات.
ملاحظات الإصدار الكاملة لحزمة تطوير البرامج (SDK) من ARCore لنظام التشغيل Android
ملاحظات الإصدار الكاملة لحزمة تطوير البرامج (SDK) من ARCore لنظام التشغيل iOS
الميزات الجديدة في الإصدار 1.22.0 من ARCore
يضيف هذا الإصدار معلومات جديدة واجهات برمجة تطبيقات التسجيل والتشغيل واجهات برمجة التطبيقات لفلتر إعدادات الكاميرا في ARCore إضافات لمنصة AR Foundation يمكنك الاطّلاع على ملاحظات الإصدار الكاملة لإضافات ARCore لمعرفة التفاصيل.
تغييرات وتعديلات إضافية
يمكنك الاطّلاع على ملاحظات الإصدار التالية للتعرّف على إصلاحات الأخطاء الإضافية وغيرها من الأعطال. التغييرات.
ملاحظات الإصدار الكاملة لحزمة تطوير البرامج (SDK) من ARCore لنظام التشغيل Android
ملاحظات الإصدار الكاملة لحزمة تطوير البرامج (SDK) من ARCore لنظام التشغيل iOS
الميزات الجديدة في الإصدار 1.21.0 من ARCore
يضيف هذا الإصدار واجهات برمجة تطبيقات جديدة للتسجيل والتشغيل Android وAndroid NDK والانسجام.
التسجيل والتشغيل
باستخدام واجهات برمجة التطبيقات للتسجيل والتشغيل، يمكنك تسجيل بيانات الفيديو والواقع المعزّز مرة واحدة ضمن بيئة معيّنة واستخدام ذلك المحتوى بدلاً من جلسة كاميرا مباشرة لأغراض الاختبار. يحفظ ARCore الجلسات المسجّلة في ملفات MP4 التي تحتوي على مقاطع فيديو متعددة وبيانات متنوعة أخرى على الجهاز. يمكنك بعد ذلك توجيه تطبيقك لاستخدام هذه البيانات بدلاً من جلسة كاميرا مباشرة. هذا يسمح بإعادة تشغيل هذا المحتوى إلى أجل غير مسمى لتجربة تأثيرات الواقع المعزّز المختلفة الاضطرار إلى العودة إلى الميدان.
وللحصول على مزيد من التفاصيل:
Java:
ج:
الانسجام:
الميزات الجديدة في الإصدار 1.20.0 من ARCore
يضيف هذا الإصدار التغييرات الملحوظة التالية:
دعم جديد لـ Cloud Anchor Anchors الدائمون
تم تعديل إمكانات البيانات الوصفية للصور لنظامَي التشغيل Android وAndroid NDK.
إرشادات جديدة تتطلب إصدار Gradle 5.6.4 أو إصدار أحدث، لإتاحة استخدام إضافات ARCore لأجهزة AR Foundation أو ARCore حزمة SDK for Unity (الإصدار 1.19 أو إصدار أحدث) مع Unity 2018.4 أو إصدار أحدث.
دعم جديد لتثبيتات Cloud Anchors الدائمة
قبل الإصدار 1.20 من ARCore، كان بالإمكان حلّ Cloud Anchors لمدة تصل إلى 24 ساعة فقط بعد استضافتها لأول مرة. باستخدام Cloud Anchors الدائم، يمكنك الآن إنشاء Cloud Anchor نقطة بقاء (TTL) تتراوح بين يوم واحد و365 يومًا. يمكنك أيضًا زيادة فترة ظهور الإعلان الثابت بعد استضافته باستخدام Cloud Anchor Management API.
تُطبَّق سياسة الإيقاف النهائي لـ Cloud Anchors الجديدة
C: دليل المطوِّر
ArSession_hostAndAcquireNewCloudAnchorWithTtl
، وArSession_estimateFeatureMapQualityForHosting
Java: دليل المطوِّر
hostCloudAnchorWithTtl
،estimateFeatureMapQualityForHosting
iOS: دليل المطوِّر
hostCloudAnchor:TTLDays:error:
وestimateFeatureMapQualityForHosting:
ARCore extensions for AR Foundation: دليل مطوّري برامج Android دليل مطوِّري تطبيقات iOS
ARAnchorManager.HostCloudAnchor(ARAnchor, int)
,ARAnchorManager.SetAuthToken(string)
، وARAnchorManager.EstimateFeatureMapQualityForHosting(Pose)
.Unity الذي يستهدف Android: دليل المطوِّر
XPSession.CreateCloudAnchor(Anchor, int)
وXPSession.EstimateFeatureMapQualityForHosting(Pose)
Unity لاستهداف iOS: دليل المطوِّر
XPSession.SetAuthToken(string)
وXPSession.CreateCloudAnchor(UnityARUserAnchorComponent, int)
تغييرات وتعديلات إضافية
يمكنك الاطّلاع على ملاحظات الإصدار التالية للتعرّف على إصلاحات الأخطاء الإضافية وغيرها من الأعطال. التغييرات.
ملاحظات الإصدار الكاملة لحزمة تطوير البرامج (SDK) من ARCore لنظام التشغيل Android
ملاحظات الإصدار الكاملة لحزمة تطوير البرامج (SDK) من ARCore لنظام التشغيل iOS
الميزات الجديدة في الإصدار 1.19.0 من ARCore
يضيف هذا الإصدار التغييرات الملحوظة التالية:
- واجهة برمجة تطبيقات الموضع الفوري الجديدة لنظام التشغيل Android، Android NDK، و الانسجام
- إرشادات جديدة لتصميم نظام التشغيل Android 11 مع الانسجام.
موضع الإعلان الفوري
تسمح واجهة برمجة تطبيقات الموضع الفوري للمستخدم بوضع كائن الواقع المعزّز على الشاشة بدون الحاجة إلى انتظار ARCore لاكتشاف هندسة السطح. موضع العنصر يتم تحسينه في الوقت الفعلي مع تحرك المستخدم بشكل أكبر في جميع أنحاء البيئة. مرة واحدة يكتشف ARCore الوضع الصحيح في المنطقة التي يتم وضع كائن الواقع المعزّز فيها، ويتم تحديث الكائن الأبيض تلقائيًا ليصبح دقيقًا ويصبح معتمًا.
يعرض المقطع التالي شخصية افتراضية من جهاز Android على أرض الواقع. المؤقت. ويكون الشكل أبيض ويقل حجمه كثيرًا عند وضعه أول مرة. بعد ARCore ويحسّن حساباته لأبعاد المشهد، ويقفز الشكل إلى الموقع الدقيق. وقد يؤدي ذلك إلى اختلاف في "المقاس" الذي تم رصده. من الكائن.
وللحصول على مزيد من التفاصيل:
نظام التشغيل Android:
Android NDK:
الانسجام:
الميزات الجديدة في الإصدار 1.18.0 من ARCore
يضيف هذا الإصدار التغييرات الملحوظة التالية:
- واجهة برمجة التطبيقات Depth API الجديدة لأجهزة Android Android NDK، والانسجام.
- إرشادات جديدة لإنشاء مواد عرض ميزة "الوجوه المحسّنة" واستيرادها إلى Android استوديو YouTube.
- ستتوفّر واجهة برمجة التطبيقات Depth API في
4.1.0-preview.2
لكليهماAR Foundation
وARCore XR Plugin
.
واجهة برمجة التطبيقات Depth API
على الأجهزة المتوافقة مع العمق، تستخدم واجهة برمجة التطبيقات Depth API الكاميرا المزوّدة بنموذج أحمر أخضر أزرق أو مستشعر العمق النشط في الجهاز المتوافق مع ARCore إذا المتاحة، لإنشاء خرائط العمق. ويمكنك بعد ذلك استخدام عمق البيانات لكل بكسل بواسطة خريطة العمق لجعل الكائنات الافتراضية تظهر بدقة أمام أو خلفها لكائنات العالم الواقعي، ما يتيح للمستخدمين تجارب غامرة وواقعية.
على سبيل المثال، تُظهر الصور التالية شكل Android افتراضيًا في مساحة حقيقية. تحتوي على صندوق بجانب الباب. تمنع Depth API بشكل صحيح خلف حافة الجذع.
وللحصول على مزيد من التفاصيل:
نظام التشغيل Android:
Android NDK:
الانسجام:
الميزات الجديدة في الإصدار 1.17.0 من ARCore
بارز في ARCore SDK لنظام التشغيل Android
تمت إضافة طرق جديدة تسمح بالتخزين المؤقت لإطارات عدة كاميرات. جنبًا إلى جنب مع أساليب أخرى مثل العرض المتعدد سلاسل، ويمكن استخدامها لتقليل التباين في عدد اللقطات في الثانية.
تمت إضافة بيانات الاستخدام غير المتوفّرة لأداة استشعار العمق وعدد اللقطات المُستهدَف في الثانية:
ويمكنك الاطّلاع أيضًا على ملاحظات الإصدار الكاملة لحزمة تطوير البرامج (SDK) لنظام التشغيل Android.
بارز في ARCore SDK for Unity
- تمت إضافة دعم العرض المتعدّد السلاسل في إصدار Unity 2018.2 أو إصدار أحدث. ما سيؤدي في معظم الحالات إلى تحسين الأداء ويمكنها أيضًا المساعدة في تقليل التباين في عدد اللقطات في الثانية. هذا مشروع الوحدة الموجود في إعدادات المشروع > المشغّل > Android > إعدادات أخرى > العرض المتعدّد السلاسل: يمكنك الاطّلاع على لمزيد من التفاصيل، يُرجى دليل المطوِّر.
- تمت إضافة
SessionStatus.ErrorCameraNotAvailable
. وSessionStatus.ErrorIllegalState
للإشارة إلى حالات خطأ جلسة ARCore.
يمكنك الاطّلاع أيضًا على ملاحظات الإصدار الكاملة لحزمة تطوير البرامج (SDK) من ARCore لـ Unity.
بارز في ARCore SDK لنظام التشغيل iOS
انخفض الحجم الثنائي لحزمة تطوير البرامج (SDK) لإعلانات Cloud Anchors بشكل كبير.
أصبحت رموز البت متاحة الآن لميزة "الوجوه المحسّنة".
يمكنك الاطّلاع أيضًا على ملاحظات الإصدار الكامل من ARCore لنظام التشغيل iOS.
الميزات الجديدة في الإصدار 1.16.0 من ARCore
بارز في ARCore SDK لنظام التشغيل Android وSceneform SDK لنظام التشغيل Android
يضيف هذا الإصدار التغييرات الملحوظة التالية:
- تعرض معظم الأجهزة الآن إعدادات إضافية متوافقة للكاميرا مع إعدادات أقل
درجات دقة زخارف وحدة معالجة الرسومات مقارنةً بدرجة دقة تركيب وحدة معالجة الرسومات التلقائية في الجهاز
يمكنك الاطّلاع على الأجهزة المتوافقة مع ARCore لمعرفة التفاصيل.
تتوفّر درجات دقة وحدة معالجة الرسومات الموسّعة هذه من خلال واجهة برمجة التطبيقات
getSupportedCameraConfigs(CameraConfigFilter)
.
انظر أيضًا:
ملاحظات الإصدار الكاملة لحزمة تطوير البرامج (SDK) لنظام التشغيل Android
ملاحظات الإصدار الكاملة لحزمة تطوير البرامج (SDK) لنظام التشغيل Android
بارز في ARCore المفضَّلة for AR Foundation
يضيف هذا الإصدار التغييرات الملحوظة التالية:
تم تطوير
XRCameraConfiguration
في مؤسسة AR Foundation من خلال طُرق تتيح لك اختيار إعدادات الكاميرا المناسبة بناءً على المعايير التي تريدها تتضمن هذه الطرق GetTextureDimensions(), GetFPSRange(), وGetDepthSensorUsages(). اطّلِع على التعليمات المفصّلة.أصبح الإصدار Unity 2019.3.0f6 الآن هو الحد الأدنى المقترَح لاستخدام إضافات ARCore. يتطلّب الإصدار 3.1.0-preview.6 من AR Foundation الإصدار 2019.3 أو إصدار أحدث من Unity.
تستخدم Unity الآن العبارات Anchor وCloud Anchor وCloud Anchor ID في واجهة برمجة التطبيقات للواقع المعزّز من عدّة منصات تم تعديل مستندات إضافات ARCore لتعكس هذا التغيير.
انظر أيضًا:
بارز في ARCore SDK for Unity
يضيف هذا الإصدار التغيير البارز التالي:
- تعرض معظم الأجهزة الآن إعدادات إضافية متوافقة للكاميرا مع إعدادات أقل درجات دقة زخارف وحدة معالجة الرسومات مقارنةً بدرجة دقة تركيب وحدة معالجة الرسومات التلقائية في الجهاز (راجع الأجهزة المتوافقة مع ARCore لمعرفة التفاصيل). تتوفّر درجات دقة وحدة معالجة الرسومات الموسّعة هذه من خلال واجهة برمجة التطبيقات ARCoreCameraConfigFilter.
انظر أيضًا:
ملاحظات الإصدار المكتملة من ARCore SDK for Unity
الميزات الجديدة في الإصدار 1.15.0 من ARCore
بارز في ARCore المفضَّلة for AR Foundation
يضيف هذا الإصدار التغييرات الملحوظة التالية.
تمت إضافة نموذج CloudAnchors الذي يوضح كيفية إنشاء تجارب الواقع المعزّز المشتركة لكل من Android وiOS. يُرجى الاطّلاع على التعليمات لنظام Android. أو iOS.
الإصدار Unity 2019.2.17f1 هو الآن الحدّ الأدنى الذي يُنصح باستخدامه مع ARCore. الإضافات.
بارز في ARCore SDK for Unity
يواجه هذا الإصدار المشاكل المعروفة التالية.
قد تؤدي "المعاينة الفورية" إلى تجميد Unity عند استخدام نظام التشغيل Android 9 وكابل USB 3. لحلّ هذه المشكلة، يجب تحديث نظام التشغيل إلى الإصدار Android 10 أو استخدام كابل USB 2.
قد يتعذّر عرض "المعاينة الفورية" على الجهاز عند عرض لعبة Unity درجة الدقة عالية جدًا. لحلّ هذه المشكلة، خفِّض مستوى دقة عرض لعبة Unity في محرِّر.
ملاحظات الإصدار المكتملة من ARCore SDK for Unity
تغييرات إضافية
يمكنك الاطّلاع على ملاحظات الإصدار التالية للتعرّف على إصلاحات الأخطاء الإضافية وغيرها من الأعطال. التغييرات.
ملاحظات الإصدار الكاملة لحزمة تطوير البرامج (SDK) لنظام التشغيل Android
ملاحظات الإصدار الكاملة لحزمة تطوير البرامج (SDK) لنظام التشغيل Android
ملاحظات الإصدار الكاملة لحزمة تطوير البرامج (SDK) من ARCore لنظام التشغيل iOS
الميزات الجديدة في الإصدار 1.14.0 من ARCore
يضيف هذا الإصدار التغييرات الملحوظة التالية.
عندما يفقد أحد التطبيقات الكاميرا مؤقتًا أمام تطبيق آخر على الجهاز، أصبح سبب تعذُّر التتبع الآن أكثر تحديدًا:
جهاز Android:
TrackingFailureReason
بسعرCAMERA_UNAVAILABLE
بدلاً منNONE
.Android NDK:
ArTrackingFailureReasons
هوAR_TRACKING_FAILURE_REASON_CAMERA_UNAVAILABLE
بدلاً منAR_TRACKING_FAILURE_REASON_NONE
الانسجام:
Session.LostTrackingReason
بسعرLostTrackingReason.CameraUnavailable
بدلاً منNone
.
تجمع Google البيانات وتعالجها من استخدامك لحزمة إضافات ARCore بما يتوافق مع سياسة خصوصية Google وبنود خدمة Google APIs. يمكنك أوقِف هذه الميزة.
الميزات الجديدة في الإصدار 1.13.0 من ARCore
يضيف هذا الإصدار التغييرات الملحوظة التالية.
دعم استخدام إضافات ARCore for Unity's AR Foundation في إصدار iOS التطبيقات مع Cloud Anchors.
إتاحة تقدير الإضاءة البيئية بنطاق عالي الديناميكية في المشهد
يمكنك الاطّلاع على ملاحظات الإصدار التالية للتعرّف على إصلاحات الأخطاء الإضافية وغيرها من الأعطال. التغييرات.
ملاحظات الإصدار الكاملة لحزمة تطوير البرامج (SDK) لنظام التشغيل Android
ملاحظات الإصدار الكاملة لحزمة تطوير البرامج (SDK) لنظام التشغيل Android
ملاحظات الإصدار الكاملة لحزمة تطوير البرامج (SDK) من ARCore لنظام التشغيل iOS
الميزات الجديدة في الإصدار 1.12.0 من ARCore
يتضمّن هذا الإصدار التغييرات التالية:
تمت إضافة ميزة "وجوه معززة" إلى نظام iOS. لمزيد من المعلومات، يُرجى مراجعة هذه النظرة العامة والتشغيل السريع ودليل المطوِّر.
إتاحة استخدام إضافات ARCore لأجهزة Unity's AR Foundation في تصميم تطبيقات Android التطبيقات مع Cloud Anchors.
التغييرات التالية على Cloud Anchors:
- للامتثال لمتطلبات الخصوصية المُعدَّلة لاستخدام الإصدار 1.12 من حِزم تطوير البرامج (SDK) من ARCore أو فيما بعد، يجب الإفصاح عن استخدام Cloud Anchors بشكل بارز في تطبيقك عن طريق تضمين النص التالي، بالإضافة إلى رابط للتعلم أكثر، على شاشة الإشعار: "لتعزيز هذه الجلسة، ستعالج Google البيانات المرئية من الكاميرا". يمكنك القيام بذلك عن طريق تنفيذ يتوفّر مسار إشعار المستخدم المقترَح في نماذج تطبيقات Cloud Anchor.
لمزيد من التفاصيل، راجِع قسم متطلّبات خصوصية المستخدِم.
لمزيد من التفاصيل حول Cloud Anchors:
نظام التشغيل Android:
Android NDK:
نظام التشغيل iOS:
الانسجام:
إضافات ARCore:
الميزات الجديدة في الإصدار 1.11.0 من ARCore
يتضمّن هذا الإصدار التغييرات التالية:
تمت إعادة تسمية خدمة ARCore لتصبح خدمات Google Play للواقع المعزّز. ويتم الآن توزيعه على أجهزة Google Play كجزء من "خدمات Google Play".
تستهدف إعدادات كاميرا ARCore 60 لقطة في الثانية على الأجهزة المتوافقة ويعطي الأولوية لاستخدام أداة استشعار العمق في الأجهزة الموجودة عليه. يمكنك استخدام فلاتر جديدة لإعدادات الكاميرا لتقييد عدد اللقطات في الثانية عند التقاط الكاميرا إلى 30 لقطة في الثانية، منع ARCore من استخدام أداة استشعار عمقها أو الفلترة استنادًا إلى كلا الخيارين.
لمزيد من التفاصيل حول إعدادات الكاميرا:
نظام التشغيل Android:
Android NDK:
الانسجام:
الميزات الجديدة في الإصدار 1.10.0 من ARCore
يضيف هذا الإصدار إمكانات جديدة لتقدير الإضاءة بتقنية HDR البيئية إلى Lighting Estimation API لأجهزة Android وAndroid NDK وUnity.
تستخدم واجهات برمجة التطبيقات هذه التعلم الآلي لتحليل صورة كاميرا الإدخال لتقدير الإضاءة البيئية. يمكنك استخدام بيانات تقدير الإضاءة هذه لعرض إضاءة واقعية للغاية، بما في ذلك ضوء توجيهي أساسي، الظلال والإضاءة المحيطة والإضاءة البارزة والانعكاسات في الأماكن الافتراضية الأخرى. وقد ينتج عن ذلك محتوى افتراضي يبدو أكثر واقعية.
وللحصول على مزيد من التفاصيل:
نظام التشغيل Android:
Android NDK:
الانسجام:
الميزات الجديدة في الإصدار 1.9.0 من ARCore
الميزات الجديدة في ARCore SDK لأجهزة Android
في هذا الإصدار، تتوفّر واجهات برمجة التطبيقات والميزات الجديدة التالية:
Scene Viewer هو عارض مجسم لتفعيل تجارب الواقع المعزّز من موقعك الإلكتروني يتيح لمستخدمي أجهزة Android المحمولة وضع النماذج ثلاثية الأبعاد المستضافة على الويب وعرضها والتفاعل معها بسهولة في بيئتهم.
ميزات "الصور المجمّعة" الجديدة:
يتتبّع ARCore الآن نقل الصور المُعزّزة. ومن الأمثلة على الصور المتحركة الإعلان على حافلة عابرة أو صورة على كائن مستوٍ يمسكه المستخدم أثناء تحريك يده.
بعد اكتشاف إحدى الصور، يكون بإمكان ARCore متابعة تتبع موضع الصورة واتجاهها، حتى إذا تم تحريكها مؤقتًا خارج إطار الكاميرا.
استخدام
AugmentedImage#getTrackingMethod()
(Java) أوArAugmentedImage_getTrackingMethod()
(NDK) لتحديد ما إذا كانت الصورة المجمَّعة يتم تتبُّعه حاليًا بواسطة الكاميرا (FULL_TRACKING
)، أو يتم تتبُّعه اعتمادًا على آخر موضع معروف له (LAST_KNOWN_POSE
).
تتضمّن مستندات Cloud Anchors الآن شرحًا أكثر تفصيلاً تتم استضافة الإعلانات الثابتة ومعالجتها.
الميزات الجديدة في ARCore SDK لمنصة Unity
ميزات "الصور المجمّعة" الجديدة:
يتتبّع ARCore الآن نقل الصور المُعزّزة. ومن الأمثلة على الصور المتحركة الإعلان على حافلة عابرة أو صورة على جسم مستوٍ يحمله المستخدم أثناء تحريكه.
بعد اكتشاف إحدى الصور، يكون بإمكان ARCore متابعة تتبع موضع الصورة واتجاهها، حتى إذا تم تحريكها مؤقتًا خارج إطار الكاميرا.
AugmentedImage.GetTrackingMethod()
الجديد تتيح واجهة برمجة التطبيقات لتطبيقك تحديد ما إذا كانت الصورة المجمَّعة يتم تتبُّعه حاليًا بواسطة الكاميرا (FullTracking
)، أو يتم تتبُّعه استنادًا إلى آخر موضع معروف له (LastKnownPose
).
تتضمّن مستندات Cloud Anchors الآن شرحًا أكثر تفصيلاً تتم استضافة الإعلانات الثابتة ومعالجتها.
الميزات الجديدة في ARCore SDK لنظام التشغيل iOS
دعم هذه الأجهزة:
iPad Mini من الجيل الخامس
iPad Air من الجيل الثالث
تتضمّن مستندات Cloud Anchors الآن شرحًا أكثر تفصيلاً تتم استضافة الإعلانات الثابتة ومعالجتها.