O SDK do Android XR agora está disponível na prévia para desenvolvedores. Queremos saber sua opinião Acesse nossa página de suporte para entrar em contato.

Esta página foi traduzida pela API Cloud Translation.

Extensão XR_ANDROID_trackables do OpenXR

String de nome

XR_ANDROID_trackables_object

Tipo de extensão

Extensão de instância

Número de extensão registrado

467

Revisão

Dependências de extensão e versão

XR_ANDROID_trackables

Data da última modificação

2024-10-03

Status do IP

Nenhuma reivindicação de IP conhecida.

Colaboradores

Spencer Quin, Google

Nihav Jain, Google

John Pursey, Google

Jared Finder, Google

Levana Chen, Google

Kenny Vercaemer, Google

Visão geral

Essa extensão ativa o rastreamento de objetos físicos. Por exemplo, teclados, mouses e outros objetos no ambiente.

Rastrear objetos

Essa extensão adiciona XR_TRACKABLE_TYPE_OBJECT_ANDROID a XrTrackableTypeANDROID.

O aplicativo pode criar um XrTrackableTrackerANDROID chamando xrCreateTrackableTrackerANDROID e especificando XR_TRACKABLE_TYPE_OBJECT_ANDROID como o tipo rastreável em XrTrackableTrackerCreateInfoANDROID::trackableType para rastrear objetos.

Conseguir objeto rastreável

A função xrGetTrackableObjectANDROID é definida como:

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

Descrições dos parâmetros

tracker é o XrTrackableTrackerANDROID a ser consultado.
- getInfo é o XrTrackableGetInfoANDROID com as informações usadas para receber o objeto rastreável.
- objectOutput é um ponteiro para a estrutura XrTrackableObjectANDROID em que o objeto rastreável é retornado.

XR_ERROR_MISMATCHING_TRACKABLE_TYPE_ANDROID será retornado se o tipo rastreável do XrTrackableANDROID não for XR_TRACKABLE_TYPE_OBJECT_ANDROID ou se o tipo rastreável do XrTrackableTrackerANDROID não for XR_TRACKABLE_TYPE_OBJECT_ANDROID.

Uso válido (implícito)

A extensão XR_ANDROID_trackables_object precisa ser ativada antes de chamar xrGetTrackableObjectANDROID
- tracker precisa ser um identificador XrTrackableTrackerANDROID válido
- getInfo precisa ser um ponteiro para uma estrutura XrTrackableGetInfoANDROID válida.
- objectOutput precisa ser um ponteiro para uma estrutura XrTrackableObjectANDROID.

Códigos de retorno

Sucesso

XR_SUCCESS
- XR_SESSION_LOSS_PENDING

Falha

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

A estrutura XrTrackableObjectANDROID é definida como:

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

Descrições dos participantes

type é o XrStructureType dessa estrutura.
- next é NULL ou um ponteiro para a próxima estrutura em uma cadeia de estruturas. Nenhuma dessas estruturas é definida no núcleo do OpenXR ou nesta extensão.
- trackingState é o XrTrackingStateANDROID do objeto.
- centerPose é o XrPosef do objeto localizado em XrTrackableGetInfoANDROID::baseSpace.
- extents é a dimensão XrExtent3DfEXT do objeto.
- objectLabel é o XrObjectLabelANDROID que o ambiente de execução determinou para esse objeto.
- lastUpdatedTime é o XrTime da última atualização do objeto.

Uso válido (implícito)

A extensão XR_ANDROID_trackables_object precisa ser ativada antes de usar XrTrackableObjectANDROID
- type precisa ser XR_TYPE_TRACKABLE_OBJECT_ANDROID
- next precisa ser NULL ou um ponteiro válido para a próxima estrutura em uma cadeia de estruturas
- trackingState precisa ser um valor válido de XrTrackingStateANDROID
- objectLabel precisa ser um valor XrObjectLabelANDROID válido

O tipo enumerado XrObjectLabelANDROID é um rótulo para um objeto 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;

Exemplo de código para receber objetos rastreáveis

O exemplo de código abaixo demonstra como acessar objetos rastreáveis.

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

Novas constantes de tipo enumerado

A enumeração XrStructureType foi ampliada com:

XR_TYPE_TRACKABLE_OBJECT_ANDROID
XR_TYPE_TRACKABLE_OBJECT_CONFIGURATION_ANDROID

A enumeração XrTrackableTypeANDROID foi ampliada com:

XR_TRACKABLE_TYPE_OBJECT_ANDROID

Novos tipos enumerados

XrObjectLabelANDROID

Novas estruturas

XrTrackableObjectANDROID

Novas funções

xrGetTrackableObjectANDROID

Problemas

Histórico de versões

Revisão 1, 03/10/2024 (Kenny Vercaemer)
- Descrição inicial da extensão.