استخدِم المباني والتضاريس من حولك في Unity.

توفّر واجهات برمجة التطبيقات Geometry API لتصميم المناظر الطبيعية الأشكال الهندسية للتضاريس أو المباني أو الهياكل الأخرى في المشهد. يمكن استخدام الأشكال الهندسية لإخفاء العناصر أو عرضها أو وضع محتوى الواقع المعزّز من خلال واجهات برمجة التطبيقات لاختبار العناصر. يتم الحصول على بيانات هندسة المشهد في الشارع من خلال صور "التجوّل الافتراضي من Google".

تجربة العيّنة

يوضّح نموذج التطبيق الجيوفيزيائي كيفية الحصول على أشكال المناظر الطبيعية للشوارع وعرضها.

إعداد واجهة برمجة التطبيقات Geospatial API

لاستخدام Geometry في "مشهد الشوارع"، عليك إعداد Geospatial API في مشروعك. اتّبِع التعليمات الواردة في مقالة تفعيل واجهة برمجة التطبيقات Geospatial API لإعداد واجهة برمجة التطبيقات Geospatial API.

تفعيل هندسة المشهد في الشارع

تحصل واجهة برمجة التطبيقات Geospatial API على بيانات هندسة المشهد في الشارع عند ضبط GeospatialMode على GeospatialMode.Enabled وStreetscapeGeometryMode على StreetscapeGeometryMode.Enabled.

الحصول على هندسة المشهد في الشوارع في جلسة ARCore

أضِف مكوّن ARStreetscapeGeometryManager إلى GameObject. عند إضافة أشكال المناظر الحضرية أو تعديلها أو إزالتها، يتم تشغيل الحدث ARStreetscapeGeometryManager.StreetscapeGeometriesChanged.

public Material streetscapeGeometryMaterial;

List<ARStreetscapeGeometry> _addedStreetscapeGeometries = new List<ARStreetscapeGeometry>();
List<ARStreetscapeGeometry> _updatedStreetscapeGeometries = new List<ARStreetscapeGeometry>();
List<ARStreetscapeGeometry> _removedStreetscapeGeometries = new List<ARStreetscapeGeometry>();

public void OnEnable()
{
    StreetscapeGeometryManager.StreetscapeGeometriesChanged +=
        GetStreetscapeGeometry;
}

public void Update() {
  foreach (ARStreetscapeGeometry streetscapegeometry in _addedStreetscapeGeometries)
  {
    GameObject renderObject = new GameObject(
       "StreetscapeGeometryMesh", typeof(MeshFilter), typeof(MeshRenderer));

    if (renderObject)
    {
        renderObject.transform.position = streetscapegeometry.pose.position;
        renderObject.transform.rotation = streetscapegeometry.pose.rotation;
        renderObject.GetComponent<MeshFilter>().mesh = streetscapegeometry.mesh;
        renderObject.GetComponent<MeshRenderer>().material = streetscapeGeometryMaterial;
    }
  }
}

public void OnDisable()
{
    StreetscapeGeometryManager.StreetscapeGeometriesChanged -=
        GetStreetscapeGeometry;
}

private void GetStreetscapeGeometry(ARStreetscapeGeometriesChangedEventArgs eventArgs)
{
    _addedStreetscapeGeometries = eventArgs.Added;
    _updatedStreetscapeGeometries = eventArgs.Updated;
    _removedStreetscapeGeometries = eventArgs.Removed;
}

فهم ARStreetscapeGeometry

يحتوي ARStreetscapeGeometry على معلومات عن مبنى:

مستوى التفاصيل 1 للمبنى

يتكوّن BuildingLOD1 من مساحات المباني التي تمّت إزالتها من السطح المستوي. قد تكون ارتفاعات المباني غير دقيقة.

مستوى التفاصيل 2 للمبنى

سيكون لدى BuildingLOD2 شكل هندسي بدقة أعلى. ستتطابق الجدران والأسقف الشبكية بشكلٍ أكبر مع شكل المبنى. قد تبقى بعض العناصر الأصغر حجمًا، مثل المداخن أو فتحات التهوية على السطح، خارج الشبكة.

فهم Mesh

Mesh هي شبكة مضلّعات تمثّل إعادة إنشاء سطح هندسة المشهد في الشارع. يُرجى الاطّلاع على Mesh وMeshRenderer. يُرجى العلم أنّه لا يتم احتساب القيم العادية تلقائيًا، ويمكنك الاطّلاع على Mesh.RecalculateNormals() لاحتساب هذه القيم.

إرفاق محتوى الواقع المعزّز بـ ARStreetscapeGeometry

استخدِم ARAnchorManager.AddAnchor() لإنشاء نقطة تثبيت في وضع معيّن بالقرب من الرؤوس في ARStreetscapeGeometry.mesh. ستكتسب هذه العلامة الفارقة حالة التتبّع من العنصر الرئيسي ARStreetscapeGeometry.

إجراء اختبار مطابقة مع ARStreetscapeGeometry

يمكن استخدام ARRaycastManagerExtensions.RaycastStreetscapeGeometry لإجراء اختبار التصادم مع هندسة المشهد في الشارع. في حال العثور على تقاطعات، يحتوي XRRaycastHit على معلومات عن وضع الجسم في موقع الاصطدام بالإضافة إلى إشارة إلى ARStreetscapeGeometry الذي تم اصطدامه. يمكن تمرير هندسة المشهد في الشارع إلى ARAnchorManager.AddAnchor() لإنشاء عنصر تثبيت مرتبط بها.

Vector2 screenTapPosition = Input.GetTouch(0).position;
List<XRRaycastHit> hitResults = new List<XRRaycastHit>();
if (RaycastManager.RaycastStreetscapeGeometry(screenTapPosition, ref hitResults)){
  ARStreetscapeGeometry streetscapegeometry =
      StreetscapeGeometryManager.GetStreetscapeGeometry(hitResults[0].trackableId);
  if (streetscapegeometry != null)
  {
      ARAnchor anchor = StreetscapeGeometryManager.AttachAnchor(streetscapegeometry, hitResults[0].pose);
  }
}

تفعيل "التفاصيل الجغرافية المكانية"

تجمع ميزة العمق الجغرافي المكاني بين هندسة المشهد في الشارع ومعلومات أدوات الاستشعار المحلية لتحسين بيانات العمق. عند تفعيل ميزة "العمق الجغرافي المكاني"، يتم تعديل عمق الصورة الناتجة وصور العمق الأوّلي لتضمين شكل هندسي ممسوح ضوئيًا للمشهد في الشارع بالإضافة إلى العمق المرصود محليًا. وقد يؤدي ذلك إلى تحسين دقة الوضعيات باستخدام ميزة "العمق".