Android XR SDK'sı artık Geliştirici Önizlemesi'nde kullanılabilir. Geri bildirimlerinizi bekliyoruz! Bizimle iletişime geçmek için destek sayfamızı ziyaret edin.

Bu sayfa, Cloud Translation API ile çevrilmiştir.

XR_ANDROID_trackables OpenXR uzantısı

Ad dizesi

XR_ANDROID_trackables_object

Uzantı Türü

Örnek uzatma

Kayıtlı Uzatma Numarası

467

Düzeltme

Uzantı ve Sürüm Bağımlılıkları

XR_ANDROID_trackables

Son Değiştirilme Tarihi

2024-10-03

IP Durumu

Bilinen IP hak talepleri yok.

Katkıda bulunanlar

Spencer Quin, Google

Nihav Jain, Google

John Pursey, Google

Jared Finder, Google

Levana Chen, Google

Kenny Vercaemer, Google

Genel Bakış

Bu uzantı, fiziksel nesne izlemeyi etkinleştirir. Örneğin, klavyeler, fareler ve ortamdaki diğer nesneler.

Nesneleri izleme

Bu uzantı, XR_TRACKABLE_TYPE_OBJECT_ANDROID öğesini XrTrackableTypeANDROID alanına ekler.

Uygulama, nesneleri izlemek için xrCreateTrackableTrackerANDROID işlevini çağırarak ve XrTrackableTrackerCreateInfoANDROID::trackableType parametresinde izlenebilir tür olarak XR_TRACKABLE_TYPE_OBJECT_ANDROID değerini belirterek XrTrackableTrackerANDROID oluşturabilir.

İzlenebilir nesne alma

xrGetTrackableObjectANDROID işlevi şu şekilde tanımlanır:

XrResult xrGetTrackableObjectANDROID(
    XrTrackableTrackerANDROID                   tracker,
    const XrTrackableGetInfoANDROID*            getInfo,
    XrTrackableObjectANDROID*                   objectOutput);

Parametre Açıklamaları

tracker, sorgulanacak XrTrackableTrackerANDROID öğesidir.
- getInfo, takip edilebilir nesneyi almak için kullanılan bilgileri içeren XrTrackableGetInfoANDROID öğesidir.
- objectOutput, izlenebilen nesnenin döndürüldüğü XrTrackableObjectANDROID yapısının işaretçisidir.

XrTrackableANDROID öğesinin izlenebilir türü XR_TRACKABLE_TYPE_OBJECT_ANDROID değilse veya XrTrackableTrackerANDROID öğesinin izlenebilir türü XR_TRACKABLE_TYPE_OBJECT_ANDROID değilse XR_ERROR_MISMATCHING_TRACKABLE_TYPE_ANDROID döndürülür.

Geçerli Kullanım (Dolayı)

xrGetTrackableObjectANDROID çağrılmadan önce XR_ANDROID_trackables_object uzantısı etkinleştirilmelidir.
- tracker geçerli bir XrTrackableTrackerANDROID işaretçisi olmalıdır
- getInfo, geçerli bir XrTrackableGetInfoANDROID yapısının işaretçisi olmalıdır
- objectOutput, XrTrackableObjectANDROID yapısına işaret eden bir olmalıdır

İade Kodları

Başarılı

XR_SUCCESS
- XR_SESSION_LOSS_PENDING

Hata

XR_ERROR_FUNCTION_UNSUPPORTED
- XR_ERROR_VALIDATION_FAILURE
- XR_ERROR_RUNTIME_FAILURE
- XR_ERROR_HANDLE_INVALID
- XR_ERROR_INSTANCE_LOST
- XR_ERROR_SESSION_LOST
- XR_ERROR_SESSION_NOT_RUNNING
- XR_ERROR_TIME_INVALID

XrTrackableObjectANDROID yapısı şu şekilde tanımlanır:

typedef struct XrTrackableObjectANDROID {
    XrStructureType           type;
    void*                     next;
    XrTrackingStateANDROID    trackingState;
    XrPosef                   centerPose;
    XrExtent3DfEXT            extents;
    XrObjectLabelANDROID      objectLabel;
    XrTime                    lastUpdatedTime;
} XrTrackableObjectANDROID;

Üye Açıklamaları

type, bu yapının XrStructureType değeridir.
- next, NULL veya bir yapı zincirindeki sonraki yapının işaretçisidir. Temel OpenXR'da veya bu uzantıda böyle bir yapı tanımlanmamıştır.
- trackingState, nesnenin XrTrackingStateANDROID değeridir.
- centerPose, XrTrackableGetInfoANDROID::baseSpace içinde bulunan nesnenin XrPosef değeridir.
- extents, nesnenin XrExtent3DfEXT boyutudur.
- objectLabel, çalışma zamanında bu nesne için belirlenen XrObjectLabelANDROID değeridir.
- lastUpdatedTime, nesnenin son güncellemesinin XrTime değeridir.

Geçerli Kullanım (Dolayı)

