Resumen ejecutivo
Para conectar XREAL Aura a un sistema empresarial, ejecuta una aplicación corporativa autorizada en su unidad de procesamiento (compute puck) con Android XR y deja que esa aplicación solicite datos a la API del sistema. Una API es una conexión de software que permite a una aplicación obtener información de otra. Esta guía crea una pequeña aplicación que recupera una orden de trabajo y muestra sus instrucciones en Aura.
Una orden de trabajo de mantenimiento es una buena primera integración porque combina un número de registro, datos del equipo e instrucciones prácticas. La aplicación recupera esos campos mediante una conexión autorizada y los presenta en una ventana legible. El mismo enfoque puede adaptarse a otros registros empresariales cuando sus API y sus reglas de acceso lo permitan.
Cómo funciona la integración empresarial de XREAL Aura
XREAL Aura utiliza unas gafas con cable y una unidad de procesamiento, el pequeño ordenador que ejecuta Android XR y tu aplicación. La aplicación se conecta al sistema de la empresa a través de wifi y de una ruta de red aprobada; las gafas muestran la información devuelta. [1]
Una orden de trabajo describe una tarea y las instrucciones para llevarla a cabo. Un empleado introduce el número de orden en la aplicación de Aura y selecciona Load work order. La aplicación solicita ese registro al sistema empresarial y, a continuación, muestra el nombre del equipo, la versión del procedimiento y las instrucciones detalladas. Con Next y Previous, el empleado puede desplazarse por las instrucciones sin que el registro de origen se modifique.
Si tu empresa ya dispone de una aplicación Android que muestra estos registros, pide a su desarrollador que compruebe si funciona correctamente en Android XR antes de crear otra. Google admite interfaces Android estándar (como una aplicación Android 2D para móvil o para pantalla grande) mostradas en un panel del sistema XR, es decir, como una ventana 2D dentro del entorno XR. Aun así, una aplicación existente necesita pruebas de compatibilidad y de acceso. [4]
Para más contexto sobre el hardware, consulta nuestra página de producto de XREAL Aura. Confirma la disponibilidad y el soporte actuales en tu país, ya que la información sobre el lanzamiento cambia. [2]
Paso 1: Obtén una orden de trabajo de prueba y sus datos de conexión
Tu aplicación de Aura necesita un registro que mostrar y permiso para recuperarlo del sistema de tu empresa. Una orden de trabajo es un registro de tarea que contiene un número de orden, datos del equipo e instrucciones, como los pasos para inspeccionar una máquina.
· Antes de escribir el código, asegúrate de disponer de un endpoint HTTPS, un token de acceso de prueba y un número de orden de trabajo de ejemplo (p. ej., WO-1001) que se ajuste al esquema JSON de la Referencia para desarrolladores.
· Pide a tu equipo de TI la dirección de la API que recupera esta orden y un token de acceso de prueba temporal. La dirección de la API indica a la aplicación dónde solicitar el registro; el token le da permiso para leer los datos. Pide a TI que confirme que ambos funcionan y si se requiere acceso a la red de la empresa.
· Comparte con TI la Referencia para desarrolladores que aparece al final de este artículo para que comprueben que los datos devueltos coinciden con la aplicación de ejemplo. Si son distintos, actualiza el código del paso 3 para que lea los nombres de campo de tu sistema. Si no existe una API adecuada, TI deberá proporcionar una primero.
Ten preparados estos tres elementos: la dirección de la API se introduce en el código en el paso 3, y el token y el número de orden de trabajo, en la aplicación en ejecución en el paso 4. Juntos permiten que la aplicación recupere la tarea y muestre sus instrucciones en Aura.
Paso 2: Abre Android Studio y prepara la aplicación
Paso 2.1: Crea el proyecto en tu ordenador
· En el navegador de tu ordenador, abre la página oficial de descarga de Android Studio. Instala Android Studio y completa su configuración. Si necesitas las herramientas XR específicas de Google, sigue su guía de configuración de Android Studio para XR, que actualmente recomienda una compilación Canary, una versión de desarrollo temprana. [5]
· Abre Android Studio. En la pantalla de bienvenida, selecciona New Project. Si hay otro proyecto abierto, selecciona File > New > New Project en el menú superior de Android Studio.
· En la ventana del proyecto, selecciona Phone and Tablet > Empty Activity. Selecciona Next.
· Establece Name en AuraWorkOrders y Package name en com.example.auraworkorders. Usa Kotlin cuando aparezca una opción de lenguaje, mantén la configuración del SDK de la plantilla y selecciona Finish.
· Espera a que Android Studio termine la sincronización de Gradle. Gradle es la herramienta de compilación que prepara las bibliotecas y la configuración del proyecto. Resuelve cualquier error en la ventana Build o Sync antes de continuar.
Paso 2.2: Permite que la aplicación acceda a la red
El manifiesto es el archivo de Android que declara lo que necesita la aplicación, incluido el permiso de red.
· En el panel Project, a la izquierda de Android Studio, selecciona la vista Android en su menú desplegable. Si el panel está oculto, selecciona View > Tool Windows > Project.
· En ese panel, despliega app > manifests y abre AndroidManifest.xml.
· Dentro del elemento manifest, encima del elemento application, añade esta línea. Conserva el resto del archivo generado.
<uses-permission android:name="android.permission.INTERNET" />· En el mismo archivo, localiza la etiqueta de apertura application. Añade android:usesCleartextTraffic="false" como atributo dentro de esa etiqueta. Android ya bloquea el HTTP sin cifrar en las aplicaciones orientadas a Android 9 o posterior, así que esta línea hace explícita la intención.
El permiso INTERNET se concede durante la instalación; no genera ninguna ventana emergente de acceso cuando se ejecuta la aplicación. [6] El ejemplo utiliza las herramientas de red y de JSON integradas en Android, por lo que no es necesario añadir Retrofit ni ninguna otra biblioteca de red.
Paso 3: Añade el código que recupera y muestra la orden de trabajo
Este código conecta la aplicación con la dirección del paso 1, lee la respuesta y muestra las instrucciones de una en una. La solicitud de red se ejecuta por separado de la interfaz para que la pantalla siga respondiendo.
Paso 3.1: Abre el archivo correcto en Android Studio
· En el panel Project, a la izquierda de Android Studio, despliega app > kotlin+java > com.example.auraworkorders. En algunas versiones, la carpeta de código fuente se llama java.
· Abre MainActivity.kt. Este archivo controla la pantalla inicial de la aplicación.
· Sustituye su contenido por el código siguiente. Si tu nombre de paquete es distinto, cambia la primera línea para que coincida con el paquete que creaste en el paso 2.
package com.example.auraworkorders
import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.compose.foundation.layout.*
import androidx.compose.foundation.rememberScrollState
import androidx.compose.foundation.verticalScroll
import androidx.compose.material3.*
import androidx.compose.runtime.*
import androidx.compose.ui.Modifier
import androidx.compose.ui.text.input.PasswordVisualTransformation
import androidx.compose.ui.unit.dp
import org.json.JSONObject
import java.net.URL
import java.util.concurrent.Executors
import javax.net.ssl.HttpsURLConnection
data class WorkStep(
val number: Int, val title: String,
val instruction: String, val expectedResult: String
)
data class WorkOrder(
val id: String, val asset: String,
val revision: String, val steps: List<WorkStep>
)
fun fetchOrder(id: String, token: String): WorkOrder {
require(Regex("[A-Za-z0-9-]{1,40}").matches(id))
// Replace only this origin with your approved API origin.
val url = URL("https://api.your-company.example/work-orders/$id")
val c = url.openConnection() as HttpsURLConnection
try {
c.requestMethod = "GET"
c.instanceFollowRedirects = false
c.connectTimeout = 10000
c.readTimeout = 10000
c.setRequestProperty("Authorization", "Bearer $token")
c.setRequestProperty("Accept", "application/json")
val status = c.responseCode
check(status == 200) { "HTTP $status" }
val text = c.inputStream.bufferedReader().use { it.readText() }
val obj = JSONObject(text)
check(obj.getString("id") == id) { "Order ID mismatch" }
val array = obj.getJSONArray("steps")
check(array.length() > 0) { "No instructions available" }
val steps = (0 until array.length()).map { index ->
val s = array.getJSONObject(index)
WorkStep(s.getInt("number"), s.getString("title"),
s.getString("instruction"), s.getString("expectedResult"))
}.sortedBy { it.number }
return WorkOrder(obj.getString("id"), obj.getString("asset"),
obj.getString("revision"), steps)
} finally {
c.disconnect()
}
}
class MainActivity : ComponentActivity() {
private val worker = Executors.newSingleThreadExecutor()
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContent {
MaterialTheme {
WorkOrderScreen { id, token, done ->
worker.execute {
val result = runCatching { fetchOrder(id, token) }
runOnUiThread {
if (!isDestroyed) done(result)
}
}
}
}
}
}
override fun onDestroy() {
worker.shutdownNow()
super.onDestroy()
}
}
@Composable
fun WorkOrderScreen(
load: (String, String, (Result<WorkOrder>) -> Unit) -> Unit
) {
var id by remember { mutableStateOf("WO-1001") }
var token by remember { mutableStateOf("") }
var order by remember { mutableStateOf<WorkOrder?>(null) }
var index by remember { mutableStateOf(0) }
var busy by remember { mutableStateOf(false) }
var message by remember { mutableStateOf("Enter test credentials.") }
Surface(Modifier.fillMaxSize()) {
Column(Modifier.padding(24.dp)
.verticalScroll(rememberScrollState()),
verticalArrangement = Arrangement.spacedBy(16.dp)) {
Text("Work instructions", style = MaterialTheme.typography.headlineMedium)
OutlinedTextField(value = id, onValueChange = { id = it },
label = { Text("Work order ID") },
singleLine = true, enabled = !busy)
OutlinedTextField(value = token, onValueChange = { token = it },
label = { Text("Sandbox access token") }, singleLine = true,
visualTransformation = PasswordVisualTransformation(),
enabled = !busy)
Button(enabled = !busy && token.isNotBlank() &&
Regex("[A-Za-z0-9-]{1,40}").matches(id), onClick = {
busy = true
order = null
index = 0
message = "Loading work order..."
load(id, token) { result ->
busy = false
result.onSuccess {
order = it
message = "Read-only instructions loaded."
}.onFailure {
message = "Could not load order. Check access and network."
}
}
}) { Text(if (busy) "Loading..." else "Load work order") }
Text(message)
order?.let { current ->
Text("${current.id} | ${current.asset}")
Text("Procedure revision ${current.revision}")
val step = current.steps[index]
Text("Step ${index + 1} of ${current.steps.size}",
style = MaterialTheme.typography.titleLarge)
Text(step.title, style = MaterialTheme.typography.headlineSmall)
Text(step.instruction, style = MaterialTheme.typography.bodyLarge)
Text("Expected result: ${step.expectedResult}")
Row(horizontalArrangement = Arrangement.spacedBy(16.dp)) {
Button(enabled = index > 0,
onClick = { index-- }) { Text("Previous") }
Button(enabled = index < current.steps.lastIndex,
onClick = { index++ }) { Text("Next") }
}
Text("Navigation does not record task completion.")
}
}
}
}Paso 3.2: Introduce la dirección de la API de tu empresa
· Sigue en MainActivity.kt en Android Studio. Pulsa Ctrl+F en Windows o Linux, o Command+F en macOS, y busca api.your-company.example.
· Sustituye la URL de ejemplo de la línea URL(...) por el patrón de endpoint de tu empresa del paso 1. Mantén $id donde corresponde el número de orden de trabajo. Por ejemplo, si el servidor espera /api/jobs/WO-1001, el código debe solicitar https://YOUR-APPROVED-HOST/api/jobs/$id .· No pongas el token en este archivo. La aplicación ofrece un campo de prueba temporal para introducirlo cuando la ejecutes.
· Si la respuesta de tu API difiere de la Referencia para desarrolladores, actualiza los nombres de campo y la estructura que lee fetchOrder antes de ejecutarla. En esta función, JSONObject lee la respuesta y getJSONArray("steps") abre su lista de instrucciones.
· En Android Studio, selecciona Build > Make Project si ese comando está disponible en tu versión, o usa el botón Run de la barra de herramientas en el paso 4 para compilar el proyecto. Corrige los errores de compilación en la ventana Build.
Resultado esperado: el proyecto se compila y la URL de MainActivity.kt apunta a tu servicio de prueba real. La dirección de ejemplo que termina en .example no se conectará a ningún sistema empresarial.
Paso 4: Prueba la conexión en tu ordenador
Un emulador es un dispositivo Android virtual que se muestra en tu ordenador. Úsalo primero para comprobar la dirección de la API, el token y las instrucciones devueltas antes de ponerte a solucionar problemas en un dispositivo físico.
Paso 4.1: Inicia la aplicación desde Android Studio
· En el menú superior de Android Studio, selecciona Tools > Device Manager.
· Si ya existe un dispositivo virtual Android adecuado, selecciona su botón de inicio. De lo contrario, selecciona Create Device o el botón más, elige un perfil de teléfono, selecciona una imagen del sistema disponible, descárgala si se te pide y completa el asistente. Inicia el nuevo dispositivo.
· De vuelta en la barra de herramientas superior de Android Studio, selecciona ese dispositivo en ejecución en el menú desplegable de dispositivos. Mantén app seleccionada como configuración de ejecución y, después, selecciona el botón verde Run.
· Espera a que la aplicación se abra en el emulador. Deberías ver Work instructions, Work order ID, Sandbox access token y Load work order.
Paso 4.2: Solicita el registro empresarial
· En la aplicación en ejecución dentro del emulador, selecciona Work order ID e introduce el número de orden de prueba del paso 1.
· En la misma aplicación, selecciona Sandbox access token y pega el token temporal proporcionado por TI. Pega solo su valor, sin la palabra Bearer.
· Selecciona Load work order. Si la solicitud se realiza correctamente, la aplicación muestra Read-only instructions loaded, seguido del número de orden, el nombre del equipo, la revisión del procedimiento y la primera instrucción.
· Selecciona Next para leer la siguiente instrucción. Selecciona Previous para volver atrás. Desplázate dentro de la aplicación si una instrucción se extiende por debajo de la ventana.
Resultado esperado: el registro mostrado coincide con el que abriste en la aplicación empresarial en el paso 1. Si no se carga, consulta la sección de resolución de problemas antes de pasar a Aura.
Paso 5: Ejecuta la misma aplicación conectada en XREAL Aura
Paso 5.1: Prepara Aura para el desarrollo
· Enciende Aura mediante su unidad de procesamiento. En la aplicación Settings de Aura, conéctate a una red wifi desde la que se pueda acceder a la API del paso 1. Pide a TI que confirme cualquier requisito de red privada.
· Sigue el proceso de incorporación para desarrolladores vigente que proporciona XREAL para habilitar la depuración y conectar la unidad de procesamiento a tu ordenador. Empieza por las preguntas frecuentes de Aura de XREAL (tutorials.xreal.com/docs/aura/troubleshooting/faq/), que incluyen el apartado de recursos para desarrolladores; empieza por ahí si necesitas las instrucciones actuales.
· En la aplicación Settings de Aura, abre Developer options y habilita el método de depuración compatible con tu dispositivo, siguiendo ese proceso de incorporación. Autoriza tu ordenador de desarrollo si Aura muestra un aviso. La guía de dispositivos de hardware de Google explica el proceso general de Android. [7]
Las etiquetas exactas de los menús de Aura y la disposición de los cables dependen del hardware y del firmware. Las preguntas frecuentes de XREAL Aura indican que los dos puertos USB-C de la unidad de procesamiento admiten la depuración ADB estándar con Android Studio, así que conecta el ordenador al puerto de carga (Charging Port) de la izquierda y deja las gafas en el puerto de las gafas (Glasses Port) de la derecha. La tabla de especificaciones solo indica compatibilidad completa con ADB en el Glasses Port, así que prueba ese puerto si no se reconoce el de la izquierda, y sigue las instrucciones actuales de XREAL para habilitar el acceso de desarrollador. [1]
Paso 5.2: Instala la aplicación desde Android Studio
· En tu ordenador, vuelve al proyecto AuraWorkOrders en Android Studio.
· Abre el menú desplegable de dispositivos en la barra de herramientas superior de Android Studio. Selecciona tu dispositivo de desarrollo Aura conectado en lugar del emulador.
· Si el dispositivo no aparece, selecciona Tools > Troubleshoot Device Connections en Android Studio y sigue el asistente de conexión. Confirma la autorización de depuración y el método de conexión con el proceso de incorporación de XREAL.
· Cuando aparezca el dispositivo, mantén app seleccionada como configuración de ejecución y selecciona el botón verde Run. Android Studio compila, instala e inicia la aplicación en el dispositivo seleccionado.
Paso 5.3: Recupera el registro en las gafas
· Ponte las Aura y busca la ventana de la aplicación Work instructions que ha iniciado Android Studio.
· En esa ventana, introduce el mismo número de orden de prueba y el mismo token temporal que usaste en el paso 4. Utiliza los métodos de entrada disponibles en tu dispositivo; los teclados y ratones Bluetooth estándar funcionan con Aura (Settings > Connected Devices > Pair new device), y un teclado Bluetooth compatible puede facilitar la introducción de datos durante las pruebas. [1]
· Selecciona Load work order y, después, usa Next, Previous y el desplazamiento para leer sus instrucciones.
· Compara el número de orden, el nombre del equipo y el texto de las instrucciones con el registro original de tu aplicación empresarial. Si coinciden, habrás demostrado que la aplicación de Aura puede recuperar y mostrar ese registro empresarial.
Problemas habituales y qué comprobar
· La aplicación no se compila: en Android Studio, abre View > Tool Windows > Build y lee el primer error notificado. Comprueba el nombre del paquete y si el proyecto Empty Activity usa Compose y Material 3.
· La aplicación no puede cargar la orden: en MainActivity.kt, en Android Studio, confirma que se ha sustituido el nombre de host de ejemplo. Pide a TI que compruebe que se puede acceder al endpoint desde la red del emulador o de Aura.
· La API devuelve 401: la API no ha aceptado la credencial. Pide a TI que compruebe la validez del token y el servicio al que está destinado, o consigue un nuevo token de prueba.
· La API devuelve 403: la cuenta no tiene permiso. Pide al administrador del sistema empresarial que conceda el acceso adecuado.
· La API devuelve 404: comprueba el número de orden y si el endpoint apunta al entorno de prueba correcto.
· La API devuelve datos, pero la aplicación falla: pide al desarrollador de la API que compare la respuesta con la Referencia para desarrolladores. El ejemplo requiere una lista steps no vacía y un id que coincida con la orden solicitada.
· Funciona en el emulador, pero no en Aura: confirma la ruta de red de Aura y el acceso a la API y, a continuación, comprueba la aplicación en el dispositivo. No desactives las comprobaciones de certificados HTTPS para eludir un error de conexión.
El ejemplo muestra al usuario un mensaje de error genérico. Para conocer el estado exacto de la API, pide al administrador que revise los registros del servidor sin exponer tokens ni órdenes de trabajo completas. Para los errores de la aplicación, usa View > Tool Windows > Logcat en Android Studio; Logcat muestra los registros de la aplicación.
Referencia para desarrolladores de la API de ejemplo
Usa esta sección al comprobar la respuesta en el paso 1 o al adaptar fetchOrder en el paso 3. Describe el contrato de esta aplicación de ejemplo, no un endpoint proporcionado por XREAL.
Solicitud: GET https://api.your-company.example/work-orders/WO-1001
Encabezados de la solicitud: Authorization: Bearer <token de acceso de corta duración> y Accept: application/json
Respuesta correcta esperada: HTTP 200 con esta estructura JSON
{
"id": "WO-1001",
"asset": "Training station A",
"revision": "3",
"steps": [
{
"number": 1,
"title": "Confirm the training station",
"instruction": "Match the station label to this work order. Stop if the labels differ.",
"expectedResult": "The station label matches Training station A."
},
{
"number": 2,
"title": "Review the reference label",
"instruction": "Read the sample label and compare it with the training reference sheet.",
"expectedResult": "The sample label matches the approved reference."
}
]
}El campo id identifica la orden de trabajo, asset identifica su equipo y revision identifica la versión del procedimiento. Cada entrada dentro de steps tiene un número, un título, la instrucción completa y un expectedResult. El ejemplo ordena los pasos por número.
Utiliza instrucciones aprobadas para el trabajo real; el ejemplo describe una estación de formación inactiva. Antes de pasar a producción, valida el tamaño de la respuesta y la longitud de los campos, rechaza los datos de procedimiento no válidos y define el comportamiento ante la caducidad del token. La API debe comprobar los permisos para cada orden solicitada. El código de ejemplo es ilustrativo y no se ha compilado ni probado con un sistema real ni con un dispositivo Aura físico.
Conclusión
Conectar XREAL Aura a un sistema empresarial empieza por una dirección de API aprobada y un permiso de acceso, seguidos de una aplicación de Android Studio que recupere el registro necesario. Probar la conexión en un ordenador antes de implementarla en Aura ayuda a distinguir los problemas de acceso a los datos de los de configuración del dispositivo. El ejemplo de la orden de trabajo lleva los datos del equipo y las instrucciones paso a paso a una pantalla legible en las gafas, lo que ofrece a las empresas un punto de partida práctico para que la información operativa esté accesible en el lugar de trabajo. El inicio de sesión corporativo, los permisos adecuados y las pruebas en el dispositivo preparan esa conexión para un piloto con empleados.
Habla sobre la disponibilidad del hardware y los requisitos de tu piloto con VR Expert.

























