El SDK de ARCore para iOS se conecta con ARKit para proporcionar capacidades de Cloud Anchor, lo que te permite compartir anclas entre dispositivos iOS y Android en el mismo entorno.
Aprende a usar la API de ARCore Cloud Anchor o el servicio de Cloud Anchor de ARCore en tus propias apps.
Requisitos previos
- Xcode, versión 13.0 o posterior
- CocoaPods 1.4.0 o una versión posterior si usas CocoaPods
- Un dispositivo Apple compatible con ARKit que ejecute iOS 12.0 o una versión posterior (se requiere el destino de implementación de iOS 12.0 o una versión posterior)
Si eres nuevo en Cloud Anchors, sigue estos pasos:
Asegúrate de comprender el proceso que se usa para alojar y resolver una Cloud Anchor.
Lee la quickstart para conocer los requisitos del sistema, las instrucciones de instalación y configuración.
Revisa una de las muestras de Cloud Anchor
Habilita Cloud Anchors en tu app
Para usar la API de Cloud Anchors, debes crear un GARSessionConfiguration
y configurar la propiedad cloudAnchorMode
, como se describe en Configura una sesión de ARCore en iOS. Usa setConfiguration:error: (GARSession)
para establecer la configuración.
También debes habilitar la API de ARCore para tu aplicación.
Aloja y resuelve anclas
Puedes alojar y resolver las anclas de la nube con la API de Cloud Anchor de ARCore. La API incluye métodos de devolución de llamada para las operaciones completadas, así como objetos Future que se pueden sondear.
Aloja un ancla
Alojar un ARAnchor
coloca el ancla en un sistema de coordenadas común para un espacio físico determinado.
Una solicitud de host envía datos visuales a un servidor de Google, que asigna la posición de ARAnchor
en un sistema de coordenadas que representa el espacio físico actual. Una solicitud de host correcta muestra un ID de Cloud Anchor nuevo, que se puede compartir y usar para resolver el ancla más tarde.
- (void)addAnchorWithTransform:(matrix_float4x4)transform {
self.arAnchor = [[ARAnchor alloc] initWithTransform:transform];
[self.sceneView.session addAnchor:self.arAnchor];
__weak ExampleViewController *weakSelf = self;
self.hostFuture = [self.cloudAnchorManager
hostCloudAnchor:self.arAnchor
completion:^(NSString *anchorId, GARCloudAnchorState cloudState) {
[weakSelf handleHostAnchor:anchorId cloudState:cloudState];
}
error:nil];
[self enterState:HelloARStateHosting];
}
Resolver un ancla
La resolución de un ARAnchor
permite que los dispositivos iOS y Android en un espacio físico determinado agreguen anclas alojadas previamente a escenas nuevas.
Una solicitud de resolución envía al servidor de Google un ID de Cloud Anchor junto con datos visuales del marco actual. El servidor intentará hacer coincidir estos datos visuales con las imágenes de dónde se asignan las Cloud Anchors alojados en la actualidad. Cuando la resolución se realiza de forma correcta, se agrega una ancla nueva a la sesión y se muestra.
- (void)resolveAnchorWithIdentifier:(NSString *)identifier {
GARResolveCloudAnchorFuture *garFuture =
[self.gSession resolveCloudAnchorWithIdentifier:identifier
completionHandler:completion
error:&error];
}
// Pass the ARFRame to the ARCore session every time there is a frame update.
// This returns a GARFrame that contains a list of updated anchors. If your
// anchor's pose or tracking state changed, your anchor will be in the list.
- (void)cloudAnchorManager:(CloudAnchorManager *)manager didUpdateFrame:(GARFrame *)garFrame {
for (GARAnchor *garAnchor in garFrame.updatedAnchors) {
if ([garAnchor isEqual:self.garAnchor] && self.resolvedAnchorNode) {
self.resolvedAnchorNode.simdTransform = garAnchor.transform;
self.resolvedAnchorNode.hidden = !garAnchor.hasValidTransform;
}
}
}
Patrón de sondeo opcional GARSession
Si usas Metal o necesitas una opción de sondeo y tu app se ejecuta a un mínimo de 30 FPS, usa el siguiente patrón para pasar elementos ARFrame
al GARSession
:
-(void)myOwnPersonalUpdateMethod {
ARFrame *arFrame = arSession.currentFrame;
NSError *error = nil;
GARFrame *garFrame = [garSession update:arFrame error:&error];
// your update code here
}
Cuotas de API
La API de ARCore tiene las siguientes cuotas para el ancho de banda de solicitudes:
Tipo de cuota | Máximo | Duración | Se aplica a |
---|---|---|---|
Cantidad de anclas | Ilimitada | No disponible | Proyecto |
Solicitudes host fijas | 30 | minuto | Dirección IP y proyecto |
Fijar solicitudes resolve | 300 | minuto | Dirección IP y proyecto |
Problemas conocidos y soluciones
Hay algunos problemas conocidos cuando se trabaja con el SDK de ARCore para iOS.
La configuración del esquema predeterminado causa una falla intermitente de la app
Los parámetros de configuración de los esquemas de captura de marco de GPU y de validación de la API de Metal están habilitados de forma predeterminada, lo que a veces puede hacer que la app falle dentro del SDK.
Cómo diagnosticar fallas de la app
Cada vez que sospeches que se produjo una falla, echa un vistazo al seguimiento de pila.
Si ves MTLDebugComputeCommandEncoder
en el seguimiento de pila, es probable que se deba a la configuración predeterminada del esquema.
Solución alternativa
Ve a Product > Scheme > Edit Scheme….
Abre la pestaña Run.
Haz clic en Options para ver la configuración actual.
Asegúrate de que GPU Frame Capture y Metal API Validation estén inhabilitados.
Compila y ejecuta tu app.
Consulta el CHANGELOG
de CocoaPods para obtener información sobre otros problemas conocidos.
Limitaciones
El SDK de ARCore para iOS no admite la llamada de método setWorldOrigin(relativeTransform:)
de ARKit.
Consideraciones sobre el rendimiento
El uso de memoria aumenta cuando habilitas la API de ARCore. Se espera que el uso de batería del dispositivo aumente debido al mayor uso de red y de CPU.