XrTrackableObjectANDROID kullanmadan önce XR_ANDROID_trackables_object uzantısı etkinleştirilmelidir.
- type XR_TYPE_TRACKABLE_OBJECT_ANDROID olmalıdır
- next NULL veya bir yapı zincirindeki sonraki yapıya işaret eden geçerli bir işaretçi olmalıdır.
- trackingState geçerli bir XrTrackingStateANDROID değeri olmalıdır.
- objectLabel geçerli bir XrObjectLabelANDROID değeri olmalıdır.

XrObjectLabelANDROID enum, XrTrackableANDROID nesnesi için bir etikettir.

typedef enum XrObjectLabelANDROID {
    XR_OBJECT_LABEL_UNKNOWN_ANDROID = 0,
    XR_OBJECT_LABEL_KEYBOARD_ANDROID = 1,
    XR_OBJECT_LABEL_MOUSE_ANDROID = 2,
    XR_OBJECT_LABEL_LAPTOP_ANDROID = 3,
    XR_OBJECT_LABEL_MAX_ENUM_ANDROID = 0x7FFFFFFF
} XrObjectLabelANDROID;

İzlenebilir nesneleri almayla ilgili örnek kod

Aşağıdaki örnek kodda, izlenebilir nesnelerin nasıl alınacağı gösterilmektedir.

XrSession session; // previously initialized

// The function pointers are previously initialized using xrGetInstanceProcAddr.
PFN_xrCreateTrackableTrackerANDROID xrCreateTrackableTrackerANDROID; // previously initialized
PFN_xrGetAllTrackablesANDROID xrGetAllTrackablesANDROID; // previously initialized
PFN_xrGetTrackableObjectANDROID xrGetTrackableObjectANDROID; // previously initialized
PFN_xrDestroyTrackableTrackerANDROID xrDestroyTrackableTrackerANDROID; // previously initialized

XrTime updateTime; // Time used for the current frame's simulation update.
XrSpace appSpace; // Space created for XR_REFERENCE_SPACE_TYPE_LOCAL.

XrTrackableTrackerCreateInfoANDROID
  createInfo{XR_TYPE_TRACKABLE_TRACKER_CREATE_INFO_ANDROID};
createInfo.trackableType = XR_TRACKABLE_TYPE_OBJECT_ANDROID;
XrTrackableTracker objectTrackableTracker;
XrResult result = xrCreateTrackableTrackerANDROID(
  session,
  &createInfo,
  &objectrackableTracker);
if (result != XR_SUCCESS) { /* Handle failures. */ }

uint32_t trackableCountOutput = 0;
std::vector<XrTrackableANDROID> allObjectTrackables;

// Query the number of trackables available.
result = xrGetAllTrackablesANDROID(
  objectTrackableTracker,
  0,
  &trackableCountOutput,
  nullptr
);

if (result == XR_SUCCESS) {
  allObjectTrackables.resize(trackableCountOutput, XR_NULL_TRACKABLE_ANDROID);

  // Fetch the actual trackable handles in the appropriately resized array.
  result = xrGetAllTrackablesANDROID(
    objectTrackableTracker,
    trackableCountOutput,
    &trackableCountOutput,
    allObjectTrackables.data());

  if (result == XR_SUCCESS) {
    for (XrTrackableANDROID trackable : allObjectTrackables) {

      // Object trackable query information
      XrTrackableGetInfoANDROID objectGetInfo;
      objectGetInfo.type = XR_TYPE_TRACKABLE_GET_INFO_ANDROID;
      objectGetInfo.next = nullptr;
      objectGetInfo.trackable = trackable;
      objectGetInfo.space = appSpace;
      objectGetInfo.time = updateTime;

      // Get the object trackable. Note that the tracker only returns object types.
      XrTrackableObjectANDROID object = { XR_TYPE_TRACKABLE_OBJECT_ANDROID };
      result = xrGetTrackableObjectANDROID(
        objectTrackableTracker,
        &objectGetInfo,
        &object
      );

      if (result == XR_SUCCESS) {
        /** Do Stuff with the object */
      }
    }
  }
}

// Release trackable tracker.
result = xrDestroyTrackableTrackerANDROID(objectTrackableTracker);

Yeni Enum Constants

XrStructureType dizini aşağıdakilerle genişletildi:

XR_TYPE_TRACKABLE_OBJECT_ANDROID
XR_TYPE_TRACKABLE_OBJECT_CONFIGURATION_ANDROID

XrTrackableTypeANDROID dizini aşağıdakilerle genişletildi:

XR_TRACKABLE_TYPE_OBJECT_ANDROID

Yeni Sıralamalar

XrObjectLabelANDROID

Yeni Yapılar

XrTrackableObjectANDROID

Yeni İşlevler

xrGetTrackableObjectANDROID

Sorunlar

Sürüm Geçmişi

Düzeltme 1, 03.10.2024 (Kenny Vercaemer)
- İlk uzantı açıklaması.