Android용 Cloud Anchors 빠른 시작

cloud_anchor_java 및 persistent_cloud_anchor_java 샘플 앱에서 Cloud Anchors 호스팅 및 해결을 사용해 보세요.

어떤 샘플 앱을 사용해야 하나요?

클라우드 앵커는 ARCore API 클라우드 엔드포인트에서 호스팅되는 앵커입니다. 이 API를 사용하면 사용자가 동일한 앱에서 환경을 공유할 수 있습니다. 영구 클라우드 앵커는 24시간 이상 호스팅할 수 있는 클라우드 앵커입니다.

  • persistent_cloud_anchor_java는 공동작업 프로젝트 사용 사례의 구현입니다. 키리스 승인을 사용하여 ARCore API 호출을 승인합니다. Firebase 백엔드를 사용하여 기기 간에 클라우드 앵커 ID를 공유하지 않으므로 시작하고 실행하기가 훨씬 쉽습니다.
  • cloud_anchor_java는 멀티플레이어 사용 사례의 구현입니다. API 키를 사용하여 ARCore API 호출을 승인합니다.

기본 요건

요구사항

하드웨어

소프트웨어

  • Android 스튜디오 버전 3.0 이상, Android SDK 플랫폼 버전 7.0 (API 수준 24) 이상
  • Android용 ARCore SDK(다음 두 가지 방법 중 하나로 획득 가능)
    • GitHub에서 다운로드하고 머신에서 추출합니다.
    • 다음 명령어를 사용하여 저장소를 클론합니다. 
      git clone https://github.com/google-ar/arcore-android-sdk.git

Android 스튜디오에서 샘플 앱 열기

ARCore SDK는 클라우드 앵커 기능을 보여주는 cloud_anchor_java 및 persistent_cloud_anchor_java 샘플 앱을 제공합니다. 다음 단계에 따라 Android 스튜디오에서 앱을 엽니다.

영구 클라우드 앵커

  1. Android 스튜디오에서 열기를 클릭합니다.

  2. 머신에서 arcore-android-sdk 디렉터리가 저장된 위치로 이동합니다. 전체 SDK 폴더를 열지 마세요. samples > persistent_cloud_anchor_java로 이동하여 Open을 클릭합니다.

클라우드 앵커

  1. Android 스튜디오에서 열기를 클릭합니다.

  2. 머신에서 arcore-android-sdk 디렉터리가 저장된 위치로 이동합니다. 전체 SDK 폴더를 열지 마세요. 대신 samples > cloud_anchor_java로 이동하여 Open을 클릭합니다.

클라우드 앵커 ID 공유 설정

클라우드 앵커 ID는 호스팅된 클라우드 앵커를 식별하는 문자열입니다. 호스팅된 앵커에 연결된 3D 객체를 확인하거나 렌더링하는 데 사용됩니다.

영구 클라우드 앵커

클라우드 앵커 ID 공유는 앱에서 로컬로 유지됩니다. 여기서는 아무 작업도 수행할 필요가 없습니다.

클라우드 앵커

cloud_anchor_java 샘플 앱은 Firebase의 실시간 데이터베이스를 사용하여 기기 간에 클라우드 앵커 ID를 공유합니다. 자체 앱에서 다른 솔루션을 사용할 수 있습니다.

  1. 앱에 Firebase를 수동으로 추가합니다. cloud_anchor_java 패키지 이름은 com.google.ar.core.examples.java.cloudanchor입니다. main/AndroidManifest.xml에서 확인할 수 있습니다.
  2. 앱에 Firebase를 추가할 때 생성한 google-services.json 파일을 다운로드합니다.
  3. Firebase로 실시간 데이터베이스를 만듭니다.
  4. Android 스튜디오에서 google-services.json 파일을 프로젝트의 app 디렉터리에 추가합니다.

ARCore API 호출 승인

앱의 Cloud Anchor를 호스팅하고 해결하기 위해 ARCore API 호출을 승인합니다. Google Cloud에서 ARCore API 사용의 단계를 따르고 영구 Cloud Anchor의 경우 키리스 승인을 사용하거나 Cloud Anchor의 경우 API 키 승인을 사용합니다.

