Pakiet SDK XR na Androida jest teraz dostępny w wersji dla programistów. Chcemy poznać Twoją opinię. Aby się z nami skontaktować, odwiedź naszą stronę pomocy.

Ta strona została przetłumaczona przez Cloud Translation API.

Rozszerzenie OpenXR XR_ANDROID_trackables

Ciąg znaków nazwy

XR_ANDROID_trackables_object

Typ rozszerzenia

Rozszerzenie instancji

Zarejestrowany numer wewnętrzny

467

Weryfikacja

Zależności rozszerzenia i wersji

XR_ANDROID_trackables

Data ostatniej modyfikacji

2024-10-03

Stan adresu IP

Brak znanych roszczeń dotyczących adresu IP.

Twórcy

Spencer Quin, Google

Nihav Jain, Google

John Pursey, Google

Jared Finder, Google

Levana Chen, Google

Kenny Vercaemer, Google

Omówienie

To rozszerzenie umożliwia śledzenie obiektów fizycznych. Na przykład klawiatury, myszy i inne obiekty w otoczeniu.

Śledzenie obiektów

To rozszerzenie dodaje XR_TRACKABLE_TYPE_OBJECT_ANDROID do XrTrackableTypeANDROID.

Aplikacja może utworzyć XrTrackableTrackerANDROID, wywołując funkcję xrCreateTrackableTrackerANDROID i podając XR_TRACKABLE_TYPE_OBJECT_ANDROID jako typ śledzenia w XrTrackableTrackerCreateInfoANDROID::trackableType, aby śledzić obiekty.

Pobieranie obiektu śledzonego

Funkcja xrGetTrackableObjectANDROID jest zdefiniowana w ten sposób:

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

Opisy parametrów

tracker to XrTrackableTrackerANDROID, którego dotyczy zapytanie.
- getInfo to XrTrackableGetInfoANDROID z informacjami służącymi do uzyskania obiektu śledzenia.
- objectOutput to wskaźnik do struktury XrTrackableObjectANDROID, w której zwracany jest obiekt śledzenia.

Wartość XR_ERROR_MISMATCHING_TRACKABLE_TYPE_ANDROID zostanie zwrócona, jeśli typ obiektu śledzonego XrTrackableANDROID nie jest XR_TRACKABLE_TYPE_OBJECT_ANDROID lub jeśli typ obiektu śledzonego XrTrackableTrackerANDROID nie jest XR_TRACKABLE_TYPE_OBJECT_ANDROID.

Prawidłowe użycie (domyślne)

Przed wywołaniem metody xrGetTrackableObjectANDROID musi być włączone rozszerzenie XR_ANDROID_trackables_object.
- tracker musi być prawidłowym identyfikatorem XrTrackableTrackerANDROID
- getInfo musi być wskaźnikiem do prawidłowej struktury XrTrackableGetInfoANDROID
- objectOutput musi być wskaźnikiem do struktury XrTrackableObjectANDROID.

Kody zwrotu

Gotowe

XR_SUCCESS
- XR_SESSION_LOSS_PENDING

Błąd

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

Struktura XrTrackableObjectANDROID jest zdefiniowana jako:

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

Opisy członków

type to XrStructureType tej struktury.
- next to NULL lub wskaźnik do następnej struktury w łańcuchu struktur. Nie ma żadnych takich struktur zdefiniowanych w podstawowym OpenXR ani w tym rozszerzeniu.
- trackingState to XrTrackingStateANDROID obiektu.
- centerPose to XrPosef obiektu znajdującego się w XrTrackableGetInfoANDROID::baseSpace.
- extents to wymiar XrExtent3DfEXT obiektu.
- objectLabel to XrObjectLabelANDROID zdefiniowany przez środowisko uruchomieniowe dla tego obiektu.
- lastUpdatedTime to data XrTime ostatniej aktualizacji obiektu.

Prawidłowe użycie (domyślne)

Przed użyciem klasy XrTrackableObjectANDROID
- type musi być XR_TYPE_TRACKABLE_OBJECT_ANDROID
- next musi być NULL lub prawidłowym wskaźnikiem do następnej struktury w łańcuchu struktur.
- trackingState musi być prawidłową wartością XrTrackingStateANDROID
- objectLabel musi być prawidłową wartością XrObjectLabelANDROID.

Typ enumeracji XrObjectLabelANDROID to etykieta obiektu XrTrackableANDROID.

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;

Przykładowy kod do uzyskiwania obiektów śledzenia

Poniższy przykładowy kod pokazuje, jak pobierać obiekty śledzenia.

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);

Nowe stałe typu wyliczeniowego

Wyliczenie XrStructureType zostało rozszerzone o:

XR_TYPE_TRACKABLE_OBJECT_ANDROID
XR_TYPE_TRACKABLE_OBJECT_CONFIGURATION_ANDROID

Wyliczenie XrTrackableTypeANDROID zostało rozszerzone o:

XR_TRACKABLE_TYPE_OBJECT_ANDROID

Nowe wartości w polu enum

XrObjectLabelANDROID

Nowe struktury

XrTrackableObjectANDROID

Nowe funkcje

xrGetTrackableObjectANDROID

Problemy

Historia wersji

Wersja 1, 3.10.2024 (Kenny Vercaemer)
- Początkowy opis rozszerzenia.