تغييرات جديدة وملحوظة في ARCore
الميزات الجديدة في الإصدار 1.44.0 من ARCore
لا يحتوي هذا الإصدار على ميزات جديدة.
الميزات الجديدة في الإصدار 1.43.0 من ARCore
واجهة Places API في نقل بيانات Geospatial Creator
تستخدم ميزة البحث في Geospatial Creator الآن New Places API من Google. لاستخدام ميزة البحث، فعِّل "واجهة برمجة التطبيقات للأماكن (جديدة)" في 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 extensions for Unity's AR Foundation متوافقة الآن مع الإصدارات 5.x من مؤسسة AR Foundation. لنقل مشروع حالي إلى AR Foundation، يُرجى الاطّلاع على دليل نقل البيانات.
الميزات الجديدة في الإصدار 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 الآن البحث النصي لتحديد موضع عرض مربّعات الصور الثلاثية الأبعاد. يمكنك الاطّلاع على البحث عن نقاط الاهتمام في Geospatial Creator للحصول على مزيد من المعلومات.
الميزات الجديدة في الإصدار 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): النمط الرباعي الأوروبي (EUS) للوضعية
- 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: يؤدي تحديد مستوى واجهة برمجة تطبيقات مستهدَف في إعدادات المشروع > المشغّل > 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 API ليتضمن إمكانية استشعار العمق على المدى البعيد، ما يزيد من نطاق ملاحظات العمق التي يمكن تمثيلها. يتم استخدام جميع صور العمق البالغ عددها 16 بت، ما يوفر نطاقًا أقصى يبلغ 65535 ملم. في السابق، كانت تتم تعبئة 13 وحدة بت فقط، بحد أقصى 8191 مليمتر.
يمكنك الاطّلاع على التغييرات في Depth API للاطّلاع على مستندات مطوّري البرامج الخاصة بالنظام الأساسي وفهم التغييرات التي طرأت على Depth API.
ملاحظات خاصة بالنظام الأساسي
Android
واجهات برمجة تطبيقات ARCore Geospatial الجديدة
Java
- يوفّر
Earth
إمكانية الأقلمة في الإحداثيات النسبية للأرض.Earth.createAnchor()
ينشئAnchor
جديدًا في الموقع والاتجاه المحدّدَين بالنسبة إلى الأرض.
Earth.Earthstate
تصف حالةEarth
الحالية، بما في ذلكTrackingState
.- يصف
GeospatialPose
موقعًا جغرافيًا وارتفاعًا واتجاه بوصلة بالنسبة إلى الأرض.
- يوفّر
C
ArEarth
يوفّر إمكانية الأقلمة في الإحداثيات النسبية للأرض.ArEarth_acquireNewAnchor()
ينشئAnchor
جديدًا في الموقع والاتجاه المحدّدَين بالنسبة إلى الأرض.ArEarthState
تصف حالةArEarth
الحالية، بما في ذلكArTrackingState
.
- يصف
ArGeospatialPose
موقعًا جغرافيًا وارتفاعًا واتجاه بوصلة بالنسبة إلى الأرض.
واجهات برمجة تطبيقات 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
توفّر عملية الأقلمة حسب تطبيق Earth.- يدير
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
جديد. لا تضم صيغة الإصدار هذه تبعيات خارجية مثل External Dependency Manager for Unity وتسمح بالترقية إلى موسيقى الرقص الإلكترونية. قد يؤدي استخدام هذا الإصدار البسيط إلى حلّ حالات عدم التوافق عند استخدام مكتبات Firebase. للبدء، يمكنك الاطّلاع على تعليمات تثبيت ARCore تجاه مؤسسة AR Foundation.تمت ترقية ExternalDependencyManager إلى الإصدار 1.2.168 ليتوافق بشكل أفضل مع إصدارات 2021.2 والإصدارات الأحدث. يمكنك الاطّلاع على التفاصيل في سجلّ تغييرات EDM.
تم إصلاح مشكلة ضبط جلسة 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) المتأثرة على الوظيفة المحدَّدة التي يتم طلبها. يمكنك الاطّلاع على الإشعار عن الإيقاف النهائي لمزيد من المعلومات.
- C: ستعرض المكالمات التي يتم إجراؤها إلى
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>
فارغة.
- C: ستعرض المكالمات التي يتم إجراؤها إلى
- 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
تسجيل مسار مخصّص
إنّ إمكانية مسار البيانات المخصّصة الجديدة في واجهة برمجة التطبيقات للتسجيل والتشغيل تتيح لك إضافة بيانات مخصّصة إلى إطار 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 أو الإصدارات الأقدم لم تعد قادرة على استضافة "ثابت في السحابة الإلكترونية" أو حلّها.
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 وUnity.
التسجيل والتشغيل
باستخدام واجهات برمجة التطبيقات للتسجيل والتشغيل، يمكنك تسجيل بيانات الفيديو والواقع المعزّز مرة واحدة داخل بيئة معيّنة واستخدام ذلك المحتوى لاستبدال جلسة كاميرا مباشرة لأغراض الاختبار. يحفظ ARCore الجلسات المسجّلة في ملفات MP4 التي تتضمن مقاطع فيديو متعددة وبيانات متنوعة أخرى على الجهاز. يمكنك بعد ذلك توجيه تطبيقك لاستخدام هذه البيانات بدلاً من جلسة كاميرا مباشرة. يتيح لك هذا الإجراء إعادة تشغيل هذا المحتوى إلى أجل غير مسمّى وتجربة تأثيرات الواقع المعزّز المختلفة بدون الحاجة إلى العودة إلى ساحة القتال.
للاطّلاع على مزيد من التفاصيل:
Java:
C:
Unity:
الميزات الجديدة في الإصدار 1.20.0 من ARCore
يضيف هذا الإصدار التغييرات الملحوظة التالية:
دعم جديد لـ Cloud Anchor Anchors الدائمون
تم تعديل إمكانات البيانات الوصفية للصور لنظامَي التشغيل Android وAndroid NDK.
إرشادات جديدة تتطلّب الإصدار 5.6.4 من Gradle أو إصدارًا أحدث، لإتاحة استخدام إضافات ARCore للناشرين مع مؤسسة AR أو ARCore SDK for Unity (الإصدار 1.19 أو إصدار أحدث) مع إصدار Unity 2018.4 أو إصدار أحدث.
دعم جديد لتثبيتات Cloud Anchors الدائمة
قبل الإصدار 1.20 من ARCore، كان بإمكان Cloud Anchors حل مشاكله لمدة تصل إلى 24 ساعة فقط بعد استضافته لأول مرة. باستخدام "Cloud Anchors" الدائم، يمكنك الآن إنشاء "Cloud Anchor" وتحديد مدة البقاء فيه بين يوم واحد و365 يومًا. يمكنك أيضًا إطالة عمر إعلان الارتساء بعد استضافته من قبل باستخدام Cloud Anchor Management API.
تُطبَّق سياسة الإيقاف النهائي لـ Cloud Anchors الجديدة
ج: دليل المطوِّر و
ArSession_hostAndAcquireNewCloudAnchorWithTtl
وArSession_estimateFeatureMapQualityForHosting
Java: دليل المطوِّر و
hostCloudAnchorWithTtl
وestimateFeatureMapQualityForHosting
.iOS: دليل المطوِّر و
hostCloudAnchor:TTLDays:error:
وestimateFeatureMapQualityForHosting:
ARCore Networks 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 وUnity.
- إرشادات جديدة لتصميم نظام التشغيل Android 11 باستخدام Unity.
موضع الإعلان الفوري
تتيح واجهة برمجة التطبيقات للموقع الإلكتروني الفوري للمستخدم وضع كائن الواقع المعزّز على الشاشة بدون الحاجة إلى انتظار أن تكتشف ARCore هندسة السطح. ويتم تحسين موضع العنصر في الوقت الفعلي مع تحرك المستخدم بشكل أكبر في جميع أنحاء البيئة. بعد أن يكتشف ARCore الوضع الصحيح في المنطقة التي يتم فيها وضع كائن الواقع المعزّز، يتم تحديث الجسم الأبيض تلقائيًا ليصبح دقيقًا ويصبح معتمًا.
يعرض المقطع التالي شخصية افتراضية لجهاز Android على جدول واقعي. ويكون الشكل أبيض ويقل حجمه كثيرًا عند وضعه أول مرة. بعد أن قامت ARCore بتحسين حساباتها لأبعاد المشهد، ينتقل الشكل إلى موضع أكثر دقة. وقد يؤدي هذا إلى اختلاف في "الحجم" المتصور للكائن.
للاطّلاع على مزيد من التفاصيل:
نظام التشغيل Android:
Android NDK:
Unity:
الميزات الجديدة في الإصدار 1.18.0 من ARCore
يضيف هذا الإصدار التغييرات الملحوظة التالية:
- واجهة برمجة تطبيقات Depth API جديدة لأجهزة Android وAndroid NDK وUnity.
- إرشادات جديدة لإنشاء مواد عرض ميزة "الوجوه المحسّنة" واستيرادها إلى "استوديو Android"
- ستتم إتاحة Depth API في
4.1.0-preview.2
لكل منAR Foundation
وARCore XR Plugin
.
واجهة برمجة التطبيقات Depth API
لإنشاء خرائط عمق، تستخدم واجهة برمجة التطبيقات Depth API على الأجهزة المتوافقة مع عمقها الكاميرا المزوّدة بنموذج أحمر أخضر أزرق في الجهاز المتوافق مع ARCore أو أداة استشعار العمق النشط إن توفّرت. ويمكنك بعد ذلك استخدام العمق لكل بكسل الذي توفّره خريطة العمق لعرض الكائنات الافتراضية بدقة أمام أو خلف أشياء في العالم الحقيقي، ما يتيح للمستخدمين تجربة غامرة وواقعية.
على سبيل المثال، تعرض الصور التالية شكل Android افتراضيًا في مساحة حقيقية تحتوي على صندوق بجانب الباب. تحجب واجهة برمجة التطبيقات Depth API بشكل صحيح الشكل خلف حافة الجذع.
للاطّلاع على مزيد من التفاصيل:
نظام التشغيل Android:
Android NDK:
Unity:
الميزات الجديدة في الإصدار 1.17.0 من ARCore
بارز في ARCore SDK لنظام التشغيل Android
تمت إضافة طرق جديدة تسمح بالتخزين المؤقت لإطارات عدة كاميرات. وإلى جانب الأساليب الأخرى، مثل العرض المتعدّد السلاسل، يمكن استخدام ذلك لتقليل التباين في عدد اللقطات في الثانية.
تمت إضافة بيانات الاستخدام غير المتوفّرة لأداة استشعار العمق وعدد اللقطات المُستهدَف في الثانية:
ويمكنك الاطّلاع أيضًا على ملاحظات الإصدار الكاملة لحزمة تطوير البرامج (SDK) لنظام التشغيل Android.
بارز في ARCore SDK for Unity
- تمت إضافة دعم العرض المتعدّد السلاسل في إصدار Unity 2018.2 أو الإصدارات الأحدث، ما سيؤدي في معظم الحالات إلى تحسين الأداء والحدّ من التباين في عدد اللقطات في الثانية. هذا إعداد لمشروع Unity، ويمكن العثور عليه في إعدادات المشروع > المشغّل > 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 في API للواقع المعزّز من عدّة منصات. تم تعديل مستندات إضافات 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 Extensions.
بارز في 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 لمنصّة AR Foundation من Unity لإنشاء تطبيقات iOS باستخدام Cloud Anchors
إتاحة تقدير الإضاءة البيئية بنطاق عالي الديناميكية في المشهد
ويمكنك الاطّلاع على ملاحظات الإصدار التالية للتعرّف على إصلاحات إضافية للأخطاء والتغييرات الأخرى التي قد تؤدي إلى أعطال.
ملاحظات الإصدار الكاملة لحزمة تطوير البرامج (SDK) لنظام التشغيل Android
ملاحظات الإصدار الكاملة لحزمة تطوير البرامج (SDK) لنظام التشغيل Android
ملاحظات الإصدار الكاملة لحزمة تطوير البرامج (SDK) من ARCore لنظام التشغيل iOS
الميزات الجديدة في الإصدار 1.12.0 من ARCore
يتضمّن هذا الإصدار التغييرات التالية:
تمت إضافة ميزة "وجوه معززة" إلى نظام iOS. للحصول على مزيد من المعلومات، يمكنك الاطّلاع على هذه النظرة العامة وquickstart ودليل المطوِّر.
دعم لاستخدام إضافات ARCore for Unity's AR Foundation لإنشاء تطبيقات Android باستخدام Cloud Anchors.
التغييرات التالية على Cloud Anchors:
- للامتثال لمتطلبات الخصوصية المعدّلة لاستخدام الإصدار 1.12 من ARCore SDK أو إصدار أحدث، يجب الإفصاح بشكل واضح عن استخدام Cloud Anchors في تطبيقك من خلال تضمين النص التالي بالإضافة إلى رابط لمعرفة المزيد من المعلومات على شاشة الإشعار: "لتعزيز تشغيل هذه الجلسة، ستعالج Google البيانات المرئية من الكاميرا". ويمكنك إجراء ذلك من خلال تنفيذ خطوات إشعارات المستخدم الموصى بها المتاحة في نماذج تطبيقات Cloud
لمزيد من التفاصيل، راجِع قسم متطلّبات خصوصية المستخدِم.
لمزيد من التفاصيل حول Cloud Anchors:
نظام التشغيل Android:
Android NDK:
نظام التشغيل iOS:
Unity:
إضافات ARCore:
الميزات الجديدة في الإصدار 1.11.0 من ARCore
يتضمّن هذا الإصدار التغييرات التالية:
تمت إعادة تسمية خدمة ARCore لتصبح خدمات Google Play للواقع المعزّز. ويتم الآن توزيعه على أجهزة Google Play كجزء من "خدمات Google Play".
تستهدِف إعدادات كاميرا ARCore معدّل 60 لقطة في الثانية على الأجهزة المتوافقة وتعطي الأولوية لاستخدام أداة استشعار العمق على الأجهزة المزوّدة بها. يمكنك استخدام فلاتر جديدة لإعدادات الكاميرا لضبط عدد اللقطات في الثانية عند التقاط الكاميرا على 30 لقطة في الثانية، أو منع ARCore من استخدام أداة استشعار العمق، أو الفلترة استنادًا إلى كلا الخيارين.
لمزيد من التفاصيل حول إعدادات الكاميرا:
نظام التشغيل Android:
Android NDK:
Unity:
الميزات الجديدة في الإصدار 1.10.0 من ARCore
يضيف هذا الإصدار إمكانات جديدة لتقدير الإضاءة بتقنية Environmental HDR إلى واجهة برمجة التطبيقات Lighting Estimation API لأجهزة Android وAndroid NDK وUnity.
تستخدم واجهات برمجة التطبيقات هذه تقنية تعلُّم الآلة لتحليل صورة كاميرا الإدخال وتقدير الإضاءة البيئية. يمكنك استخدام بيانات تقدير الإضاءة هذه لعرض إضاءة واقعية للغاية، بما في ذلك ضوء الاتجاه الأساسي والظلال والإضاءة المحيطة والإضاءة البارزة والانعكاسات على الأجسام الافتراضية. وقد ينتج عن ذلك محتوى افتراضي يبدو أكثر واقعية.
للاطّلاع على مزيد من التفاصيل:
نظام التشغيل Android:
Android NDK:
Unity:
الميزات الجديدة في الإصدار 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 الآن شرحًا أكثر تفصيلاً حول كيفية استضافة الارتساء وحلّه.