iOS용 ARCore SDK는 ARKit과 상호작용하여 Cloud Anchor 기능을 제공하므로 동일한 환경에서 iOS 기기와 Android 기기 간에 앵커를 공유할 수 있습니다.
자체 앱에서 ARCore Cloud Anchor API 또는 ARCore Cloud Anchor 서비스를 사용하는 방법을 알아봅니다.
기본 요건
- Xcode 버전 13.0 이상
- CocoaPods를 사용하는 경우 Cocoapods 1.4.0 이상
- iOS 12.0 이상을 실행하는 ARKit 호환 Apple 기기(iOS 12.0 이상 배포 타겟 필요)
Cloud Anchors를 처음 사용하는 경우:
Cloud 앵커를 호스팅하고 확인하는 데 사용되는 프로세스를 이해해야 합니다.
시스템 요구사항, 설정, 설치 안내는 빠른 시작을 참고하세요.
클라우드 앵커 샘플 중 하나를 확인하세요.
앱에서 Cloud Anchors 사용 설정
Cloud Anchors API를 사용하려면 iOS에서 ARCore 세션 구성에 설명된 대로 GARSessionConfiguration를 만들고 cloudAnchorMode 속성을 설정해야 합니다. setConfiguration:error: (GARSession)를 사용하여 구성을 설정합니다.
애플리케이션에 ARCore API도 사용 설정해야 합니다.
앵커 호스팅 및 확인
ARCore Cloud Anchor API를 사용하여 클라우드 앵커를 호스팅하고 확인할 수 있습니다. 이 API에는 완료된 작업의 콜백 메서드와 폴링할 수 있는 Future 객체가 포함되어 있습니다.
앵커 호스팅
ARAnchor를 호스팅하면 지정된 실제 공간의 공통 좌표 체계에 앵커가 배치됩니다.
호스트 요청은 시각적 데이터를 Google 서버로 전송하며, 이 서버는 현재 물리적 공간을 나타내는 좌표계에서 ARAnchor의 위치를 매핑합니다. 호스트 요청이 성공하면 나중에 공유하고 앵커를 확인하는 데 사용할 수 있는 새 클라우드 앵커 ID가 반환됩니다.
- (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];
}
앵커 확인
ARAnchor를 확인하면 특정 실제 공간의 Android 및 iOS 기기가 이전에 호스팅된 앵커를 새 장면에 추가할 수 있습니다.
확인 요청은 Google 서버에 현재 프레임의 시각적 데이터와 함께 클라우드 앵커 ID를 전송합니다. 서버는 이 시각적 데이터를 현재 호스팅된 Cloud 앵커가 매핑된 위치의 이미지와 일치시키려고 시도합니다. 확인에 성공하면 새 앵커가 세션에 추가되고 반환됩니다.
- (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;
}
}
}
선택적 GARSession 폴링 패턴
Metal을 사용하거나 폴링 옵션이 필요하며 앱이 최소 30fps로 실행되는 경우 다음 패턴을 사용하여 ARFrame를 GARSession에 전달합니다.
-(void)myOwnPersonalUpdateMethod {
ARFrame *arFrame = arSession.currentFrame;
NSError *error = nil;
GARFrame *garFrame = [garSession update:arFrame error:&error];
// your update code here
}
API 할당량
ARCore API에는 요청 대역폭에 관한 다음과 같은 할당량이 있습니다.
| 할당량 유형 | 최대 | 기간 | 적용 대상 |
|---|---|---|---|
| 앵커 수 | 무제한 | 해당 사항 없음 | 프로젝트 |
| 앵커 호스트 요청 | 30 | 분 | IP 주소 및 프로젝트 |
| 앵커 resolve 요청 | 300 | 분 | IP 주소 및 프로젝트 |
알려진 문제 및 해결 방법
iOS용 ARCore SDK를 사용할 때 몇 가지 알려진 문제가 있습니다.
기본 스키마 설정으로 인해 간헐적으로 앱이 비정상 종료됨
GPU 프레임 캡처 및 Metal API 유효성 검사 스킴 설정은 기본적으로 사용 설정되어 있으므로 SDK 내에서 앱이 비정상 종료되는 경우가 있습니다.
앱 비정상 종료 진단하기
비정상 종료가 발생했다고 생각되면 스택 트레이스를 살펴보세요.
스택 트레이스에 MTLDebugComputeCommandEncoder가 표시되면 기본 스킴 설정 때문일 수 있습니다.
해결 방법
Product > Scheme > Edit Scheme… 페이지로 이동합니다.
Run 탭을 엽니다.
Options를 클릭하여 현재 설정을 확인합니다.
GPU Frame Capture 및 Metal API Validation가 모두 사용 중지되어 있는지 확인합니다.
앱을 빌드하고 실행합니다.
Cocoapods CHANGELOG에서 알려진 다른 문제를 확인하세요.
제한사항
iOS용 ARCore SDK는 ARKit setWorldOrigin(relativeTransform:) 메서드 호출을 지원하지 않습니다.
성능에 대한 고려사항
ARCore API를 사용 설정하면 메모리 사용량이 증가합니다. 네트워크 사용량과 CPU 사용률이 증가하여 기기의 배터리 사용량이 늘어날 수 있습니다.