iOS의 클라우드 앵커 빠른 시작

ARCore Cloud Anchor API 또는 ARCore 클라우드 앵커 서비스는 iOS 앱에 클라우드 앵커 기능을 제공하므로 사용자가 iOS와 Android 기기 모두에서 AR 환경을 공유할 수 있습니다.

이 가이드에서는 다음을 수행하는 방법을 설명합니다.

  • 클라우드 앵커와 함께 작동하도록 개발 환경 설정
  • 샘플 앱에서 앵커 호스팅 및 확인 사용해 보기

기본 요건

  • Xcode 버전 13.0 이상
  • Cocoapods 1.4.0 이상(Cocoapods를 사용하는 경우)
  • iOS 12.0 이상을 실행하는 ARKit 호환 Apple 기기 (iOS 12.0 이상의 배포 대상 필요)
를 통해 개인정보처리방침을 정의할 수 있습니다.

클라우드 앵커 사용

다음 단계에서는 클라우드 앵커 샘플 앱을 사용하여 ARCore 클라우드 앵커를 지원하는 앱을 구성하고 빌드하는 작업을 알아봤습니다.

클라우드 앵커 샘플 앱 가져오기

  1. GitHub에서 iOS용 ARCore SDK 클론 또는 다운로드 샘플 앱 코드를 가져옵니다.

  2. 터미널 또는 Finder 창을 열고 복제한 폴더로 이동합니다. SDK를 다운로드할 수 있습니다

  3. 샘플 앱 코드는
    에서 찾을 수 있습니다. /arcore-ios-sdk-master/Examples/CloudAnchorExample입니다.

    영구 클라우드 앵커 샘플 앱 코드는 다음과 같습니다.
    후 /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample입니다.

세션 설정

샘플 앱은 세션:

클라우드 앵커 ID 공유 설정

클라우드 앵커 샘플 앱은 Firebase를 사용하여 기기에서 사용할 수 있습니다. 자체 앱에서 다른 솔루션을 사용할 수 있습니다.

샘플 앱에서 Firebase 데이터베이스를 설정하려면 다음 안내를 따르세요.

  1. 앱에 Firebase를 추가하는 방법에 대한 Firebase 안내를 따릅니다.
  2. 추가 과정에서 생성된 GoogleService-Info.plist 파일을 다운로드합니다. 앱에 Firebase를 추가합니다.
  3. 샘플에 Firebase Storage를 사용 설정합니다. <ph type="x-smartling-placeholder">
      </ph>
    • Firebase Console로 이동하고 설정할 프로젝트를 선택합니다. 확인할 수 있습니다
    • Database 패널을 선택합니다.
    • Realtime Database 옵션에서 Get Started를 클릭합니다.
    • Security rules for Realtime Database 메뉴가 열립니다.
      • 샘플을 실행하려면 Start in test mode를 선택합니다.
      • 게시할 앱에 Firebase를 사용하는 경우에는 더 제한적인 보안 규칙을 사용해야 합니다
  4. Xcode에서 앱 옆에 있는 GoogleService-Info.plist 파일을 추가합니다. Info.plist입니다.

ARCore API 설정

클라우드 앵커를 사용하려면 먼저 ARCore API를 확인합니다.

포드 업데이트 실행

CloudAnchorExample 앱은 Podfile ARCore SDK 및 iOS 버전이 필요합니다. 이러한 종속 항목을 설치하려면 다음 안내를 따르세요.

  1. 터미널 창을 열고 앱이 생성된 폴더에서 pod update를 실행합니다. Xcode 프로젝트가 존재합니다.
    이렇게 하면 나중에 빌드하고 빌드하는 데 사용할 .xcworkspace 파일이 생성됩니다. 실행할 수 있습니다

앱에 ARCore SDK 추가를 참고하세요. 를 참조하세요.Podfile

  1. Xcode에서 프로젝트의 .xcworkspace 파일을 엽니다.

    빌드 오류를 방지하려면 .xcworkspace에서 빌드해야 합니다. 파일(.xcodeproj 파일 아님)입니다.

App Bundle ID 변경

Xcode에서 팀과 함께 앱에 서명할 수 있도록 앱의 번들 ID를 변경합니다.

앱 빌드 및 실행

  1. 기기를 연결하고 Xcode에서 앱을 실행합니다.

  2. (선택사항) 샘플 앱을 빌드하고 실행하는 경우 다음을 참고하세요. 섹션을 참조하세요.

샘플 앱 사용해 보기

  1. .xcworkspace 파일에서 샘플 앱을 빌드하고 실행하여 실행합니다. 액세스할 수 있습니다.

  2. 메시지가 표시되면 앱에 카메라 권한을 부여합니다. ARKit 후 카메라 앞에 있는 평면을 감지하기 시작합니다.

  3. HOST 버튼을 탭하여 호스팅 모드로 전환합니다. 호스팅된 앵커를 공유하기 위한 회의실 코드 생성되어 화면에 표시됩니다.

  4. 평면을 탭하여 해당 평면에 클라우드 앵커 호스팅을 시작하세요.

    • 앱이 평면에 Andy Android 객체를 배치하고 앵커를 연결합니다. 하겠습니다.
    • 호스트 요청이 ARCore API 클라우드 엔드포인트로 전송됩니다. 호스트 요청에는 볼 수 있습니다.
    • 앵커가 호스팅되면 클라우드를 확인하는 데 사용되는 ID를 가져옵니다. 사용할 수 있습니다.

  5. 이전에 액세스할 수 있도록 RESOLVE 아이콘을 탭하고 방 코드를 입력하세요. 동일한 기기 또는 다른 기기를 사용하여 이 방에 호스팅된 클라우드 앵커입니다.

    • 확인 요청이 ARCore API 클라우드 엔드포인트로 전송됩니다.
    • 확인 요청에 클라우드 앵커 ID가 포함됩니다. ID가 성공하면 서버는 앵커 변환에 사용됩니다.
    • 샘플 앱은 변환을 사용하여 장면에 앵커를 추가하고 가상 객체를 렌더링할 수 있습니다

앱에 ARCore SDK 추가

앱에서 이 태그를 사용하려면 Podfile ARCore SDK 및 지원되는 iOS 버전 관리 방법은 다음과 같습니다.

  1. 다음 platform 및 pod를 프로젝트의 Podfile:

        platform :ios, '11.0'
    pod 'ARCore/CloudAnchors', '~> 1.45.0'
를 통해 개인정보처리방침을 정의할 수 있습니다.
  1. 터미널 창을 열고 다음 폴더에서 pod update를 실행합니다. Xcode 프로젝트가 존재하는지 확인하세요.
    이렇게 하면 코드를 빌드하고 배포하는 데 사용하는 .xcworkspace 파일이 생성됩니다. 실행할 수 있습니다

영구 클라우드 앵커

지속성으로 클라우드 앵커 호스팅에 설명된 대로 클라우드 앵커의 수명을 최대 365일로 설정할 수 있습니다. 샘플 코드 영구 클라우드 앵커를 사용하는 방법은 /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample에서 제공됩니다. GitHub의 iOS용 ARCore SDK 디렉터리에 있습니다.

다음 단계