샘플 앱 빌드 및 실행

영구 클라우드 앵커

앱 실행

  1. 기기에서 개발자 옵션 및 USB 디버깅이 사용 설정되어 있는지 확인합니다.
  2. USB를 통해 기기를 개발 머신에 연결합니다.
  3. Android 스튜디오에서 기기를 배포 대상으로 선택하고 실행을 클릭합니다.

persistent_cloud_anchor_java이 기기에서 실행되어 ARCore가 기기 카메라 앞에 있는 평면을 감지하도록 프롬프트가 표시됩니다.

Google Cloud 승인이 실패하면 문제 해결 단계를 참고하세요.

앵커 배치

  1. 앱이 평면 감지를 시작하면 화면을 탭하여 감지된 평면 중 하나에 앵커를 배치합니다.
  2. 호스트 버튼을 탭하여 배치된 앵커를 호스팅합니다. 이렇게 하면 앵커의 위치를 주변 시각적 특징과 관련해 나타내는 데이터를 포함하는 호스트 요청이 ARCore API로 전송됩니다.

호스트 요청이 성공하면 배치된 위치에 앵커가 설정되고 클라우드 앵커 ID가 할당됩니다. 호스트 요청이 성공하면 앱에 회의실 코드가 표시되어야 합니다. 이 코드를 사용하여 모든 기기에서 이 방에 대해 이전에 호스팅된 앵커에 액세스할 수 있습니다.

앵커 확인

  1. 해결을 탭하고 이전에 반환된 방 코드를 입력하여 이 방에 호스팅된 앵커에 액세스합니다. 이렇게 하면 ARCore API에 해결 요청이 전송되고 현재 방에 호스팅된 모든 앵커의 ID가 반환됩니다. persistent_cloud_anchor_java는 이러한 ID를 사용하여 호스팅된 앵커에 연결된 3D 객체를 렌더링합니다.

클라우드 앵커

앱 실행

  1. 기기에서 개발자 옵션 및 USB 디버깅이 사용 설정되어 있는지 확인합니다.
  2. USB를 통해 기기를 개발 머신에 연결합니다.
  3. Android 스튜디오에서 기기를 배포 대상으로 선택하고 실행을 클릭합니다.

cloud_anchor_java이 기기에서 실행되어 ARCore가 기기 카메라 앞에 있는 평면을 감지하도록 프롬프트가 표시됩니다.

오류: com.google.firebase.database.DatabaseException: Failed to get FirebaseDatabase instance: Specify DatabaseURL within FirebaseApp or from your getInstance

이 오류가 발생하면 firebase_url 속성이 google-services.json에 있는지 확인하세요. 실시간 데이터베이스가 생성되었는지 확인하고 google-services.json를 다운로드하여 이 속성의 올바른 값을 가져올 수 있습니다.

앵커 배치

  1. 앱이 평면 감지를 시작하면 화면을 탭하여 감지된 평면 중 하나에 앵커를 배치합니다.
  2. 호스트 버튼을 탭하여 배치된 앵커를 호스팅합니다. 이렇게 하면 앵커의 위치를 주변 시각적 특징과 관련해 나타내는 데이터를 포함하는 호스트 요청이 ARCore API로 전송됩니다.

호스트 요청이 성공하면 배치된 위치에 앵커가 설정되고 클라우드 앵커 ID가 할당됩니다. 호스트 요청이 성공하면 앱에 회의실 코드가 표시되어야 합니다. 이 코드를 사용하여 모든 기기에서 이 방에 대해 이전에 호스팅된 앵커에 액세스할 수 있습니다.

앵커 확인

  1. 해결을 탭하고 이전에 반환된 방 코드를 입력하여 이 방에 호스팅된 앵커에 액세스합니다. 이렇게 하면 ARCore API에 해결 요청이 전송되고 현재 방에 호스팅된 모든 앵커의 ID가 반환됩니다. cloud_anchor_java는 이러한 ID를 사용하여 호스팅된 앵커에 연결된 3D 객체를 렌더링합니다.

다음 단계